chore: migrate to Zensical static site generator (#744)

Author: HonkingGoose

.github/contributing.md

@@ -2,10 +2,10 @@
 
 Your feedback and pull requests are very welcome!
 
-We use MkDocs + Material for MkDocs to build the website.
+We use [Zensical](https://zensical.org/) to build the website.
 
-If you find a typo or other small textual error on a published page, select the "Edit this page" link at the bottom of the affected page.
-This link will take you to the right file on GitHub to make the edit and open a pull request.
+If you find a typo or other small textual error on a published page, select the "Edit this page" button near the top right of the page.
+This button takes you to the right file on GitHub to make the edit and open a pull request.
 
 For larger edits we recommend that you create a development environment, so that you can preview your work.
 
@@ -25,25 +25,25 @@ To build the site locally on your workstation you'll need:
 
 Follow these steps to setup your local development environment:
 
-1. Install the latest version of Python 3.8
-1. Install Node 24 (npm 11 is bundled with Node 24)
-1. Install Git, if you haven't already
-1. Make a fork of this repository via GitHub (select the "Fork" button)
-1. Clone your fork repository with `git clone link_to_fork`
-1. Tell Git that `HonkingGoose/git-gosling` is the `upstream` remote: `git remote add upstream https://github.com/HonkingGoose/git-gosling.git`
-1. Make sure you have all the data from the `upstream` remote by doing a `git fetch --all --prune`
-1. Do `git merge upstream/main main` to update your local `main` branch
-1. Make you're sure on the local main branch with `git switch main` (do not make your own commits on the local `main` branch!)
-1. Create a new branch to do your work on with `git switch -c descriptive_name_for_branch`
-1. Run `npm ci` to download and install all the dependencies for this project with npm
-1. Run `make smoketest` to ensure everything works before you start your work
-1. You can get a live preview with `make serve`, this starts a local development server and opens a browser window, most changes can be seen live without having to restart the server
-1. Make your changes
-1. When you're done, run the Prettier formatter with `npm run prettier-fix`
-1. Use the `git add` command to stage your work and commit with `git commit -v`
-1. Run the smoketest with `make smoketest`
-1. Push your local feature branch to your GitHub fork with `git push --set-upstream origin descriptive_name_for_branch`
-1. Open a pull request by going to this projects repository and going to the "Pull requests" tab
-1. GitHub will show your recently pushed branches here, and suggest you make a pull request, if your branch does not show up, select the "New pull request" button
+1. Install the latest version of Python `3.8`.
+1. Install Node 24 (npm 11 is bundled with Node 24).
+1. Install Git, if you haven't already.
+1. Make a fork of this repository via GitHub (select the "Fork" button).
+1. Clone your fork repository with `git clone link_to_fork`.
+1. Tell Git that `HonkingGoose/git-gosling` is the `upstream` remote: `git remote add upstream https://github.com/HonkingGoose/git-gosling.git`.
+1. Make sure you have all the data from the `upstream` remote by doing a `git fetch --all --prune`.
+1. Do `git merge upstream/main main` to update your local `main` branch.
+1. Make you're sure on the local main branch with `git switch main` (do not make your own commits on the local `main` branch!).
+1. Create a new branch to do your work on with `git switch -c descriptive_name_for_branch`.
+1. Run `npm ci` to download and install all the dependencies for this project with npm.
+1. Run `make smoketest` to ensure everything works before you start your work.
+1. You can get a live preview with `make serve`, this starts a local development server and opens a browser window. Most changes can be seen live without having to restart the server.
+1. Make your changes.
+1. When you're done, run the Prettier formatter with `npm run prettier-fix`.
+1. Use the `git add` command to stage your work and commit with `git commit -v`.
+1. Run the smoketest with `make smoketest`.
+1. Push your local feature branch to your GitHub fork with `git push --set-upstream origin descriptive_name_for_branch`.
+1. Open a pull request by going to this projects repository and going to the "Pull requests" tab.
+1. GitHub will show your recently pushed branches here, and suggest you make a pull request, if your branch does not show up, select the "New pull request" button.
 1. Your pull request will get reviewed, and if the maintainers like it, it will get merged.
-1. After your pull request is merged, you can remove your local branch with `git branch -D branch_name`
+1. After your pull request is merged, you can remove your local branch with `git branch -D branch_name`.

Makefile

@@ -8,11 +8,11 @@ prepare:
 	npm run prepare
 
 build:
-	mkdocs build --strict
+	zensical build --strict
 
 serve:
-	mkdocs serve
+	zensical serve
 
 smoketest:
-	mkdocs build --strict
+	zensical build --strict
 	npm run prettier

includes/abbreviations.md

@@ -1,5 +1,5 @@
 <!-- This file lists all abbreviations in the guide. -->
-<!-- https://squidfunk.github.io/mkdocs-material/reference/tooltips/?h=abbre#adding-abbreviations -->
+<!-- https://zensical.org/docs/setup/extensions/python-markdown/#abbreviations -->
 <!-- Keep this list sorted from A-Z. -->
 
 *[2FA]: Two-factor authentication

mkdocs.yml

@@ -39,25 +39,24 @@ theme:
     - navigation.prune
 
   palette:
+    # Palette toggle for automatic mode
     - media: "(prefers-color-scheme)"
       toggle:
-        icon: material/brightness-auto
+        icon: lucide/sun-moon
         name: Switch to light mode
 
+    # Palette toggle for light mode
     - media: "(prefers-color-scheme: light)"
       scheme: default
-      primary: indigo
-      accent: indigo
       toggle:
-        icon: material/weather-night
+        icon: lucide/sun
         name: Switch to dark mode
 
+    # Palette toggle for dark mode
     - media: "(prefers-color-scheme: dark)"
       scheme: slate
-      primary: light blue
-      accent: light blue
       toggle:
-        icon: material/weather-sunny
+        icon: lucide/moon
         name: Switch to system preference
 
 markdown_extensions:

requirements.txt

@@ -1 +1 @@
-mkdocs-material==9.7.0
+zensical==0.0.6