FIX + Doc / Build_readthedocs_documentation

Fixing readthedocs build for pycalibration documentation:

https://rtd.xfel.eu/projects/european-xfel-offline-calibration/builds/

https://rtd.xfel.eu/docs/european-xfel-offline-calibration/en/latest/

Description

This has only some small fixes for the readthedocs to go forward and build successfully.

All the documentation needs to be revised.

How Has This Been Tested?

Relevant Documents (optional)

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• Docs (changes to the documentation)

Checklist:

Reviewers

@roscar @danilevc @schmidtp

docs/source/conf.py

@@ -48,12 +48,6 @@ sys.path.append(os.path.abspath("../pycalibration/"))
 p = Popen(["./makeAllDocs.sh"])
 p.communicate()
 
-import mock
-autodoc_mock_imports = ['Cython']
-
-MOCK_MODULES = ['numpy', 'matplotlib', 'matplotlib.pyplot','Cython']
-for mod_name in MOCK_MODULES:
-    sys.modules[mod_name] = mock.Mock()
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
@@ -391,7 +385,6 @@ from nbconvert import RSTExporter
 from xfel_calibrate import notebooks
 
 rst_exporter = RSTExporter()
-
 with open("available_notebooks.rst", "w") as f:
     f.write(dedent("""
             .. _available_notebooks:
@@ -413,7 +406,8 @@ with open("available_notebooks.rst", "w") as f:
 
         for caltype in sorted(values.keys()):
             data = values[caltype]
-
+            if data.get("notebook", None) is None:
+                continue
             nbpath = os.path.abspath("{}/../../../{}".format(__file__, data["notebook"]))
             with open(nbpath, "r") as nf:
                 nb = nbformat.read(nf, as_version=4)
@@ -446,7 +440,7 @@ with open("available_notebooks.rst", "w") as f:
             f.write("\n\n")
 
 # add test results
-test_artefact_dir = os.path.realpath("../../tests/artefacts")
+test_artefact_dir = os.path.realpath("../../tests/legacy/artefacts")
 
 import shutil
 import textwrap
@@ -581,7 +575,6 @@ Contents:
 """
 if not os.path.exists("./test_rsts"):
     os.makedirs("./test_rsts")
-
 with open("test_results.rst", "w") as f:
     f.write(header)
     for commit, modtime in sorted_dir(test_artefact_dir):
@@ -615,6 +608,5 @@ with open("test_results.rst", "w") as f:
                     rst = xml_to_rst_report(xs, commit, reports=reports.get(rloc, []))
                     fr.write(rst)
             f.write("   test_rsts/{}\n".format(commit))
-
 def setup(app):
     app.add_stylesheet('css/test_decorators.css')