claude
f0cb2382c8
- tools/build_wiki.py: host-agnostic generator — renders modules/** + capstone into wiki pages with a unit-by-unit _Sidebar, a Home TOC, and a _Footer; rewrites lab/ and repo-root links to absolute repo URLs (labs stay in the repo, linked not copied). Single source of truth stays in modules/. - .gitea/workflows/sync-wiki.yml + .github/workflows/sync-wiki.yml: sync the wiki on every push to main touching modules/**, capstone/**, README, or the generator. Documented prerequisites: an Actions runner + a WIKI_TOKEN secret (+ GitHub wiki must be initialized once). - tools/README.md: how to run the sync manually and via CI. - README: "Read it as a book" pointer to the wiki. The Gitea wiki has already been populated with the initial render. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TfzV5QvtPDz8LJS3Pu5VLT
52 lines
1.8 KiB
YAML
52 lines
1.8 KiB
YAML
# Render the course (single source of truth = modules/) into the Gitea wiki on
|
|
# every push to main. The wiki is generated BUILD OUTPUT — never hand-edit it.
|
|
#
|
|
# Prerequisites (one-time):
|
|
# 1. An Actions runner is attached to this repo/org (Settings -> Actions -> Runners).
|
|
# 2. A repo secret WIKI_TOKEN holds a token with write access to the wiki
|
|
# (a PAT/deploy token scoped to repository write is enough — NOT a site-admin token).
|
|
# 3. The wiki is initialized (it is — created with a Home page).
|
|
name: Sync course wiki
|
|
on:
|
|
push:
|
|
branches: [main]
|
|
paths:
|
|
- 'modules/**'
|
|
- 'capstone/**'
|
|
- 'README.md'
|
|
- 'tools/build_wiki.py'
|
|
- '.gitea/workflows/sync-wiki.yml'
|
|
workflow_dispatch: {}
|
|
|
|
jobs:
|
|
sync-wiki:
|
|
runs-on: ubuntu-latest
|
|
steps:
|
|
- uses: actions/checkout@v7
|
|
- uses: actions/setup-python@v6
|
|
with:
|
|
python-version: '3.x'
|
|
- name: Render and push the wiki
|
|
shell: bash
|
|
env:
|
|
WIKI_TOKEN: ${{ secrets.WIKI_TOKEN }}
|
|
run: |
|
|
set -euo pipefail
|
|
if [ -z "${WIKI_TOKEN:-}" ]; then
|
|
echo "::error::WIKI_TOKEN secret is not set — see this workflow's header."
|
|
exit 1
|
|
fi
|
|
base="git.jpaul.io/justin/ai-workflow-course"
|
|
git clone "https://claude:${WIKI_TOKEN}@${base}.wiki.git" wiki
|
|
python3 tools/build_wiki.py --repo-root . --out wiki \
|
|
--web-base "https://${base}" --branch main --host gitea
|
|
cd wiki
|
|
git config user.name "claude"
|
|
git config user.email "claude@jpaul.io"
|
|
git add -A
|
|
if git diff --cached --quiet; then
|
|
echo "wiki already up to date"; exit 0
|
|
fi
|
|
git commit -m "docs(wiki): sync from modules/ @ $(echo "$GITHUB_SHA" | cut -c1-8)"
|
|
git push origin HEAD
|