docs: mkdocs edit and view on github

[cwhite911]

This PR is a replacement for PR #5104 addressing Issue #5103.

This pull request includes several changes to the man/Makefile and related files to enhance the documentation build process and add new features for editing and viewing on GitHub. The most important changes include adding new scripts and hooks, updating the mkdocs.yml configuration, and modifying HTML templates for custom actions.

Enhancements to the documentation build process:

• man/Makefile: Added new entries for gh-paths.yml and hook_list_scripts.py, and created a target to list Markdown file contents. [1] [2]

Configuration updates:

• man/mkdocs/mkdocs.yml: Added repository information, new hooks, and updated the theme to include content actions for editing and viewing on GitHub. [1] [2]

Template modifications:

• man/mkdocs/overrides/partials/actions.html: Added a custom actions template to handle different tool categories and generate custom edit URLs.

New script:

• man/mkdocs/scripts/hook_list_scripts.py: Introduced a new script to read and store tool names from gh-paths.yml into the Mkdocs extra configuration directly into GitHub to view and edit documentation sources.

Know Issue

• Tools that don't follow the <tool_directory>/<tool_name>/<prefix>.<tool_name>.md convention (raster/r.watershed/r.watershed.md) or are not in /scripts/**/*.md do not work.

[cwhite911]

• man/Makefile: Added new entries for gh-paths.yml and hook_list_scripts.py, and created a target to list Markdown file contents. [1] [2]

I chose a different approach to get the tool paths by extracting their github url from the generated md files in docs/mkdocs/source using the mkdocs on_config hook and setting the path for the page edit buttons with a custom jinga function. At this point I've have most edge cases sorted out, but I am still working on the gui section and identifying any other unknown unknowns, so any input would be helpful.

I know we could just add our own edit on github button at the bottom of the page like we are currently doing to add the Source Code section..

Available at: r.volume source code (history)
Edit Docs: r.volume docs edit
Latest change: Thursday Feb 13 11:55:34 2025 in commit: ffc0b8c

But I'm trying to embrace the material mkdocs ecosystem by doing it the way it's design.

[cwhite911]

@landam do you know a better way to do this?

[cwhite911]

This is ready for review.

[petrasovaa]

Works great!