docs(antora): consolidate docs image to offline "markup-antora" build#781
Merged
Conversation
Replace the per-repo Antora docs image with the consolidated "markup-antora" definition (one image shared across the SKaiNET docs projects, vendored here until the public registry image is published). Features of the merged image: - Offline Mermaid: every [mermaid] block is rendered to inline SVG at build time by mermaid-cli (Alpine Chromium + Puppeteer) via the baked local-mermaid-extension.js block processor. No Kroki, no kroki.io, no network at build or view time. - Diagram caching: content-hash, in-memory + optional on-disk (MERMAID_CACHE_DIR); identical diagrams render once. - Rootless-safe under --user $(id -u):$(id -g) (HOME=/tmp + cleanup of root-owned /tmp dirs; fixes Chromium crashpad / cosmiconfig EACCES). - Build-time mermaid smoke test (a broken image fails docker build). - Offline extras available: @antora/lunr-extension, pre-baked Antora UI bundle, MathJax es5; asciidoctor-kroki kept as an escape hatch. - Full Alpine font set for diagram labels, emoji and CJK. local-mermaid-extension.js now dedupes identical diagrams via a content-hash cache. puppeteer-config.json is a real file (was echoed inline). CI is unchanged: docs.yml already builds from docs/.docker. Usage and details: see docs/.docker/README.md. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
📖 Documentation Preview The documentation has been built successfully for this PR. Generated Files:
Artifacts:
This comment will be updated automatically when the PR is updated. |
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.
Replace the per-repo Antora docs image with the consolidated "markup-antora" definition (one image shared across the SKaiNET docs projects, vendored here until the public registry image is published).
Features of the merged image:
local-mermaid-extension.js now dedupes identical diagrams via a content-hash cache. puppeteer-config.json is a real file (was echoed inline). CI is unchanged: docs.yml already builds from docs/.docker.
Usage and details: see docs/.docker/README.md.