On Wednesday, March 10, 2021 at 4:50:41 AM UTC-6 Dima wrote:

> numpy does this:
> https://numpy.org/devdocs/docs/howto_build_docs.html
>
> you can only build numpy docs after numpy is installed.
>

Of course, with numpy "installed" doesn't necessarily mean installed in the 
main site-packages, you can use a virtualenv.  Then you delete the 
virtualenv once the docs are built and install the module and the docs for 
real.  It's hard to avoid something like this if using Sphinx's autodoc 
features that actually import the Python module and build the docs from the 
docstrings it finds.

Sage is likely too complicated for this to work, but you can skip the 
virtualenv step by having Sphinx work off the copy of the in 
"build/lib.macosx-10.9-x86_64-3.9" or similar.  This is the trick we use 
with 
SnapPy:  https://github.com/3-manifolds/SnapPy/blob/master/doc_src/conf.py

Nathan

-- 
You received this message because you are subscribed to the Google Groups 
"sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-devel+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/sage-devel/bef870a4-de6d-4f17-a761-227b3902a92dn%40googlegroups.com.

Reply via email to