# Cecil

> Cecil est une application PHP en ligne de commande qui fusionne des pages Markdown, des médias et des templates Twig afin de générer un site web statique.

- [Actualités](https://cecil-945.pages.dev/fr/actualites.md): Actualités à propos de Cecil.
- [Documentation](https://cecil-945.pages.dev/fr/documentation.md): Documentation du générateur de site statique Cecil.
- [Comment faire ?](https://cecil-945.pages.dev/fr/comment-faire.md): Articles et tutoriels pour réaliser les tâches courantes avec Cecil.
- [Vitrine](https://cecil-945.pages.dev/fr/vitrine/): Sites Web créés avec Cecil.
- [Thèmes](https://cecil-945.pages.dev/fr/themes/): Thèmes prêt à l’emploi pour Cecil.
- [Kits de démarrage](https://cecil-945.pages.dev/fr/kits-de-demarrage/): Cecil fournit des kits de démarrage prêts à l'emploi pour vous aider à créer votre site Web rapidement.
- [Télécharger](https://cecil-945.pages.dev/fr/telecharger.md): Comment télécharger Cecil.

## Documentation

- [Bien démarrer](https://cecil-945.pages.dev/fr/documentation/bien-demarrer.md): Découvrez Cecil, créez votre premier site web en quelques minutes et comprenez l’organisation d’un projet.
  - [Démarrage rapide](https://cecil-945.pages.dev/fr/documentation/bien-demarrer/demarrage-rapide.md): Installez Cecil, créez un site, ajoutez des pages, prévisualisez-le localement, puis générez-le et déployez-le.
  - [Installation](https://cecil-945.pages.dev/fr/documentation/bien-demarrer/installation.md): Prérequis, méthodes d’installation (PHAR, binaire autonome, gestionnaires de paquets, Composer), mise à jour et dépannage.
  - [Structure des dossiers](https://cecil-945.pages.dev/fr/documentation/bien-demarrer/structure-des-dossiers.md): Organisation des fichiers sources, arborescence du site généré et routage des fichiers vers les URL.
  - [Kits de démarrage](https://cecil-945.pages.dev/fr/documentation/bien-demarrer/kits-de-demarrage.md): Démarrez rapidement avec un modèle de projet prêt à l’emploi.
- [Contenu](https://cecil-945.pages.dev/fr/documentation/contenu.md): Créez et organisez votre contenu : pages, front matter, Markdown, contenu multilingue et dynamique.
  - [Pages et sections](https://cecil-945.pages.dev/fr/documentation/contenu/pages.md): Anatomie d’une page, préfixe de fichier, sections, sous-sections et page d’accueil.
  - [Front matter](https://cecil-945.pages.dev/fr/documentation/contenu/front-matter.md): Variables de page personnalisées et prédéfinies : menu, taxonomie, planification, redirection, alias, sortie, etc.
  - [Markdown](https://cecil-945.pages.dev/fr/documentation/contenu/markdown.md): Syntaxe et extensions Markdown : attributs, liens, images, table des matières, notes, coloration syntaxique, etc.
  - [Multilingue](https://cecil-945.pages.dev/fr/documentation/contenu/multilingue.md): Traduisez les pages via le nom de fichier ou le front matter et liez les pages traduites.
  - [Contenu dynamique](https://cecil-945.pages.dev/fr/documentation/contenu/contenu-dynamique.md): Utilisez des variables et expressions Twig dans le contenu des pages.
- [Templates](https://cecil-945.pages.dev/fr/documentation/templates.md): Travaillez avec les layouts, templates et composants Twig.
  - [Organisation et règles de recherche](https://cecil-945.pages.dev/fr/documentation/templates/regles-de-recherche.md): Types de templates, convention de nommage, templates intégrés et choix du template d’une page.
  - [Variables](https://cecil-945.pages.dev/fr/documentation/templates/variables.md): Variables disponibles dans les templates : site, page et cecil.
  - [Composants](https://cecil-945.pages.dev/fr/documentation/templates/composants.md): Créez des composants de template réutilisables.
  - [Localisation](https://cecil-945.pages.dev/fr/documentation/templates/localisation.md): Traduisez les textes et localisez les dates dans les templates.
  - [Cache](https://cecil-945.pages.dev/fr/documentation/templates/cache.md): Cache des templates et cache de fragments.
  - [Étendre](https://cecil-945.pages.dev/fr/documentation/templates/etendre.md): Ajoutez des fonctions et filtres personnalisés, ou utilisez un thème.
  - [Fonctions et filtres](https://cecil-945.pages.dev/fr/documentation/templates/reference.md): Référence des fonctions, tris et filtres Twig fournis par Cecil.
    - [Fonctions](https://cecil-945.pages.dev/fr/documentation/templates/reference/fonctions.md): url, html, readtime, hash, cache_key, getenv, dump, etc.
    - [Tris](https://cecil-945.pages.dev/fr/documentation/templates/reference/tris.md): Triez des collections de pages, menus ou taxonomies.
    - [Filtres](https://cecil-945.pages.dev/fr/documentation/templates/reference/filtres.md): filter_by, markdown_to_html, toc, slugify, excerpt, highlight, preg_*, etc.
- [Assets](https://cecil-945.pages.dev/fr/documentation/assets.md): Manipulez les assets (images, feuilles de style, scripts, etc.) avec la fonction asset() : traitement, optimisation et empreinte.
  - [Images](https://cecil-945.pages.dev/fr/documentation/assets/images.md): Redimensionnez, recadrez et convertissez les images, générez des images responsives et des placeholders.
  - [CSS, JavaScript et traitements](https://cecil-945.pages.dev/fr/documentation/assets/traitements.md): Compilez Sass, minifiez, ajoutez une empreinte, intégrez ou embarquez les assets.
  - [Fournisseurs de CDN](https://cecil-945.pages.dev/fr/documentation/assets/fournisseurs-cdn.md): Exemples de configuration de fournisseurs de CDN d’images (Cloudinary, Cloudimage, TwicPics, imgix, Netlify Image CDN).
- [Configuration](https://cecil-945.pages.dev/fr/documentation/configuration.md): Configurez votre site avec le fichier cecil.yml.
  - [Options du site](https://cecil-945.pages.dev/fr/documentation/configuration/site.md): title, baseurl, menus, taxonomies, theme, date, metatags, debug, etc.
  - [Langues](https://cecil-945.pages.dev/fr/documentation/configuration/langues.md): Langue principale et langues supplémentaires d’un site multilingue.
  - [Codes de locale](https://cecil-945.pages.dev/fr/documentation/configuration/codes-de-locale.md): Liste des codes de locale à utiliser avec l’option languages.
  - [Pages](https://cecil-945.pages.dev/fr/documentation/configuration/pages.md): Dossier des pages, tri, pagination, chemins, corps, pages virtuelles, générateurs, etc.
  - [Données et fichiers statiques](https://cecil-945.pages.dev/fr/documentation/configuration/donnees-et-statiques.md): Options des fichiers de données et des fichiers statiques.
  - [Assets](https://cecil-945.pages.dev/fr/documentation/configuration/assets.md): Dossier des assets, compilation, minification, images et CDN.
  - [Layouts](https://cecil-945.pages.dev/fr/documentation/configuration/layouts.md): Dossier des templates, échappement, images, traductions et composants.
  - [Sortie](https://cecil-945.pages.dev/fr/documentation/configuration/sortie.md): Dossier de sortie, formats et post-traitement.
  - [Cache](https://cecil-945.pages.dev/fr/documentation/configuration/cache.md): Cache des assets, des templates et des traductions.
  - [Serveur et optimisation](https://cecil-945.pages.dev/fr/documentation/configuration/serveur.md): En-têtes du serveur local et optimisation de la sortie.
  - [Surcharge de configuration](https://cecil-945.pages.dev/fr/documentation/configuration/surcharge.md): Surchargez la configuration avec des variables d’environnement ou une option CLI.
- [Commandes](https://cecil-945.pages.dev/fr/documentation/commandes.md): Référence des commandes et options de la CLI de Cecil.
  - [new:site](https://cecil-945.pages.dev/fr/documentation/commandes/new-site.md): Créer un nouveau site.
  - [new:page](https://cecil-945.pages.dev/fr/documentation/commandes/new-page.md): Créer une nouvelle page, éventuellement à partir d’un modèle.
  - [serve](https://cecil-945.pages.dev/fr/documentation/commandes/serve.md): Prévisualiser le site avec le serveur intégré.
  - [build](https://cecil-945.pages.dev/fr/documentation/commandes/build.md): Générer le site.
  - [doctor](https://cecil-945.pages.dev/fr/documentation/commandes/doctor.md): Diagnostiquer la configuration, le front matter, le SEO et les liens.
- [Déployer](https://cecil-945.pages.dev/fr/documentation/deployer.md): Déployez votre site statique sur des plateformes Jamstack, via le déploiement continu ou sur un hébergement statique.
  - [Plateformes Jamstack](https://cecil-945.pages.dev/fr/documentation/deployer/plateformes-jamstack.md): Netlify, Vercel, statichost, Cloudflare Pages, Render.
  - [Build et déploiement continus](https://cecil-945.pages.dev/fr/documentation/deployer/deploiement-continu.md): GitHub Pages et GitLab CI.
  - [Hébergement statique](https://cecil-945.pages.dev/fr/documentation/deployer/hebergement-statique.md): Déployer sur un hébergement statique (Surge).
- [Développeurs](https://cecil-945.pages.dev/fr/documentation/developpeurs.md): Étendez Cecil avec PHP, utilisez-le comme bibliothèque et comprenez son architecture.
  - [Étendre](https://cecil-945.pages.dev/fr/documentation/developpeurs/etendre.md): Créez des générateurs de pages, ajoutez des extensions Twig et post-traitez les fichiers de sortie.
  - [Bibliothèque](https://cecil-945.pages.dev/fr/documentation/developpeurs/bibliotheque.md): Utilisez Cecil comme bibliothèque PHP : installez-le avec Composer, puis générez et diagnostiquez par programmation.
  - [Architecture](https://cecil-945.pages.dev/fr/documentation/developpeurs/architecture.md): Diagramme du processus de génération et composants clés.

## Comment faire ?

- [Ajouter une table des matières et des notes](https://cecil-945.pages.dev/fr/comment-faire/markdown-sommaire-notes.md): Enrichir les pages Markdown de Cecil avec une table des matières, des blocs de notes et des attributs personnalisés.
- [Rediriger d’anciennes URL](https://cecil-945.pages.dev/fr/comment-faire/contenu-redirection-alias.md): Conserver le fonctionnement des anciens liens dans Cecil avec les variables de front matter redirect et alias.
- [Utiliser des réglages différents selon l’environnement](https://cecil-945.pages.dev/fr/comment-faire/configuration-environnements.md): Surcharger la configuration de Cecil selon l’environnement avec les variables d’environnement CECIL_ et des fichiers de configuration supplémentaires.
- [Compiler, minifier et empreinter CSS et JavaScript](https://cecil-945.pages.dev/fr/comment-faire/templates-assets-scss.md): Traiter les fichiers Sass, CSS et JavaScript dans les templates Cecil avec la fonction asset et ses filtres.
- [Organiser les pages avec des tags et des catégories](https://cecil-945.pages.dev/fr/comment-faire/contenu-taxonomies.md): Classer les pages Cecil avec des taxonomies comme les tags et les catégories, et personnaliser leurs pages de liste.
- [Construire un menu de navigation](https://cecil-945.pages.dev/fr/comment-faire/templates-menus.md): Déclarer des menus dans la configuration ou le front matter de Cecil et les afficher dans les templates.
- [Ajouter une recherche côté client](https://cecil-945.pages.dev/fr/comment-faire/sortie-index-de-recherche.md): Ajouter une recherche côté client à un site statique Cecil avec un index JSON des pages et une petite bibliothèque JavaScript.
- [Déployer sur GitHub Pages avec GitHub Actions](https://cecil-945.pages.dev/fr/comment-faire/deploiement-github-pages.md): Générer et déployer automatiquement un site Cecil sur GitHub Pages avec la GitHub Action de Cecil.
- [Publier un flux RSS ou JSON](https://cecil-945.pages.dev/fr/comment-faire/sortie-flux-rss-json.md): Publier des flux RSS, Atom ou JSON de votre site Cecil avec les formats de sortie et les templates intégrés.
- [Paginer une liste de pages](https://cecil-945.pages.dev/fr/comment-faire/templates-pagination.md): Découper les longues listes de pages (blog, sections, taxonomies) en plusieurs pages avec la pagination de Cecil.
- [Traduire un site en plusieurs langues](https://cecil-945.pages.dev/fr/comment-faire/contenu-multilingue.md): Traduire les pages, la configuration et les textes des templates d’un site Cecil en plusieurs langues.
- [Appliquer les fonctionnalités SEO dans les templates](https://cecil-945.pages.dev/fr/comment-faire/templates-metatags.md): Ajouter les fonctionnalités SEO de Cecil aux templates avec le partial metatags.
- [Optimiser les images dans Markdown](https://cecil-945.pages.dev/fr/comment-faire/markdown-performance-images.md): Optimiser les images Markdown dans Cecil avec tailles responsives, formats et chargement différé.
- [Générer plusieurs formats d'images dans des modèles](https://cecil-945.pages.dev/fr/comment-faire/templates-image-formats.md): Générer des formats d'image AVIF et WebP dans les modèles Cecil.
- [Rendre des images réactives dans des modèles](https://cecil-945.pages.dev/fr/comment-faire/templates-responsive-images.md): Rendre des images réactives dans les modèles Cecil avec la fonction html.

## Thèmes

- [Composants de thème](https://cecil-945.pages.dev/fr/themes/composants/): Composants de thème pour Cecil.