Update docs deploy scripts

The update in 5cbabe1 didn't provide for a .nojekyll file, which is necessary when publishing to GitHub Pages to avoid Jekyll messing with our statically generated documentation.

Also added a user input to the manual deploy script which allows deploying from any past reference (tag or commit).

Author: waylan

.github/workflows/deploy.yml

@@ -49,7 +49,16 @@ jobs:
   ghpages:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout Source Repo
+        uses: actions/checkout@v4
+        with:
+          path: md
+      - name: Checkout Target Repo
+        uses: actions/checkout@v4
+        with:
+          ssh-key: ${{ secrets.PAGES_DEPLOY_KEY  }}
+          repository: Python-Markdown/Python-Markdown.github.io
+          path: target
       - name: Setup Python
         uses: actions/setup-python@v4
         with:
@@ -60,15 +69,11 @@ jobs:
           python -m pip install .[docs]
       - name: Build
         run: |
+          cd md
           python -m mkdocs build --clean --verbose
       - name: Publish
         if: success()
-        uses: cpina/github-action-push-to-another-repository@main
-        env:
-          SSH_DEPLOY_KEY: ${{ secrets.PAGES_DEPLOY_KEY }}
-        with:
-          source-directory: 'site'
-          destination-github-username: 'Python-Markdown'
-          destination-repository-name: 'Python-Markdown.github.io'
-          user-name: ${{ github.actor }}
-          target-branch: master
+        run: |
+          cd target
+          git config user.email [email protected]
+          python -m ghp-import --push --no-jekyll --branch=master ../md/site

.github/workflows/manual_deploy.yml

@@ -1,14 +1,30 @@
 name: manual deploy
 
 on:
-  workflow_dispatch
+  workflow_dispatch:
+    inputs:
+      ref:
+        description: 'The branch, tag or SHA to checkout and build.'
+        type: string
+        required: true
+        default: master
 
 jobs:
 
   ghpages:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout Source Repo
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.ref }}
+          path: md
+      - name: Checkout Target Repo
+        uses: actions/checkout@v4
+        with:
+          ssh-key: ${{ secrets.PAGES_DEPLOY_KEY  }}
+          repository: Python-Markdown/Python-Markdown.github.io
+          path: target
       - name: Setup Python
         uses: actions/setup-python@v4
         with:
@@ -19,15 +35,11 @@ jobs:
           python -m pip install .[docs]
       - name: Build
         run: |
+          cd md
           python -m mkdocs build --clean --verbose
       - name: Publish
         if: success()
-        uses: cpina/github-action-push-to-another-repository@main
-        env:
-          SSH_DEPLOY_KEY: ${{ secrets.PAGES_DEPLOY_KEY }}
-        with:
-          source-directory: 'site'
-          destination-github-username: 'Python-Markdown'
-          destination-repository-name: 'Python-Markdown.github.io'
-          user-name: ${{ github.actor }}
-          target-branch: master
+        run: |
+          cd target
+          git config user.email [email protected]
+          python -m ghp-import --push --no-jekyll --branch=master ../md/site