Sphinx extensions for working with LaTeX math
texext contains a couple of Sphinx extensions for working with LaTeX math.
math_dollar replaces math expressions between dollars in ReST with equivalent inline math.
Here is some math: $a = 2$
will be replaced by:
Here is some math: :math:`a = 2`
The extension makes some effort not to replace dollars that aren’t meant as math, but please check your output carefully, and submit an issue on the texext issue tracker if we have messed up.
To enable math_dollar, make sure that the texext package is on your Python path, and add textext.math_dollar to your list of extensions in the Sphinx conf.py. If you want math_dollar to process docstrings, you should add sphinx.ext.autodoc higher up your extensions list than math_dollar.
Users of sympy may want to generate LaTeX expressions dynamically in Sympy, and then render them in LaTeX in the built pages. You can do this with the mathcode directive:
.. mathcode:: import sympy a, b = sympy.symbols('a, b') a * 10 + 2 * b
The directive runs sympy.latex() on the return result of the final expression, and embeds it in a .. math:: directive, resulting in equivalent output to sphinx of:
.. math:: 10 a + 2 b
Context (namespace) is preserved by default, so you can use context in subsequent directives, e.g.:
.. mathcode:: a * 5 + 3 * b
If the last expression in the mathcode block is not an expression, the context gets updated, but the extension generates no math directive to the output. This allows you to have blocks that fill in calculations without rendering to the page. For example, this generates no output:
.. mathcode:: expr = a * 4
You can use the generated context in a later directive:
.. mathcode:: expr
To reset the context (namespace), use the newcontext option:
.. mathcode:: :newcontext: import sympy # again
If you would like mathcode to share a namespace with the matplotlib plot_directive, set the following in your conf.py:
# Config of mathcode directive mathcode_use_plot_ns = True
Remember that, by default, the plot_directive will clear the namespace context for each directive, so you may want to use the :context: option to the plot directive, most of the time.
To enable the mathcode directive, make sure that the texext package is on your Python path, and add textext.mathcode to your list of extensions in the Sphinx conf.py.
Released under the BSD two-clause license - see the file LICENSE in the source distribution.
travis-ci kindly tests the code automatically under Python versions 2.6 through 2.7, and 3.2 through 3.5.
The latest released version is at https://pypi.python.org/pypi/texext
Please put up issues on the texext issue tracker.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size texext-0.1.tar.gz (26.4 kB)||File type Source||Python version None||Upload date||Hashes View hashes|
|Filename, size texext-0.1.zip (31.2 kB)||File type Source||Python version None||Upload date||Hashes View hashes|