Skip to content

site: the version badge renders again; the content sweep - #19

Merged
ronaldtse merged 2 commits into
mainfrom
site/fix-all-sweep
Oct 24, 2026
Merged

ronaldtse merged 2 commits into
mainfrom
site/fix-all-sweep

Conversation

@ronaldtse

Copy link
Copy Markdown
Contributor

Full-site sweep after the specs fix — everything else broken or stale:

  • The VersionBadge was lost in the Astro cutover: the library and
    about pages imported a Vue component from the archived VitePress
    theme through a script-setup block Astro does not process, so the
    import rendered as raw text and no badge ever appeared.
    fetch-api-reference.mjs now also fetches the pubid gem's version
    from main into src/data/pubid-version.json;
    src/components/VersionBadge.astro renders it at build time; the
    library index converts to MDX to host it; the about page links the
    generated API reference instead (its long raw-HTML body is not
    JSX-safe for MDX).
  • The specs index loses its empty VitePress script block.
  • The URN spec tables (both ISO and IEC) resynced from
    docs: fix the URN spec tables asciidoctor drops cells from pubid#589 — the ISO spec's wrapped table cells now render
    complete and the IEC spec converts with zero asciidoctor errors
    (the unescaped || cells were splitting into phantom cells).
  • The prebuild-generated api-reference-*.md pages are gitignored
    (written by the prebuild at deploy time).

Verified in the build: /library carries the v2.0.0.pre.alpha.53
badge, both spec pages render cell-complete with zero asciidoctor
errors, and no VitePress remnants remain anywhere in src/.

The VersionBadge was lost in the Astro cutover: the library and about
pages imported a Vue component from the archived VitePress theme
through a script-setup block Astro does not process, so the import
rendered as raw text and no badge ever appeared.

- fetch-api-reference.mjs also fetches the pubid gem's version from
  main into src/data/pubid-version.json;
- src/components/VersionBadge.astro renders it at build time; the
  library index converts to MDX to host it; the about page links the
  generated API reference instead (its long raw-HTML body is not
  JSX-safe for MDX);
- the specs index loses its empty VitePress script block;
- the api-reference generated pages are gitignored (written by the
  prebuild at deploy time).
@ronaldtse
ronaldtse merged commit 5916f27 into main Oct 24, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant