Hi,

On Wed, Nov 23, 2011 at 05:41:32AM -0800, kcrisman wrote:
> 
> 
> On Nov 23, 8:24 am, Jeroen Demeyer <jdeme...@cage.ugent.be> wrote:
> > On 2011-11-23 11:50, Florent Hivert wrote:
> >
> > > I'm also volunteering to
> > > add a section about that in the developer guide. What do you think ?
> 
> See 
> http://www.sagemath.org/doc/developer/sage_manuals.html#setting-hyperlink-to-modules-classes-methods-etc
> 
> > That would be very cool.  I have often thought about making "See Also"
> > links, but I never know how to do it.  Of course, the "see also" links
> > really should be hyperlinks.  Also, is it possible for example to put
> 
> Right!  See for instance 
> http://hg.sagemath.org/sage-main/file/9e29a3d84c48/sage/plot/plot.py#l1
> and anything with a tilde, basically, like
> 
> :func:`~sage.plot.arrow.arrow`
> 
> this is how such links are created, see
> 
> http://www.sagemath.org/doc/reference/sage/plot/plot.html
> 
> and clicking on 'arrow()' takes you to
> 
> http://www.sagemath.org/doc/reference/sage/plot/arrow.html#sage.plot.arrow.arrow
> 
> There are similar structures for modules, I think.
> 
> > links to the developer/installation guide?

> Hmm, since those are basically separately generated, that might not be
> possible.  Experts in the doc build, any ideas?

Yes it is perfectly feasible using intersphinx (though this may force multiple
compilation a la LaTeX).

Actually to ease linking, I wrote

  "Ticket #9128 Sphinx should be aware of all.py to find its links" 

but I think it has certainly bit-rotted now. It allows to link any document
(in particular tutorial and construction) to the reference manual. I'll plan
to update it for the new sphinx version now that it is in Sage.

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

Reply via email to