Quarto PDF docs take 2

[visr]

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

[asinghvi17]

https://github.com/PumasAI/QuartoNotebookRunner.jl/pull/135 may be interesting to you if using the Julia engine, we might start using it in https://github.com/geocompx/geocompjl pretty soon as well.

It basically allows the code in the cell to determine the number and contents of outputs, so it can even output things like a tabset. Useful if you want to show parameters programmatically without having to manually create the tabset...

[visr]

Thanks for the suggestion @asinghvi17! Looking forward to the geocompjl book. In our Quarto project we have a mix of Julia and Python code. I think we therefore cannot use QuartoNotebookRunner and have to stay with jupyter.

[visr]

This is too outdated. If we still need this we need a new PR. It seems quite tricky to do though, and we'd need quite some text and formula modifications for Latex support. Perhaps once Typst book support lands in Quarto we should revisit this https://github.com/quarto-dev/quarto-cli/discussions/6979.