add doc building

Author: cvanelteren

.github/workflows/build.yml

@@ -250,6 +250,91 @@ jobs:
             exit 1
           fi
 
+  docs:
+    name: Build documentation
+    needs: [build_wheels]
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.9"
+
+      - name: Download basemap wheel for Linux
+        uses: actions/download-artifact@v4
+        with:
+          name: dist-basemap-wheels-ubuntu-22.04
+          path: ./wheels/
+
+      - name: Download data packages
+        uses: actions/download-artifact@v4
+        with:
+          pattern: dist-basemap_data*
+          path: ./data_packages/
+          merge-multiple: true
+
+      - name: Install packages
+        run: |
+          # Get Python version to find matching wheel
+          PYTHON_VERSION=$(python -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')")
+          echo "Using Python $PYTHON_VERSION"
+
+          # Install matching wheel for Linux
+          MATCHING_WHEEL=$(find ./wheels -name "basemap-*-cp3${PYTHON_VERSION/./}*.whl" | head -1)
+          if [ -n "$MATCHING_WHEEL" ]; then
+            echo "Installing wheel: $MATCHING_WHEEL"
+            python -m pip install "$MATCHING_WHEEL"
+          else
+            echo "No matching wheel found for Python $PYTHON_VERSION. Available wheels:"
+            ls -la ./wheels/
+            echo "Falling back to installing any available wheel..."
+            python -m pip install ./wheels/*.whl
+          fi
+
+          # Install data packages
+          echo "Installing data packages..."
+          python -m pip install ./data_packages/*.whl
+
+      - name: Install documentation requirements
+        run: |
+          cd packages/basemap
+          python -m pip install -r requirements-doc.txt
+
+      - name: Build documentation
+        run: |
+          cd packages/basemap
+          python -m sphinx doc/source public
+
+      - name: Upload docs artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: docs-artifact
+          path: packages/basemap/public
+
+      - name: Upload github-pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          name: github-pages
+          path: packages/basemap/public
+
+  pages:
+    name: Deploy documentation
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    needs: [docs, check]
+    runs-on: ubuntu-22.04
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    permissions:
+      pages: write
+      id-token: write
+    steps:
+      - name: Deploy github-pages
+        uses: actions/deploy-pages@v3
+        id: deployment
+
   upload:
     name: Upload packages
     needs: [build_data, build_sdist, build_wheels, check]