doc: Enable MathJax rendering for equations in MkDocs documentation #6703
+5
−0
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.




Solves #6610, Hi I am a new contributor to grass! Excited to contribute more...
This PR enables proper rendering of mathematical expressions in the GRASS MkDocs documentation.
Some manual pages such as
r.runoffcontain LaTeX formulas, but these were previously shown as raw$...$text. This update integrates MathJax and the required Markdown extension so that equations render correctly both inline and in block form.Testing
Its Output:

Notes from local build experience
While testing this change locally, I found it non-obvious how to build and preview the documentation.
At first, addon manual pages like
r.runoffwere missing, and changes inindex.mdhad no visible effect.Eventually I realized that MkDocs serves content from the generated directory:
and not directly from files under
man/.After updating the correct
mkdocs.ymland the generatedsource/index.mdinside thedistfolder, MathJax worked as expected.The final changes in this PR are applied to
man/mkdocs/mkdocs.yml