Daily - December 12, 2024 - Links and notes

Daily Shaarli

All links of one day in a single page.

December 12, 2024

Amazing work by prof. McPherson: siunitx v3 for MathJax v3

This solves a major shortcoming when authoring documents in Quarto or R Markdown that generate both PDF and HTML output. MathJax lets the author use LaTeX commands in the source that translate into proper output in the HTML, but before this work there was no support for siunitx v3. This work can be said to take over where burnpanck/MathJax-siunitx left off.

To use it, I copied siunitx.js from its repo to my Quarto project and then made Quarto add it to the published site by setting resources: [ "path/to/siunitx.js" ] in the project dict. I also added the following to the top-level YAML:

format:
  html:
    html-math-method:
      method: mathjax
      url: "https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml.js"
    include-in-header:
      text: |
        <script>
        window.MathJax = {
          loader: {
            load: ['[custom]/siunitx.js', '[tex]/html'],
            paths: { custom: './path/to/' }
          },
          tex: {
            packages: { '[+]': ['siunitx', 'html'] },
            siunitx: {
              'per-mode': 'power'
            }
          }
        };
        </script>

And that should give you siunitx v3 commands in Quarto :-)
Of course unless you put the siunitx macros inside dollar signs they will simply be ignored by pandoc in the HTML output, but that's a small price to pay for maintaining a single source that produces both PDF and HTML while still letting you use almost all siunitx macros.

siunitx MathJax LaTeX quarto pandoc