[SciPy-dev] [Docutils-users] Fwd: [sage-devel] numpy in SAGE, etc.
Jens Jørgen Mortensen
jensj at fysik.dtu.dk
Wed Dec 20 07:10:09 CST 2006
On Tue, 2006-12-19 at 15:34 -0500, David Huard wrote:
> If I understand correctly, I'd have to add the latex-math
> role to rst/roles.py and the latex-math directive to the
> rst/directives directory and register it in the __init__. However, the
> directives defined in Jens' sandbox are writer specific, so I'm a bit lost.
You will have to merge the code from rst2mathml.py and rst2latexmath.py.
I would start from the code in rst2mathml.py, where the node class
(latex_math) will have to be changed to something like this:
tagname = '#latex-math'
def __init__(self, rawsource, mathml_tree, latex):
self.mathml_tree = mathml_tree
self.latex = latex
Also the latex_math_role function and the latex_math_directive class
will have to be modified a bit to use the new node class.
And then the visit/depart methods should be added to the writers.
Hope that helps,
> A little bit of context:
> The SciPy and NumPy folks are looking at the
> various documentation systems out there to build the API documentation
> and tutorials. Up to now, the combination epydoc+reST seems to most
> powerful. However, Latex formulas are a must for those packages and the
> raw role is a bit low-level for our needs, hence the interest in
> including the latex-math role and directive in the trunk so that epydoc
> can run smoothly using it.
More information about the Scipy-dev