Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Render PDF docs #1298

Draft
wants to merge 4 commits into
base: main
Choose a base branch
from
Draft

Render PDF docs #1298

wants to merge 4 commits into from

Conversation

Hofer-Julian
Copy link
Contributor

Fixes #666

@Hofer-Julian
Copy link
Contributor Author

Blocked by conda-forge/quarto-feedstock#44

@visr
Copy link
Member

visr commented Apr 22, 2024

One option to make progress on this that @Hofer-Julian suggested is to remove quarto from our Pixi dependencies, and ask developers to install Quarto themselves again from https://quarto.org/docs/get-started/. We could keep using our Pixi tasks to build docs.

@visr visr changed the title Render PDF docs with typst Render PDF docs Apr 29, 2024
@visr
Copy link
Member

visr commented Apr 29, 2024

I'm afraid we cannot use Typst yet, it is currently only for individual documents: quarto-dev/quarto-cli#6979

But let's just push this forward towards decent PDF docs using Latex.

@visr
Copy link
Member

visr commented Apr 30, 2024

I keep running into errors. Using quarto 1.4 it cannot compile the title-block.md template, throwing an error similar to quarto-dev/quarto-cli#8556.

On quarto 1.5 prerelease I get:

ERROR:
compilation failed- error
Unable to load picture or PDF file 'index_files/figure-latex/mermaid-figure-1.png'.

Even though the file is there. This is the command I use to try to build the docs:

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

Some more references in case someone wants to try this again:
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

@visr visr mentioned this pull request Apr 30, 2024
3 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Include docs PDF in release assets
2 participants