How to build docs for a distribution?

Skip to first unread message

Isuru Fernando

Jun 14, 2020, 12:36:30 AM6/14/20
I'm using "python build" to build the sage python library and install in conda.

How do I build the docs without going through the './sage' build process?


François Bissey

Jun 14, 2020, 12:46:24 AM6/14/20
First you need to bootstrap the documentation (or patch to remove documentation about installing sage).

Other than that I build the doc in a folder called docbuild

I deal with a few things that I still can’t figure out
Lots of garbage files from plotting, which would otherwise be caught in my installation.
rst files morph into rst.txt files for some reason, which means you cannot doctest them once installed.

then I copy in the right place after install. This is done by boiler plate portage
> --
> You received this message because you are subscribed to the Google Groups "sage-packaging" group.
> To unsubscribe from this group and stop receiving emails from it, send an email to
> To view this discussion on the web visit

Antonio Rojas

Jun 14, 2020, 3:47:35 AM6/14/20
to sage-packaging
Here is our (hopefully self-explanatory) build script (the main build step is line 53)

Timo Kaufmann

Jun 14, 2020, 7:12:43 AM6/14/20
to sage-packaging
Reply all
Reply to author
0 new messages