Add build_docs action to PRs

Author: melissawm

.github/workflows/build_docs.yml

@@ -0,0 +1,53 @@
+name: Build PR Docs
+
+on:
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  build-and-upload:
+    name: Build & Upload Artifact
+    runs-on: ubuntu-latest
+    steps:
+      - name: Clone docs repo
+        uses: actions/checkout@v3
+
+      - name: Clone main repo
+        uses: actions/checkout@v3
+        with:
+          path: napari
+          repository: napari/napari
+
+      - uses: actions/setup-python@v2
+        with:
+          python-version: 3.9
+
+      - uses: tlambert03/setup-qt-libs@v1
+
+      - name: Install Dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install "napari/[all]"
+
+      - name: Testing
+        run: |
+          python -c 'import napari; print(napari.__version__)'
+          python -c 'import napari.layers; print(napari.layers.__doc__)'
+
+      - name: Build Docs
+        uses: GabrielBB/xvfb-action@v1
+        env:
+          GOOGLE_CALENDAR_ID: ${{ secrets.GOOGLE_CALENDAR_ID }}
+          GOOGLE_CALENDAR_API_KEY: ${{ secrets.GOOGLE_CALENDAR_API_KEY }}
+        with:
+          # the napari-docs repo is cloned into a docs/ folder, hence the
+          # invocation below. Locally, you should simply run make docs
+          run: make docs
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v2
+        with:
+          name: docs
+          path: docs/_build

docs/conf.py

@@ -168,7 +168,7 @@ def reset_napari_theme(gallery_conf, fname):
 
 
 sphinx_gallery_conf = {
-    'examples_dirs': '../examples',  # path to your example scripts
+    'examples_dirs': '../../napari/examples',  # path to your example scripts
     'gallery_dirs': 'gallery',  # path to where to save gallery generated output
     'filename_pattern': '/*.py',
     'ignore_pattern': 'README.rst|/*_.py',