Skip to content

Commit 2c7f4da

Browse files
committed
Deploy Astro to Pages; retire MkDocs
- docs.yml now builds the Astro/Starlight site (uv installs lokf for the prebuild data steps: lokf export + gen_api_docs; Node builds web/) and deploys web/dist to Pages - remove MkDocs: mkdocs.yml, docs/ (source + hook + vendored cytoscape), the [dependency-groups] docs, the sync-cytoscape recipe; justfile docs/docs-build now drive the Astro site - carry the JSON-LD XSS escaping into web Head.astro (was in the MkDocs hook); drop the obsolete test_hooks.py / test_vendored.py guards - uv.lock relocked without the mkdocs deps 117 tests pass; uv sync --locked + both prebuild scripts work; astro build green with escaped Dataset JSON-LD.
1 parent 2c95759 commit 2c7f4da

31 files changed

Lines changed: 30 additions & 2566 deletions

.github/workflows/docs.yml

Lines changed: 16 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -19,21 +19,30 @@ jobs:
1919
contents: read
2020
steps:
2121
- uses: actions/checkout@v4
22-
with:
23-
fetch-depth: 0 # full history for git-revision-date-localized
2422

23+
# uv drives the prebuild data steps (lokf export, gen_api_docs); Node
24+
# builds the Astro/Starlight site.
2525
- uses: astral-sh/setup-uv@v5
2626
with:
2727
enable-cache: true
28+
- uses: actions/setup-node@v4
29+
with:
30+
node-version: 22
31+
cache: npm
32+
cache-dependency-path: web/package-lock.json
33+
34+
- name: Install the lokf package (for the prebuild data steps)
35+
run: uv sync --locked
2836

29-
- name: Build site (strict)
30-
# --only-group: the docs build doesn't need the project or its runtime
31-
# deps (mkdocstrings reads src/ statically) — 37 packages instead of 107
32-
run: uv run --locked --only-group docs mkdocs build --strict
37+
- name: Build the Astro site
38+
working-directory: web
39+
run: |
40+
npm ci
41+
npm run build
3342
3443
- uses: actions/upload-pages-artifact@v3
3544
with:
36-
path: site
45+
path: web/dist
3746

3847
deploy:
3948
if: github.event_name == 'push' && github.ref == 'refs/heads/main'

docs/CNAME

Lines changed: 0 additions & 1 deletion
This file was deleted.

docs/assets/js/cytoscape.min.js

Lines changed: 0 additions & 32 deletions
This file was deleted.

docs/examples.md

Lines changed: 0 additions & 69 deletions
This file was deleted.

docs/getting-started.md

Lines changed: 0 additions & 82 deletions
This file was deleted.

0 commit comments

Comments
 (0)