Add CI for docs

Author: robtaylor

.github/workflows/build-docs.yml

@@ -0,0 +1,36 @@
+name: Build Docs
+on:
+  workflow_call:
+
+jobs:
+  build-docs:
+    runs-on: ubuntu-22.04
+
+    env:
+      GH_TOKEN: "${{ secrets.GITHUB_TOKEN}}"
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up PDM
+        uses: pdm-project/setup-pdm@v4
+        with:
+          python-version: "3.10"
+          cache: true
+
+      - name: Install deps
+        run: pdm install -d
+
+      - name: Build docs
+        run: pdm docs
+
+      - name: set .nojeckyll for GitHub
+        run: touch docs/build/.nojekyll
+
+      - name: Upload docs artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: docs
+          path: docs/build
+

.github/workflows/deploy-docs-internal.yml

@@ -0,0 +1,31 @@
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+name: deploy-internal
+run-name: Deploy docs internally
+jobs:
+  build-docs:
+    uses: ./.github/workflows/build-docs.yml
+
+  deploy-internal:
+    runs-on: ubuntu-latest
+    needs: build-docs
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Download docs artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: docs
+          path: docs/build
+
+      - uses: JamesIves/github-pages-deploy-action@v4
+        with:
+          folder: docs/build
+          branch: gh-pages
+          clean-exclude: pr-preview
+          force: false

.github/workflows/preview-docs.yml

@@ -0,0 +1,35 @@
+# .github/workflows/preview.yml
+name: Deploy PR previews
+concurrency: preview-${{ github.ref }}
+on:
+  pull_request:
+    types:
+      - opened
+      - reopened
+      - synchronize
+      - closed
+
+jobs:
+  build-docs:
+    uses: ./.github/workflows/build-docs.yml
+
+  deploy-preview:
+    runs-on: ubuntu-latest
+    needs: build-docs
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Download docs artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: docs
+          path: docs/build
+
+      - uses: rossjrw/pr-preview-action@v1
+        with:
+          source-dir: docs/build
+          preview-branch: gh-pages
+          umbrella-dir: pr-preview
+          action: auto
+          pages-base-url: chipflow-docs.docs.chipflow-infra.com

docs/requirements.txt

@@ -2,5 +2,4 @@ git+https://github.com/SymbiFlow/sphinx_materialdesign_theme.git#egg=sphinx-symb
 
 docutils
 sphinx
-sphinx-autobuild
 sphinxcontrib-wavedrom

docs/source/conf.py

@@ -44,7 +44,7 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
-  'sphinxcontrib.wavedrom',
+  'sphinxcontrib.yowasp_wavedrom',
   'sphinx.ext.mathjax',
   'sphinx.ext.todo'
 ]