[Docutils-users] Equation numbering in LaTeX writer

[Eduard B. <edu...@ae...>]

Hello,

I've been using docutils and reStructuredText to write a scientific
document. While I'm fairly happy with the results so far, I have some
trouble enumerating and referencing equations. It appears that docutils
supports this in principle, as the signature of
utils.math.pick_math_environment suggests. However, the LaTeX does not
make use of this feature, as far as I can see.

My current workaround is to change line 2529 of
writers/latex2e/__init__.py from

    math_env = pick_math_environment(node.astext())

to

    math_env = pick_math_environment(node.astext(), numbered=True)

This enables enumeration and allows me to label and reference my
equations using raw LaTeX. While this solves my practical issue, I think
it's not exactly an elegant solution. Is there a more straightforward
and perhaps target-independent way to achieve this?

Cheers,
Eduard.