OSGeo / gdal

GDAL is an open source MIT licensed translator library for raster and vector geospatial data formats.
https://gdal.org
Other
4.91k stars 2.56k forks source link

Include math images in offline HTML manual #10081

Open jidanni opened 5 months ago

jidanni commented 5 months ago

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.)

rouault commented 5 months ago

Related Sphinx doc:

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