Deltares / Ribasim

Water resources modeling
https://deltares.github.io/Ribasim/
MIT License
36 stars 5 forks source link

Quarto PDF docs take 2 #1555

Open visr opened 2 weeks ago

visr commented 2 weeks ago

Part of #666, does not automatically build yet or is included in release assets. Supersedes #1298.

For this we need to wait on the conda-forge release of Quarto 1.5, which is currently a release candidate. Otherwise it fails as mentioned here.

Use this to render:

pixi run --environment=dev quarto render docs --profile manual --to pdf

Only since the Quarto 1.5 RC is not in conda-forge, I have to remove pixi run, causing issues of not being able to find Python. So I didn't test if this worked on all content, just some parts.

Some more references in case someone wants to try this: https://quarto.org/docs/books/ https://quarto.org/docs/reference/formats/pdf.html https://quarto.org/docs/reference/projects/books.html https://github.com/Deltares/iMOD-Documentation https://github.com/Deltares/iMOD-Documentation/blob/main/docs/_quarto-manual.yml