gdal icon indicating copy to clipboard operation
gdal copied to clipboard

Include math images in offline HTML manual

Open jidanni opened this issue 1 year ago • 1 comments

Feature description

For the offline documents (#10077) to truly work offline, the math equations need to be rendered e.g., on https://gdal.org/tutorials/gdal_grid_tut.html#gdal-grid-tutorial beforehand and included in the .zip . It shouldn't make the .zip much bigger. Else the user will just see the raw math markup, and in their browser console error messages connecting to cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js (because the user is offline.)

jidanni avatar May 31 '24 00:05 jidanni

Related Sphinx doc:

  • https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_math_renderer
  • https://www.sphinx-doc.org/en/master/usage/extensions/math.html

If we were to tackle this, we could either switch to sphinx.ext.imgmath (but maybe lose in functionality as there are accessibly functionnality built in mathjax), or stay with the default mathjax rendered, but have a local copy of the javascript code

rouault avatar May 31 '24 01:05 rouault