Use pydata theme for docs (#163)

* Update requirements.txt

* Update conf.py

* moving things around

Author: dfm

docs/Makefile

@@ -19,7 +19,7 @@ TUTORIALS = tutorials/hyper.rst tutorials/model.rst tutorials/new-kernel.rst \
 			tutorials/first.rst tutorials/scaling.rst tutorials/mixture.rst  \
 			tutorials/bayesopt.rst
 
-tutorials/%.rst: _static/notebooks/%.ipynb tutorials/tutorial_rst.tpl
+tutorials/%.rst: _static/notebooks/%.ipynb
 	jupyter nbconvert --template tutorials/tutorial_rst --to rst $< --output-dir tutorials
 
 .PHONY: clean

docs/conf.py

@@ -44,8 +44,8 @@
 master_doc = "index"
 
 # General information about the project.
-project = u"George"
-copyright = u"2012-2021 Dan Foreman-Mackey"
+project = "george"
+copyright = "2012-2023 Dan Foreman-Mackey"
 
 version = george.__version__
 release = george.__version__
@@ -54,22 +54,17 @@
 pygments_style = "sphinx"
 
 # Readthedocs.
-on_rtd = os.environ.get("READTHEDOCS", None) == "True"
-if not on_rtd:
-    import sphinx_rtd_theme
-
-    html_theme = "sphinx_rtd_theme"
-    html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
-
+html_theme = "pydata_sphinx_theme"
+html_title = "george"
 htmp_theme_options = dict(
     analytics_id="analytics_id",
 )
-html_context = dict(
-    display_github=True,
-    github_user="dfm",
-    github_repo="george",
-    github_version="main",
-    conf_py_path="/docs/",
-)
+# html_context = dict(
+#     display_github=True,
+#     github_user="dfm",
+#     github_repo="george",
+#     github_version="main",
+#     conf_py_path="/docs/",
+# )
 html_static_path = ["_static"]
-html_show_sourcelink = False
+# html_show_sourcelink = False

docs/index.rst

@@ -30,26 +30,9 @@ George is being actively developed in `a public repository on GitHub
 
 .. toctree::
    :maxdepth: 2
-   :caption: User Guide
 
-   user/quickstart
-   user/kernels
-   user/gp
-   user/solvers
-   user/modeling
-
-
-.. toctree::
-   :maxdepth: 1
-   :caption: Tutorials
-
-   tutorials/first
-   tutorials/model
-   tutorials/hyper
-   tutorials/scaling
-   tutorials/new-kernel
-   tutorials/mixture
-   tutorials/bayesopt
+   user/index
+   tutorials/index
 
 
 Contributors
@@ -61,9 +44,9 @@ Contributors
 License & Attribution
 ---------------------
 
-Copyright 2012-2022 Daniel Foreman-Mackey and contributors.
+Copyright 2012-2023 Daniel Foreman-Mackey and contributors.
 
-George is being developed by `Dan Foreman-Mackey <http://dan.iel.fm>`_ in a
+George is being developed by `Dan Foreman-Mackey <https://dfm.io>`_ in a
 `public GitHub repository <https://github.com/dfm/george>`_.
 The source code is made available under the terms of the MIT license.
 

docs/requirements.txt

@@ -1 +1,2 @@
 pyyaml
+pydata-sphinx-theme

docs/tutorials/bayesopt.rst

@@ -1,6 +1,3 @@
-
-.. module:: george
-
 .. note:: This tutorial was generated from an IPython notebook that can be
           downloaded `here <../../_static/notebooks/bayesopt.ipynb>`_.
 

docs/tutorials/first.rst

@@ -1,6 +1,3 @@
-
-.. module:: george
-
 .. note:: This tutorial was generated from an IPython notebook that can be
           downloaded `here <../../_static/notebooks/first.ipynb>`_.
 

docs/tutorials/hyper.rst

@@ -1,6 +1,3 @@
-
-.. module:: george
-
 .. note:: This tutorial was generated from an IPython notebook that can be
           downloaded `here <../../_static/notebooks/hyper.ipynb>`_.
 

docs/tutorials/index.rst

@@ -0,0 +1,14 @@
+Tutorials
+=========
+
+.. toctree::
+   :maxdepth: 2
+
+   first
+   model
+   hyper
+   scaling
+   new-kernel
+   mixture
+   bayesopt
+

docs/tutorials/mixture.rst

@@ -1,6 +1,3 @@
-
-.. module:: george
-
 .. note:: This tutorial was generated from an IPython notebook that can be
           downloaded `here <../../_static/notebooks/mixture.ipynb>`_.
 

docs/tutorials/model.rst

@@ -1,6 +1,3 @@
-
-.. module:: george
-
 .. note:: This tutorial was generated from an IPython notebook that can be
           downloaded `here <../../_static/notebooks/model.ipynb>`_.