Hi,
Sorry for replying to myself.
> I'd like to have some crossref back and forth from sage source __doc__ to some
> rst file under doc/en/... and as well to some html files provided by some
> spkg. This raise two different but related questions:
>
> 1 - It seems that Sphinx build environment when building the reference manual
> and construction for example are unrelated. I can't manage to have link
> working back and forth. For example, I can't manage to have the link
> :mod:`sage.combinat.permutation` to work in constructions/groups.rst or to
> have :ref:`_chapter-groups` to work from sage/combinat/permutations.py
>
> 2 - Suppose that we want to provide an spkg with some included html doc, say
> some python doc in html. So the doc would be stored somewhere under $SAGE_ROOT
> say starting from $SAGE_ROOT/local/doc/python/index.html what would be the
> good way to link it from within sage doc (both .py and .rst files) ?
Thanks to Leif on trac I add the idea to search for intersphinx in sage. It is
commented out in doc/common/conf.py:
# Add any Sphinx extension module names here, as strings. They can be extensions
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
extensions = ['sage_autodoc', 'sphinx.ext.graphviz',
'sphinx.ext.inheritance_diagram']
#, 'sphinx.ext.intersphinx', 'sphinx.ext.extlinks']
Is there any reason (eg: speed) for that ? What about putting it back ?
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
