docs: automated documentation pipeline (per-symbol source → pages)
Some checks failed
docs / build-and-deploy (push) Failing after 38s
Some checks failed
docs / build-and-deploy (push) Failing after 38s
Replace the hardcoded landing page and minimal reference with a generated documentation site driven by a single source of truth. - docs/language/**: one file per symbol (93 keywords/types/builtins/namespace methods/operators/annotations), each with front-matter (id, kind, tokens, sig, tip) + description + a ```ludic example. Seeded by exploding the former inline SECTIONS list; these files are now the source of truth. - docs/site/: site.json (editable hero/features/showcase/messaging, not hardcoded) + snippets/*.ludic (real programs shown on the landing page). - tools/docgen/gen.py: generates index.html, api.html, ludic-highlight.js and symbols.json. The highlighter's symbol tables, hover tips and jump anchors are GENERATED from the per-symbol files — add a symbol and it is recognized, tipped and linked in every snippet automatically. Python stdlib only. - tools/docgen/check.py: verifies the pages contract + that no snippet token links to a missing reference anchor. - .forgejo/workflows/docs.yml: rebuilds and publishes to the pages branch on every push to main touching the docs sources. Consumes the new Screen.*/Color.*/named-arg API and the 221-color palette. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
parent
a3a1e4d160
commit
51ddfa3ce9
121 changed files with 3827 additions and 0 deletions
20
docs/site/snippets/lifecycle.ludic
Normal file
20
docs/site/snippets/lifecycle.ludic
Normal file
|
|
@ -0,0 +1,20 @@
|
|||
program Toggles {
|
||||
property Health { hp: int = 0, max: int = 100 }
|
||||
property Shield { amount: int = 0 }
|
||||
model Player { Health, Shield }
|
||||
|
||||
# hooks fire at the toggle point, data bound by name
|
||||
@OnDisable(Shield) handler Down { print(Shield.amount + 1) }
|
||||
@OnEnable(Shield) handler Up { print(Shield.amount + 2) }
|
||||
|
||||
handler Seed phase Start {
|
||||
spawn Player { Health { max: 50 }, Shield { amount: 5 } }
|
||||
}
|
||||
|
||||
handler Run phase Render {
|
||||
for (e) in query [Player] { disable Shield on self() } # @OnDisable
|
||||
for (e) in query [Player] { enable Shield on self() } # @OnEnable, data intact
|
||||
disable Player # whole model off
|
||||
quit()
|
||||
}
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue