Migrate website to Zensical

.github/workflows/ci.yml

@@ -6,12 +6,11 @@ jobs:
     test:
         runs-on: ubuntu-latest
         steps:
-            - uses: actions/checkout@v4
             - uses: actions/checkout@v4
             - uses: astral-sh/setup-uv@v4
               with:
                   version: "latest"
-            - run: uv run mkdocs build --strict
+            - run: uv run zensical build --clean
             - uses: actions/upload-artifact@v4
               with:
                   name: Website

.github/workflows/gh-pages.yml

@@ -1,31 +1,27 @@
 name: Deploy GitHub Pages
-
 on:
     push:
         branches:
             - main
-
 permissions:
-    contents: write
-
+    contents: read
+    pages: write
+    id-token: write
 jobs:
     deploy:
+        environment:
+            name: github-pages
+            url: ${{ steps.deployment.outputs.page_url }}
         runs-on: ubuntu-latest
         steps:
-            - uses: actions/checkout@v4
-            - name: Configure Git Credentials
-              run: |
-                  git config user.name github-actions[bot]
-                  git config user.email 41898282+github-actions[bot]@users.noreply.github.com
-            - uses: actions/checkout@v4
+            - uses: actions/configure-pages@v5
+            - uses: actions/checkout@v5
             - uses: astral-sh/setup-uv@v4
               with:
                   version: "latest"
-            - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
-            - uses: actions/cache@v4
+            - run: zensical build --clean
+            - uses: actions/upload-pages-artifact@v4
               with:
-                  key: mkdocs-material-${{ env.cache_id }}
-                  path: .cache
-                  restore-keys: |
-                      mkdocs-material-
-            - run: uv run mkdocs gh-deploy --force
+                  path: site
+            - uses: actions/deploy-pages@v4
+              id: deployment

.pre-commit-config.yaml

@@ -5,7 +5,6 @@ repos:
           - id: trailing-whitespace
           - id: end-of-file-fixer
           - id: check-yaml
-            exclude: "^mkdocs.*"
           - id: check-ast
           - id: check-json
             types: [text]

README.md

@@ -4,9 +4,10 @@
 
 ## Building this website locally
 
-This website codebase uses `uv` and `mkdocs`. To get started (assuming you have `uv` installed):
+This website codebase uses `uv` and `zensical`. To get started (assuming you have `uv` installed):
 
 - clone this repo and `cd` into it
-- run `uv run mkdocs serve` to set up the environment and run the development server
+- run `uv run zensical serve` to set up the environment and run the development server
+- run `uv run zensical build` to build the site for production
 
 This project also uses `pre-commit` which you can optionally run locally (though not required as it's run in the cloud anyway).

docs/contributing.md

@@ -10,8 +10,8 @@ Here the process of creating a talk is detailed - from the talk's inception to t
 
 Do you have a step in your software workflow that could be improved with the right tool? Or maybe you often find yourself thinking, "There has to be a better way to do this!" If so, share your thoughts by opening an issue on GitHub or posting in Teams (or reach out directly to the Python for Lunch organiser). Describe your workflow, the challenges you’re facing, and any ideas you have - we’d love to discuss and explore potential solutions!
 
-[Post a GitHub issue]({{ repo_url }}/issues/new/choose){ .md-button target="\_blank" }
-[Discuss in Teams]({{ teams_url }}){ .md-button target="\_blank" }
+[Post a GitHub issue](https://github.com/UU-IMAU/python-for-lunch/issues/new/choose){ .md-button target="\_blank" }
+[Discuss in Teams](https://teams.microsoft.com/l/channel/19%3A11ca5db51d9541e8be4f9714b4fd26e1%40thread.tacv2/Python%20for%20Lunch?groupId=d0097cb1-d2f5-432f-aa73-532bd153058f&tenantId=d72758a0-a446-4e0f-a0aa-4bf95a4a10e7){ .md-button target="\_blank" }
 
 ## Writing and giving the talk
 

docs/index.md

@@ -12,7 +12,7 @@ As part of this refresh, we have this website! Join our mailing list to stay inf
 
 [![Solarpunk lunch](https://media2.giphy.com/media/v1.Y2lkPTc5MGI3NjExMDhkZWhxaHdyNm85dTVuZmNqODVsbHQxbjZmbWp6OWJudzdyMDY2aSZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/u5j0JHGEEOgidHTWgH/giphy.gif)](https://giphy.com/gifs/theline-thelineanimation-solarpunk-dear-alice-r3lL7v9H2aWhfD0IFs)
 
-[Join the mailing list!]({{ mailinglist_url }}){ .md-button target="\_blank" }
+[Join the mailing list!](https://edu.nl/ydfu8){ .md-button target="\_blank" }
 [Go to talks](./talks/index.md){ .md-button }
 
 Head across to the talks page to see prior and upcoming talks, or go to the "Python for Lunch" channel in the IMAU team on Microsoft Teams for more discussion!

pyproject.toml

@@ -5,10 +5,7 @@ description = "Python for lunch"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
-    "mkdocs-macros-plugin>=1.3.7",
-    "mkdocs>=1.6.1",
-    "mkdocs-jupyter>=0.25.1",
-    "mkdocs-material>=9.5.50",
+    "zensical>=0.0.29",
 ]
 
 [tool.ruff]