chg: dev: (re)enable spinx builds in github ci, push to ghpages

Signed-off-by: Stephen L Arnold <[email protected]>

.github/workflows/release.yml

@@ -104,40 +104,40 @@ jobs:
           files: |
             packages/timew*
 
-  #docs:
-    #name: Release docs
-    #needs: [create_release]
-    #runs-on: ubuntu-20.04
-
-    #steps:
-    #- uses: actions/checkout@v4
-      #with:
-        #fetch-depth: 0
-
-    #- uses: actions/setup-python@v5
-      #with:
-        #python-version: '3.9'
-
-    #- name: Add python requirements
-      #run: |
-        #python -m pip install --upgrade pip
-        #pip install tox
-
-    #- name: Build docs
-      #run: |
-        #tox -e ldocs,docs
-
-    #- uses: actions/upload-artifact@v4
-      #with:
-        #name: ApiDocsHTML
-        #path: "docs/_build/html/"
-
-    #- name: set nojekyll for github
-      #run: |
-        #sudo touch docs/_build/html/.nojekyll
-
-    #- name: Deploy docs to gh-pages
-      #if: ${{ github.event_name == 'push' }}
-      #uses: JamesIves/github-pages-deploy-action@v4
-      #with:
-        #folder: docs/_build/html/
+  docs:
+    name: Release docs
+    needs: [create_release]
+    runs-on: ubuntu-22.04
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - uses: actions/setup-python@v5
+      with:
+        python-version: '3.9'
+
+    - name: Add python requirements
+      run: |
+        python -m pip install --upgrade pip
+        pip install tox
+
+    - name: Build docs
+      run: |
+        tox -e ldocs,docs
+
+    - uses: actions/upload-artifact@v4
+      with:
+        name: ApiDocsHTML
+        path: "docs/build/html/"
+
+    - name: set nojekyll for github
+      run: |
+        sudo touch docs/build/html/.nojekyll
+
+    - name: Deploy docs to gh-pages
+      if: ${{ github.event_name == 'push' }}
+      uses: JamesIves/github-pages-deploy-action@v4
+      with:
+        folder: docs/build/html/

.github/workflows/sphinx.yml

@@ -0,0 +1,47 @@
+name: Docs
+on:
+  workflow_dispatch:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  build:
+    runs-on: ubuntu-20.04
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - uses: actions/setup-python@v5
+      with:
+        python-version: '3.9'
+
+    - name: Add python requirements
+      run: |
+        python -m pip install --upgrade pip
+        pip install tox
+
+    - name: Build docs
+      run: |
+        tox -e ldocs,docs
+
+    - uses: actions/upload-artifact@v4
+      with:
+        name: ApiDocsHTML
+        path: "docs/build/html/"
+
+    - name: set nojekyll for github
+      run: |
+        sudo touch docs/build/html/.nojekyll
+
+    - name: Deploy docs to gh-pages
+      if: ${{ github.event_name == 'push' }}
+      uses: JamesIves/github-pages-deploy-action@v4
+      with:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        BRANCH: gh-pages
+        FOLDER: docs/build/html/
+        SINGLE_COMMIT: true