On Wednesday, February 27, 2013 10:26:13 AM UTC-8, John H Palmieri wrote:
>
>
>
> On Wednesday, February 27, 2013 7:24:36 AM UTC-8, Travis Scrimshaw wrote:
>>
>> Hey everyone,
>>    While reviewing #14130, there was a multiline array* environment 
>> inside of a .. MATH::, and this ended up building just fine as html, but 
>> did not compile in pdf form. For example, suppose you have:
>>
>> .. MATH::
>>
>>     \begin{align*}
>>     f(x) & = x^2 - 2 \\
>>     g(x) & = \frac{f(x) - x^3}{x-3}
>>     \end{align*}
>>
>> This would build as a html doc, but would fail as a pdf doc. Is this a 
>> bug or is there a better way of doing things?
>>
>
> The problem is the "align" environment: it is not meant to be used in math 
> mode, but rather as a way to enter math mode instead of \[ \] delimiters 
> (or $$ $$ delimiters, etc.). Using the ".. math::" markup tells Sphinx that 
> the following code should be typeset in math mode, and then using 
> \begin{align} tells it to enter math mode again, and this naturally leads 
> to an error when you run pdflatex on it. You can look at the LaTeX source 
> code to check (in doc/output/latex/en/...); it will probably have an align 
> environment nested inside a gather environment.
>
> Using an environment like "aligned" is better, since aligned is meant to 
> be used within math mode.
>

I guess another option is as it's done in vertex_separation.pyx:

.. math::
    :nowrap:

    \begin{align*}
    ...
    \end{align*}

":nowrap:" tells Sphinx not to include math delimiters, so you're free to 
use align*, etc.

-- 
John


-- 
You received this message because you are subscribed to the Google Groups 
"sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to sage-devel+unsubscr...@googlegroups.com.
To post to this group, send email to sage-devel@googlegroups.com.
Visit this group at http://groups.google.com/group/sage-devel?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to