ci: push pages to docs repository

Signed-off-by: Moritz Wanzenböck <[email protected]>

.github/workflows/docs.yml

@@ -35,10 +35,16 @@ jobs:
     - uses: actions/checkout@v4
       with:
         fetch-depth: '0'
-    - name: Configure Git Credentials
+    - uses: webfactory/[email protected]
+      with:
+        ssh-private-key: ${{ secrets.GH_PAGES_REPO_KEY }}
+    - name: Configure Git
       run: |
         git config user.name github-actions[bot]
         git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+        # Deployed docs are in another repo for nice URLs
+        git remote add gh-pages [email protected]:piraeusdatastore/docs.git
+        git fetch gh-pages gh-pages --depth=1
     - uses: actions/setup-python@v5
       with:
         python-version: 3.x
@@ -52,7 +58,7 @@ jobs:
     - run: pip install mkdocs-material[imaging] mike
     - name: Deploy latest docs
       if: ${{ github.ref_type == 'branch' }}
-      run: mike deploy -u -p v2 latest
+      run: mike deploy -u -r gh-pages -p v2 latest
     - name: Deploy release docs
       if: ${{ github.ref_type == 'tag' }}
-      run: mike deploy -u -p ${{ github.ref_name }} stable
+      run: mike deploy -u -r gh-pages -p ${{ github.ref_name }} stable