24 lines
2.1 KiB
Markdown
24 lines
2.1 KiB
Markdown
# Instructions for compiling this project in CoCalc
|
|
|
|
> [CoCalc](https://academiccloud.de/services/cocalc/) is a web service for data scientists. As part of the [AcademicCloud](https://academiccloud.de/), 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](https://doc.cocalc.com/latex.html).
|
|
>
|
|
> **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](https://academiccloud.de/services/cocalc/).
|
|
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. |