Update build-doc.yml

Author: LiamConnors

.github/workflows/build-doc.yml

@@ -26,17 +26,20 @@ jobs:
         run: |
           cd doc
           uv venv
+          source .venv/bin/activate
           uv pip install -r requirements.txt
 
       - name: Install plotly in editable mode
         if: github.ref_name != 'doc-prod'
         run: |
           cd doc
+          source .venv/bin/activate
           uv pip install -e ..
 
       - name: List installed packages
         run: |
           cd doc
+          source .venv/bin/activate
           uv pip list
 
       - name: Build HTML docs
@@ -65,6 +68,7 @@ jobs:
           path: doc/build/ipynb/
 
       - name: Build API docs
+        if: github.ref_name == 'migrate-to-gh-actions' && github.event_name == 'push'
         run: |
           cd doc
           source .venv/bin/activate
@@ -77,7 +81,96 @@ jobs:
           make html
 
       - name: Upload API docs artifact
+        if: github.ref_name == 'migrate-to-gh-actions' && github.event_name == 'push'
         uses: actions/upload-artifact@v4
         with:
           name: apidoc-build
           path: doc/apidoc/_build/html/
+
+      # Deploy steps — currently using test branches for validation
+      # TODO: Change branch trigger to 'doc-prod' and deploy branches to 'built', 'built_ipynb', 'gh-pages'
+      - name: Create GitHub App token
+        if: github.ref_name == 'migrate-to-gh-actions' && github.event_name == 'push'
+        uses: actions/create-github-app-token@v2
+        id: app-token
+        with:
+          app-id: ${{ vars.GRAPHING_LIBRARIES_CI_GHAPP_ID }}
+          private-key: ${{ secrets.GRAPHING_LIBRARIES_CI_GHAPP_PRIVATE_KEY }}
+          owner: ${{ github.repository_owner }}
+          repositories: plotly.py-docs,graphing-library-docs
+
+      - name: Checkout plotly.py-docs (built-test)
+        if: github.ref_name == 'migrate-to-gh-actions' && github.event_name == 'push'
+        uses: actions/checkout@v6
+        with:
+          repository: plotly/plotly.py-docs
+          ref: built-test
+          token: ${{ steps.app-token.outputs.token }}
+          path: plotly.py-docs-html
+
+      - name: Deploy HTML docs
+        if: github.ref_name == 'migrate-to-gh-actions' && github.event_name == 'push'
+        run: |
+          git config --global user.name plotlydocbot
+          git config --global user.email accounts@plot.ly
+          rm -rf plotly.py-docs-html/*
+          cp -r doc/build/html/* plotly.py-docs-html/
+          cd plotly.py-docs-html
+          git add .
+          git commit -m "build of https://github.com/plotly/plotly.py/commit/${{ github.sha }}" || echo "No changes to commit"
+          git push --force
+
+      - name: Checkout plotly.py-docs (built_ipynb-test)
+        if: github.ref_name == 'migrate-to-gh-actions' && github.event_name == 'push'
+        uses: actions/checkout@v6
+        with:
+          repository: plotly/plotly.py-docs
+          ref: built_ipynb-test
+          token: ${{ steps.app-token.outputs.token }}
+          path: plotly.py-docs-ipynb
+
+      - name: Deploy notebooks
+        if: github.ref_name == 'migrate-to-gh-actions' && github.event_name == 'push'
+        run: |
+          rm -rf plotly.py-docs-ipynb/*
+          cp -r doc/build/ipynb/* plotly.py-docs-ipynb/
+          cd plotly.py-docs-ipynb
+          git add .
+          git commit -m "build of https://github.com/plotly/plotly.py/commit/${{ github.sha }}" || echo "No changes to commit"
+          git push --force
+
+      - name: Checkout plotly.py-docs (gh-pages-test)
+        if: github.ref_name == 'migrate-to-gh-actions' && github.event_name == 'push'
+        uses: actions/checkout@v6
+        with:
+          repository: plotly/plotly.py-docs
+          ref: gh-pages-test
+          token: ${{ steps.app-token.outputs.token }}
+          path: plotly.py-docs-api
+
+      - name: Deploy API docs
+        if: github.ref_name == 'migrate-to-gh-actions' && github.event_name == 'push'
+        run: |
+          rm -rf plotly.py-docs-api/*
+          cp -r doc/apidoc/_build/html/* plotly.py-docs-api/
+          touch plotly.py-docs-api/.nojekyll
+          cd plotly.py-docs-api
+          git add .
+          git commit -m "build of https://github.com/plotly/plotly.py/commit/${{ github.sha }}" || echo "No changes to commit"
+          git push --force
+
+      - name: Checkout graphing-library-docs
+        if: github.ref_name == 'migrate-to-gh-actions' && github.event_name == 'push'
+        uses: actions/checkout@v6
+        with:
+          repository: plotly/graphing-library-docs
+          ref: test-trigger
+          token: ${{ steps.app-token.outputs.token }}
+          path: graphing-library-docs
+
+      - name: Trigger downstream doc build
+        if: github.ref_name == 'migrate-to-gh-actions' && github.event_name == 'push'
+        run: |
+          cd graphing-library-docs
+          git commit --allow-empty -m "deploying https://github.com/plotly/plotly.py/commit/${{ github.sha }}"
+          git push