Merge pull request earthobservations#173 from earthobservations/fix-d…

…ocs-dependencies

Fix docs dependencies

.readthedocs.yml

@@ -19,4 +19,5 @@ python:
   install:
     - method: pip
       path: .
-    - requirements: docs/requirements.txt
+      extra_requirements:
+        - docs

docs/conf.py

@@ -16,6 +16,8 @@
 import os
 import sys
 import tomlkit
+import sphinx_material
+
 sys.path.insert(0, os.path.abspath('..'))
 
 
@@ -51,13 +53,12 @@ def _get_project_meta():
 # ones.
 extensions = [
     "sphinx.ext.autodoc",
-    "sphinx_autodoc_typehints",
     "sphinx.ext.napoleon",
     "sphinx.ext.todo",
     "sphinx.ext.autosectionlabel",
-    "sphinx_rtd_theme",
-    "sphinxcontrib.rsvgconverter",
     "sphinx.ext.imgconverter",
+    "sphinxcontrib.rsvgconverter",
+    "sphinx_autodoc_typehints",
     #"matplotlib.sphinxext.only_directives",
     "matplotlib.sphinxext.plot_directive",
     "IPython.sphinxext.ipython_directive",
@@ -78,7 +79,7 @@ def _get_project_meta():
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = "sphinx_rtd_theme"
+# html_theme = "sphinx_rtd_theme"
 
 # 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,
@@ -97,20 +98,19 @@ def _get_project_meta():
 # This value contains a list of modules to be mocked up. This is useful when
 # some external dependencies are not met at build time and break the building process.
 # https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html#confval-autodoc_mock_imports
-autodoc_mock_imports = [
-    "pandas",
-    "numpy",
-    "scipy",
-    "dateutil",
-    "dateparser",
-]
+# autodoc_mock_imports = [
+#     "pandas",
+#     "numpy",
+#     "scipy",
+#     "dateutil",
+#     "dateparser",
+# ]
 
 # Use docstring from both class-level and __init__ when documenting a class.
 autoclass_content = "both"
 
 
 # -- Material options -------------------------------------------
-import sphinx_material
 
 html_show_sourcelink = True
 html_sidebars = {

docs/pages/tutorial.rst

@@ -8,15 +8,15 @@ Prerequisites
 =============
 Import modules necessary for general functioning.
 
-.. ipython::
+.. ipython:: python
 
-    In [1]: import warnings
-       ...: warnings.filterwarnings("ignore")
-       ...: import wetterdienst
-       ...: from wetterdienst import PeriodType, TimeResolution, Parameter
-       ...: import matplotlib as mpl
-       ...: import matplotlib.pyplot as plt
-       ...: from matplotlib import cm
+    import warnings
+    warnings.filterwarnings("ignore")
+    import wetterdienst
+    from wetterdienst import PeriodType, TimeResolution, Parameter
+    import matplotlib as mpl
+    import matplotlib.pyplot as plt
+    from matplotlib import cm
 
 
 ========
@@ -28,32 +28,31 @@ Which parameters are available?
 
 All available combinations
 ==========================
-.. ipython::
+.. ipython:: python
 
-    In [2]: print(wetterdienst.discover_climate_observations())
+    print(wetterdienst.discover_climate_observations())
 
 
 Daily historical data
 =====================
-.. ipython::
+.. ipython:: python
 
-    In [3]: print("Selection of daily historical data")
-       ...: print(
-       ...:     wetterdienst.discover_climate_observations(
-       ...:         time_resolution=TimeResolution.DAILY,
-       ...:         period_type=PeriodType.HISTORICAL
-       ...:     )
-       ...: )
+    # Selection of daily historical data
+    print(
+        wetterdienst.discover_climate_observations(
+            time_resolution=TimeResolution.DAILY,
+            period_type=PeriodType.HISTORICAL
+        )
+    )
 
 
 ================
 Get station list
 ================
+.. ipython:: python
 
-.. ipython::
-
-    In [1]: metadata_hdp = wetterdienst.metadata_for_climate_observations(
-       ...:     Parameter.PRECIPITATION_MORE, TimeResolution.DAILY, PeriodType.HISTORICAL)
-       ...: print("Number of stations with available data: ", metadata_hdp["HAS_FILE"].sum())
-       ...: print("Some of the stations:")
-       ...: metadata_hdp.head()
+    metadata_hdp = wetterdienst.metadata_for_climate_observations(
+        Parameter.PRECIPITATION_MORE, TimeResolution.DAILY, PeriodType.HISTORICAL)
+    print("Number of stations with available data: ", metadata_hdp["HAS_FILE"].sum())
+    print("Some of the stations:")
+    metadata_hdp.head()