Fixing read the docs build (#138)

.readthedocs.yaml

@@ -22,6 +22,6 @@ formats:
 
 # We recommend specifying your dependencies to enable reproducible builds:
 # https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
-# python:
-#   install:
-#   - requirements: docs/requirements.txt
+python:
+   install:
+   - requirements: requirements.txt

docs/conf.py

@@ -73,7 +73,7 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = 'en'
 
 # There are two options for replacing |today|: either, you set today to some
 # non-false value, then it is used:
@@ -146,7 +146,7 @@
 # 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".
-html_static_path = ["_static"]
+# html_static_path = ["_static"]
 
 # Add any extra paths that contain custom files (such as robots.txt or
 # .htaccess) here, relative to this directory. These files are copied
@@ -293,4 +293,6 @@
 
 
 # Example configuration for intersphinx: refer to the Python standard library.
-intersphinx_mapping = {"https://docs.python.org/": None}
+intersphinx_mapping = {
+    'python': ('https://docs.python.org/3/', None),
+}

docs/modules/maps.rst

@@ -20,5 +20,7 @@ maps API
 ========
 
 .. py:module:: pygbif
+   :noindex:
 
 .. automethod:: maps.map
+

docs/modules/registry.rst

@@ -27,6 +27,7 @@ registry API
 ============
 
 .. py:module:: pygbif
+   :noindex:
 
 .. automethod:: registry.datasets
 .. automethod:: registry.dataset_metrics

docs/modules/species.rst

@@ -24,6 +24,7 @@ species API
 ===========
 
 .. py:module:: pygbif
+   :noindex:
 
 .. automethod:: species.name_backbone
 .. automethod:: species.name_suggest

requirements.txt

@@ -13,3 +13,4 @@ vcrpy==4.2.1
 pytest
 pytest-cov
 codecov
+sphinx_rtd_theme