#6495: Build the reference manual incrementally
---------------------------------------------------------------+------------
Reporter: mpatel | Owner:
tba
Type: enhancement | Status:
needs_review
Priority: major | Milestone:
sage-pending
Component: documentation | Resolution:
Keywords: days38 | Work issues:
Report Upstream: N/A | Reviewers:
Volker Braun
Authors: Mitesh Patel, John Palmieri, Florent Hivert | Merged in:
Dependencies: #13143 | Stopgaps:
---------------------------------------------------------------+------------
Comment (by hivert):
> > > He asked if the page url are kept or not. The answer is that they
moved:
> > Hmm, I was dimly aware of this but didn't think it through. That will
break a loooot of links (e.g., on ask.sagemath.org). Is there any way to
auto-generate forwarding or 'mirrors' from the old pages?
>
> there are several options:
>
> 1. use {{{.htaccess}}} thing to fix this on any particular website;
>
> 2. write a script to look through all {{{href}}} targets in each file
with changed location, and create for it a file with forwards;
>
> 3. maybe sphinx can help in this business, I don't know.
I don't thinks it does. On the contrary, it makes it a nightmare (at least
to me). Sphinx made the assumption that creating a new document needs
creating a new directory (storing html, markup, indexes...). Since we
splitting the reference manual in different documents we had to move files
around.
Mike Hansen was considering implementing something which is close to
option 2, because it it seems that option 1 is not easily doable (whereas
I'm starting to now more than a little about Sphinx, I shamefully
admitting that I don't know how to write/configure a website).
Florent
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/6495#comment:153>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--
You received this message because you are subscribed to the Google Groups
"sage-trac" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/sage-trac?hl=en.
