New attempt to fix doc publishing @minor

.github/workflows/python-package.yml

@@ -27,26 +27,29 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install -r requirements/dev.txt
-    - name: Build documentation
+    - name: Prepare documentation build
       run: |
-        make docs
-    - name: Publish documentation
-      run: |
-        author_name="$(git show --format=%an -s)"
-        author_email="$(git show --format=%ae -s)"
-        echo "git config user.name $author_name"
-        git config user.name $author_name
-        echo "git config user.email $author_email"
-        git config user.email $author_email
-        echo "git fetch origin gh-pages"
+        mkdir -p docs
+        rm -f doc_src/api/categories*.rst
+        ls -A1 docs | xargs -I {} rm -rf docs/{}
         git fetch origin gh-pages
-        ghp-import -ops docs
-#    - name: Sphinx Pages
-#      # You may pin to the exact commit or the version.
-#      # uses: seanzhengw/sphinx-pages@70dd0557fc226cfcd41c617aec5e9ee4fce4afe2
-#      uses: seanzhengw/sphinx-pages@d29427677b3b89c1b5311d9eb135fb4168f4ba4a
-#      with:
-#        # Token for the repo. Can be passed in using $\{{ secrets.GITHUB_TOKEN }}
-#        github_token: ${{ secrets.GITHUB_TOKEN }}
-#        # Auto create a README.md file at branch gh-pages root with repo/branch/commit links
-#        source_dir: "doc_src"
+        git update-ref -d refs/heads/gh-pages
+#    - name: Publish documentation
+#      run: |
+#        author_name="$(git show --format=%an -s)"
+#        author_email="$(git show --format=%ae -s)"
+#        echo "git config user.name $author_name"
+#        git config user.name $author_name
+#        echo "git config user.email $author_email"
+#        git config user.email $author_email
+#        echo "git fetch origin gh-pages"
+#        git fetch origin gh-pages
+#        git update-ref -d refs/heads/gh-pages
+    - name: Sphinx Pages
+      # You may pin to the exact commit or the version.
+      # uses: seanzhengw/sphinx-pages@70dd0557fc226cfcd41c617aec5e9ee4fce4afe2
+      uses: seanzhengw/sphinx-pages@d29427677b3b89c1b5311d9eb135fb4168f4ba4a
+      with:
+        # Token for the repo. Can be passed in using $\{{ secrets.GITHUB_TOKEN }}
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        source_dir: "doc_src"