Skip to content

Add README for documentation - #59

Open
SuperCowProducts wants to merge 4 commits into
Davide-sd:masterfrom
SuperCowProducts:master
Open

Add README for documentation#59
SuperCowProducts wants to merge 4 commits into
Davide-sd:masterfrom
SuperCowProducts:master

Conversation

@SuperCowProducts

Copy link
Copy Markdown

I'm pleased to say this project's documentation builds flawlessly first-try AND has is capable of generating a beautiful PDF - a very rare case indeed!

I put the steps I followed down in a README.md inside the `doc' folder - you'd probably want to adapt it, but I though it was worth 1. noting down the precise procedure I followed for future reproducibility, 2. letting users expllicitly know building the docs is an ordinary and supported procedure - perhaps we can add a pipeline to auto-build PDF on Read the Docs?

Thank you for this project, I'm excited to try seamless graph creation from SymPy calculations

SuperCowProducts and others added 2 commits June 13, 2026 21:55
Added instructions for creating a table of contents in the README.
@SuperCowProducts

SuperCowProducts commented Jun 14, 2026

Copy link
Copy Markdown
Author

I've also generated a table of contents ready to be embedded inside the PDF, and have also provided the original recipe.toml file for the very first automated heading-detection step.

Added a reference to the original recipe.toml file for user convenience.
Added link to ready-built PDF in README.
@Davide-sd

Copy link
Copy Markdown
Owner

@SuperCowProducts thanks for the effort. I looked at the PDF file and it looks like you used the minimum install option, as only charts generated by Matplotlib where included.

On my development environment, with all the dependencies installed, I run the exact command: it mostly worked, in the sense that almost all of the plots (generated with Matplotlib, Plotly, K3D-Jupyter) were included. However, there were a couple of issues, namely with GIFs that can't be included in a PDF, and with some unicode characters being problematic in Latex.

At the moment, I don't have time to work out these issues, so I'll leave this PR open. Feel free to give it a try...

@SuperCowProducts

Copy link
Copy Markdown
Author

@SuperCowProducts thanks for the effort. I looked at the PDF file and it looks like you used the minimum install option, as only charts generated by Matplotlib where included.

On my development environment, with all the dependencies installed, I run the exact command: it mostly worked, in the sense that almost all of the plots (generated with Matplotlib, Plotly, K3D-Jupyter) were included. However, there were a couple of issues, namely with GIFs that can't be included in a PDF, and with some unicode characters being problematic in Latex.

At the moment, I don't have time to work out these issues, so I'll leave this PR open. Feel free to give it a try...

Thank you for the clarification, I usually skim through those errors as I find it surprising if the PDF is actually generated at all lol. I'd need to check if LaTeX has GIF support at all, and as for Unicode, usually that's a sign some extra packages are needed in the preamble. Then it should be fine.

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.

2 participants