Une documentation restructurée
La documentation a été restructurée : les longues pages uniques (certaines dépassaient 1 500 lignes !) ont été découpées en sections composées de pages plus courtes et ciblées.
Cette restructuration a été rendue possible par la gestion des sections imbriquées introduite dans Cecil 9 : tout dossier contenant un fichier index.md devient une sous-section de sa section parente, avec ses propres pages, l’héritage des layouts et un fil d’Ariane. Ce site étant créé avec Cecil, la documentation est la première à en profiter !
Nouvelle structure
La documentation est désormais organisée en 8 sections :
- Bien démarrer : démarrage rapide, installation, structure des répertoires et kits de démarrage
- Contenu : pages, front matter, Markdown, contenu multilingue et dynamique
- Templates : règles de résolution, variables, composants, localisation, cache, extension, et une référence des fonctions et filtres
- Assets : images, traitement et fournisseurs CDN (une toute nouvelle section, auparavant intégrée aux Templates)
- Configuration : une page par sujet de configuration (site, langues, pages, assets, sortie, cache, serveur, etc.)
- Commandes :
new:site,new:page,serve,buildetdoctor - Déployer : plateformes Jamstack, déploiement continu et hébergement statique
- Développeurs : étendre Cecil, l’utiliser comme bibliothèque et comprendre son architecture
Une navigation simplifiée
- Une arborescence de navigation dans la barre latérale indique où vous vous trouvez et permet de déplier chaque section.
- La page d’accueil de chaque section liste ses pages avec une courte description.
- La recherche indexe désormais chaque page et son introduction : les résultats pointent directement vers le bon sujet.
La documentation est disponible en anglais et en français. Si vous repérez une erreur ou un oubli, utilisez le lien « Suggérer une modification » en bas de chaque page.