Add Doc action (#2)

* update workflow yaml

* update workflow to try and fix build errors

* try again with action fixes

* update python version in runner

* update sphinx command

* update sphinx command for poetry env

* update sphinx command for poetry env

Author: tipatterson-dev

.github/workflows/docs_pages.yaml

@@ -1,35 +1,34 @@
 name: Docs2Pages
-on:
-  push:
-    tags: '*'
-  pull_request:
-    branches:
-      - master
+on: [push, pull_request, workflow_dispatch]
+permissions:
+  contents: write
 
 jobs:
   build-docs:
     runs-on: ubuntu-latest
     steps:
     - name: Checkout
-      uses: actions/checkout@master
+      uses: actions/checkout@v3
+    - uses: actions/setup-python@v5
       with:
-        fetch-depth: 0
-    - uses: actions/setup-python@v2
-      with:
-        python-version: 3.9
-    - uses: abatilo/actions-poetry@v2.1.3
-    - name: install
-      run: poetry install -E amazon -E docs
-    - name: Build documentation
+        python-version: '3.12'
+
+    - name: Install Poetry
+      uses: snok/install-poetry@v1
+
+    - name: Install dependencies
       run: |
-        mkdir gh-pages
-        touch gh-pages/.nojekyll
-        cd docs/
-        poetry run sphinx-build -b html . _build
-        cp -r _build/* ../gh-pages/
+        poetry install --with dev
+
+    - name: Sphinx build
+      run: |
+        poetry run sphinx-build -M html docs/source docs/build/html
+
     - name: Deploy documentation
-      if: ${{ github.event_name == 'push' }}
-      uses: JamesIves/github-pages-deploy-action@4.1.4
+      uses: peaceiris/actions-gh-pages@v3
+      if: github.event_name == 'push' && github.ref == 'refs/heads/master'
       with:
-        branch: gh-pages
-        folder: gh-pages
+        publish_branch: gh-pages
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        publish_dir: ./docs/build/html
+        force_orphan: true