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

PDF documentation generation #44

Open
gmabey opened this issue Nov 17, 2023 · 0 comments
Open

PDF documentation generation #44

gmabey opened this issue Nov 17, 2023 · 0 comments

Comments

@gmabey
Copy link
Contributor

gmabey commented Nov 17, 2023

This should be considered a low-priority feature request.
I've been using the --print-to-pdf switch on google chrome to generate a PDF document of the sabledocs generated HTML pages. I just do it as a CI/CD step on index.html and then on each of the pages corresponding to my multiple .proto files, then I use pdfunite to concatenate them together.
This works.
The down-sides are that the links don't work, and the copyright footer gets repeated more often than it needs to be.
Also, I see that chrome picks a different font size for printing based on the content.
But it works.

I'm just creating this issue to plant the seed of an idea that could make this much better.
If there was a "single_page" mode in sabledocs.toml that would result in all of the content being put into a single .html file, and if (in that same mode) all links (except for the repository-url links of course) were local to the page, it would make this setup 10x better.

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

No branches or pull requests

1 participant