-
Notifications
You must be signed in to change notification settings - Fork 89
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 manual #64
Comments
@alexanderhiam I wrote a script to (kind of) make it easy to generate a PDF from the wiki. |
Nice! Yeah, I'll have to clear some white space. I'd also like to include the main page with the pinout diagram, and it would be great to generate a toc from those links. That may require using something like panadoc as a last step. |
I tried pandoc initially. Directly converted the markdown files from the wiki git repo, but hated the formatting. Especially the code blocks. This one is a bit complicated but prettier. |
If I remember right you can specify the stylesheet to use for markdown conversion in pandoc, so it could just use the Github stylesheet. |
And PyPDF2 may also be able to do all that, I've never used it. |
Yepp, it does that with grip too (easier thn pandoc), but thought it would be a better look/feel than the same old gfm. |
Hi all! Why not using Sphinx with
I can create a new issue and eventually helping out porting the documentation to that format. |
@lucalenardi I'd like to use something like Sphinx in the long run, but I don't have the time now to make that switch, so I want to do something quicker in the interim. |
OK, it's time to bite the bullet and convert to using Sphinx - see issue #88 |
It seems like many users don't find there way to the PyBBIO wiki (https://github.com/graycatlabs/PyBBIO/wiki), so there should be a generated PDF manual for each release.
I have plans to migrate the docs and tutorials to http://graycat.io, but that might not happen for a while, so the first PDF manual might have to be made from the wiki source.
The text was updated successfully, but these errors were encountered: