Conversation
The Astro/Starlight site is gone; docs/ is a Hugo site with choudoufu's
templates (site/layouts, site.css) and the same shape: a landing page
whose three beats are the what-it-enables pages' own front matter, a
header menu of consumers rendered from data/consumers.yaml, and a proof
strip whose figures come from data/figures.json. Pages quote a figure
with {{< figure "corpus.comparable" >}}, which fails the build on a bad
path rather than rendering nothing.
Sections: what-it-enables, try-it, for-your-platform (hub plus a page per
consumer) and spec, which holds introduction, the generated normative
text, reference, conformance and evidence. Every old URL is an alias.
sync-spec.mjs writes content/spec/normative/ and resolves the spec files'
./x.md links to site paths. The prose linter reads the Hugo content tree,
skips the generated pages, and treats a shortcode as a number.
CI builds with peaceiris/actions-hugo; just site and just site-serve are
the local entry points. spec/README.md's first line said the
specification was empty; it is not.
10 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The docs site is rebuilt as a Hugo site on choudoufu's layouts and stylesheet (INTENTIUS/choudoufu
site/), replacing Astro/Starlight.what-it-enables/front matter, the same-policy-twice comparison, a consumer picker fromdata/consumers.yaml, a proof strip fromdata/figures.json./).what-it-enables,try-it,for-your-platform,spec(introduction, normative, reference, conformance, evidence). Every previous URL is an alias.{{< figure "path" >}}quotes a figure and fails the build on a bad path;{{< consumers >}}renders the table; fences take{title="file"}and show it as a caption.sync-spec.mjswritescontent/spec/normative/, resolves./x.mdlinks, and points./VERSIONat GitHub. Linter roots follow; the generated pages are skipped.peaceiris/actions-hugoat0.162.1;just siteandjust site-serve [port]locally (needsbrew install hugo).