fission-shell-site
Static site shell for Fission applications and documentation sites.
fission-shell-site lowers real Fission widget trees and Markdown/MDX content routes into static HTML, CSS, and search metadata. It powers the Fission documentation site itself. Application developers normally use it through the fission facade with the site feature and through the fission site command:
[dependencies]
fission = { version = "0.14.1", features = ["site"] }
fission site serve --project-dir documentation
fission site build --project-dir documentation --release
What it contains
A static-site app model with custom widget routes and content routes.
Markdown/MDX content loading with page metadata, sidebars, table-of-contents links, and templates.
HTML generation from Fission nodes, plus generated CSS derived from widget styles and design-system values.
Optional code highlighting, client-side search index generation, favicons, sitemap, robots output, canonical URLs, JSON-LD, and route-filtered page element injection.
Link checking and production build validation used by fission site check.
Shared document configuration with SSR for design systems, packaged fonts,
themes, favicons, syntax highlighting, CSS, and route-filtered page elements.
Static routes can also select locales and metadata at build time, load route
state from SiteRenderContext, attach JSON-LD, and append a retained Fission
footer across the site.
Design notes
This is a shell, not a separate website framework. Custom pages are written as normal Fission widgets. Content pages are rendered through Fission templates. The static shell visits the resulting Fission node tree and emits semantic HTML instead of opening an OS window or canvas.
Site-specific semantic regions can select native HTML landmarks and anchors
without changing how the same widget tree renders in native shells:
| |
|---|
| |
| |
| |
| |
| |
| An ordinary <a href="#details"> |
| |
| |
site-heading-1:top through site-heading-6:* | The matching heading with an id |
Use these identifiers on SemanticsRegion widgets only when the region has
the corresponding document meaning. Other shells continue to consume the
ordinary Fission semantics and layout nodes.
Documentation
See the static site guide at fission.rs. The source for the live documentation site is in the repository documentation project. License
Apache-2.0