Découvrir Lisible
Introduction
Comprendre Lisible, sa structure et le parcours recommandé avant de créer votre premier site.
Lisible est un framework de blog statique construit avec Astro. Il réunit un cœur fonctionnel audité, six expériences visuelles interchangeables et une chaîne éditoriale bilingue. Le contenu reste unique : changer de variante ne duplique ni les articles ni la configuration.
Ce que Lisible fournit
- un rendu statique avec très peu de JavaScript côté lecteur ;
- six variantes visuelles partageant les mêmes contrats ;
- des contenus MDX par défaut en français et en anglais, avec tout Markdown inclus ;
- Pagefind, RSS, sitemap, OpenGraph, JSON-LD et exports texte ;
- des callouts, formules KaTeX, diagrammes Mermaid et draw.io en plein écran ;
- des arborescences, onglets, étapes et spoilers interactifs en MDX ;
- les tags, archives, séries, brouillons, couvertures et articles épinglés ;
- une navigation sans rechargement grâce aux transitions Astro ;
- un previewer en direct partageable et synchronisé sur un commit source exact ;
- des garde-fous qualité : contrôles de liens et d’assets, tests unitaires et de bout en bout, conformité inter-variantes.
Modèle mental
flowchart LR C["Contenu partagé\nMDX par défaut"] --> A["Collection Astro"] S["Configuration\nsite + features"] --> V["Variante active"] A --> V V --> H["HTML statique"] V --> I["Îlots interactifs"] H --> D["dist/"] I --> D
Le dossier shared/ possède les données communes. Le dossier versions/<variante>/ possède le rendu. Les scripts racine choisissent la variante puis délèguent dev, build et preview au bon paquet.
Parcours recommandé
- Explorez le preview en direct pour comparer variantes et réglages.
- Lisez Architecture pour savoir où placer chaque changement.
- Suivez Installation et Configuration.
- Consultez Contenu, Markdown et MDX avant de publier.
- Activez ou désactivez les capacités dans
lisible.config.json. - Terminez par Qualité, Build et déploiement, puis Dépannage.
Périmètre
Lisible privilégie une édition Git simple. Il ne fournit pas de CMS, d’analytics ou de service d’email. Ces choix réduisent le coût initial et la surface de maintenance, tout en laissant la possibilité d’ajouter des intégrations au besoin.
Documentation maintenue avec LisibleModifier cette page ↗