docs: render icons, repair the companion-adapter card, adopt the house theme - #8
Merged
Conversation
The homepage cards are written with Material's icon shorthand (`:material-graph:`, `:material-memory:` and so on), but `pymdownx.emoji` was never enabled, so nothing resolved them and the published site showed the literal text. Enabling it with Material's twemoji index and SVG generator is the documented requirement for `.icons` shorthand. Verified against a strict build: `:material-` appears zero times in the built index.html, and four inline SVG icons render in the card grid. Four, not five — the compmech-reference-pack card lost its icon and title line when the package was dropped from the public tree, leaving an orphaned body. That is a separate fix. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TcdE6eeSDBh8xrgKCoGrkw
…he site URL Three corrections to the published documentation surface. **The house theme.** Ports the look from dev/demos/02-adaptive-path.html onto Material as docs/stylesheets/akms.css: the light and dark palettes, the 16/20px radii, the 2.5px card borders and the hard offset shadows. The demo scopes its tokens to [data-theme]; Material stamps [data-md-color-scheme], so the palettes are re-scoped and mapped onto Material's own --md-* variables rather than restated as a parallel system. `primary`/`accent` move to `custom` so the stylesheet wins — a named Material colour would override it. Typography is deliberately not a literal port. The demo sets a cursive face for body and monospace text, which costs too much on reference tables, API signatures and code blocks. Baloo 2 carries the identity on headings and the header rule; body and code keep Material's readable defaults. **The companion-adapter card.** docs/index.md carried an orphaned card body — a `---` and a description with no icon or title line — left behind when compmech-reference-pack was dropped from the public tree. It rendered as a detached paragraph inside the grid. Restored as a proper card pointing at the architecture page that documents extension points, worded so it describes the adapter without implying it is installable yet. **The site URL.** site_url was an empty string and repo_url/edit_uri were absent, all three marked "finalized at publication time". They are knowable now, and site_url drives canonical links and the sitemap. Verified on a strict build: five cards render inline SVG icons, zero literal `:material-` remains, the stylesheet is linked and emitted, and the canonical link resolves to https://cemm2.github.io/AKMS/index.html. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TcdE6eeSDBh8xrgKCoGrkw
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.
Three corrections to the published documentation surface.
Icons were printing their own names
The homepage cards use Material's icon shorthand (
:material-graph:,:material-memory:), butpymdownx.emojiwas never enabled, so nothingresolved them and the live site showed the literal text.
The companion-adapter card was structurally broken
docs/index.mdhad an orphaned card body with---and a description withno icon or title line
The house theme
Ports the look from
dev/demos/02-adaptive-path.htmlonto Material asdocs/stylesheets/akms.css(without the Baloo2 font for code and body)Site URL
site_urlwas an empty string andrepo_url/edit_uriwere absent, allmarked "finalized at publication time" : leftover from the private to public transition