add docs to pixi

.github/workflows/pixi.yml

@@ -33,13 +33,13 @@ jobs:
  path: ./dist
 
  test:
- name: ${{ matrix.test-env }} (${{ matrix.os }} ${{ matrix.browser }})
+ name: (${{ matrix.os }}) test
  needs: [build]
  runs-on: ${{ matrix.os }}-latest
  strategy:
  fail-fast: false
  matrix:
- os: ["ubuntu"] #, "macos", "windows"]
+ os: ["ubuntu"]
  # add matrix for browsers later on
  steps:
  - run: git config --global core.autocrlf false
@@ -59,8 +59,51 @@ jobs:
  uses: actions/upload-artifact@v4
  with:
  name: |-
- nbconvert-a11y-${{ github.run_number }}-${{ matrix.test-env }}-${{ matrix.os }}
+ nbconvert-a11y-${{ github.run_number }}-${{ matrix.os }}-test
  path: |
  ./.pixi/task-cache-v0
  ./build/reports
- ./contrib/*/build/reports
+ 
+ docs:
+ name: docs
+ needs: [test]
+ runs-on: ubuntu-latest
+ steps:
+ - run: git config --global core.autocrlf false
+ - uses: actions/checkout@v4
+ - uses: prefix-dev/[email protected]
+ with:
+ pixi-version: v${{ env.USE_PIXI_VERSION }}
+ cache: true
+ environments: docs
+ - run: pixi run -ve docs build
+ - if: always()
+ uses: actions/upload-artifact@v4
+ with:
+ name: nbconvert-a11y-${{ github.run_number }}-site
+ path: site
+
+ publish:
+ name: publish the mkdocs build to github pages
+ needs: [docs]
+ runs-on: ubuntu-latest
+ steps:
+ - name: checkout repo
+ uses: actions/checkout@v3
+ - uses: actions/download-artifact@v3
+ with:
+ name: nbconvert-a11y-${{ github.run_number }}-site
+ path: site
+ - name: Deploy main 🚀
+ uses: JamesIves/github-pages-deploy-action@v4
+ if: ${{ github.ref_name == 'main' }}
+ with:
+ folder: site # The folder the action should deploy.
+ single-commit: true
+ - name: Deploy non-main 🚀
+ uses: JamesIves/github-pages-deploy-action@v4
+ if: ${{ github.ref_name != 'main' }}
+ with:
+ folder: site # The folder the action should deploy.
+ single-commit: true
+ target-folder: branch/${{ github.ref_name }}