Updating the documentation sphinx environment

docs/_static/astroquery.css

@@ -0,0 +1,9 @@
+
+.sd-card .sd-card-img-top {
+  height: 52px;
+  width: 52px;
+  margin-left: auto;
+  margin-right: auto;
+  margin-top: 10px;
+}
+

docs/conf.py

@@ -31,7 +31,7 @@
 
 # Load all of the global Astropy configuration
 try:
-    from sphinx_astropy.conf.v1 import *  # noqa
+    from sphinx_astropy.conf.v2 import *  # noqa
 except ImportError:
     print('ERROR: the documentation requires the sphinx-astropy package to '
           'be installed')
@@ -72,6 +72,10 @@
     'pyvo': ('https://pyvo.readthedocs.io/en/stable', None),
 })
 
+extensions += [
+    "sphinx_design",
+]
+
 # -- Project information ------------------------------------------------------
 
 # This does not *have* to match the package name, but typically does
@@ -102,11 +106,26 @@
 # variables set in the global configuration. The variables set in the
 # global configuration are listed below, commented out.
 
-html_theme_options = {
-    'logotext1': 'astro',  # white,  semi-bold
-    'logotext2': 'query',  # orange, light
-    'logotext3': ':docs',   # white,  light
-}
+
+
+html_theme_options.update(
+    {
+        "logo": {
+            "image_light": "_static/astroquery_banner.png",
+            "image_dark": "_static/astroquery_banner.png",
+        },
+        # https://github.com/pydata/pydata-sphinx-theme/issues/1492
+        "navigation_with_keys": False,
+        "navbar_align": "right"
+    }
+)
+
+
+
+html_favicon = "_static/astroquery_logo.ico"
+html_static_path = ["_static"]
+html_css_files = ["astroquery.css"]
+html_copy_source = False
 
 # Add any paths that contain custom themes here, relative to this directory.
 # To use a different custom theme, add the directory containing the theme.
@@ -175,9 +194,9 @@ def __getattr__(cls, name):
             return Mock()
 
 
-MOCK_MODULES = ['atpy', 'beautifulsoup4', 'vo', 'lxml', 'keyring', 'bs4']
-for mod_name in MOCK_MODULES:
-    sys.modules[mod_name] = Mock()
+#MOCK_MODULES = ['atpy', 'beautifulsoup4', 'vo', 'lxml', 'keyring', 'bs4']
+#for mod_name in MOCK_MODULES:
+#    sys.modules[mod_name] = Mock()
 
 # -- Options for the edit_on_github extension ----------------------------------------
 #

docs/developer.rst

@@ -0,0 +1,38 @@
+Developer documentation
+-----------------------
+
+The modules and their maintainers are listed on the
+`Maintainers <https://github.com/astropy/astroquery/wiki/Maintainers>`_
+wiki page.
+
+
+The :doc:`api` is intended to be kept as consistent as possible, such
+that any web service can be used with a minimal learning curve imposed on the
+user.
+
+.. toctree::
+   :maxdepth: 1
+
+   api.rst
+   template.rst
+   testing.rst
+
+The following Astroquery modules are mostly meant for internal use of
+services in Astroquery, you can use them for your scripts, but we don't guarantee API stability.
+
+.. toctree::
+  :maxdepth: 1
+
+  utils.rst
+  query.rst
+  utils/tap.rst
+
+To debug astroquery, logging level can be configured with the following:
+
+.. doctest-skip::
+
+    >>> from astroquery import log
+    >>> log.setLevel(level)
+
+If ``level`` is set to ``"DEBUG"``, then HTTP requests are logged.
+If ``level`` is set to ``"TRACE"``, then HTTP requests and responses are logged.

docs/genindex.rst

@@ -0,0 +1,4 @@
+.. This file is a placeholder and will be replaced
+
+Index
+#####