#10118: upgrade sphinx to version 1.0.4
-------------------------------+--------------------------------------------
Reporter: mvngu | Owner: tbd
Type: enhancement | Status: needs_review
Priority: major | Milestone: sage-4.6.1
Component: packages | Keywords: sphinx spkg
Author: Minh Van Nguyen | Upstream: N/A
Reviewer: | Merged:
Work_issues: |
-------------------------------+--------------------------------------------
Comment(by mvngu):
Replying to [comment:12 jdemeyer]:
> If possible, I would like to see
> * See the resulting HTML of a Sphinx run without LaTeX.
See the URL
http://mvngu.googlecode.com/hg/10118-sphinx/en/index.html
[[BR]][[BR]]
> * The log file of running Sphinx without LaTeX.
See the log files:
1. [attachment:dochtml.log]
1. [attachment:docpdf.log]
[[BR]]
> Would it make sense for {{{make doc-html}}} to first test whether
{{{latex}}} is installed? If there is no {{{latex}}}, give an error and
don't build the documentation.
That would result in a user, whose system doesn't have LaTeX but can
compile Sage OK, without at least a way to build the vast majority of the
Sage standard documentation. Currently, on a system without LaTeX you
could still build the HTML version of the Sage documentation, but any
expressions typeset in LaTeX could not be rendered using LaTeX. This means
that the documentation does build, but you won't be able to see LaTeX math
expressions typeset beautifully; you can still read the corresponding
LaTeX typesetting, though. However, if you build the HTML version with
jsMath rendering of mathematical expressions, then you don't need LaTeX at
all. The only case where you really need LaTeX is when you build the PDF
version of the documentation.
So LaTeX is not necessary for building the Sage documentation. But if you
don't have LaTeX, there's very little reason why the documentation builder
should abort and refuse to build the HTML version of the documentation.
The resulting "broken" HTML built documentation is still very readable;
you just don't get beautifully typeset math expressions. And if you have
jsMath installed, build the documentation with jsMath.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/10118#comment:13>
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.
