Enable documentation to have auto-generated figures

.github/workflows/docs.yml

@@ -27,10 +27,16 @@ jobs:
       run: |
         pip install -r .github/workflows/requirements/docs.txt
 
+    - name: Install Gnuplot
+      run: |
+        sudo apt update
+        sudo apt install -y gnuplot
+
     - name: Build with sphinx
       run: |
         cd docs
-        make html WORKSPACE_PATH=/tmp/workspace
+        # make html WORKSPACE_PATH=/tmp/workspace
+        ./build_doc.py --html
 
     - name: Check for Typos using Codespell
       run: |

.github/workflows/requirements/docs.txt

@@ -20,3 +20,4 @@ pyarrow==3.0.0;python_version<="3.6"
 google-cloud-bigquery
 tqdm
 deprecation
+matplotlib

docs/build_doc.py

@@ -307,7 +307,7 @@ def _build_pdf(self):
         self.logger.info("Building PDF...")
 
         run_app(self.logger, ["sphinx-build", "-b", "latex", ".", "_build"])
-        run_app(self.logger, ["make", "latexpdf"])
+        run_app(self.logger, ["make", "latexpdf", "WORKSPACE_PATH=/tmp/workspace"])
 
     def _build_html(self):
         """This builds the documentation with exporting to HTML."""
@@ -317,7 +317,7 @@ def _build_html(self):
         self.logger.info("Building HTML...")
 
         run_app(self.logger, ["sphinx-build", "-b", "html", ".", "_build"])
-        run_app(self.logger, ["make", "html"])
+        run_app(self.logger, ["make", "html", "WORKSPACE_PATH=/tmp/workspace"])
 
     def build_doc(self):
         """This builds the documentation."""