docs: some sections + edit button etc

Author: gauteh

docs/Makefile

@@ -14,6 +14,14 @@ help:
 
 .PHONY: help Makefile
 
+clean:
+	rm -rf build
+	rm -rf source/generated
+	rm -rf source/gallery
+	rm -rf source/autoapi
+	rm -rf source/sg_execution_times.rst
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) clean
+
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile

docs/source/api.rst

@@ -13,17 +13,6 @@ Top-level API
     from_dataframe
     trajectory_dict_to_dataset (deprecated)
 
-.. Geometries
-.. ----------
-.. .. autosummary::
-..     :toctree: generated/
-
-..     geometry.decode_geometries
-..     geometry.encode_geometries
-..     geometry.shapely_to_cf
-..     geometry.cf_to_shapely
-..     geometry.GeometryNames
-
 .. currentmodule:: xarray
 
 .. DataArray

docs/source/conf.py

@@ -1,13 +1,15 @@
 import os, sys
 sys.path.insert(0, os.path.abspath('../..'))
 
+import trajan  # noqa
+
 import sphinx_autosummary_accessors
 # Configuration file for the Sphinx documentation builder.
 
 # -- Project information
 
 project = 'TrajAn'
-copyright = '2022-2023, G. Hope and K. F. Dagestad'
+copyright = '2022-2024, G. Hope and K. F. Dagestad'
 author = 'G. Hope and K. F. Dagestad'
 
 release = 'latest (git / main)'
@@ -70,6 +72,10 @@
     "doc_path": "docs",
 }
 
+html_theme_options = {
+    "use_edit_page_button": True,
+}
+
 autosummary_generate = True
 
 autodoc_typehints = "description"