Quick Start

Build a site

git clone https://github.com/celestia-island/lagrange
cd lagrange
cargo run --release -- build --src docs --out target/site

Open target/site/index.html — it redirects to the English book.

Live hikari components

Code blocks tagged hikari are compiled and rendered at build time. The resulting HTML is shown in a preview pane with a toggle to view the source.

rsx! {
    div {
        class: "demo-greeting",
        style: "padding:1rem;border:1px solid #ccc;border-radius:8px;text-align:center;",
        h2 { "Hello from hikari!" }
        p { "This component was compiled at build time and rendered to static HTML." }
    }
}

Directory layout

docs/
├── logo.webp            # shared assets live at the docs root
├── en/
│   ├── README.md        # -> ../../README.md (the repo landing page)
│   ├── SUMMARY.md       # drives the sidebar
│   └── guides/*.md
├── zh-Hans/
│   ├── README.md        # one translated landing page per language
│   └── ...

Each subdirectory of docs/ is one language. SUMMARY.md drives the sidebar. README.md and index.md both map to index.html; symlinking docs/en/README.md to the root README.md keeps GitHub and the docs site in sync.

Markdown support

Headings, paragraphs, fenced code, lists, blockquotes, tables, thematic breaks, images, inline code, bold, italic, links, and raw HTML blocks (so a centred <p align="center">…</p> in a README passes through untouched).

Blockquotes are supported too.

Deploying

The build emits a static directory — see the root README for GitHub Pages, Cloudflare Pages and Vercel recipes.