Refactor build system

Author: brianhelba

.github/workflows/doc.yml

@@ -0,0 +1,48 @@
+name: pages
+on:
+  pull_request:
+  push:
+    branches:
+      - master
+concurrency:
+  # Only run the latest workflow per-branch
+  group: "${{ github.workflow }}-${{ github.ref_name }}"
+  cancel-in-progress: true
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+      - name: Install Poetry
+        run: |
+          pip install --upgrade pip
+          pip install poetry
+      - name: Install project
+        run: |
+          poetry install
+      - name: Build docs
+        run: |
+          poetry run task build
+      - name: Upload GitHub Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: "build/html"
+  deploy:
+    needs: build
+    if: github.event_name == 'push' && github.ref == 'refs/heads/master'
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/pages.yml

@@ -1,2 +1,3 @@
-resonant_docs/build
+/build
+
 .DS_Store

.gitignore

@@ -1,23 +1,8 @@
-# resonant
+# Resonant
+Resonant marketing website.
 
-Resonant documentation materials.
-
-## Build instructions
-
-You can use `poetry` to build and view the documentation locally. There are two
-ways to do it.
-
-
-### Static build
-
-1. Run `poetry install` to build the dependencies.
-2. Run `poetry run task build` to build the documentation.
-3. Run `poetry run task serve` to serve the docs on port 8000 (or `poetry run
-   task serve 8001` to use a different port of your choice).
-
-### Watch mode build.
-
-1. Run `poetry install` to build the dependencies.
-2. Run `poetry run task watch` to build and serve the docs on port 8000 (or
-   `poetry run task watch PORT=8001` to use a different port of your choice).
+## Development instructions
+1. [Install Poetry](https://python-poetry.org/docs/#installation)
+2. Run `poetry install` to build the dependencies.
+2. Run `poetry run task watch` to build and serve the docs.
    Changes to the documentation source code will cause an automatic rebuild.

CNAME

@@ -1,25 +1,26 @@
 [tool.poetry]
 name = "resonant_docs"
 version = "0.1.0"
-description = "Documentation for Resonant"
+description = "Resonant marketing website"
 authors = ["Kitware D&A Team <[email protected]>"]
 
 [tool.poetry.dependencies]
-python = "^3.8"
+python = "^3.12"
 
-[tool.poetry.dev-dependencies]
+[tool.poetry.group.docs.dependencies]
 Sphinx = "^4.5.0"
 sphinx-copybutton = "^0.5.0"
-sphinx-notfound-page = "^0.8"
 sphinx-panels = "^0.6.0"
 furo = "^2022.4.7"
+
+[tool.poetry.group.dev.dependencies]
 taskipy = "^1.10.2"
 sphinx-autobuild = "^2021.3.14"
 
 [tool.taskipy.tasks]
-build = { cmd = "make html -C doc", help = "Build the HTML documentation" }
-serve = { cmd = "python -m http.server --bind 127.0.0.1 -d doc/build/html", help = "Serve the built docs (supply an optional port number, 8000 by default)" }
-watch = { cmd = "make livehtml -C doc", help = "Build the HTML documentation in watch mode" }
+pre_build = "rm -rf ./build"
+build = "sphinx-build -M html resonant_docs build"
+watch = "sphinx-autobuild --port 0 resonant_docs build"
 
 [build-system]
 requires = ["poetry-core>=1.0.0"]