docs: convert Python API docs to Sphinx Material theme (#5617)

Author: cwhite911

.github/workflows/documentation.yml

@@ -160,7 +160,7 @@ jobs:
 
       - name: Build Sphinx documentation
         run: |
-          pip install sphinx sphinx-sitemap
+          pip install -r "grass/python/grass/docs/requirements.txt"
           cd grass
           make sphinxdoclib
           ARCH="$(grass --config arch)"

python/grass/docs/Makefile

@@ -60,14 +60,14 @@ libpythonclean:
 
 libpythonapidoc:
 	@echo "SPHINXBUILD: Using <$(SPHINXBUILD)>"
-	$(call run_grass,$(SPHINXAPIDOC) -T -f -o src/ ../imaging/)
-	$(call run_grass,$(SPHINXAPIDOC) -T -f -o src/ ../exceptions/)
-	$(call run_grass,$(SPHINXAPIDOC) -T -f -o src/ ../gunittest/ ../gunittest/multireport.py ../gunittest/multirunner.py ../gunittest/main.py)
-	$(call run_grass,$(SPHINXAPIDOC) -T -f -o src/ ../pydispatch/)
-	$(call run_grass,$(SPHINXAPIDOC) -T -f -o src/ ../pygrass/)
-	$(call run_grass,$(SPHINXAPIDOC) -T -f -o src/ ../script/)
-	$(call run_grass,$(SPHINXAPIDOC) -T -f -o src/ ../temporal/)
-	$(call run_grass,$(SPHINXAPIDOC) --module-first -T -f -o src/ ../../grass)
+	$(call run_grass,$(SPHINXAPIDOC) -T -f -t _templates/sphinx/apidoc/ -o src/ ../imaging/)
+	$(call run_grass,$(SPHINXAPIDOC) -T -f -t _templates/sphinx/apidoc/ -o src/ ../exceptions/)
+	$(call run_grass,$(SPHINXAPIDOC) -T -f -t _templates/sphinx/apidoc/ -o src/ ../gunittest/ ../gunittest/multireport.py ../gunittest/multirunner.py ../gunittest/main.py)
+	$(call run_grass,$(SPHINXAPIDOC) -T -f -t _templates/sphinx/apidoc/ -o src/ ../pydispatch/)
+	$(call run_grass,$(SPHINXAPIDOC) -T -f -t _templates/sphinx/apidoc/ -o src/ ../pygrass/)
+	$(call run_grass,$(SPHINXAPIDOC) -T -f -t _templates/sphinx/apidoc/ -o src/ ../script/)
+	$(call run_grass,$(SPHINXAPIDOC) -T -f -t _templates/sphinx/apidoc/ -o src/ ../temporal/)
+	$(call run_grass,$(SPHINXAPIDOC) --module-first -T -f -t _templates/sphinx/apidoc/ -o src/ ../../grass)
 
 libpythonhtml: checksphinx
 	@echo "SPHINXBUILD: Using <$(SPHINXBUILD)>"

python/grass/docs/README.md

@@ -0,0 +1,38 @@
+# GRASS Python Docs
+
+## Local Development
+
+### Prerequisites
+
+Install the following dependencies from the `requirements.txt` file: in
+`python/grass/docs` directory.
+
+* [sphinx (v8.1.3)](https://www.sphinx-doc.org/en/master/changes/8.1.html)
+* [sphinx-material (v0.0.36)](https://bashtage.github.io/sphinx-material/)
+* [sphinx-sitemap (v2.6.0)](https://sphinx-sitemap.readthedocs.io/en/latest/)
+
+```bash
+pip install -r python/grass/docs/requirements.txt
+```
+
+### Build the Documentation
+
+To build the documentation, run the following command in the `python/grass/docs`
+directory:
+
+```bash
+make sphinxdoclib
+```
+
+This will generate the documentation in the `dist` directory.
+
+### View the Documentation
+
+To view the documentation, open the `index.html` file in the
+`dist/docs/html/libpython`
+directory with a local web server.
+
+## CI/CD
+
+The documentation is built and deployed automatically using GitHub Actions.
+The workflow is triggered on every push to the `main` branch `.github/workflows/documentation.yml`.