sphinx-math-dollar
sphinx-math-dollar copied to clipboard
Restrict display math further?
See https://github.com/sympy/sphinx-math-dollar/pull/12. Display math is currently allowed everywhere inline math is. But that includes things like headers, where display math doesn't make any sense. Should we restrict it? My feeling is we should probably just let it work, as people won't likely do it anyway, but I don't feel strongly about it.
What are drawbacks of using math in headers? I am going to use it and care about reasons why I should not.
Now, links pointing to seactions with math symbols are not rendered right:
source:
.. _scalars:
######################
Calculation of Scalars
######################
.. contents:: :local:
*****************************
Update T,S and $\rho$ scalars
*****************************
Is this something that broke in the most recent 1.2 release?
If I understand correctly, your issue is that the rho is not blue in the link text? I just tested your example and it seems to render fine in both 1.1.1 and 1.2. Perhaps this is an issue with the CSS of the theme you are using.
As to the original question, this is specifically about restricting display math. Inline math should definitely be allowed in headers. But I don't know if it makes sense for display math (double dollars), whose support was just added in 1.2.