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.