DOC: enable local sphinx builds

.gitignore

@@ -414,3 +414,4 @@ TSWLatexianTemp*
 
 # exclude notebooks directory: this is generated during build
 /notebooks/
+/sphinx/base/

sphinx/.gitignore

@@ -0,0 +1,3 @@
+base
+source/_generated
+source/apidoc

sphinx/make.py

@@ -1,30 +1,24 @@
 #!/usr/bin/env python3
 """
-Make sphinx documentation using the makefile in pytools
+Make sphinx documentation using the pytools make utility
 """
-
 import os
-import sys
+from urllib import request
 
+BRANCH = "2.0.x"
 
-def make() -> None:
-    """
-    Run the common make file available in the pytools repo
-    """
-    cwd = os.path.dirname(os.path.realpath(__file__))
-    os.chdir(cwd)
 
-    sys.path.insert(
-        0,
-        os.path.normpath(
-            os.path.join(cwd, os.pardir, os.pardir, "pytools", "sphinx", "base")
-        ),
-    )
-    # noinspection PyUnresolvedReferences
-    from make_base import make
+if __name__ == "__main__":
 
-    make(modules=["pytools", "sklearndf", "facet"])
+    # noinspection PyUnusedLocal
+    def run_make(branch: str, working_directory: str) -> None:
+        """Stub, overwritten by bootstrap.py"""
 
+    # run the common make file available in the pytools repo
+    with request.urlopen(
+        f"https://raw.githubusercontent.com/BCG-Gamma/pytools/{BRANCH}"
+        f"/sphinx/base/bootstrap.py"
+    ) as response:
+        exec(response.read().decode("utf-8"), globals())
 
-if __name__ == "__main__":
-    make()
+    run_make(branch=BRANCH, working_directory=os.path.dirname(__file__))

sphinx/source/_templates/api_landing.rst → sphinx/source/api_landing.rst

@@ -1,7 +1,7 @@
 The figure below provides a high level overview of the workflow when using FACET, and
 for each step in the workflow, a brief description.
 
-.. image:: ../_static/Facet_flow.svg
+.. image:: _static/Facet_flow.svg
    :width: 550
 
 Please refer to the :ref:`tutorials<tutorials>` for examples of using FACET classes

sphinx/source/conf.py

@@ -7,28 +7,20 @@
 import os
 import sys
 
-sys.path.insert(
-    0,
-    os.path.abspath(
-        os.path.join(
-            os.path.dirname(__file__),
-            os.pardir,
-            os.pardir,
-            os.pardir,
-            "pytools",
-            "sphinx",
-            "base",
-        )
-    ),
-)
+_dir_base = os.path.join(os.path.dirname(os.path.dirname(__file__)), "base")
+sys.path.insert(0, _dir_base)
 
 from conf_base import set_config
 
-# ----- custom configuration -----
+# ----- set custom configuration -----
 
 set_config(
     globals(),
     project="facet",
-    modules=["facet", "pytools", "sklearndf"],
-    html_logo="_static/Gamma_Facet_Logo_RGB_LB.svg",
+    html_logo=os.path.join("_static", "Gamma_Facet_Logo_RGB_LB.svg"),
+    intersphinx_mapping={
+        "pytools": ("https://bcg-gamma.github.io/pytools/", None),
+        "shap": ("https://shap.readthedocs.io/en/stable", None),
+        "sklearndf": ("https://bcg-gamma.github.io/sklearndf/", None),
+    },
 )