Discover Lisible
Introduction
Understand Lisible, its structure and the recommended path before creating your first site.
Lisible is a static blog framework built with Astro. It combines one audited functional core, six interchangeable visual experiences and a bilingual editorial pipeline. Content stays unique: switching variants never duplicates posts or configuration.
What Lisible provides
- static output with very little reader-side JavaScript;
- six visual variants that share the same contracts;
- French and English MDX content by default, including all Markdown features;
- Pagefind, RSS, sitemap, OpenGraph, JSON-LD and text exports;
- callouts, KaTeX formulas, full-screen Mermaid and draw.io diagrams;
- interactive file trees, tabs, steps and spoilers in MDX;
- tags, archives, series, drafts, covers and pinned posts;
- reload-free navigation with Astro transitions;
- a shareable live previewer synchronized to an exact source commit;
- quality gates: link and asset checks, unit and end-to-end tests, cross-variant conformance.
Mental model
flowchart LR C["Shared content\nMDX by default"] --> A["Astro collection"] S["Configuration\nsite + features"] --> V["Active variant"] A --> V V --> H["Static HTML"] V --> I["Interactive islands"] H --> D["dist/"] I --> D
The shared/ directory owns common data. The versions/<variant>/ directory owns presentation. Root scripts select the variant, then delegate dev, build and preview to the matching package.
Recommended path
- Explore the live preview to compare variants and settings.
- Read Architecture to learn where each change belongs.
- Follow Installation and Configuration.
- Review Content, Markdown and MDX before publishing.
- Enable or disable capabilities in
lisible.config.json. - Finish with Quality, Build and deployment, then Troubleshooting.
Scope
Lisible favors simple Git-based authoring. It does not ship a CMS, analytics or an email service. Those choices reduce initial cost and maintenance surface while keeping integrations possible when needed.
Documentation maintained with LisibleEdit this page ↗