Merge pull request #7 from ihmeuw-msca/publish-docs

Changes learned while working on docs for OneMod

.github/workflows/deploy.yml

@@ -30,6 +30,8 @@ jobs:
         password: ${{ secrets.PYPI_API_TOKEN }}
 
   docs:
+    environment:
+      name: github-pages
     runs-on: ubuntu-latest
     permissions:
       pages: write
@@ -41,10 +43,13 @@ jobs:
         with:
           python-version: "3.12"
       - name: Install dependencies
-        run: python -m pip install .[docs] --upgrade pip
+        run: |
+          python -m pip install .[docs] --upgrade pip
       - name: Generate API docs & Build sphinx documentation
         run: |
           git fetch --tags
+          git checkout main
+          git pull
           cd docs
           python build.py
           cd ..
@@ -53,7 +58,7 @@ jobs:
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          path: './docs/pages'
+          path: './docs-out/html'
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v4

docs/build.py

@@ -7,11 +7,12 @@
 
 
 def build_doc(version: str) -> None:
+    print(f"Build _{version}_")
     run(f"git checkout v{version}")
     run("git checkout main -- conf.py")
     run("git checkout main -- meta.toml")
 
-    run("make html")
+    run("sphinx-build -M html . _build")
     run(f"mv _build/html pages/{version}")
     run("rm -rf _build")
     run("git checkout main")