Skip to content

docs: ShellDocs 0.1.18 (colour presets, shelldocs preview) - #2

Merged
Shewart merged 4 commits into
mainfrom
feat/shelldocs-0.1.18
Oct 21, 2026
Merged

Shewart merged 4 commits into
mainfrom
feat/shelldocs-0.1.18

Conversation

@Shewart

@Shewart Shewart commented Oct 21, 2026

Copy link
Copy Markdown
Contributor

Moves the site to ShellDocs 0.1.18-alpha and documents what it added.

  • Bump the four packages and the version strings to 0.1.18-alpha.
  • Colour presets: a Colour presets section on the theming page with a live demo (wwwroot/demos/presets.html in an IframePreview, follows light and dark), o.Theme on the configuration page, --theme on the init page, a note on the tokens page. The "Theme has no effect" text is gone. The site stays on Graphite.
  • New page cli/preview for shelldocs preview, linked from build, deployment, the quick start and the CLI package page.
  • --base-href now fixes root-relative links (build and deployment pages).
  • HTML entities in attribute values are decoded (inline tags page, Card page, agent rules); SearchState, SidebarCollapseState and MobileNavState are removed (search page).
  • Folder meta.json titles now apply, so the sidebar and llms.txt read "CLI" and the breadcrumb root reads "Documentation".

Checked: Release build 0 warnings; dev server: new pages, presets demo in light and dark, search, llms.txt; static export with CLI 0.1.18 served by shelldocs preview: pages, llms files, search and the 404 page.

The four packages and the version strings in the content and README. The home page's terminal replay shows graphite, the theme shelldocs init picks by default since 0.1.18.
ShellDocs 0.1.18 adds seven palettes (o.Theme, init --theme). The theming page gets a Colour presets section with a live demo: wwwroot/demos/presets.html loads tokens.css in an IframePreview and switches presets, since a preset recolours the whole document it is on. The 'Theme has no effect' text goes from theming, configuration and init; the tokens and CLI package pages mention the presets. The site stays on Graphite.
New CLI page for shelldocs preview, linked from build, deployment, the quick start and the CLI package page. The build and deployment pages say --base-href now puts the subpath in front of root-relative links.
Since 0.1.18 HTML entities in component attribute values are decoded, so the inline-tags page, the Card page and the agent rules no longer say they stay literal. The search page says SearchState, SidebarCollapseState and MobileNavState are gone.
@Shewart
Shewart merged commit 86fd854 into main Oct 21, 2026
1 check passed
@Shewart
Shewart deleted the feat/shelldocs-0.1.18 branch October 21, 2026 08:17
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