Upload & Revision Instructions

Note

Jump in and translate – that’s where the real work happens. The file gymnastics at the end are best left to Franz or Niels anyway.

Once a chapter is finalised, follow these steps to get it onto the website.

---

Naming convention

Save chapter files with the same names used for the English originals:

02_introduction.md
03_chapter1.md
04_chapter2.md
05_chapter3.md
06_chapter4.md
07_backmatter.md

Where to place files

Put them in the chapters/ subfolder of your language:

da/chapters/02_introduction.md
da/chapters/03_chapter1.md
...

pl/chapters/02_introduction.md
...

Adding a chapter to the site navigation

Open _quarto.yml and add the new file to the sidebar for your language. Example for Danish:

- id: da
  title: "Danish"
  contents:
    - da/index.qmd
    - da/chapters/02_introduction.md   # add this line

Rendering and publishing

Once files are in place, run from the project root:

quarto render

Check the output locally in _site/ (open _site/index.html in a browser). When satisfied, publish with:

./publish.sh

This pushes the rendered site to the pages branch on Codeberg.

---

Revision workflow

If a published chapter needs corrections:

1. Edit the .md file in your language folder.
2. Re-run quarto render and check locally.
3. Run ./publish.sh to republish.

Do not edit files directly in _site/ — changes there will be overwritten on the next render.