Defining LaTeX commands in a single location for use throughout the docs

[juliohm]

As discussed on gitter, currently we have to retype \newcommand on every markdown file to get a notation that is consistent across documentation pages.

It would be interesting to have a single place where one can define all the LaTeX syntax in the docs.

[juliohm]

Any update on this issue with the latest Documenter.jl? :)

[fredrikekre]

No but it is trivial to implement if you want to.
Edit: Maybe this is not for latex output?

[juliohm]

Do we have support for this in the new Documenter.jl?

[mortenpi]

Yes, we actually do. You can configure KaTeX & MathJax in make.jl now (#1097). So for MathJax it should look something like this:

makedocs(...,
    format = Documenter.HTML(...,
        mathengine = MathJax(Dict(
            :TeX => Dict(
                :equationNumbers => Dict(:autoNumber => "AMS"),
                # Custom Tex commands:
                :Macros => Dict(
                    :defd => "≝",
                    :ket => ["|#1\\rangle", 1],
                    :bra => ["\\langle#1|", 1],
                )
            )
        ))
    )
)

I'll downgrade this to a documentation issue.

[juliohm]

Nice to have this feature 👍

[wsshin]

                :Macros => Dict(
                    :defd => "≝",
                    :ket => ["|#1\\rangle", 1],
                    :bra => ["\\langle#1|", 1],

It seems that defining new LaTeX commands like this works only for MathJax. Is there an equivalent for KaTeX?

[mortenpi]

@wsshin Yes, it should be possible, although I do not have a snippet on hand. But you can pass a configuration dict to KaTeX() too, and KaTeX accepts a macros option. Might be a little bit of trial and error to get it working exactly right, but you can double check the generated JS in build/assets/documenter.js.