update doc build tooling to Zensical (#221)

* update doc build tooling to Zensical

* update doc build tooling to Zensical

Author: tomkralidis

.github/workflows/website.yml

@@ -5,22 +5,34 @@ on:
     paths:
     - 'web/**'
 
-defaults:
-  run:
-    working-directory: web
-
 jobs:
   build:
     name: Build and Deploy Website
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-python@v2
+      - uses: actions/checkout@master
+      - uses: actions/setup-python@v6
         with:
           python-version: '3.x'
       - name: Install requirements 📦
         run: |
           python -m pip install --upgrade pip
-          pip install -r requirements.txt
-      - name: Deploy 📦
-        run: mkdocs gh-deploy --strict --force --message 'update website via GitHub Actions'
+          pip3 install -r web/requirements.txt
+      - name: Build site 📦
+        run: |
+          cd web && zensical build --clean --strict
+          mv site /tmp/
+      - name: checkout gh-pages branch
+        uses: actions/checkout@master
+        with:
+          ref: gh-pages
+      - name: Deploy to GitHub Pages 📦
+        run: |
+          git checkout gh-pages
+          git config --global user.email "tomkralidis@gmail.com"
+          git config --global user.name "Tom Kralidis"
+          ls | grep -v ".nojekyll"| xargs rm -fr
+          mv -f /tmp/site/* .
+          git add .
+          git commit -am "update website via GitHub Actions"
+          git push

web/README.md

@@ -1,7 +1,7 @@
 # Workshop website
 
 This [workshop](https://geopython.github.io/geopython-workshop) is powered
-by [MkDocs](https://www.mkdocs.org) which facilitates easy management
+by [Zensical](https://zensical.org) which facilitates easy management
 of website content and publishing.
 
 ## Setting up the website environment locally
@@ -16,9 +16,9 @@ cd geopython-workshop/web
 # install required dependencies
 pip install -r requirements.txt
 # build the website
-mkdocs build
+zensical build --clean --strict
 # serve locally
-mkdocs serve  # website is made available on http://localhost:8000/
+zensical serve  # website is made available on http://localhost:8000/
 ```
 
 ## Content management workflow
@@ -35,10 +35,10 @@ The basic workflow is as follows:
 
 ```bash
 vi docs/new-page.md  # add content
-vi mkdocs.yml  # add to navigation section
+vi zensical.toml  # add to navigation section
 # edit any other files necessary which may want to link to the new page
 git add docs/new-page.md
-git commit -m 'add new page on topic x' docs/new-page.md mkdocs.yml
+git commit -m 'add new page on topic x' docs/new-page.md zensical.toml
 git push origin master
 ```
 
@@ -48,11 +48,4 @@ Like adding a page. Edit and commit/push.
 
 ## Publishing updates to the live site
 
-Updates are automatically pushed to GitHub Pages.  To publish updates
-manually:
-
-```bash
-# NOTE: you require access privileges to the GitHub repository
-# to publish live updates
-mkdocs gh-deploy -m 'add new page on topic x'
-```
+Updates are automatically pushed to GitHub Pages.