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

WIP - try to split documentation into small files #711

Draft
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

rocky
Copy link
Member

@rocky rocky commented Jan 3, 2023

This currently doesn't work though.

One thing that would really help working on building documentation is to split out part and chapter files as their own TeX include file.

When I was trying to get image inclusion working I also tried this.

There is a bug though in this part that mystifies me. @mmatera if you could get this working this would help a lot.

Basically we replace docpipline.py with some options for a more specialized program extract-doc under mathics.doc.latex

About the image inclusion. I spent a far bit of work investigating this and right now the code is too messy conceptually and in terms of code modularity to consider this. Possibly if the chapter split were done doing this might be easier.

What I eventually plan on doing is to add the graphics includes by hand before a release. I will also probably create a diff file so that if it has to happen again we can semi automate this. Hopefully though by the release after next we will have addressed this.

This currently doesn't work though
@rocky rocky marked this pull request as draft January 3, 2023 01:59
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.

1 participant