Make equation numbering a default option in mathjax [feature added]

[jdhao]

I agree and want to create new issue

• Yes, I was on Hexo Docs page, especially on Templates, Variables, Helpers and Troubleshooting.
• Yes, I was on NexT Documentation Site.
• And yes, I already searched for current issues and this is not help to me.

suggestions

Right now I am using hexo-renderer-pandoc to render latex equations in my post. But in order to support equation numbering, as is shown in this post, we need to change the mathjax.swig file under the theme next root directory (the path is layout\_third-party\math\mathjax.swig). We need to change

<script type="text/x-mathjax-config">
    MathJax.Hub.Config({
      tex2jax: {
        inlineMath: [ ['$','$'], ["\\(","\\)"]  ],
        processEscapes: true,
        skipTags: ['script', 'noscript', 'style', 'textarea', 'pre', 'code']
      }
    });
</script>

to

<script type="text/x-mathjax-config">
    MathJax.Hub.Config({
      tex2jax: {
        inlineMath: [ ['$','$'], ["\\(","\\)"]  ],
        processEscapes: true,
        skipTags: ['script', 'noscript', 'style', 'textarea', 'pre', 'code']
      },
      TeX: {equationNumbers: { autoNumber: "AMS" }}
    });
</script>

in order to support automatic equation numbering. I hope the following option may be added as a default option:

 TeX: {equationNumbers: { autoNumber: "AMS" }}

[ivan-nginx]

Before we can continue this topic, did u read Math Equations / CN version)?

[jdhao]

@ivan-nginx yep, I have read it. But it has nothing to do what I propose here.

[ivan-nginx]

Ok, can u give some examples here with *.md codes and screenshoots maybe? Where is the difference?

[jdhao]

Without the equation numbering option, we can not refer to equations easily in our post. For example, for the following equation,

$$\begin{equation}
e=mc^2
\end{equation}\label{eq1}$$

we can later easily refer to it. A sample markdown snippet may be:

the famous matter-energy equation $\eqref{eq1}$ is proposed by Einstein.

With that option, the equation will be numbered and correctly referred in the text in a concise way.

[ivan-nginx]

Oh, it's like variables, right? Can u give full *.md content to reproduce this?

[jdhao]

I have posted a full markdown file here. It is used to generate post here.

[ivan-nginx]

Ok, so, i get it after reproduce content in comment above:

1. As is for now from master branch:
   
2. With TeX: {equationNumbers: { autoNumber: "AMS" }} additions:
   

So, i think it can be added by default without any breaking changes in MathJax code.
@jdhao u can to do it with pull request, i think. Also, it would be great if u update Math docs in EN/CN languages.

[sli1989]

@jdhao Do you have time to do this PR?

[jdhao]

I do not have time now and may have time on Friday. Besides, I am not sure what exactly to be pull-requested.

[sli1989]

1. take your time , you can take this for reference if you want to.
2. remember to update the Math docs in EN/CN. add some instruction of how to use it.