latex-skript/docs/cocalc-instructions.md

Instructions for compiling this project in CoCalc

CoCalc is a web service for data scientists. As part of the AcademicCloud, it is available to students at University of Bamberg. CoCalc is useful for collaboration on \LaTeX documents, Jupyter Notebooks, and much more. CoCalc provides an extensive documentation.

Please note: The Academic Cloud version is currently in preview, causing limited resources, no backups, and changes without prior notice. Use at your own risk.

This tutorial demonstrates how to set up CoCalc to compile the LaTeX script.

Project setup

1. Open CoCalc. Students at University of Bamberg may use this instance.
2. Click the blue button to go to your projects.
3. Click on “Create Project …”.
   • Add a title (e.g., “latex-workshop”).
   • Click on “Customize software environment” and choose “TeXLive” from the dropdown.
   • Create the project and wait for the initialization to finish. It is done when you see a blue button allowing you to “Create or Upload Files …”
4. Choose “Explorer” on the left side and click on “Upload.” Select your compressed project archive. Once uploaded, click on the name and proceed to “Extract Files …”
5. Back in the Explorer, you can now navigate through our project directory. Go to the file main-exercises.tex. It should load a familiar \LaTeX work environment and automatically build the document for you. Compilation will be triggered whenever you hit Ctrl + S.

Some general advice

• Use the dropdown next to the three colorful buttons to switch between source code files related to the same root document. Do not open them in separate tabs via the Explorer.
• CoCalc projects stop on inactivity. You will be prompted to restart the project.
• When you add new .tex documents, CoCalc automatically fills them with some content you may want to use. For our purposes, you may delete this so-called boilerplate code.