Implement automatic HTML generation

.github/workflows/docs.yml

@@ -0,0 +1,57 @@
+name: Docs
+on:
+  pull_request:
+    types: [synchronize, edited, opened]
+  push:
+    branches: [main]
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Install Poetry
+        run: pipx install poetry
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          cache: poetry
+      - name: Install Environment
+        run: poetry install --with=docs
+      - name: Build Documentation
+        run: >-
+          poetry run sphinx-build
+          --color
+          -b html
+          ${{github.workspace}}
+          ${{github.workspace}}/_site
+      - name: Archive Documentation
+        run: >-
+          tar
+          --create
+          --gzip
+          --verbose
+          --mode=a+rw
+          --file=cps-docs.tar.gz
+          --directory=${{_site
+          .
+      - name: Upload Archive
+        uses: actions/upload-artifact@v4
+        with:
+          if-no-files-found: error
+          name: github-pages
+          path: ${{github.workspace}}/cps-docs.tar.gz
+  deploy:
+    if: github.event.repository.default_branch == github.ref_name
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url}}
+    steps:
+      - name: Deploy to GitHub Pages
+        uses: actions/deploy-pages@v4
+        id: deployment

.github/workflows/spellcheck.yml

@@ -0,0 +1,15 @@
+name: Spellcheck
+on:
+  pull_request:
+    types: [synchronize, edited, opened]
+  push:
+    branches: [main]
+jobs:
+  spellcheck:
+    name: Spellcheck
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Spellcheck
+        uses: crate-ci/typos@master

conf.py

@@ -20,7 +20,7 @@
 copyright = u'2023, Matthew Woehlke'
 
 release = '.'.join(map(str, [0, 9, 0]))
-version = re.match('\\d+\.\\d+', release).group(0)
+version = re.match(r'\d+\.\d+', release).group(0)
 
 language = 'en'
 primary_domain = 'cps'

pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.poetry]
+name = "cps"
+version = "0.dev"
+description = ""
+authors = ["The CPS Project <@>"]
+readme = "README.md"
+packages = [
+  { include = "cps.py", from = "extensions" },
+  { include = "autosectionlabel.py", from = "extensions" }
+]
+
+[tool.poetry.dependencies]
+python = "^3.10"
+
+[tool.poetry.group.docs.dependencies]
+python = "^3.10"
+sphinx = ">=7.2.6"
+
+[tool.poetry.plugins."sphinx.builders"]
+cps = "cps"
+autosectionlabel = "autosectionlabel"
+
+[tool.typos]
+files.extend-exclude = ["*.css", "*.svg"]