I am attempting to use docbuild to build Sage-style documentation for a package that is external to Sage. I haven't been able to find information on how to set up and run the docbuild pipeline and am running into several errors. Is there any information available on how to configure docbuild for external packages?
Revision history [back]
 | 1 | initial version |
Using docbuild on an external package
Using docbuild on an external package
I am attempting to use docbuild to build Sage-style documentation for a package that is external to Sage. I haven't been able to find information on how to set up and run the docbuild pipeline and am running into several errors. Is there any information available on how to configure docbuild for external packages? packages?
I'm running the command as sage --docbuild file=/path/to/file html. I was running into a missing theme, but downloading this directory: https://github.com/sagemath/sage/tree/develop/src/doc/common (which was missing from my mamba installation of Sage) and running the command from with the .../site-packages/sage directory seems have to solved that.
A few errors I'm still running into:
SAGE_DOC_SRCseems to be set to the wrong location. I think this is becauseSAGE_ROOTis being set to/home/user/mamba/envs/sageinstead of.../site-packages/sage, but I haven't been able to resolve this.- I'm running into an error in
sphinx.ext.doctestwheredoctest.DocTestParser()is raisingAttributeError: module 'doctest' has no attribute 'DocTestParser'
