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]

PumasAI/QuartoNotebookRunner.jl#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.