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
Full docs copy for offline read (PDF, EPUB, HTML) #923
Comments
Did a little research on this. There is actually a MkDocs plugin now that outputs a PDF (which is arguably the most accessible format, if we just choose one), However, ran into some errors I'm spinning my wheels on. Perhaps @jholdstock has some ideas here? This is the error I'm getting (for all images):
I think it might be related this known issue. The workaround is to change a MkDocs config parameter, which I fear could create new issues. This plugin is based on another project called mkdocs-combine , which combines multiple markdown files into a single markdown file. Which can then be used as input into a tool like pandoc, which can generate any format (PDF, single-page html, epub, etc.). I've tried using pandoc to create the PDF, but am running into yet more errors. Would keep going here, but wanted to check in to see if anyone had ideas on this before I spent any more time. |
What is the situation with this? |
Hello, i have the following errors : https://pastebin.com/WVpDPvCZ i dont know what is wrongg in my configuration ? Best Regards, |
Hi @elmesrar - I have moved your log onto pastebin and updated your comment. Please don't paste such long logs into github comments. Investigating this now. |
I've spent some time on this, and fixed all of the "broken" links and references (#1168, decred/dcrdevdocs#98) I got mkdocs-pdf-export-plugin running, but it has a bunch of issues:
I have discovered mkdocs-print-site-plugin which seems to be a much more elegant solution - I tested it and it works really well. The only issue is we need to wait for squidfunk/mkdocs-material#2655 to be released first. |
I saw the reference to this issue on the mkdocs-material issue. I'm the author of The epub is a nice idea, but it seems to be more involved. Found f.e. https://github.com/gutenbergtools/ebookmaker. Not on the roadmap but I'm open for PRs if we discuss the design together ;) |
Suggested here.
As an example see how Python bundles the entire documentation: https://docs.python.org/3/download.html
The text was updated successfully, but these errors were encountered: