Hi there,
I'm working on a few ticket to improve the handling of the doc:
#11251 Add todo extension to Sphinx
#9128 Sphinx should be aware of all.py to find its links
#11263 Markup ".. link" is wrong in the developer guide.
In order to do it I have to change Sphinx configuration in
$SAGE_ROOT/devel/sage/doc/common/conf.py
However I've just discovered that when we generated the help doc using "?"
either in command or in the notebook, we use sphinx through a function
sphinxify in
$SAGE_ROOT/devel/sagenb/sagenb/misc/sphinxify.py
This file contains inline a far from begin up to date copy of the conf.py:
conf = r'''
###########################################################
# Taken from `$SAGE_ROOT$/devel/sage/doc/common/conf.py` #
###########################################################
[...]
# General information about the project.
project = u""
copyright = u'2005--2009, The Sage Development Team'
[...]
'''
Is there a reason for having two different files ? Why not fetching the copy
from sage itself ?
Cheers,
Florent
--
To post to this group, send an email to sage-devel@googlegroups.com
To unsubscribe from this group, send an email to
sage-devel+unsubscr...@googlegroups.com
For more options, visit this group at http://groups.google.com/group/sage-devel
URL: http://www.sagemath.org
