improve docs by writing chemical species upright

[Mo-Gul]

Currently

ChemEquations.jl/docs/src/index.md

Lines 7 to 9 in 393e520

	```math
	CH_4 + O_2 \to CO_2 + H_2 O
	```

is rendered as

on https://zlatanvasovic.github.io/ChemEquations.jl/dev/.

But as you for sure know, chemical species should be written in an upright font. I think it should be possible to achieve that with the mhchem extensions of MathJax and KaTeX, depending on which renderer you are using. Please have a look at

https://mhchem.github.io/MathJax-mhchem/

[zlatanvasovic]

You're absolutely right, I'll check your proposal. If you manage to make a working solution, you're always welcome to submit a PR here. 😄

[Mo-Gul]

I'd love to provide a PR, but unfortunately I am an absolute newbie to Julia and thus have no clue how I would get the resulting HTML output from Documenter.jl. Said that I can't test if a proposal works ...

[longemen3000]

the text encased in math quotes is valid latex. you could write straight text by using \text{Text} or \textrm{Text}. for example:

 \text{CH}_4 + \text{O}_2 \to \text{CO}_2 + \text{H}_2 \text{O} 

renders as:

[ProfLeao]

Has anything been done in this direction? If not, I can try to do something.

[Mo-Gul]

Nope, the equation is still rendered as "pure math". Of course the trivial fix would be to apply longmen's solution (assuming it works). Would you be willing to have a look at mhchem or what is your plan?

[ProfLeao]

I plan to enable MathJax3 as the default math engine and then use mhchem. I believe this will provide a greater number of possibilities for writing chemical equations in the documentation.

[Mo-Gul]

That sounds great to me, but let's hope that @zlatanvasovic is still active and will approve your PR.
I keep my fingers crossed ...

[ProfLeao]

I've written him a few emails. In his own time he will.

But this is a little more complicated, the intervention in the documentation is a bit deeper. The language has changed a lot since the package was last updated.

Take the expected behavior of the equationmatrix method for example, it's not like that anymore.

jldoctest
julia> equationmatrix(ce"H2 + Cl2 → HCl")
2×3 Array{Int64,2}:
 2  0  1
 0  2  1

I'm currently tracking this kind of update, otherwise the build won't work.

[ProfLeao]

PR #11 to see the proposed updates.

[ProfLeao]

#11 (comment)