mirror of
https://github.com/boostorg/boostlook.git
synced 2026-02-26 04:32:18 +00:00
ddd6c64d37
Update grey scale, blue, orange, and accent primitives to match Figma variable exports. Remap light and dark theme semantic tokens for text, buttons, surfaces, and icons. Add stroke-strong and stroke-mid tokens. Flatten dark mode accent surfaces to grey. Preview landing page: add standalone docs note, fix theme toggle icons to match Antora.
Preview Site
Local preview of Boost documentation with boostlook-v3 CSS applied. Deployed to boostlook-v3.netlify.app.
Prerequisites
- Node.js 16+ (for Antora)
- asciidoctor (
brew install asciidoctor) - b2 (from the Boost superproject)
- Python 3 (for local server)
Sibling repos expected at:
~/dev/website-v2-docs # Antora site & library docs
~/boost # Boost superproject (for b2/charconv)
~/user-config.jam must contain:
using asciidoctor ;
Building
Full build
Builds everything (Antora lib docs, site docs, charconv via b2), syncs into preview/, swaps in boostlook-v3.css, and starts a local server:
./build-preview.sh
CSS only
Edit CSS in src/css/, then rebuild and swap without re-running Antora/b2:
./build-preview.sh --css-only
Serve only
Start the local server without rebuilding anything:
./build-preview.sh --serve
Structure
preview/
index.html Landing page
style-guide/ Design tokens (colors, typography, spacing)
capy/ Boost.Capy library docs (Antora)
charconv/ Boost.Charconv library docs (Asciidoctor + b2)
user-guide/ Site docs (Antora)
contributor-guide/ Site docs (Antora)
formal-reviews/ Site docs (Antora)
_/ Shared assets (fonts, JS, images, CSS)
How it works
build-css.shconcatenatessrc/css/*.cssintoboostlook-v3.css- Antora builds capy + site docs from
website-v2-docsinto itsbuild/dir - b2 builds charconv HTML from
~/boost/libs/charconv/doc/, usingboostlook-v3.cssswapped into~/boost/tools/boostlook/boostlook.css rsynccopies built output intopreview/boostlook-v3.cssreplacespreview/_/css/boostlook.cssfor Antora pages
Netlify
Netlify deploys from preview/ on push. The build command in netlify.toml only does the CSS swap (Antora/b2 builds are done locally and committed).