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?
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... (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_SRC
seems to be set to the wrong location. I think this is becauseSAGE_ROOT
is being set to/home/user/mamba/envs/sage
instead of.../site-packages/sage
, but I haven't been able to resolve this.- I'm running into an error in
sphinx.ext.doctest
wheredoctest.DocTestParser()
is raisingAttributeError: module 'doctest' has no attribute 'DocTestParser'
Could https://github.com/sagemath/sage_sample be a source of inspiration?
See https://github.com/sagemath/sage/issu...: I don't think this is supported, although it would be nice if it were.