feat: use same theme as pystac

That's pydata-sphinx-theme for those keeping score at home.

.readthedocs.environment.yml

@@ -16,11 +16,11 @@ dependencies:
       - lxml-stubs
       - mypy
       - nbsphinx
+      - pydata-sphinx-theme
       - pylint
       - sphinx
       - sphinx-autobuild
       - sphinx-click
-      - sphinxcontrib-fulltoc
       - sphinxcontrib-napoleon
       - types-certifi
       - types-orjson

docs/conf.py

@@ -45,7 +45,6 @@
     "sphinx.ext.viewcode",
     "sphinx.ext.githubpages",
     "sphinx.ext.extlinks",
-    "sphinxcontrib.fulltoc",
     "sphinx_click",
     "nbsphinx",
 ]
@@ -84,21 +83,30 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = "alabaster"
+html_theme = "pydata_sphinx_theme"
+html_logo = "_static/stactools.png"
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
 #
 html_theme_options = {
-    "show_powered_by": False,
-    "github_user": "stac-utils",
-    "github_repo": "stactools",
-    "github_banner": True,
-    "show_related": False,
-    "note_bg": "#FFF59C",
+    "icon_links": [
+        {
+            "name": "GitHub",
+            "url": "https://github.com/stac-utils/stactools",
+            "icon": "fab fa-github-square",
+            "type": "fontawesome",
+        }
+    ],
+    "external_links": [
+        {"name": "STAC spec", "url": "https://stacspec.org/"},
+        {"name": "PySTAC", "url": "https://pystac.readthedocs.io/en/stable/"},
+    ],
+    "show_nav_level": 3,
 }
 
+
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
@@ -112,7 +120,14 @@
 # default: ``['localtoc.html', 'relations.html', 'sourcelink.html',
 # 'searchbox.html']``.
 #
-# html_sidebars = {}
+html_sidebars = {
+    "**": [
+        "search-field.html",
+        "globaltoc.html",
+        "sourcelink.html",
+    ],
+}
+
 
 # -- Options for HTMLHelp output ---------------------------------------------
 

requirements-dev.txt

@@ -9,13 +9,13 @@ mypy
 nbsphinx
 packaging
 pre-commit
+pydata-sphinx-theme
 pylint
 pytest
 pytest-cov
 sphinx
 sphinx-autobuild
 sphinx-click
-sphinxcontrib-fulltoc
 sphinxcontrib-napoleon
 types-certifi
 types-orjson