Merge pull request #46 from Sichao25/yus/debug_actions

Debug `docs.yml` workflow

Author: cwsmith

.github/workflows/docs.yml

@@ -8,15 +8,23 @@ on:
 
 jobs:
   build:
-
-    runs-on: macos-latest
-
+    runs-on: ubuntu-latest
     steps:
     - name: Checkout repo
-      uses: actions/[email protected]
+      uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.11'
+    
     - name: Requirements
-      run: brew install doxygen
-        && pip3 install -r docsDoxySphinx/requirements.txt
+      run: |
+        sudo apt-get update
+        sudo apt-get install doxygen
+        pip3 install -r docsDoxySphinx/requirements.txt
+    
     - name: Build docs
-      run: cd docsDoxySphinx
-        && make html
+      run: |
+        cd docsDoxySphinx
+        make html

docsDoxySphinx/environment.yaml

@@ -2,6 +2,6 @@ name: docs
 channels:
   - defaults
 dependencies:
-  - sphinx==4.5.0
+  - sphinx==8.2.3
   - pip:
-    - sphinx_rtd_theme==1.0.0
+    - sphinx_rtd_theme==3.0.2

docsDoxySphinx/requirements.txt

@@ -1,4 +1,4 @@
-Sphinx==4.5.0
-sphinx-rtd-theme==1.0.0
-sphinx-sitemap==2.2.0
-breathe==4.33.1
+Sphinx==8.2.3
+sphinx-rtd-theme==3.0.2
+sphinx-sitemap==2.6.0
+breathe==4.35.0