Ограничения разметки латекса Sphinx

вы должны отредактировать стандартный файл конфигурации, что sphinx-quickstart создает, иначе Сфинкс будет блевать на математические блоки. В файле conf.py, Я изменил

extensions = []

to

extensions = ['sphinx.ext.pngmath']

после этого более или менее работал следующий первый файл;

.. foo documentation master file, created by
   sphinx-quickstart on Thu Oct 25 11:04:31 2012.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Welcome to foo's documentation!
===============================

Contents:

.. toctree::
   :maxdepth: 2

This is the first chapter
=========================

Instead, I am doing multi-line stuff, often like eqnarray in LaTeX:

.. math::
    DividendYield &=& \frac{DVT(t)}{CurrentMarketCap} \
    Avg_Assets &=& \biggl( A/B \biggr) \textrm { when B is not zero...}

он произвел следующий латексный код для математического фрагмента:

\chapter{This is the first chapter}
\label{index:welcome-to-foo-s-documentation}\label{index:this-is-the-first-chapter}
Instead, I am doing multi-line stuff, often like eqnarray in LaTeX:
\begin{gather}
\begin{split}DividendYield &=& \frac{DVT(t)}{CurrentMarketCap} \
Avg_Assets &=& \biggl( A/B \biggr) \textrm { when B is not zero...}\end{split}\notag\\begin{split}\end{split}\notag
\end{gather}

выбор использования комбинации split и gather кажется мне немного странным и, очевидно, не делает хорошо работайте с кодом, который вы написали для eqnarray, но это жестко закодировано в Sphinx.

запуск pdflatex остановился на \end{gather}, с ошибкой Extra alignment tab has been changed to \cr. но я смог пройти мимо этого, введя nonstopmode. Это дает мне следующий результат:

в то время как все еще что-то не так с выравниванием (из-за различий между split и eqnarray среды), textrm и biggl, похоже, работают нормально. (Обратите внимание, что вы еще нужно избежать подчеркивания в Average_Assets, но это нормально для курса, AFAICT).

вы может сойдет с рук постобработка сгенерированного кода LaTeX, например, путем замены \begin{gather}\begin{split} и \end{split}\notag\\begin{split}\end{split}\notag\end{gather} по математической среде по вашему выбору.

обновление:

скриншот из обновления, похоже, с веб-страницы, а не документа LaTeX! Поэтому мне кажется, что то, что вызывает ошибку, - это обработчик, который преобразует латексную математическую нотацию, чтобы браузер мог показать что-то. Это, вероятно, будет либо MathJax или jsMath. Глядя на код, pngmath будет создавать другие сообщения об ошибках. Согласно на этой странице ваш код должны работа в mathjax. От страница символов jsMath, не похоже, что jsmath поддерживает \Biggl. Поэтому я предполагаю, что Сфинкс настроен на использование jsMath. Взгляд на источник сгенерированной сети страница должна рассказать вам, что используется для визуализации математики. Если моя догадка верна, переключение конфигурации на использование mathjax и небольшая адаптация вашего уравнения могут решить проблему.

обновление 2: я могу определенно подтвердить, что он отлично работает с MathJax (см. ниже). Однако у меня нет установленного jsMath.