#6495: Build the reference manual incrementally
-----------------------------------------------+----------------------------
Reporter: mpatel | Owner: tba
Type: enhancement | Status: needs_work
Priority: major | Milestone: sage-5.0
Component: documentation | Resolution:
Keywords: | Work issues: intersphinx
Report Upstream: N/A | Reviewers: Volker Braun
Authors: Mitesh Patel, John Palmieri | Merged in:
Dependencies: #12016 | Stopgaps:
-----------------------------------------------+----------------------------
Changes (by jhpalmieri):
* cc: hivert (added)
* keywords: sd32 =>
* work_issues: => intersphinx
Comment:
Rebased to 5.0.beta13, but the intersphinx stuff needs fixing (the use of
intersphinx here conflicts with the changes in #9128, and I haven't fixed
this). Part 1 of the patch was mostly generated automatically using the
attached script. After running the script, I removed lines like `..
_ch:algebras:` (from algebras/index.rst, in this case) by hand.
Replying to [comment:45 jdemeyer]:
> Regarding #12016: you should simply use the value of `SAGE_NUM_THREADS`,
nothing fancier than that.
Okay, done.
> Regarding `spkg-dist`: this is essentially a duplicate of #12081 and
#12086, so this patch should be removed. In any case, removing the files
from `MANIFEST.in` is the proper way of dealing with this, as opposed to
removing the files before packaging the repository. Ideally, `sage-sdist`
should not change the current Sage source tree at all.
I removed that part of the patch.
> What's the rationale for adding all these files to
`doc/common/themes/sageref`?
The new structure of the reference manual, in particular the new directory
structure, means we need new templates for the files coming from
`reference/algebras/index.rst`, as opposed to the old templates, which
work for the main file `reference/index.rst`.
> Instead of always building twice, would it be possible to '''detect'''
whether the manual has already been built once. For example, if I want
both the HTML and PDF documentation, the current patch would do 4 passes,
even if 3 would be sufficient.
I don't know how to do this.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/6495#comment:47>
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.
