ci: wip

Author: robtaylor

.github/workflows/build-docs.yml

@@ -0,0 +1,36 @@
+name: Build Docs
+on:
+  workflow_call:
+    secrets:
+      GITHUB_TOKEN:
+        required: true
+
+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
+
+      - name: Build docs
+        run: pdm docs
+
+      - name: Upload docs artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: docs
+          path: docs/build
+

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

@@ -0,0 +1,34 @@
+# .github/workflows/deploy.yml
+name: Deploy docs internally
+on:
+  push:
+    branches:
+      - main
+jobs:
+  build-docs:
+    uses: ./.github/workflows/build-docs.yml
+    secrets: inherit
+
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup PDM
+        uses: pdm-project/setup-pdm@v4
+        with:
+          python-version: "3.10"
+          cache: true
+
+      - name: Install dependencies
+        run: pdm install
+
+      - name: Build docs
+        run: pdm docs
+
+      - 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

@@ -9,12 +9,15 @@ on:
       - synchronize
       - closed
 
-env:
-  GH_TOKEN: ${{ github.token }}
-
 jobs:
+  build-docs:
+    uses: ./.github/workflows/build-docs.yml
+    secrets: 
+      GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN}}"
+
   deploy-preview:
     runs-on: ubuntu-latest
+    needs: build-docs
     steps:
       - uses: actions/checkout@v4
 

.github/workflows/main.yml renamed to .github/workflows/release.yml

@@ -1,36 +1,14 @@
-name: CI
+name: Release docs LIVE!
 on:
-  push:
-    branches:
-    - main
-  pull_request:
+  release:
 
 env:
   GH_TOKEN: ${{ github.token }}
 
 jobs:
   build-docs:
-    runs-on: ubuntu-22.04
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Set up PDM
-        uses: pdm-project/setup-pdm@v4
-        with:
-          python-version: "3.10"
-
-      - name: Install deps
-        run: pdm install
-
-      - name: Build docs
-        run: pdm docs
-
-      - name: Upload docs artifact
-        uses: actions/upload-artifact@v4
-        with:
-          name: docs
-          path: docs/build
+    uses: ./.github/workflows/build-docs.yml
+    secrets: inherit
 
   publish-docs:
     needs: build-docs
@@ -46,7 +24,7 @@ jobs:
         uses: actions/download-artifact@v4
         with:
           name: docs
-          path: docs/
+          path: docs/build
 
       - name: Publish "latest" docs
         if: ${{ github.event_name == 'push' && github.event.ref == 'refs/heads/main' }}
@@ -55,5 +33,5 @@ jobs:
           repository-name: chipflow/chipflow.github.io
           ssh-key: ${{ secrets.PAGES_DEPLOY_KEY }}
           branch: main
-          folder: docs/
+          folder: docs/build
           target-folder: en/latest/