{ "version": "https://jsonfeed.org/version/1.1", "title": "Cecil - Documentation", "home_page_url": "https://cecil-945.pages.dev/fr/documentation/", "feed_url": "https://cecil-945.pages.dev/fr/documentation/feed.json", "description": "Documentation du générateur de site statique Cecil.", "icon": "https://cecil-945.pages.dev/favicon.7ff4b89eec6dad139a7d2d6561543285.png", "favicon": "https://cecil-945.pages.dev/thumbnails/64x/favicon.7ff4b89eec6dad139a7d2d6561543285.png", "language": "fr", "items": [ { "id": "https://cecil-945.pages.dev/fr/documentation/bien-demarrer/installation/", "url": "https://cecil-945.pages.dev/fr/documentation/bien-demarrer/installation/", "title": "Installation", "summary": "Prérequis, méthodes d’installation (PHAR, binaire autonome, gestionnaires de paquets, Composer), mise à jour et dépannage.", "date_published": "2026-10-05T00:00:00+00:00", "date_modified": "2026-10-13T00:00:00+00:00","content_text": "Installation\nCecil est distribué sous la forme d’un unique fichier exécutable, cecil.phar, qui fonctionne partout où PHP est installé, ainsi que sous forme de binaires autonomes qui ne nécessitent pas PHP.\nPrérequis\n\nPHP 8.3+\nExtensions PHP : fileinfo, gd et mbstring\n\nVérifiez votre version de PHP et les extensions chargées :\nphp -v\nphp -m\nExtensions optionnelles\n\n\n\nExtension\nUsage\n\n\n\n\nintl\nLocalisation des dates avec d’autres locales que en (améliore les performances sinon).\n\n\nimagick\nTraitement des images, préféré à GD si disponible.\n\n\nffi\nTraitement des images avec libvips (nécessite une installation via Composer).\n\n\n\nTélécharger le PHAR\nTéléchargez cecil.phar depuis votre terminal :\ncurl -LO https:\/\/cecil.app\/cecil.phar\nPuis exécutez-le avec PHP :\nphp cecil.phar --version\nVous pouvez également télécharger une version spécifique ou la version d’aperçu.\nBinaire autonome\nSi PHP n’est pas installé, téléchargez le binaire autonome correspondant à votre plateforme depuis la dernière version GitHub. Il embarque PHP et les extensions requises.\n\n\n\nPlateforme\nFichier\n\n\n\n\nLinux x64\ncecil-linux-x64\n\n\nLinux ARM64\ncecil-linux-arm64\n\n\nmacOS Intel\ncecil-macos-x64\n\n\nmacOS Apple Silicon\ncecil-macos-arm64\n\n\nWindows x64\ncecil-windows-x64.exe\n\n\n\nPar exemple, sous Linux x64 :\ncurl -Lo cecil https:\/\/github.com\/Cecilapp\/Cecil\/releases\/latest\/download\/cecil-linux-x64\nchmod +x cecil\n.\/cecil --version\nSous macOS, les binaires ne sont pas signés : supprimez l’attribut de quarantaine avant la première exécution avec xattr -d com.apple.quarantine cecil.\nLes sommes de contrôle SHA-256 sont disponibles dans le fichier cecil-binaries.sha256 de chaque version, et la provenance du build peut être vérifiée avec gh attestation verify cecil --repo Cecilapp\/Cecil.\nLe binaire utilise GD pour le traitement des images : Imagick et libvips ne sont pas disponibles. La commande self-update n’est pas disponible non plus : téléchargez à nouveau le binaire pour le mettre à jour.\nLa commande serve repose sur le serveur web intégré de PHP, que le binaire n’embarque pas : elle nécessite un exécutable PHP local. Sans PHP, exécutez la commande build et servez le dossier de sortie avec un autre serveur web.\nInstallation globale\nInstaller Cecil globalement permet d’exécuter la commande cecil depuis n’importe quel dossier, au lieu de php cecil.phar.\nmacOS et Linux\nAvec Homebrew :\nbrew install cecilapp\/tap\/cecil\nOu manuellement, en déplaçant le PHAR dans un dossier de votre PATH :\nmv cecil.phar \/usr\/local\/bin\/cecil\nchmod +x \/usr\/local\/bin\/cecil\nWindows\nAvec Scoop :\nscoop install https:\/\/cecil.app\/scoop\/cecil.json\nOu manuellement :\n\nDéplacez cecil.phar dans un dossier dédié tel que C:\\bin\nRenommez cecil.phar en cecil\nAjoutez ;C:\\bin à votre variable d’environnement PATH\nCréez un « wrapping batch script » à côté\n\nPHIVE\nAvec PHIVE (The PHAR Installation and Verification Environment) :\nphive install cecil\nComposer\nAvec Composer :\ncomposer global require cecil\/cecil\nAssurez-vous que le dossier des binaires globaux de Composer est dans votre PATH. Exécutez composer global config bin-dir --absolute pour l’obtenir.\nPour utiliser Cecil comme dépendance d’un projet PHP, voir Bibliothèque.\nVérifier l’installation\ncecil --version\nExécutez cecil list pour afficher les commandes disponibles.\nMise à jour\nMettez à jour Cecil vers la dernière version selon votre méthode d’installation :\n# PHAR\nphp cecil.phar self-update\n# Homebrew\nbrew upgrade cecilapp\/tap\/cecil\n# Scoop\nscoop update cecil\n# PHIVE\nphive update cecil\n# Composer\ncomposer global update cecil\/cecil\nLe binaire autonome se met à jour en le téléchargeant à nouveau.\nLa commande self-update (PHAR uniquement) accepte également les options suivantes :\n\n--rollback : revient à la version précédemment installée\n--stable : force la mise à jour vers la dernière version stable\n--preview : force la mise à jour vers la dernière version instable\n\nLe journal des modifications de chaque version est disponible sur GitHub.\nDépannage\ncommand not found: cecil\nLe dossier d’installation n’est pas dans votre PATH : ajoutez-le, ou exécutez Cecil avec php cecil.phar depuis le dossier contenant le PHAR.\nErreur de version ou d’extension PHP\nLe PHP utilisé en ligne de commande peut différer de celui attendu (plusieurs versions installées) : vérifiez-le avec php -v et php --ini, puis activez les extensions manquantes dans le fichier php.ini chargé.\nDiagnostiquer un site\nUne fois un site créé, exécutez la commande doctor pour diagnostiquer sa configuration.", "content_html": "

Installation

\n

Cecil est distribué sous la forme d’un unique fichier exécutable, cecil.phar, qui fonctionne partout où PHP est installé, ainsi que sous forme de binaires autonomes qui ne nécessitent pas PHP.

\n

Prérequis

\n\n

Vérifiez votre version de PHP et les extensions chargées :

\n
php -v\nphp -m
\n

Extensions optionnelles

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ExtensionUsage
intlLocalisation des dates avec d’autres locales que en (améliore les performances sinon).
imagickTraitement des images, préféré à GD si disponible.
ffiTraitement des images avec libvips (nécessite une installation via Composer).
\n

Télécharger le PHAR

\n

Téléchargez cecil.phar depuis votre terminal :

\n
curl -LO https://cecil.app/cecil.phar
\n

Puis exécutez-le avec PHP :

\n
php cecil.phar --version
\n\n

Binaire autonome

\n

Si PHP n’est pas installé, téléchargez le binaire autonome correspondant à votre plateforme depuis la dernière version GitHub. Il embarque PHP et les extensions requises.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
PlateformeFichier
Linux x64cecil-linux-x64
Linux ARM64cecil-linux-arm64
macOS Intelcecil-macos-x64
macOS Apple Siliconcecil-macos-arm64
Windows x64cecil-windows-x64.exe
\n

Par exemple, sous Linux x64 :

\n
curl -Lo cecil https://github.com/Cecilapp/Cecil/releases/latest/download/cecil-linux-x64\nchmod +x cecil\n./cecil --version
\n

Sous macOS, les binaires ne sont pas signés : supprimez l’attribut de quarantaine avant la première exécution avec xattr -d com.apple.quarantine cecil.

\n\n\n

Installation globale

\n

Installer Cecil globalement permet d’exécuter la commande cecil depuis n’importe quel dossier, au lieu de php cecil.phar.

\n

macOS et Linux

\n

Avec Homebrew :

\n
brew install cecilapp/tap/cecil
\n

Ou manuellement, en déplaçant le PHAR dans un dossier de votre PATH :

\n
mv cecil.phar /usr/local/bin/cecil\nchmod +x /usr/local/bin/cecil
\n

Windows

\n

Avec Scoop :

\n
scoop install https://cecil.app/scoop/cecil.json
\n

Ou manuellement :

\n
    \n
  1. Déplacez cecil.phar dans un dossier dédié tel que C:\\bin
    2. \n
  2. Renommez cecil.phar en cecil
    3. \n
  3. Ajoutez ;C:\\bin à votre variable d’environnement PATH
    4. \n
  4. Créez un « wrapping batch script » à côté
    5. \n
\n

PHIVE

\n

Avec PHIVE (The PHAR Installation and Verification Environment) :

\n
phive install cecil
\n

Composer

\n

Avec Composer :

\n
composer global require cecil/cecil
\n\n\n

Vérifier l’installation

\n
cecil --version
\n\n

Mise à jour

\n

Mettez à jour Cecil vers la dernière version selon votre méthode d’installation :

\n
# PHAR\nphp cecil.phar self-update\n# Homebrew\nbrew upgrade cecilapp/tap/cecil\n# Scoop\nscoop update cecil\n# PHIVE\nphive update cecil\n# Composer\ncomposer global update cecil/cecil
\n

Le binaire autonome se met à jour en le téléchargeant à nouveau.

\n

La commande self-update (PHAR uniquement) accepte également les options suivantes :

\n\n\n

Dépannage

\n

command not found: cecil

\n

Le dossier d’installation n’est pas dans votre PATH : ajoutez-le, ou exécutez Cecil avec php cecil.phar depuis le dossier contenant le PHAR.

\n

Erreur de version ou d’extension PHP

\n

Le PHP utilisé en ligne de commande peut différer de celui attendu (plusieurs versions installées) : vérifiez-le avec php -v et php --ini, puis activez les extensions manquantes dans le fichier php.ini chargé.

\n

Diagnostiquer un site

\n

Une fois un site créé, exécutez la commande doctor pour diagnostiquer sa configuration.

", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/developpeurs/architecture/", "url": "https://cecil-945.pages.dev/fr/documentation/developpeurs/architecture/", "title": "Architecture", "summary": "Diagramme du processus de génération et composants clés.", "date_published": "2026-05-27T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "Architecture\nCette page présente une vue d’ensemble du pipeline de construction de Cecil et de ses composants clés.\nDiagramme\ngraph TD\n %% Entrée\n CLI[\"bin\/cecil\\n(Point d'entrée CLI)\"]\n APP[\"Application\\n(Symfony Console)\"]\n CMD[\"Commandes\\nbuild \/ serve \/ new:site\\nnew:page \/ clear \/ show:content\"]\n\n CLI --> APP --> CMD\n\n %% Orchestrateur\n BUILDER[\"Builder\\n(Orchestrateur)\"]\n CONFIG[\"Configuration\\n(config.yml + default.php\\n+ thèmes)\"]\n CMD --> BUILDER\n CONFIG --> BUILDER\n\n %% Pipeline\n subgraph PIPELINE[\"Pipeline de génération (étapes)\"]\n S1[\"1. Pages\/Load\\n(Finder → fichiers Markdown)\"]\n S2[\"2. Data\/Load\\n(fichiers YAML)\"]\n S3[\"3. StaticFiles\/Load\\n(chargement des fichiers statiques)\"]\n S4[\"4. Pages\/Create\\n(création des objets Page)\"]\n S5[\"5. Pages\/Convert\\n(Markdown → HTML\\nfront matter)\"]\n S6[\"6. Taxonomies\/Create\\n(création des taxonomies)\"]\n S7[\"7. Pages\/Generate\\n(générateurs)\"]\n S8[\"8. Menus\/Create\\n(création des menus)\"]\n S9[\"9. StaticFiles\/Copy\\n(copie des fichiers statiques)\"]\n S10[\"10. Pages\/Render\\n(rendu Twig)\"]\n S11[\"11. Pages\/Save\\n(sauvegarde des pages)\"]\n S12[\"12. Assets\/Save\\n(sauvegarde des assets)\"]\n S13[\"13. Optimize\/*\\n(optimisation HTML\/CSS\/JS\/Images)\"]\n\n S1 --> S2 --> S3 --> S4 --> S5 --> S6 --> S7 --> S8 --> S9 --> S10 --> S11 --> S12 --> S13\n end\n\n BUILDER --> PIPELINE\n\n %% Sous-systèmes\n subgraph COLLECTIONS[\"Collections\"]\n PC[\"PagesCollection\\n(objets Page)\"]\n TC[\"TaxonomiesCollection\\n(vocabulaires\/termes)\"]\n MC[\"MenusCollection\"]\n end\n\n subgraph GENERATORS[\"Générateurs (virtuels)\"]\n GP[\"Pagination\"]\n GT[\"Taxonomie\"]\n GS[\"Section\"]\n GR[\"Redirection\"]\n GD[\"DefaultPages (accueil, 404)\"]\n end\n\n subgraph RENDERER[\"Rendu Twig\"]\n TW[\"Moteur Twig\"]\n EXT[\"Extensions\\n(Core, Content, Collection)\"]\n PP[\"PostProcessors\\n(métadonnées, extraits, liens)\"]\n TH[\"Thèmes \/ Layouts\"]\n TW --> EXT\n TW --> PP\n TH --> TW\n end\n\n subgraph ASSETS[\"Assets\"]\n AL[\"Localisateur d'assets\"]\n AC[\"Compilateur\\n(SCSS → CSS)\"]\n AI[\"Processeur d'images\\n(responsive, WebP, AVIF)\"]\n AO[\"Optimiseur\\n(minification CSS\/JS)\"]\n end\n\n subgraph OUTPUT[\"Sortie (_site\/)\"]\n HTML[\"pages .html\"]\n CSS2[\"assets CSS\/JS\"]\n IMG[\"images\"]\n SF[\"fichiers statiques\"]\n end\n\n S4 --> PC\n S6 --> TC\n S8 --> MC\n S7 --> GENERATORS\n GENERATORS --> PC\n S10 --> RENDERER\n S12 --> ASSETS\n\n PC --> RENDERER\n TC --> RENDERER\n MC --> RENDERER\n\n RENDERER --> S11\n S11 --> HTML\n S12 --> CSS2\n S12 --> IMG\n S9 --> SF\n\n %% Entrées\n subgraph INPUT[\"Sources\"]\n MD[\"content\/\\n(Markdown + front matter)\"]\n DATA[\"data\/\\n(YAML)\"]\n STATIC[\"static\/\"]\n LAYOUTS[\"layouts\/\\n(modèles Twig)\"]\n end\n\n MD --> S1\n DATA --> S2\n STATIC --> S3\n LAYOUTS --> TH\nLégende des composants clés\n\n\n\nComposant\nRôle\n\n\n\n\nBuilder\nOrchestrateur central, exécute les étapes en séquence\n\n\nConfig\nFusion de la configuration par défaut + thème + projet + CLI\n\n\nSteps\nPipeline modulaire (13 étapes), chacune avec init() \/ canProcess() \/ process()\n\n\nCollections\nPages, Taxonomies, Menus — structures de données centrales\n\n\nGenerators\nCréent des pages virtuelles (pagination, tags, redirections…)\n\n\nRenderer (Twig)\nApplique les modèles + extensions + post-traitements\n\n\nAssets\nCompile SCSS, optimise images, fingerprinte les fichiers\n\n\n", "content_html": "

Architecture

\n

Cette page présente une vue d’ensemble du pipeline de construction de Cecil et de ses composants clés.

\n

Diagramme

\n
graph TD\n    %% Entrée\n    CLI[\"bin/cecil\\n(Point d'entrée CLI)\"]\n    APP[\"Application\\n(Symfony Console)\"]\n    CMD[\"Commandes\\nbuild / serve / new:site\\nnew:page / clear / show:content\"]\n\n    CLI --> APP --> CMD\n\n    %% Orchestrateur\n    BUILDER[\"Builder\\n(Orchestrateur)\"]\n    CONFIG[\"Configuration\\n(config.yml + default.php\\n+ thèmes)\"]\n    CMD --> BUILDER\n    CONFIG --> BUILDER\n\n    %% Pipeline\n    subgraph PIPELINE[\"Pipeline de génération (étapes)\"]\n        S1[\"1. Pages/Load\\n(Finder → fichiers Markdown)\"]\n        S2[\"2. Data/Load\\n(fichiers YAML)\"]\n        S3[\"3. StaticFiles/Load\\n(chargement des fichiers statiques)\"]\n        S4[\"4. Pages/Create\\n(création des objets Page)\"]\n        S5[\"5. Pages/Convert\\n(Markdown → HTML\\nfront matter)\"]\n        S6[\"6. Taxonomies/Create\\n(création des taxonomies)\"]\n        S7[\"7. Pages/Generate\\n(générateurs)\"]\n        S8[\"8. Menus/Create\\n(création des menus)\"]\n        S9[\"9. StaticFiles/Copy\\n(copie des fichiers statiques)\"]\n        S10[\"10. Pages/Render\\n(rendu Twig)\"]\n        S11[\"11. Pages/Save\\n(sauvegarde des pages)\"]\n        S12[\"12. Assets/Save\\n(sauvegarde des assets)\"]\n        S13[\"13. Optimize/*\\n(optimisation HTML/CSS/JS/Images)\"]\n\n        S1 --> S2 --> S3 --> S4 --> S5 --> S6 --> S7 --> S8 --> S9 --> S10 --> S11 --> S12 --> S13\n    end\n\n    BUILDER --> PIPELINE\n\n    %% Sous-systèmes\n    subgraph COLLECTIONS[\"Collections\"]\n        PC[\"PagesCollection\\n(objets Page)\"]\n        TC[\"TaxonomiesCollection\\n(vocabulaires/termes)\"]\n        MC[\"MenusCollection\"]\n    end\n\n    subgraph GENERATORS[\"Générateurs (virtuels)\"]\n        GP[\"Pagination\"]\n        GT[\"Taxonomie\"]\n        GS[\"Section\"]\n        GR[\"Redirection\"]\n        GD[\"DefaultPages (accueil, 404)\"]\n    end\n\n    subgraph RENDERER[\"Rendu Twig\"]\n        TW[\"Moteur Twig\"]\n        EXT[\"Extensions\\n(Core, Content, Collection)\"]\n        PP[\"PostProcessors\\n(métadonnées, extraits, liens)\"]\n        TH[\"Thèmes / Layouts\"]\n        TW --> EXT\n        TW --> PP\n        TH --> TW\n    end\n\n    subgraph ASSETS[\"Assets\"]\n        AL[\"Localisateur d'assets\"]\n        AC[\"Compilateur\\n(SCSS → CSS)\"]\n        AI[\"Processeur d'images\\n(responsive, WebP, AVIF)\"]\n        AO[\"Optimiseur\\n(minification CSS/JS)\"]\n    end\n\n    subgraph OUTPUT[\"Sortie (_site/)\"]\n        HTML[\"pages .html\"]\n        CSS2[\"assets CSS/JS\"]\n        IMG[\"images\"]\n        SF[\"fichiers statiques\"]\n    end\n\n    S4 --> PC\n    S6 --> TC\n    S8 --> MC\n    S7 --> GENERATORS\n    GENERATORS --> PC\n    S10 --> RENDERER\n    S12 --> ASSETS\n\n    PC --> RENDERER\n    TC --> RENDERER\n    MC --> RENDERER\n\n    RENDERER --> S11\n    S11 --> HTML\n    S12 --> CSS2\n    S12 --> IMG\n    S9 --> SF\n\n    %% Entrées\n    subgraph INPUT[\"Sources\"]\n        MD[\"content/\\n(Markdown + front matter)\"]\n        DATA[\"data/\\n(YAML)\"]\n        STATIC[\"static/\"]\n        LAYOUTS[\"layouts/\\n(modèles Twig)\"]\n    end\n\n    MD --> S1\n    DATA --> S2\n    STATIC --> S3\n    LAYOUTS --> TH
\n

Légende des composants clés

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ComposantRôle
BuilderOrchestrateur central, exécute les étapes en séquence
ConfigFusion de la configuration par défaut + thème + projet + CLI
StepsPipeline modulaire (13 étapes), chacune avec init() / canProcess() / process()
CollectionsPages, Taxonomies, Menus — structures de données centrales
GeneratorsCréent des pages virtuelles (pagination, tags, redirections…)
Renderer (Twig)Applique les modèles + extensions + post-traitements
AssetsCompile SCSS, optimise images, fingerprinte les fichiers
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/assets/images/", "url": "https://cecil-945.pages.dev/fr/documentation/assets/images/", "title": "Images", "summary": "Redimensionnez, recadrez et convertissez les images, générez des images responsives et des placeholders.", "date_published": "2026-05-26T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "Images\nCecil fournit des fonctions et filtres Twig pour redimensionner, recadrer et convertir des images, et pour générer des images responsives et des images de substitution.\nimage_srcset\nConstruit l'attribut HTML img srcset (responsive) d'un élément d'image.\n{{ image_srcset(asset) }}\nExemples :\n{% set asset = asset(image_path) %}\n<img src=\"{{ url(asset) }}\" width=\"{{ asset.width }}\" height=\"{{ asset.height }}\" alt=\"\" class=\"asset\" srcset=\"{{ image_srcset(asset) }}\" sizes=\"{{ image_sizes('asset') }}\">\nimage_sizes\nRenvoie l'attribut HTML img sizes basé sur un nom de classe CSS.\nIl doit être utilisé conjointement avec la fonction image_srcset.\n{{ image_sizes('class') }}\nExemples :\n{% set asset = asset(image_path) %}\n<img src=\"{{ url(asset) }}\" width=\"{{ asset.width }}\" height=\"{{ asset.height }}\" alt=\"\" class=\"asset\" srcset=\"{{ image_srcset(asset) }}\" sizes=\"{{ image_sizes('asset') }}\">\nimage_from_website\nConstruit l'élément HTML img à partir d'une URL de site Web en extrayant son image d'illustration.\nRetourne null si aucune image n'est trouvée.\n{{ image_from_website('url', {attributs}, {options}) }}\nL'image est recherchée dans le HTML de la page avec les fallbacks suivants, le premier candidat pouvant être téléchargé en tant qu'image est utilisé :\n\nOpen Graph : og:image:secure_url, og:image, og:image:url\nTwitter : twitter:image, twitter:image:src\n<link rel=\"image_src\">\nMicrodata : itemprop=\"image\"\nJSON-LD : propriété image\nPremière <img> de <article>, <main> ou <body>\n<link rel=\"apple-touch-icon\">\n<link rel=\"icon\">\n\nLes URL relatives sont résolues par rapport à <base href> ou à l'URL de la page.\nL'URL de l'image trouvée et l'image téléchargée sont mises en cache (voir cache.assets.remote.ttl).\nOptions :\n\nfallback : chemin (ou URL) de l'image utilisée si aucune image n'est trouvée\nautres options de image (ex. : responsive, formats)\n\nExemples :\n{{ image_from_website('https:\/\/example.com\/page-with-image.html') }}\n\n{# avec une image de fallback #}\n{{ image_from_website('https:\/\/example.com\/', {alt: 'Illustration'}, {fallback: 'images\/default.png'}) }}\nresize\nRedimensionne une image à une largeur (en pixels) ou\/et une hauteur (en pixels) spécifiée.\n\nSi seule la largeur est spécifiée, la hauteur est calculée pour conserver le rapport hauteur\/largeur\nSi seule la hauteur est spécifiée, la largeur est calculée pour conserver le rapport hauteur\/largeur\nSi la largeur et la hauteur sont spécifiées, l'image est redimensionnée pour s'adapter aux dimensions données, l'image est recadrée et centrée si nécessaire\nSi Remove_animation est vrai, toute animation dans l'image (par exemple, GIF) sera supprimée\n\n{{ asset(image_path)|resize(width: width, height: height, remove_animation: bool) }}\nLe fichier original n'est pas modifié et la version redimensionnée est enregistrée sous \/thumbnails\/<width>x<height>\/image.jpg.\nLes fichiers ICO sont supportés : la plus grande icône est redimensionnée et enregistrée dans un fichier ICO à icône unique (compressée en PNG). Les icônes stockées en BMP avec une profondeur de couleur autre que 24 ou 32 bits nécessitent l'extension PHP Imagick : à défaut, le fichier ICO original est conservé et un avertissement est journalisé.\nExemples :\n{{ asset(page.image)|resize(300) }}\n{# equivalent to: #}\n{{ asset(page.image)|resize(width: 300) }}\n{# resizes to 300px width, height auto-calculated to preserve aspect ratio #}\n{{ asset(page.image)|resize(height: 200) }}\n{# resizes to 300px width and 200px height, and crops if necessary #}\n{{ asset(page.image)|resize(300, 200) }}\n{# removes any animation from the image #}\n{{ asset(page.image)|resize(width: 1200, height: 630, remove_animation: true) }}\ncover\nRedimensionne une image à une largeur et une hauteur spécifiées, en la recadrant si nécessaire.\nLe filtre cover est obsolète depuis la version 8.77 et sera supprimé dans les versions futures. Utilisez plutôt le filtre resize, avec les paramètres de largeur et de hauteur.\n{{ asset(image_path)|cover(width, height) }}\nExemple:\n{{ asset(page.image)|cover(1200, 630) }}\nmaskable\nAjoute un remplissage, en pourcentages, à une image pour la rendre masquable.\n{{ asset(image_path)|maskable(padding) }}\nExemple:\n{{ asset('icon.png')|maskable }}\nwebp\nConvertit une image au format WebP.\nExemple:\n<picture>\n <source type=\"image\/webp\" srcset=\"{{ asset(image_path)|webp }}\">\n <img src=\"{{ url(asset(image_path)) }}\" width=\"{{ asset(image_path).width }}\" height=\"{{ asset(image_path).height }}\" alt=\"\">\n<\/picture>\navif\nConvertit une image au format AVIF.\nExemple:\n<picture>\n <source type=\"image\/avif\" srcset=\"{{ asset(image_path)|avif }}\">\n <img src=\"{{ url(asset(image_path)) }}\" width=\"{{ asset(image_path).width }}\" height=\"{{ asset(image_path).height }}\" alt=\"\">\n<\/picture>\nlqip\nRenvoie un espace réservé pour une image de faible qualité (100 x 100 px, flou à 50 %) comme URL de données.\n{{ asset(image_path)|lqip }}\ndominant_color\nRenvoie la couleur hexadécimale dominante d'une image.\n{{ asset(image_path)|dominant_color }}", "content_html": "

Images

\n

Cecil fournit des fonctions et filtres Twig pour redimensionner, recadrer et convertir des images, et pour générer des images responsives et des images de substitution.

\n

image_srcset

\n

Construit l'attribut HTML img srcset (responsive) d'un élément d'image.

\n
{{ image_srcset(asset) }}
\n

Exemples :

\n
{% set asset = asset(image_path) %}\n<img src=\"{{ url(asset) }}\" width=\"{{ asset.width }}\" height=\"{{ asset.height }}\" alt=\"\" class=\"asset\" srcset=\"{{ image_srcset(asset) }}\" sizes=\"{{ image_sizes('asset') }}\">
\n

image_sizes

\n

Renvoie l'attribut HTML img sizes basé sur un nom de classe CSS.\nIl doit être utilisé conjointement avec la fonction image_srcset.

\n
{{ image_sizes('class') }}
\n

Exemples :

\n
{% set asset = asset(image_path) %}\n<img src=\"{{ url(asset) }}\" width=\"{{ asset.width }}\" height=\"{{ asset.height }}\" alt=\"\" class=\"asset\" srcset=\"{{ image_srcset(asset) }}\" sizes=\"{{ image_sizes('asset') }}\">
\n

image_from_website

\n

Construit l'élément HTML img à partir d'une URL de site Web en extrayant son image d'illustration.\nRetourne null si aucune image n'est trouvée.

\n
{{ image_from_website('url', {attributs}, {options}) }}
\n

L'image est recherchée dans le HTML de la page avec les fallbacks suivants, le premier candidat pouvant être téléchargé en tant qu'image est utilisé :

\n
    \n
  1. Open Graph : og:image:secure_url, og:image, og:image:url
    2. \n
  2. Twitter : twitter:image, twitter:image:src
    3. \n
  3. <link rel=\"image_src\">
    4. \n
  4. Microdata : itemprop=\"image\"
    5. \n
  5. JSON-LD : propriété image
    6. \n
  6. Première <img> de <article>, <main> ou <body>
    7. \n
  7. <link rel=\"apple-touch-icon\">
    8. \n
  8. <link rel=\"icon\">
    9. \n
\n

Les URL relatives sont résolues par rapport à <base href> ou à l'URL de la page.

\n

L'URL de l'image trouvée et l'image téléchargée sont mises en cache (voir cache.assets.remote.ttl).

\n

Options :

\n\n

Exemples :

\n
{{ image_from_website('https://example.com/page-with-image.html') }}\n\n{# avec une image de fallback #}\n{{ image_from_website('https://example.com/', {alt: 'Illustration'}, {fallback: 'images/default.png'}) }}
\n

resize

\n

Redimensionne une image à une largeur (en pixels) ou/et une hauteur (en pixels) spécifiée.

\n\n
{{ asset(image_path)|resize(width: width, height: height, remove_animation: bool) }}
\n\n\n

Exemples :

\n
{{ asset(page.image)|resize(300) }}\n{# equivalent to: #}\n{{ asset(page.image)|resize(width: 300) }}\n{# resizes to 300px width, height auto-calculated to preserve aspect ratio #}\n{{ asset(page.image)|resize(height: 200) }}\n{# resizes to 300px width and 200px height, and crops if necessary #}\n{{ asset(page.image)|resize(300, 200) }}\n{# removes any animation from the image #}\n{{ asset(page.image)|resize(width: 1200, height: 630, remove_animation: true) }}
\n

cover

\n

Redimensionne une image à une largeur et une hauteur spécifiées, en la recadrant si nécessaire.

\n\n
{{ asset(image_path)|cover(width, height) }}
\n

Exemple:

\n
{{ asset(page.image)|cover(1200, 630) }}
\n

maskable

\n

Ajoute un remplissage, en pourcentages, à une image pour la rendre masquable.

\n
{{ asset(image_path)|maskable(padding) }}
\n

Exemple:

\n
{{ asset('icon.png')|maskable }}
\n

webp

\n

Convertit une image au format WebP.

\n

Exemple:

\n
<picture>\n    <source type=\"image/webp\" srcset=\"{{ asset(image_path)|webp }}\">\n    <img src=\"{{ url(asset(image_path)) }}\" width=\"{{ asset(image_path).width }}\" height=\"{{ asset(image_path).height }}\" alt=\"\">\n</picture>
\n

avif

\n

Convertit une image au format AVIF.

\n

Exemple:

\n
<picture>\n    <source type=\"image/avif\" srcset=\"{{ asset(image_path)|avif }}\">\n    <img src=\"{{ url(asset(image_path)) }}\" width=\"{{ asset(image_path).width }}\" height=\"{{ asset(image_path).height }}\" alt=\"\">\n</picture>
\n

lqip

\n

Renvoie un espace réservé pour une image de faible qualité (100 x 100 px, flou à 50 %) comme URL de données.

\n
{{ asset(image_path)|lqip }}
\n

dominant_color

\n

Renvoie la couleur hexadécimale dominante d'une image.

\n
{{ asset(image_path)|dominant_color }}
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/templates/regles-de-recherche/", "url": "https://cecil-945.pages.dev/fr/documentation/templates/regles-de-recherche/", "title": "Organisation et règles de recherche", "summary": "Types de templates, convention de nommage, templates intégrés et choix du template d’une page.", "date_published": "2026-05-26T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "Organisation et règles de recherche\nCecil génère les pages à l’aide de templates Twig : cette page explique comment les templates sont organisés et comment le bon template est choisi pour chaque page.\nOrganisation des fichiers\nTypes de templates\nIl existe trois types de templates, layouts, components et autres templates : layouts sont utilisés pour afficher les pages, et chacun d'eux peut inclure des templates et components.\nConvention de nommage\nLes fichiers templates sont stockés dans le répertoire layouts\/ et doivent être nommés selon la convention suivante :\nlayouts\/(<section>\/)<type>|<layout>.<format>(.<language>).twig\n\n<section> (facultatif)\nLa section de la page (ex. : blog).\n<type>\nLe type de page : home (ou index) pour homepage, list pour list, page pour page, etc. (Voir Règles de recherche pour plus de détails).\n<layout> (facultatif)\nLe nom de la layout personnalisée défini dans le front-matter de la page (par exemple : layout: my-layout).\n<format>\nLe format de sortie de la page rendue (par exemple : html, rss, json, xml, etc.).\n<language> (facultatif)\nLa langue de la page (ex. : fr).\n\nExemples :\nlayouts\/home.html.twig # `type` est \"homepage\"\nlayouts\/page.html.twig # `type` est \"page\"\nlayouts\/page.html.fr.twig # `type` est \"page\" et `language` est \"fr\"\nlayouts\/my-layout.html.twig # `layout` est \"my-layout\"\nlayouts\/blog\/list.html.twig # `section` est \"blog\"\nlayouts\/blog\/list.rss.twig # `section` est \"blog\" et `format` est \"rss\"\n<mon-site>\n├─ ...\n├─ layouts\n| ├─ index.html.twig # Utilisé par le type \"homepage\"\n| ├─ list.html.twig # Utilisé par les types \"homepage\" et \"section\"\n| ├─ list.rss.twig # Utilisé par les types \"homepage\" et \"section\", pour le format de sortie RSS\n| ├─ page.html.twig # Utilisé par le type \"page\"\n| ├─ taxonomy\n| | ├─ tags.html.twig # Utilisé par le type \"vocabulary\" de `tags` (liste des termes)\n| | └─ tag.html.twig # Utilisé par le type \"term\" de `tags` (liste des pages)\n| ├─ my-layout.html.twig # Utilisé par les pages avec `layout: my-layout` dans le front-matter\n| ├─ ...\n| └─ partials\n| ├─ footer.html.twig # Template inclus\n| └─ ...\n└─ themes # Layouts et templates des thèmes\n └─ ...\nTemplates intégrés\nCecil est livré avec un ensemble de templates intégrés.\nSi vous avez besoin de modifier des templates intégrés, vous pouvez facilement les extraire via la commande suivante : ils seront copiés dans le répertoire layouts de votre site.\nphp cecil.phar util:templates:extract\nRègles de recherche\nDans la plupart des cas vous n'avez pas besoin de préciser la layout : Cecil sélectionne la layout la plus appropriée, en fonction du type de la page.\nPar exemple, la sortie HTML de home page (index.md) sera rendue :\n\navec my-layout.html.twig si la variable layout est définie sur \"my-layout\" (dans le préambule)\nsinon, avec index.html.twig si le fichier existe\nsinon, avec home.html.twig si le fichier existe\nsinon, avec list.html.twig si le fichier existe\n\nToutes les règles sont détaillées ci-dessous, pour chaque type de page, par ordre de priorité.\nType homepage\n\n<layout>.<format>.twig\nindex.<format>.twig\nhome.<format>.twig\nlist.<format>.twig\n_default\/<layout>.<format>.twig\n_default\/index.<format>.twig\n_default\/home.<format>.twig\n_default\/list.<format>.twig\n_default\/page.<format>.twig\n\nType page\n\n<section>\/<layout>.<format>.twig\n<layout>.<format>.twig\n<section>\/page.<format>.twig\n_default\/<layout>.<format>.twig\npage.<format>.twig\n_default\/page.<format>.twig\n\nType section\n\n<layout>.<format>.twig\n<section>\/index.<format>.twig\n<section>\/list.<format>.twig\nsection\/<section>.<format>.twig\n<parent>\/index.<format>.twig, <parent>\/list.<format>.twig et section\/<parent>.<format>.twig, pour chaque section parente d’une sous-section (la plus proche en premier)\n_default\/section.<format>.twig\nlist.<format>.twig\n_default\/list.<format>.twig\n\nLa <section> d’une sous-section est son chemin complet (ex. : blog\/2024), et une sous-section se replie sur les templates de ses sections parentes : si blog\/2024\/list.html.twig n’existe pas, la sous-section blog\/2024 est rendue avec blog\/list.html.twig.\nType vocabulary\n\ntaxonomy\/<plural>.<format>.twig\nvocabulary.<format>.twig\n_default\/vocabulary.<format>.twig\n\nType term\n\ntaxonomy\/<plural>\/<term>.<format>.twig\ntaxonomy\/<singular>.<format>.twig\nterm.<format>.twig\n_default\/term.<format>.twig\n_default\/list.<format>.twig\n\nLe template du vocabulaire est nommé d’après le pluriel (ex. : taxonomy\/categories.html.twig pour \/categories\/), tandis que le template d’un terme est nommé d’après le singulier (ex. : taxonomy\/category.html.twig pour \/categories\/data-sovereignty\/).\n<term> est le nom du terme « slugifié » : un template dédié au terme « Data Sovereignty » du vocabulaire categories est taxonomy\/categories\/data-sovereignty.html.twig.\nLa plupart de ces layouts sont disponibles par défaut, voir templates intégrés.", "content_html": "

Organisation et règles de recherche

\n

Cecil génère les pages à l’aide de templates Twig : cette page explique comment les templates sont organisés et comment le bon template est choisi pour chaque page.

\n

Organisation des fichiers

\n

Types de templates

\n

Il existe trois types de templates, layouts, components et autres templates : layouts sont utilisés pour afficher les pages, et chacun d'eux peut inclure des templates et components.

\n

Convention de nommage

\n

Les fichiers templates sont stockés dans le répertoire layouts/ et doivent être nommés selon la convention suivante :

\n
layouts/(<section>/)<type>|<layout>.<format>(.<language>).twig
\n
\n
<section> (facultatif)
\n
La section de la page (ex. : blog).
\n
<type>
\n
Le type de page : home (ou index) pour homepage, list pour list, page pour page, etc. (Voir Règles de recherche pour plus de détails).
\n
<layout> (facultatif)
\n
Le nom de la layout personnalisée défini dans le front-matter de la page (par exemple : layout: my-layout).
\n
<format>
\n
Le format de sortie de la page rendue (par exemple : html, rss, json, xml, etc.).
\n
<language> (facultatif)
\n
La langue de la page (ex. : fr).
\n
\n

Exemples :

\n
layouts/home.html.twig       # `type` est \"homepage\"\nlayouts/page.html.twig       # `type` est \"page\"\nlayouts/page.html.fr.twig    # `type` est \"page\" et `language` est \"fr\"\nlayouts/my-layout.html.twig  # `layout` est \"my-layout\"\nlayouts/blog/list.html.twig  # `section` est \"blog\"\nlayouts/blog/list.rss.twig   # `section` est \"blog\" et `format` est \"rss\"
\n
<mon-site>\n├─ ...\n├─ layouts\n|  ├─ index.html.twig      # Utilisé par le type \"homepage\"\n|  ├─ list.html.twig       # Utilisé par les types \"homepage\" et \"section\"\n|  ├─ list.rss.twig        # Utilisé par les types \"homepage\" et \"section\", pour le format de sortie RSS\n|  ├─ page.html.twig       # Utilisé par le type \"page\"\n|  ├─ taxonomy\n|  |  ├─ tags.html.twig    # Utilisé par le type \"vocabulary\" de `tags` (liste des termes)\n|  |  └─ tag.html.twig     # Utilisé par le type \"term\" de `tags` (liste des pages)\n|  ├─ my-layout.html.twig  # Utilisé par les pages avec `layout: my-layout` dans le front-matter\n|  ├─ ...\n|  └─ partials\n|     ├─ footer.html.twig  # Template inclus\n|     └─ ...\n└─ themes                  # Layouts et templates des thèmes\n   └─ ...
\n

Templates intégrés

\n

Cecil est livré avec un ensemble de templates intégrés.

\n\n

Règles de recherche

\n

Dans la plupart des cas vous n'avez pas besoin de préciser la layout : Cecil sélectionne la layout la plus appropriée, en fonction du type de la page.

\n

Par exemple, la sortie HTML de home page (index.md) sera rendue :

\n
    \n
  1. avec my-layout.html.twig si la variable layout est définie sur \"my-layout\" (dans le préambule)
    2. \n
  2. sinon, avec index.html.twig si le fichier existe
    3. \n
  3. sinon, avec home.html.twig si le fichier existe
    4. \n
  4. sinon, avec list.html.twig si le fichier existe
    5. \n
\n

Toutes les règles sont détaillées ci-dessous, pour chaque type de page, par ordre de priorité.

\n

Type homepage

\n
    \n
  1. <layout>.<format>.twig
    2. \n
  2. index.<format>.twig
    3. \n
  3. home.<format>.twig
    4. \n
  4. list.<format>.twig
    5. \n
  5. _default/<layout>.<format>.twig
    6. \n
  6. _default/index.<format>.twig
    7. \n
  7. _default/home.<format>.twig
    8. \n
  8. _default/list.<format>.twig
    9. \n
  9. _default/page.<format>.twig
    10. \n
\n

Type page

\n
    \n
  1. <section>/<layout>.<format>.twig
    2. \n
  2. <layout>.<format>.twig
    3. \n
  3. <section>/page.<format>.twig
    4. \n
  4. _default/<layout>.<format>.twig
    5. \n
  5. page.<format>.twig
    6. \n
  6. _default/page.<format>.twig
    7. \n
\n

Type section

\n
    \n
  1. <layout>.<format>.twig
    2. \n
  2. <section>/index.<format>.twig
    3. \n
  3. <section>/list.<format>.twig
    4. \n
  4. section/<section>.<format>.twig
    5. \n
  5. <parent>/index.<format>.twig, <parent>/list.<format>.twig et section/<parent>.<format>.twig, pour chaque section parente d’une sous-section (la plus proche en premier)
    6. \n
  6. _default/section.<format>.twig
    7. \n
  7. list.<format>.twig
    8. \n
  8. _default/list.<format>.twig
    9. \n
\n\n

Type vocabulary

\n
    \n
  1. taxonomy/<plural>.<format>.twig
    2. \n
  2. vocabulary.<format>.twig
    3. \n
  3. _default/vocabulary.<format>.twig
    4. \n
\n

Type term

\n
    \n
  1. taxonomy/<plural>/<term>.<format>.twig
    2. \n
  2. taxonomy/<singular>.<format>.twig
    3. \n
  3. term.<format>.twig
    4. \n
  4. _default/term.<format>.twig
    5. \n
  5. _default/list.<format>.twig
    6. \n
\n\n\n", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/templates/reference/fonctions/", "url": "https://cecil-945.pages.dev/fr/documentation/templates/reference/fonctions/", "title": "Fonctions", "summary": "url, html, readtime, hash, cache_key, getenv, dump, etc.", "date_published": "2026-05-26T00:00:00+00:00", "date_modified": "2026-10-05T00:00:00+00:00","content_text": "Fonctions\n\nFonctions peut être appelée pour générer du contenu. Les fonctions sont appelées par leur nom suivi de parenthèses (()) et peuvent avoir des arguments.\n\nurl\nCrée une URL valide pour une page, une entrée de menu, un actif, un ID de page ou un chemin.\n{{ url(value, {options}) }}\n\n\n\nOptions\nDescriptif\nTapez\nPar défaut\n\n\n\n\ncanonique\nPréfixez l'URL avec baseurl ou utilisez canonical.url s'il existe.\nbooléen\nfalse\n\n\nformats\nDéfinit la page format de sortie (par exemple : json).\nchaîne\nhtml\n\n\nlangue\nDéfinit la page langue (ex. : fr).\nchaîne\nnul\n\n\n\nExemples :\n{# page #}\n{{ url(page) }}\n{{ url(page, {canonical: true}) }}\n{{ url(page, {format: json}) }}\n{{ url(page, {language: fr}) }}\n{# menu entry #}\n{{ url(site.menus.main.about) }}\n{# asset #}\n{{ url(asset('styles.css')) }}\n{# page ID #}\n{{ url('page-id') }}\n{# path #}\n{{ url('about-me\/') }}\n{{ url('tags\/' ~ tag) }}\nPour plus de commodité, la fonction url est également disponible sous forme de filtre :\n{# page #}\n{{ page|url }}\n{{ page|url({canonical: true, format: json, language: fr}) }}\n{# asset #}\n{{ asset('styles.css')|url }}\nLorsque la valeur est une chaîne, url() la « slugifie » pour trouver un ID de page correspondant (ex. : url('tags\/My Tag') retourne l’URL de la page tags\/my-tag). Si aucune page ne correspond, la chaîne est conservée comme chemin, avec les caractères invalides (ex. : espaces) encodés.\nhtml\nCrée un élément HTML à partir d'un actif (ou d'un tableau d'actifs avec des attributs personnalisés).\n{{ html(asset, {attributes}, {options}) }}\n{# dedicated functions for each common type of asset #}\n{{ css(asset) }}\n{{ js(asset) }}\n{{ image(asset) }}\n{{ audio(asset) }}\n{{ video(asset) }}\n\n\n\nOptions\nDescriptif\nTapez\n\n\n\n\nattributs\nAjoute le couple name=\"value\" à l'élément HTML.\ntableau\n\n\noptions\n{preload: boolean} : préchargements.Pour les images :{formats: array} : ajoute des formats alternatifs.{responsive: bool|string} : ajoute des images réactives (basées sur width ou des pixels density).{placeholder: string} : remplit l'arrière-plan de l'image avant son chargement (color ou lqip).\ntableau\n\n\n\nDepuis la version 8.42.0, la fonction html remplace le filtre html obsolète.\nVous pouvez définir un comportement global par défaut des options d'images (formats, responsive et placeholder) via la configuration des layouts.\nLorsque layouts.images.dark_suffix est configuré (par exemple .dark), Cecil recherche automatiquement une variante sombre de chaque image (par exemple photo.dark.jpg aux côtés de photo.jpg) et génère un élément <picture> avec un <source media=\"(prefers-color-scheme: dark)\">.\nDe la même manière, lorsque layouts.images.mobile_suffix est configuré (par exemple .mobile), Cecil recherche une variante mobile de chaque image (par exemple photo.mobile.jpg) et ajoute un <source> avec la media query layouts.images.mobile_media_query. Si une variante sombre de l’image mobile existe (par exemple photo.mobile.dark.jpg), elle est utilisée sur mobile en mode sombre.\nExemples :\n{# CSS with an attribute #}\n{{ html(asset('print.css'), {media: 'print'}) }}\n{# CSS with an attribute and an option #}\n{{ html(asset('styles.css'), {title: 'Main theme'}, {preload: true}) }}\n{# Array of assets with media query #}\n{{ html([\n {asset: asset('css\/style.css')},\n {asset: asset('css\/style-dark.css'), attributes: {media: '(prefers-color-scheme: dark)'}}\n]) }}\n{# JavaScript #}\n{{ html(asset('script.js')) }}\n{# image without specific attributes nor options #}\n{{ html(asset('image.png')) }}\n{# image with specific attributes, responsive images and alternative formats #}\n{{ html(asset('image.jpg'), {alt: 'Description', loading: 'lazy'}, {responsive: true, formats: ['avif', 'webp']}) }}\n{# image with responsive pixels density images #}\n{{ html(asset('image.jpg'), options={responsive: 'density'}, attributes={width: 256}) }}\n{# image with a Low-Quality Image Placeholder #}\n{{ html(asset('image.jpg'), {alt: 'Description', loading: 'lazy'}, {placeholder: 'lqip'}) }}\n{# Audio #}\n{{ html(asset('audio.mp3')) }}\n{# Video #}\n{{ html(asset('video.mp4')) }}\nPour plus de commodité, la fonction html reste disponible en tant que filtre (mais est considérée comme obsolète) :\n{{ asset|html({attributes}, {options}) }}\nreadtime\nDétermine le temps de lecture d'un texte, en minutes.\n{{ readtime(value) }}\nExemple:\n{{ readtime(page.content) }} min\nhash\nCalcule le hachage d'un objet, d'un tableau ou d'une chaîne avec un algorithme donné.\n{{ hash(value, algorithm) }}\nalgorithm peut être n'importe quel algorithme pris en charge par la fonction hash() de PHP (par exemple : md5, sha256, etc.). La valeur par défaut est xxh128.\nExemple:\n{{ hash('my string', 'sha256') }}\ncache_key\nCalcule une clé de cache pour fragments cache en fonction d'un nom et d'une valeur facultative.\n{% cache cache_key(name, value) %}\n {# cacheable content #}\n{% endcache %}\nLa fonction ajoute un hachage de la valeur (peut être une chaîne, un tableau ou un objet) au nom (ainsi que la langue actuelle et l'ID de build pour être sûr que la clé de cache générée est unique), donc si la valeur est modifiée, la clé de cache est également modifiée et le cache est automatiquement vidé.\ngetenv\nObtient la valeur d'une variable d'environnement à partir de sa clé.\n{{ getenv(var) }}\nExemple:\n{{ getenv('VAR') }}\ndump\nLa fonction dump affiche les informations sur une variable de modèle. Ceci est surtout utile pour déboguer un modèle qui ne se comporte pas comme prévu en introspectant ses variables :\n{{ dump(user) }}\nLe debug mode doit être activé.\nd\nLa fonction d() est la version HTML de dump() et utilise le Symfony VarDumper Component en arrière-plan.\n{{ d(variable, {theme: light}) }}\n\nSi variable n'est pas fourni, la fonction renvoie le contexte Twig actuel\nLes thèmes disponibles sont « clair » (par défaut) et « sombre »\n\nLe debug mode doit être activé.", "content_html": "

Fonctions

\n
\n

Fonctions peut être appelée pour générer du contenu. Les fonctions sont appelées par leur nom suivi de parenthèses (()) et peuvent avoir des arguments.

\n
\n

url

\n

Crée une URL valide pour une page, une entrée de menu, un actif, un ID de page ou un chemin.

\n
{{ url(value, {options}) }}
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
OptionsDescriptifTapezPar défaut
canoniquePréfixez l'URL avec baseurl ou utilisez canonical.url s'il existe.booléenfalse
formatsDéfinit la page format de sortie (par exemple : json).chaînehtml
langueDéfinit la page langue (ex. : fr).chaînenul
\n

Exemples :

\n
{# page #}\n{{ url(page) }}\n{{ url(page, {canonical: true}) }}\n{{ url(page, {format: json}) }}\n{{ url(page, {language: fr}) }}\n{# menu entry #}\n{{ url(site.menus.main.about) }}\n{# asset #}\n{{ url(asset('styles.css')) }}\n{# page ID #}\n{{ url('page-id') }}\n{# path #}\n{{ url('about-me/') }}\n{{ url('tags/' ~ tag) }}
\n\n\n

html

\n

Crée un élément HTML à partir d'un actif (ou d'un tableau d'actifs avec des attributs personnalisés).

\n
{{ html(asset, {attributes}, {options}) }}\n{# dedicated functions for each common type of asset #}\n{{ css(asset) }}\n{{ js(asset) }}\n{{ image(asset) }}\n{{ audio(asset) }}\n{{ video(asset) }}
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
OptionsDescriptifTapez
attributsAjoute le couple name=\"value\" à l'élément HTML.tableau
options{preload: boolean} : préchargements.
Pour les images :
{formats: array} : ajoute des formats alternatifs.
{responsive: bool|string} : ajoute des images réactives (basées sur width ou des pixels density).
{placeholder: string} : remplit l'arrière-plan de l'image avant son chargement (color ou lqip).		tableau
\n\n\n

Exemples :

\n
{# CSS with an attribute #}\n{{ html(asset('print.css'), {media: 'print'}) }}\n{# CSS with an attribute and an option #}\n{{ html(asset('styles.css'), {title: 'Main theme'}, {preload: true}) }}\n{# Array of assets with media query #}\n{{ html([\n  {asset: asset('css/style.css')},\n  {asset: asset('css/style-dark.css'), attributes: {media: '(prefers-color-scheme: dark)'}}\n]) }}\n{# JavaScript #}\n{{ html(asset('script.js')) }}\n{# image without specific attributes nor options #}\n{{ html(asset('image.png')) }}\n{# image with specific attributes, responsive images and alternative formats #}\n{{ html(asset('image.jpg'), {alt: 'Description', loading: 'lazy'}, {responsive: true, formats: ['avif', 'webp']}) }}\n{# image with responsive pixels density images #}\n{{ html(asset('image.jpg'), options={responsive: 'density'}, attributes={width: 256}) }}\n{# image with a Low-Quality Image Placeholder #}\n{{ html(asset('image.jpg'), {alt: 'Description', loading: 'lazy'}, {placeholder: 'lqip'}) }}\n{# Audio #}\n{{ html(asset('audio.mp3')) }}\n{# Video #}\n{{ html(asset('video.mp4')) }}
\n\n

readtime

\n

Détermine le temps de lecture d'un texte, en minutes.

\n
{{ readtime(value) }}
\n

Exemple:

\n
{{ readtime(page.content) }} min
\n

hash

\n

Calcule le hachage d'un objet, d'un tableau ou d'une chaîne avec un algorithme donné.

\n
{{ hash(value, algorithm) }}
\n

algorithm peut être n'importe quel algorithme pris en charge par la fonction hash() de PHP (par exemple : md5, sha256, etc.). La valeur par défaut est xxh128.

\n

Exemple:

\n
{{ hash('my string', 'sha256') }}
\n

cache_key

\n

Calcule une clé de cache pour fragments cache en fonction d'un nom et d'une valeur facultative.

\n
{% cache cache_key(name, value) %}\n  {# cacheable content #}\n{% endcache %}
\n

La fonction ajoute un hachage de la valeur (peut être une chaîne, un tableau ou un objet) au nom (ainsi que la langue actuelle et l'ID de build pour être sûr que la clé de cache générée est unique), donc si la valeur est modifiée, la clé de cache est également modifiée et le cache est automatiquement vidé.

\n

getenv

\n

Obtient la valeur d'une variable d'environnement à partir de sa clé.

\n
{{ getenv(var) }}
\n

Exemple:

\n
{{ getenv('VAR') }}
\n

dump

\n

La fonction dump affiche les informations sur une variable de modèle. Ceci est surtout utile pour déboguer un modèle qui ne se comporte pas comme prévu en introspectant ses variables :

\n
{{ dump(user) }}
\n\n

d

\n

La fonction d() est la version HTML de dump() et utilise le Symfony VarDumper Component en arrière-plan.

\n
{{ d(variable, {theme: light}) }}
\n\n", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/assets/traitements/", "url": "https://cecil-945.pages.dev/fr/documentation/assets/traitements/", "title": "CSS, JavaScript et traitements", "summary": "Compilez Sass, minifiez, ajoutez une empreinte, intégrez ou embarquez les assets.", "date_published": "2026-05-26T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "CSS, JavaScript et traitements\nCecil fournit des filtres Twig pour compiler du Sass, minifier, ajouter une empreinte ou intégrer les assets CSS et JavaScript.\nfingerprint\nAjoutez l'empreinte digitale du contenu du fichier au nom du fichier.\n{{ asset(path)|fingerprint }}\n{{ path|fingerprint }}\nExemples :\n{{ asset('styles.css')|fingerprint }}\nminify\nRéduire un fichier CSS ou JavaScript.\n{{ asset(path)|minify }}\nExemples :\n{{ asset('styles.css')|minify }}\n{{ asset('scripts.js')|minify }}\nminify_css\nRéduire une chaîne CSS.\n{{ variable|minify_css }}\n{% apply minify_css %}\n{# CSS here #}\n{% endapply %}\nExemples :\n{% set styles = 'some CSS here' %}\n{{ styles|minify_css }}\n<style>\n{% apply minify_css %}\n html {\n background-color: #fcfcfc;\n color: #444;\n }\n{% endapply %}\n<\/style>\nminify_js\nRéduire une chaîne JavaScript.\n{{ variable|minify_js }}\n{% apply minify_js %}\n{# JavaScript here #}\n{% endapply %}\nExemples :\n{% set script = 'some JavaScript here' %}\n{{ script|minify_js }}\n<script>\n{% apply minify_js %}\n var test = 'test';\n console.log(test);\n{% endapply %}\n<\/script>\nscss_to_css\nCompile une chaîne Sass en CSS.\n{{ variable|scss_to_css }}\n{% apply scss_to_css %}\n{# SCSS here #}\n{% endapply %}\nAlias : sass_to_css.\nExemples :\n{% set scss = 'some SCSS here' %}\n{{ scss|scss_to_css }}\n<style>\n{% apply scss_to_css %}\n $color: #fcfcfc;\n div {\n color: lighten($color, 20%);\n }\n{% endapply %}\n<\/style>\nto_css\nCompile un fichier Sass en CSS.\n{{ asset(path)|to_css }}\n{{ path|to_css }}\nExemples :\n{{ asset('styles.scss')|to_css }}\ninline\nAffiche le contenu d'un Asset.\n{{ asset(path)|inline }}\nExemple:\n{{ asset('styles.css')|inline }}\ndataurl\nRenvoie l'URL de données d'un actif.\n{{ asset(path)|dataurl }}\n{{ asset(image_path)|dataurl }}", "content_html": "

CSS, JavaScript et traitements

\n

Cecil fournit des filtres Twig pour compiler du Sass, minifier, ajouter une empreinte ou intégrer les assets CSS et JavaScript.

\n

fingerprint

\n

Ajoutez l'empreinte digitale du contenu du fichier au nom du fichier.

\n
{{ asset(path)|fingerprint }}\n{{ path|fingerprint }}
\n

Exemples :

\n
{{ asset('styles.css')|fingerprint }}
\n

minify

\n

Réduire un fichier CSS ou JavaScript.

\n
{{ asset(path)|minify }}
\n

Exemples :

\n
{{ asset('styles.css')|minify }}\n{{ asset('scripts.js')|minify }}
\n

minify_css

\n

Réduire une chaîne CSS.

\n
{{ variable|minify_css }}
\n
{% apply minify_css %}\n{# CSS here #}\n{% endapply %}
\n

Exemples :

\n
{% set styles = 'some CSS here' %}\n{{ styles|minify_css }}
\n
<style>\n{% apply minify_css %}\n  html {\n    background-color: #fcfcfc;\n    color: #444;\n  }\n{% endapply %}\n</style>
\n

minify_js

\n

Réduire une chaîne JavaScript.

\n
{{ variable|minify_js }}
\n
{% apply minify_js %}\n{# JavaScript here #}\n{% endapply %}
\n

Exemples :

\n
{% set script = 'some JavaScript here' %}\n{{ script|minify_js }}
\n
<script>\n{% apply minify_js %}\n  var test = 'test';\n  console.log(test);\n{% endapply %}\n</script>
\n

scss_to_css

\n

Compile une chaîne Sass en CSS.

\n
{{ variable|scss_to_css }}
\n
{% apply scss_to_css %}\n{# SCSS here #}\n{% endapply %}
\n

Alias : sass_to_css.

\n

Exemples :

\n
{% set scss = 'some SCSS here' %}\n{{ scss|scss_to_css }}
\n
<style>\n{% apply scss_to_css %}\n  $color: #fcfcfc;\n  div {\n    color: lighten($color, 20%);\n  }\n{% endapply %}\n</style>
\n

to_css

\n

Compile un fichier Sass en CSS.

\n
{{ asset(path)|to_css }}\n{{ path|to_css }}
\n

Exemples :

\n
{{ asset('styles.scss')|to_css }}
\n

inline

\n

Affiche le contenu d'un Asset.

\n
{{ asset(path)|inline }}
\n

Exemple:

\n
{{ asset('styles.css')|inline }}
\n

dataurl

\n

Renvoie l'URL de données d'un actif.

\n
{{ asset(path)|dataurl }}\n{{ asset(image_path)|dataurl }}
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/templates/variables/", "url": "https://cecil-945.pages.dev/fr/documentation/templates/variables/", "title": "Variables", "summary": "Variables disponibles dans les templates : site, page et cecil.", "date_published": "2026-05-26T00:00:00+00:00", "date_modified": "2026-10-06T00:00:00+00:00","content_text": "Variables\n\nL'application transmet des variables aux templates pour manipulation dans le modèle. Les variables peuvent également avoir des attributs ou des éléments auxquels vous pouvez accéder.\nUtilisez un point (.) pour accéder aux attributs d'une variable : {{ foo.bar }}\n\nVous pouvez utiliser des variables de différentes portées : site, page, cecil.\nsite\nLa variable site contient des variables intégrées et celles définies dans la configuration.\n\n\n\nVariables\nDescriptif\n\n\n\n\nsite.pages\nCollection de toutes les pages, dans la langue actuelle.\n\n\nsite.allpages\nCollection de toutes les pages, dans toutes les langues.\n\n\nsite.page(id)\nUne page avec l'ID donné.\n\n\nsite.taxonomies\nRecueil de vocabulaires.\n\n\nsite.home\nID de la page d'accueil.\n\n\nsite.time\nActuel Timestamp.\n\n\nsite.debug\nÉtat du mode débogage (true ou false).\n\n\nsite.build\nID de build actuel.\n\n\n\nExemple:\ntitle: \"My amazing website!\"\nPeut être affiché dans un modèle avec :\n{{ site.title }}\nUtilisez la méthode showable sur la collection de pages pour renvoyer uniquement les pages publiées et non les pages virtuelles\/redirectes\/exclues.\nExemple:\n{% for page in site.pages.showable %}\n <a href=\"{{ url(page) }}\">{{ page.title }}<\/a>\n{% endfor %}\nDans certains cas, vous pouvez rencontrer des conflits entre la configuration et les variables intégrées (ex. : pages.default configuration), vous pouvez donc utiliser config.<variable> (avec <variable> est le nom\/chemin de la variable) pour accéder directement à la configuration brute.\nExemple:\n{{ config.pages.default.sitemap.priority }}\nsite.menus\nBouclez sur site.menus.<menu> pour obtenir chaque entrée de la collection <menu> (par exemple : main).\n\n\n\nVariables\nDescriptif\n\n\n\n\n<entry>.name\nNom de l'entrée.\n\n\n<entry>.url\nURL d'entrée.\n\n\n<entry>.weight\nPoids d'entrée (utile pour trier les entrées de menu).\n\n\n\nExemple:\n<nav>\n <ol>\n {% for entry in site.menus.main|sort_by_weight %}\n <li><a href=\"{{ url(entry.url) }}\" data-weight=\"{{ entry.weight }}\">{{ entry.name }}<\/a><\/li>\n {% endfor %}\n <\/ol>\n<\/nav>\nsite.language\nInformations sur la langue actuelle.\n\n\n\nVariables\nDescriptif\n\n\n\n\nsite.language\nCode de langue (ex. : en).\n\n\nsite.language.name\nNom de la langue (par exemple : English).\n\n\nsite.language.locale\nLangue code local (par exemple : en_US).\n\n\nsite.language.weight\nPosition de la langue dans la liste languages.\n\n\n\nVous pouvez récupérer name, locale et weight d'un langage spécifique en passant son code en paramètre.\npar exemple : site.language.name('fr').\nsite.static\nLa collection de fichiers statiques est accessible via site.static si le static load est activé.\nChaque fichier expose les propriétés suivantes :\n\npath : chemin relatif (ex. : \/images\/img-1.jpg)\ndate : date de création (timestamp)\nupdated : date de modification (timestamp)\nname : nom (ex. : img-1.jpg)\nbasename : nom sans extension (ex. : img-1)\next : poste (ex. : jpg)\ntype : type de média (ex. : image)\nsubtype : sous-type de média (ex. : image\/jpeg)\nexif : données EXIF ​​​​de l'image (array)\naudio : Mp3Info objet\nvideo : tableau d'informations vidéo de base (durée en secondes, largeur et hauteur)\n\nsite.data\nUne collection de données est accessible via site.data.<filename> (sans extension de fichier).\nExemples :\n\ndata\/authors.yml : site.data.authors\ndata\/authors.fr.yml : site.data.authors (si site.language = \"fr\")\ndata\/galleries\/gallery-1.json : site.data.galleries['gallery-1']\n\npage\nLa variable page contient les variables intégrées d'une page et celles définies dans le avant-plan.\n\n\n\nVariables\nDescriptif\nExemple\n\n\n\n\npage.id\nIdentifiant unique.\nblog\/post-1\n\n\npage.title\nNom du fichier (sans extension).\nPost 1\n\n\npage.date\nDate de création du fichier.\nDateHeure\n\n\npage.body\nCorps du fichier.\nMarquage\n\n\npage.content\nCorps du fichier converti en HTML.\nHTML\n\n\npage.section\nDossier racine du fichier (slugified).\nblog\n\n\npage.path\nChemin du fichier (slugified).\nblog\/post-1\n\n\npage.slug\nNom du fichier (slugified).\npost-1\n\n\npage.filepath\nChemin du système de fichiers.\nBlog\/Post 1.md\n\n\npage.type\nhomepage, page, section, vocabulary ou term.\npage\n\n\npage.pages\nCollection de toutes les sous-pages.\nCollection\n\n\npage.translations\nCollection de pages traduites.\nCollection\n\n\n\nUtilisez la méthode showable sur la collection de pages pour renvoyer uniquement les pages publiées et non les pages virtuelles\/redirectes\/exclues.\nExemple:\n{% for page in page.pages.showable %}\n <a href=\"{{ url(page) }}\">{{ page.title }}<\/a>\n{% endfor %}\nSections imbriquées\nDans un contexte de sections imbriquées, les propriétés page.parent, page.ancestors, page.sections et page.toplevel facilitent la construction de la navigation.\n\n\n\nVariables\nDescriptif\nExemple\n\n\n\n\npage.parent\nPage de la section parente (null si aucune).\nPage\n\n\npage.ancestors\nCollection des sections ancêtres (la plus proche en premier).\nCollection\n\n\npage.sections\nCollection des sections descendantes immédiates.\nCollection\n\n\npage.toplevel\ntrue si la page est une section de premier niveau.\nBoolean\n\n\n\nFil d'Ariane (de la page d'accueil à la page courante) :\n<nav aria-label=\"breadcrumb\">\n <ul>\n <li><a href=\"{{ url(site.home) }}\">{{ site.title }}<\/a><\/li>\n {% for section in page.ancestors|reverse %}\n <li><a href=\"{{ url(section) }}\">{{ section.title }}<\/a><\/li>\n {% endfor %}\n {% if page.id != site.home %}\n <li><a href=\"{{ url(page) }}\" aria-current=\"page\">{{ page.title }}<\/a><\/li>\n {% endif %}\n <\/ul>\n<\/nav>\nUn partial breadcrumb.html.twig prêt à l'emploi est disponible :\n{{ include('partials\/breadcrumb.html.twig') }}\nMenu des sous-sections (sections descendantes immédiates de la section courante) :\n{% if page.sections|length %}\n<ul>\n {% for section in page.sections|sort_by_title %}\n <li><a href=\"{{ url(section) }}\">{{ section.title }}<\/a><\/li>\n {% endfor %}\n<\/ul>\n{% endif %}\nNavigation principale limitée aux sections de premier niveau (depuis n'importe quelle page) :\n<nav>\n {% for section in site.page(site.home).sections|sort_by_title %}\n <a href=\"{{ url(section) }}\">{{ section.title }}<\/a>\n {% endfor %}\n<\/nav>\nLien vers la section parente :\n{% if page.parent %}\n<a href=\"{{ url(page.parent) }}\">← {{ page.parent.title }}<\/a>\n{% endif %}\npage.<prev\/next>\nNavigation entre les pages d'une même Section, triées selon le sortby de la section (ordre chronologique pour les dates).\nAvec des sous-sections, la navigation suit l'arbre des sections : les pages d'une Section de premier niveau et de toutes ses sous-sections sont enchaînées, chaque sous-section (sa page d'index) étant placée parmi les pages de sa Section parente et suivie de ses propres pages.\n\n\n\nVariables\nDescriptif\nExemple\n\n\n\n\npage.prev\nPage précédente.\nPage\n\n\npage.next\nPage suivante.\nPage\n\n\n\nExemple:\n<a href=\"{{ url(page.prev) }}\">{{ page.prev.title }}<\/a>\npage.paginator\nPaginator vous aide à créer une navigation pour les pages de la liste : page d'accueil, sections et taxonomies.\n\n\n\nVariables\nDescriptif\n\n\n\n\npage.paginator.pages\nCollection de pages.\n\n\npage.paginator.pages_total\nNombre total de pages.\n\n\npage.paginator.count\nNombre de pages du paginateur.\n\n\npage.paginator.current\nIndex de position de la page actuelle.\n\n\npage.paginator.links.first\nID de page de la première page.\n\n\npage.paginator.links.prev\nID de page de la page précédente.\n\n\npage.paginator.links.self\nID de page de la page actuelle.\n\n\npage.paginator.links.next\nID de page de la page suivante.\n\n\npage.paginator.links.last\nID de page de la dernière page.\n\n\npage.paginator.links.path\nID de page sans l'index de position.\n\n\n\nÉtant donné que les entrées de liens sont des ID de page, vous devez utiliser la fonction url() pour créer des liens fonctionnels.\npar exemple : {{ url(page.paginator.links.next) }}\nExemple:\n{% if page.paginator %}\n<div>\n {% if page.paginator.links.prev is defined %}\n <a href=\"{{ url(page.paginator.links.prev) }}\">Previous<\/a>\n {% endif %}\n {% if page.paginator.links.next is defined %}\n <a href=\"{{ url(page.paginator.links.next) }}\">Next<\/a>\n {% endif %}\n<\/div>\n{% endif %}\nExemple:\n{% if page.paginator %}\n<div>\n {% for paginator_index in 1..page.paginator.count %}\n {% if paginator_index != page.paginator.current %}\n {% if paginator_index == 1 %}\n <a href=\"{{ url(page.paginator.links.first) }}\">{{ paginator_index }}<\/a>\n {% else %}\n <a href=\"{{ url(page.paginator.links.path ~ '\/' ~ paginator_index) }}\">{{ paginator_index }}<\/a>\n {% endif %}\n {% else %}\n {{ paginator_index }}\n {% endif %}\n {% endfor %}\n<\/div>\n{% endif %}\nTaxonomie\nVariables disponibles dans les templates vocabulary et term.\nVocabulaire\nPage \/<plural>\/ (ex. : \/categories\/).\n\n\n\nVariables\nDescriptif\n\n\n\n\npage.plural\nNom de vocabulaire au pluriel.\n\n\npage.singular\nNom de vocabulaire au singulier.\n\n\npage.terms\nListe de termes (Collection).\n\n\n\nChaque terme de page.terms fournit term.id (identifiant du terme, ex. : categories\/php), term.name (nom du terme, ex. : PHP) et le nombre de ses pages avec term|length.\nTerme\nPage \/<plural>\/<term>\/ (ex. : \/categories\/php\/).\n\n\n\nVariables\nDescriptif\n\n\n\n\npage.title\nNom du terme.\n\n\npage.term\nIdentifiant du terme (ex. : categories\/php).\n\n\npage.plural\nNom de vocabulaire au pluriel.\n\n\npage.singular\nNom de vocabulaire au singulier.\n\n\npage.pages\nListe des pages dans ce terme, triées par date (Collection).\n\n\n\nExemple de taxonomie\nConfiguration :\ntaxonomies:\n categories: category\nFront matter d’une page :\n---\ncategories: [\"Data Sovereignty\"]\n---\nListe des termes (\/categories\/), dans layouts\/taxonomy\/categories.html.twig :\n{% extends 'page.html.twig' %}\n\n{% block content %}\n <h1>{{ page.title }}<\/h1>\n <ul>\n {% for term in page.terms %}\n <li><a href=\"{{ url(term.id) }}\">{{ term.name }}<\/a> ({{ term|length }})<\/li>\n {% endfor %}\n <\/ul>\n{% endblock %}\nListe des pages d’un terme (\/categories\/data-sovereignty\/), dans layouts\/taxonomy\/category.html.twig :\n{% extends 'page.html.twig' %}\n\n{% block content %}\n <h1>{{ page.title }}<\/h1>\n {% for p in page.paginator.pages ?? page.pages %}\n <article>\n <h2><a href=\"{{ url(p) }}\">{{ p.title }}<\/a><\/h2>\n <\/article>\n {% endfor %}\n <a href=\"{{ url(page.plural) }}\">Toutes les {{ page.plural }}<\/a>\n{% endblock %}\nLiens vers les termes de la page courante, dans un template de page :\n{% for category in page.categories ?? [] %}\n <a href=\"{{ url('categories\/' ~ category) }}\">{{ category }}<\/a>\n{% endfor %}\nLa fonction url() « slugifie » la chaîne fournie pour trouver la page correspondante : url('categories\/Data Sovereignty') retourne \/categories\/data-sovereignty\/.\nVous pouvez aussi utiliser le partial intégré {{ include('partials\/terms-list.html.twig', {vocabulary: 'categories'}) }}.\ncecil\n\n\n\nVariables\nDescriptif\n\n\n\n\ncecil.url\nURL du site Cecil.\n\n\ncecil.version\nVersion actuelle de Cecil.\n\n\ncecil.poweredby\nImprimez Cecil v%s, avec %s est la version actuelle.\n\n\n", "content_html": "

Variables

\n
\n

L'application transmet des variables aux templates pour manipulation dans le modèle. Les variables peuvent également avoir des attributs ou des éléments auxquels vous pouvez accéder.\nUtilisez un point (.) pour accéder aux attributs d'une variable : {{ foo.bar }}

\n
\n

Vous pouvez utiliser des variables de différentes portées : site, page, cecil.

\n

site

\n

La variable site contient des variables intégrées et celles définies dans la configuration.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
VariablesDescriptif
site.pagesCollection de toutes les pages, dans la langue actuelle.
site.allpagesCollection de toutes les pages, dans toutes les langues.
site.page(id)Une page avec l'ID donné.
site.taxonomiesRecueil de vocabulaires.
site.homeID de la page d'accueil.
site.timeActuel Timestamp.
site.debugÉtat du mode débogage (true ou false).
site.buildID de build actuel.
\n

Exemple:

\n
title: \"My amazing website!\"
\n

Peut être affiché dans un modèle avec :

\n
{{ site.title }}
\n\n\n

site.menus

\n

Bouclez sur site.menus.<menu> pour obtenir chaque entrée de la collection <menu> (par exemple : main).

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
VariablesDescriptif
<entry>.nameNom de l'entrée.
<entry>.urlURL d'entrée.
<entry>.weightPoids d'entrée (utile pour trier les entrées de menu).
\n

Exemple:

\n
<nav>\n  <ol>\n  {% for entry in site.menus.main|sort_by_weight %}\n    <li><a href=\"{{ url(entry.url) }}\" data-weight=\"{{ entry.weight }}\">{{ entry.name }}</a></li>\n  {% endfor %}\n  </ol>\n</nav>
\n

site.language

\n

Informations sur la langue actuelle.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
VariablesDescriptif
site.languageCode de langue (ex. : en).
site.language.nameNom de la langue (par exemple : English).
site.language.localeLangue code local (par exemple : en_US).
site.language.weightPosition de la langue dans la liste languages.
\n\n

site.static

\n

La collection de fichiers statiques est accessible via site.static si le static load est activé.

\n

Chaque fichier expose les propriétés suivantes :

\n\n

site.data

\n

Une collection de données est accessible via site.data.<filename> (sans extension de fichier).

\n

Exemples :

\n\n

page

\n

La variable page contient les variables intégrées d'une page et celles définies dans le avant-plan.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
VariablesDescriptifExemple
page.idIdentifiant unique.blog/post-1
page.titleNom du fichier (sans extension).Post 1
page.dateDate de création du fichier.DateHeure
page.bodyCorps du fichier.Marquage
page.contentCorps du fichier converti en HTML.HTML
page.sectionDossier racine du fichier (slugified).blog
page.pathChemin du fichier (slugified).blog/post-1
page.slugNom du fichier (slugified).post-1
page.filepathChemin du système de fichiers.Blog/Post 1.md
page.typehomepage, page, section, vocabulary ou term.page
page.pagesCollection de toutes les sous-pages.Collection
page.translationsCollection de pages traduites.Collection
\n\n

Sections imbriquées

\n

Dans un contexte de sections imbriquées, les propriétés page.parent, page.ancestors, page.sections et page.toplevel facilitent la construction de la navigation.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
VariablesDescriptifExemple
page.parentPage de la section parente (null si aucune).Page
page.ancestorsCollection des sections ancêtres (la plus proche en premier).Collection
page.sectionsCollection des sections descendantes immédiates.Collection
page.topleveltrue si la page est une section de premier niveau.Boolean
\n

Fil d'Ariane (de la page d'accueil à la page courante) :

\n
<nav aria-label=\"breadcrumb\">\n  <ul>\n    <li><a href=\"{{ url(site.home) }}\">{{ site.title }}</a></li>\n    {% for section in page.ancestors|reverse %}\n    <li><a href=\"{{ url(section) }}\">{{ section.title }}</a></li>\n    {% endfor %}\n    {% if page.id != site.home %}\n    <li><a href=\"{{ url(page) }}\" aria-current=\"page\">{{ page.title }}</a></li>\n    {% endif %}\n  </ul>\n</nav>
\n\n

Menu des sous-sections (sections descendantes immédiates de la section courante) :

\n
{% if page.sections|length %}\n<ul>\n  {% for section in page.sections|sort_by_title %}\n  <li><a href=\"{{ url(section) }}\">{{ section.title }}</a></li>\n  {% endfor %}\n</ul>\n{% endif %}
\n

Navigation principale limitée aux sections de premier niveau (depuis n'importe quelle page) :

\n
<nav>\n  {% for section in site.page(site.home).sections|sort_by_title %}\n  <a href=\"{{ url(section) }}\">{{ section.title }}</a>\n  {% endfor %}\n</nav>
\n

Lien vers la section parente :

\n
{% if page.parent %}\n<a href=\"{{ url(page.parent) }}\">← {{ page.parent.title }}</a>\n{% endif %}
\n

page.<prev/next>

\n

Navigation entre les pages d'une même Section, triées selon le sortby de la section (ordre chronologique pour les dates).

\n

Avec des sous-sections, la navigation suit l'arbre des sections : les pages d'une Section de premier niveau et de toutes ses sous-sections sont enchaînées, chaque sous-section (sa page d'index) étant placée parmi les pages de sa Section parente et suivie de ses propres pages.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
VariablesDescriptifExemple
page.prevPage précédente.Page
page.nextPage suivante.Page
\n

Exemple:

\n
<a href=\"{{ url(page.prev) }}\">{{ page.prev.title }}</a>
\n

page.paginator

\n

Paginator vous aide à créer une navigation pour les pages de la liste : page d'accueil, sections et taxonomies.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
VariablesDescriptif
page.paginator.pagesCollection de pages.
page.paginator.pages_totalNombre total de pages.
page.paginator.countNombre de pages du paginateur.
page.paginator.currentIndex de position de la page actuelle.
page.paginator.links.firstID de page de la première page.
page.paginator.links.prevID de page de la page précédente.
page.paginator.links.selfID de page de la page actuelle.
page.paginator.links.nextID de page de la page suivante.
page.paginator.links.lastID de page de la dernière page.
page.paginator.links.pathID de page sans l'index de position.
\n\n

Exemple:

\n
{% if page.paginator %}\n<div>\n  {% if page.paginator.links.prev is defined %}\n  <a href=\"{{ url(page.paginator.links.prev) }}\">Previous</a>\n  {% endif %}\n  {% if page.paginator.links.next is defined %}\n  <a href=\"{{ url(page.paginator.links.next) }}\">Next</a>\n  {% endif %}\n</div>\n{% endif %}
\n

Exemple:

\n
{% if page.paginator %}\n<div>\n  {% for paginator_index in 1..page.paginator.count %}\n    {% if paginator_index != page.paginator.current %}\n      {% if paginator_index == 1 %}\n  <a href=\"{{ url(page.paginator.links.first) }}\">{{ paginator_index }}</a>\n      {% else %}\n  <a href=\"{{ url(page.paginator.links.path ~ '/' ~ paginator_index) }}\">{{ paginator_index }}</a>\n      {% endif %}\n    {% else %}\n  {{ paginator_index }}\n    {% endif %}\n  {% endfor %}\n</div>\n{% endif %}
\n

Taxonomie

\n

Variables disponibles dans les templates vocabulary et term.

\n

Vocabulaire

\n

Page /<plural>/ (ex. : /categories/).

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
VariablesDescriptif
page.pluralNom de vocabulaire au pluriel.
page.singularNom de vocabulaire au singulier.
page.termsListe de termes (Collection).
\n

Chaque terme de page.terms fournit term.id (identifiant du terme, ex. : categories/php), term.name (nom du terme, ex. : PHP) et le nombre de ses pages avec term|length.

\n

Terme

\n

Page /<plural>/<term>/ (ex. : /categories/php/).

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
VariablesDescriptif
page.titleNom du terme.
page.termIdentifiant du terme (ex. : categories/php).
page.pluralNom de vocabulaire au pluriel.
page.singularNom de vocabulaire au singulier.
page.pagesListe des pages dans ce terme, triées par date (Collection).
\n

Exemple de taxonomie

\n

Configuration :

\n
taxonomies:\n  categories: category
\n

Front matter d’une page :

\n
---\ncategories: [\"Data Sovereignty\"]\n---
\n

Liste des termes (/categories/), dans layouts/taxonomy/categories.html.twig :

\n
{% extends 'page.html.twig' %}\n\n{% block content %}\n  <h1>{{ page.title }}</h1>\n  <ul>\n  {% for term in page.terms %}\n    <li><a href=\"{{ url(term.id) }}\">{{ term.name }}</a> ({{ term|length }})</li>\n  {% endfor %}\n  </ul>\n{% endblock %}
\n

Liste des pages d’un terme (/categories/data-sovereignty/), dans layouts/taxonomy/category.html.twig :

\n
{% extends 'page.html.twig' %}\n\n{% block content %}\n  <h1>{{ page.title }}</h1>\n  {% for p in page.paginator.pages ?? page.pages %}\n    <article>\n      <h2><a href=\"{{ url(p) }}\">{{ p.title }}</a></h2>\n    </article>\n  {% endfor %}\n  <a href=\"{{ url(page.plural) }}\">Toutes les {{ page.plural }}</a>\n{% endblock %}
\n

Liens vers les termes de la page courante, dans un template de page :

\n
{% for category in page.categories ?? [] %}\n  <a href=\"{{ url('categories/' ~ category) }}\">{{ category }}</a>\n{% endfor %}
\n\n

cecil

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
VariablesDescriptif
cecil.urlURL du site Cecil.
cecil.versionVersion actuelle de Cecil.
cecil.poweredbyImprimez Cecil v%s, avec %s est la version actuelle.
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/templates/reference/tris/", "url": "https://cecil-945.pages.dev/fr/documentation/templates/reference/tris/", "title": "Tris", "summary": "Triez des collections de pages, menus ou taxonomies.", "date_published": "2026-05-26T00:00:00+00:00", "date_modified": "2026-10-05T00:00:00+00:00","content_text": "Tris\nTri des collections (de pages, menus ou taxonomies).\nsort_by_title\nTrie une collection par titre (avec tri naturel).\n{{ collection|sort_by_title }}\nExemple:\n{{ site.pages|sort_by_title }}\nsort_by_date\nTrie une collection par date (la plus récente en premier).\n{{ collection|sort_by_date(variable='date', desc_title=false) }}\nExemple:\n{# sort by date #}\n{{ site.pages|sort_by_date }}\n{# sort by updated variable instead of date #}\n{{ site.pages|sort_by_date(variable='updated') }}\n{# sort items with the same date by desc title #}\n{{ site.pages|sort_by_date(desc_title=true) }}\n{# reverse sort #}\n{{ site.pages|sort_by_date|reverse }}\nsort_by_weight\nTrie une collection par poids (le plus léger en premier).\n{{ collection|sort_by_weight }}\nExemple:\n{{ site.menus.main|sort_by_weight }}\nsort\nPour les cas plus complexes, vous devez utiliser le sort natif de Twig.\nExemple:\n{% set files = site.static|sort((a, b) => a.date|date('U') < b.date|date('U')) %}", "content_html": "

Tris

\n

Tri des collections (de pages, menus ou taxonomies).

\n

sort_by_title

\n

Trie une collection par titre (avec tri naturel).

\n
{{ collection|sort_by_title }}
\n

Exemple:

\n
{{ site.pages|sort_by_title }}
\n

sort_by_date

\n

Trie une collection par date (la plus récente en premier).

\n
{{ collection|sort_by_date(variable='date', desc_title=false) }}
\n

Exemple:

\n
{# sort by date #}\n{{ site.pages|sort_by_date }}\n{# sort by updated variable instead of date #}\n{{ site.pages|sort_by_date(variable='updated') }}\n{# sort items with the same date by desc title #}\n{{ site.pages|sort_by_date(desc_title=true) }}\n{# reverse sort #}\n{{ site.pages|sort_by_date|reverse }}
\n

sort_by_weight

\n

Trie une collection par poids (le plus léger en premier).

\n
{{ collection|sort_by_weight }}
\n

Exemple:

\n
{{ site.menus.main|sort_by_weight }}
\n

sort

\n

Pour les cas plus complexes, vous devez utiliser le sort natif de Twig.

\n

Exemple:

\n
{% set files = site.static|sort((a, b) => a.date|date('U') < b.date|date('U')) %}
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/templates/reference/filtres/", "url": "https://cecil-945.pages.dev/fr/documentation/templates/reference/filtres/", "title": "Filtres", "summary": "filter_by, markdown_to_html, toc, slugify, excerpt, highlight, preg_*, etc.", "date_published": "2026-05-26T00:00:00+00:00", "date_modified": "2026-10-05T00:00:00+00:00","content_text": "Filtres\nLes variables peuvent être modifiées par filtres. Les filtres sont séparés de la variable par un symbole de barre verticale (|). Plusieurs filtres peuvent être chaînés. La sortie d’un filtre est appliquée au suivant.\n{{ page.title|truncate(25)|capitalize }}\nfilter_by\nFiltre une collection de pages par nom\/valeur de variable.\n{{ collection|filter_by(variable, value) }}\nExemple:\n{{ pages|filter_by('section', 'blog') }}\nfilter\nPour les cas plus complexes, vous devez utiliser le filter natif de Twig.\nExemple:\n{% pages|filter(p => p.virtual == false and p.id not in ['page-1', 'page-2']) %}\nmarkdown_to_html\nConvertit une chaîne Markdown en HTML.\n{{ markdown|markdown_to_html }}\n{% apply markdown_to_html %}\n{# Markdown here #}\n{% endapply %}\nExemples :\n{% set markdown = '**This is bold text**' %}\n{{ markdown|markdown_to_html }}\n{% apply markdown_to_html %}\n**This is bold text**\n{% endapply %}\ntoc\nExtrait uniquement les en-têtes correspondant au selectors donné (h2, h3, etc.), ou à ceux définis dans la configuration pages.body.toc s'ils ne sont pas spécifiés.\nLe paramètre format définit le format de sortie : html ou json.\nLe paramètre url est utilisé pour créer des liens vers des titres.\n{{ markdown|toc(format, selectors, url) }}\nExemples :\n{{ page.body|toc }}\n{{ page.body|toc('html') }}\n{{ page.body|toc(selectors=['h2']) }}\n{{ page.body|toc(url=url(page)) }}\njson_decode\nConvertit une chaîne JSON en tableau.\n{{ json|json_decode }}\nExemple:\n{% set json = '{\"foo\": \"bar\"}' %}\n{% set array = json|json_decode %}\n{{ array.foo }}\nyaml_parse\nConvertit une chaîne YAML en tableau.\n{{ yaml|yaml_parse }}\nExemple:\n{% set yaml = 'key: value' %}\n{% set array = yaml|yaml_parse %}\n{{ array.key }}\nslugify\nConvertit une chaîne en slug.\n{{ string|slugify }}\nu\nLe filtre u enveloppe un texte dans un objet Unicode (une instance Symfony UnicodeString) qui expose des méthodes pour « manipuler » la chaîne.\nExemple:\n{{ 'cecil_string with twig'|u.camel.title }}\n\nCecilStringAvecTwig\n\nsingular\nLe filtre singular transforme un nom donné au pluriel en sa version singulière.\n{{ string|singular(locale)}}\nExemple:\n{# English (en) rules are used by default #}\n{{ 'partitions'|singular }}\n\npartition\n\n{{ 'partitions'|singular('fr') }}\n\npartition\n\nplural\nLe filtre plural transforme un nom donné au singulier en sa version plurielle.\n{{ string|plural(locale)}}\nExemple:\n{# English (en) rules are used by default #}\n{{ 'animal'|plural }}\n\nanimaux\n\n{{ 'animal'|plural('fr') }}\n\nanimaux\n\nexcerpt\nTronque une chaîne et ajoute un suffixe.\n{{ string|excerpt(length, suffix) }}\n\n\n\nOptions\nDescriptif\nTapez\nPar défaut\n\n\n\n\nlongueur\nTronque après ce nombre de caractères.\nentier\n450\n\n\nsuffixe\nAjoute des caractères.\nchaîne\n…\n\n\n\nExemples :\n{{ variable|excerpt }}\n{{ variable|excerpt(250, '...') }}\nexcerpt_html\nLit les caractères avant ou après la balise <!-- excerpt --> ou <!-- break -->.\nVoir Documentation de contenu pour plus de détails.\n{{ string|excerpt_html({separator, capture}) }}\n\n\n\nOptions\nDescriptif\nTapez\nPar défaut\n\n\n\n\nséparateur\nChaîne à utiliser comme séparateur.\nchaîne\nexcerpt|break\n\n\ncapturer\nPièce à capturer, before ou after le séparateur.\nchaîne\nbefore\n\n\n\nExemples :\n{{ variable|excerpt_html }}\n{{ variable|excerpt_html({separator: 'excerpt|break', capture: 'before'}) }}\n{{ variable|excerpt_html({capture: 'after'}) }}\nhighlight\nMet en surbrillance une chaîne de code avec highlight.php.\n{{ code|highlight(language) }}\nExemples :\n{{ '<?php echo $highlighted->value; ?>'|highlight('php') }}\npreg_split\nDivise une chaîne en un tableau à l'aide d'une expression régulière.\n{{ string|preg_split(pattern, limit) }}\nExemple:\n{% set headers = page.content|preg_split('\/<br[^>]*>\/') %}\npreg_match_all\nEffectue une correspondance d'expression régulière et renvoie le groupe pour toutes les correspondances.\n{{ string|preg_match_all(pattern, group) }}\nExemple:\n{% set tags = page.content|preg_match_all('\/<[^>]+>(.*)<\\\/[^>]+>\/') %}\nhex_to_rgb\nConvertit une couleur hexadécimale en RVB.\n{{ color|hex_to_rgb }}", "content_html": "

Filtres

\n

Les variables peuvent être modifiées par filtres. Les filtres sont séparés de la variable par un symbole de barre verticale (|). Plusieurs filtres peuvent être chaînés. La sortie d’un filtre est appliquée au suivant.

\n
{{ page.title|truncate(25)|capitalize }}
\n

filter_by

\n

Filtre une collection de pages par nom/valeur de variable.

\n
{{ collection|filter_by(variable, value) }}
\n

Exemple:

\n
{{ pages|filter_by('section', 'blog') }}
\n

filter

\n

Pour les cas plus complexes, vous devez utiliser le filter natif de Twig.

\n

Exemple:

\n
{% pages|filter(p => p.virtual == false and p.id not in ['page-1', 'page-2']) %}
\n

markdown_to_html

\n

Convertit une chaîne Markdown en HTML.

\n
{{ markdown|markdown_to_html }}
\n
{% apply markdown_to_html %}\n{# Markdown here #}\n{% endapply %}
\n

Exemples :

\n
{% set markdown = '**This is bold text**' %}\n{{ markdown|markdown_to_html }}
\n
{% apply markdown_to_html %}\n**This is bold text**\n{% endapply %}
\n

toc

\n

Extrait uniquement les en-têtes correspondant au selectors donné (h2, h3, etc.), ou à ceux définis dans la configuration pages.body.toc s'ils ne sont pas spécifiés.\nLe paramètre format définit le format de sortie : html ou json.\nLe paramètre url est utilisé pour créer des liens vers des titres.

\n
{{ markdown|toc(format, selectors, url) }}
\n

Exemples :

\n
{{ page.body|toc }}\n{{ page.body|toc('html') }}\n{{ page.body|toc(selectors=['h2']) }}\n{{ page.body|toc(url=url(page)) }}
\n

json_decode

\n

Convertit une chaîne JSON en tableau.

\n
{{ json|json_decode }}
\n

Exemple:

\n
{% set json = '{\"foo\": \"bar\"}' %}\n{% set array = json|json_decode %}\n{{ array.foo }}
\n

yaml_parse

\n

Convertit une chaîne YAML en tableau.

\n
{{ yaml|yaml_parse }}
\n

Exemple:

\n
{% set yaml = 'key: value' %}\n{% set array = yaml|yaml_parse %}\n{{ array.key }}
\n

slugify

\n

Convertit une chaîne en slug.

\n
{{ string|slugify }}
\n

u

\n

Le filtre u enveloppe un texte dans un objet Unicode (une instance Symfony UnicodeString) qui expose des méthodes pour « manipuler » la chaîne.

\n

Exemple:

\n
{{ 'cecil_string with twig'|u.camel.title }}
\n
\n

CecilStringAvecTwig

\n
\n

singular

\n

Le filtre singular transforme un nom donné au pluriel en sa version singulière.

\n
{{ string|singular(locale)}}
\n

Exemple:

\n
{# English (en) rules are used by default #}\n{{ 'partitions'|singular }}
\n
\n

partition

\n
\n
{{ 'partitions'|singular('fr') }}
\n
\n

partition

\n
\n

plural

\n

Le filtre plural transforme un nom donné au singulier en sa version plurielle.

\n
{{ string|plural(locale)}}
\n

Exemple:

\n
{# English (en) rules are used by default #}\n{{ 'animal'|plural }}
\n
\n

animaux

\n
\n
{{ 'animal'|plural('fr') }}
\n
\n

animaux

\n
\n

excerpt

\n

Tronque une chaîne et ajoute un suffixe.

\n
{{ string|excerpt(length, suffix) }}
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
OptionsDescriptifTapezPar défaut
longueurTronque après ce nombre de caractères.entier450
suffixeAjoute des caractères.chaîne…
\n

Exemples :

\n
{{ variable|excerpt }}\n{{ variable|excerpt(250, '...') }}
\n

excerpt_html

\n

Lit les caractères avant ou après la balise <!-- excerpt --> ou <!-- break -->.\nVoir Documentation de contenu pour plus de détails.

\n
{{ string|excerpt_html({separator, capture}) }}
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
OptionsDescriptifTapezPar défaut
séparateurChaîne à utiliser comme séparateur.chaîneexcerpt|break
capturerPièce à capturer, before ou after le séparateur.chaînebefore
\n

Exemples :

\n
{{ variable|excerpt_html }}\n{{ variable|excerpt_html({separator: 'excerpt|break', capture: 'before'}) }}\n{{ variable|excerpt_html({capture: 'after'}) }}
\n

highlight

\n

Met en surbrillance une chaîne de code avec highlight.php.

\n
{{ code|highlight(language) }}
\n

Exemples :

\n
{{ '<?php echo $highlighted->value; ?>'|highlight('php') }}
\n

preg_split

\n

Divise une chaîne en un tableau à l'aide d'une expression régulière.

\n
{{ string|preg_split(pattern, limit) }}
\n

Exemple:

\n
{% set headers = page.content|preg_split('/<br[^>]*>/') %}
\n

preg_match_all

\n

Effectue une correspondance d'expression régulière et renvoie le groupe pour toutes les correspondances.

\n
{{ string|preg_match_all(pattern, group) }}
\n

Exemple:

\n
{% set tags = page.content|preg_match_all('/<[^>]+>(.*)<\\/[^>]+>/') %}
\n

hex_to_rgb

\n

Convertit une couleur hexadécimale en RVB.

\n
{{ color|hex_to_rgb }}
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/templates/composants/", "url": "https://cecil-945.pages.dev/fr/documentation/templates/composants/", "title": "Composants", "summary": "Créez des composants de template réutilisables.", "date_published": "2026-05-26T00:00:00+00:00", "date_modified": "2026-10-05T00:00:00+00:00","content_text": "Composants\nCecil fournit une logique de composants pour vous donner le pouvoir de créer des \"unités\" de templates réutilisables.\nLa fonctionnalité des composants est fournie par l'extension de composants Twig créée par Giorgio Pogliani.\nSyntaxe des composants\nLes composants ne sont que des templates Twig stockés dans le sous-répertoire components\/ et peuvent être utilisés n'importe où dans vos templates :\n{# \/components\/button.twig #}\n<button {{ attributes.merge({class: 'rounded px-4'}) }}>\n {{ slot }}\n<\/button>\n\nLa variable slot correspond à tout contenu que vous ajouterez entre la balise d'ouverture et la balise de fermeture.\n\nPour accéder à un composant vous devez utiliser la balise dédiée x suivie de : et du nom de fichier de votre composant sans extension :\n{# \/index.twig #}\n{% x:button with {class: 'text-white'} %}\n <strong>Click me<\/strong>\n{% endx %}\nIl rendra :\n<button class=\"text-white rounded px-4\">\n <strong>Click me<\/strong>\n<\/button>", "content_html": "

Composants

\n

Cecil fournit une logique de composants pour vous donner le pouvoir de créer des \"unités\" de templates réutilisables.

\n\n

Syntaxe des composants

\n

Les composants ne sont que des templates Twig stockés dans le sous-répertoire components/ et peuvent être utilisés n'importe où dans vos templates :

\n
{# /components/button.twig #}\n<button {{ attributes.merge({class: 'rounded px-4'}) }}>\n    {{ slot }}\n</button>
\n
\n

La variable slot correspond à tout contenu que vous ajouterez entre la balise d'ouverture et la balise de fermeture.

\n
\n

Pour accéder à un composant vous devez utiliser la balise dédiée x suivie de : et du nom de fichier de votre composant sans extension :

\n
{# /index.twig #}\n{% x:button with {class: 'text-white'} %}\n    <strong>Click me</strong>\n{% endx %}
\n

Il rendra :

\n
<button class=\"text-white rounded px-4\">\n    <strong>Click me</strong>\n</button>
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/templates/localisation/", "url": "https://cecil-945.pages.dev/fr/documentation/templates/localisation/", "title": "Localisation", "summary": "Traduisez les textes et localisez les dates dans les templates.", "date_published": "2026-05-26T00:00:00+00:00", "date_modified": "2026-10-05T00:00:00+00:00","content_text": "Localisation\nCecil prend en charge traduction du texte et localisation de la date.\nTraduction de texte\nUtilise le trans tag ou filter pour traduire des textes dans des templates.\n{% trans with variables into locale %}{% endtrans %}\n{{ message|trans(variables = []) }}\nExemples\n{% trans %}Hello World!{% endtrans %}\n{{ message|trans }}\nInclure des variables :\n{% trans with {'%name%': 'Arnaud'} %}Hello %name%!{% endtrans %}\n{{ message|trans({'%name%': 'Arnaud'}) }}\nForcer les paramètres régionaux :\n{% trans into 'fr_FR' %}Hello World!{% endtrans %}\nPluraliser :\n{% trans with {'%count%': 42}%}{0}I don't have apples|{1}I have one apple|]1,Inf[I have %count% apples{% endtrans %}\nFichiers de traduction\nLes fichiers de traduction doivent être nommés messages.<locale>.<extension> et stockés dans le répertoire translations.\nLes extensions prises en charge sont définies pour chaque format de traduction dans layouts.translations.formats.\nLe code locale (ex. : fr_FR) d'une langue est défini dans les entrées languages de la configuration.\nExemple:\n<mywebsite>\n└─ translations\n ├─ messages.fr_FR.mo <- Machine Object format\n └─ messages.fr_FR.yaml <- Yaml format\nVous pouvez facilement extraire les traductions de vos templates avec la commande suivante :\nphp cecil.phar util:translations:extract --locale=<code> --show\nUtilisez --save à la place (ou en plus) de --show pour enregistrer les traductions dans un fichier. L'option --locale est obligatoire. Le format de sortie par défaut est yaml (utilisez --format=po pour le format gettext PO).\nPoedit est un éditeur de traduction simple et multiplateforme pour gettext (PO), et Poedit Pro prend en charge l'extraction de chaînes de traduction à partir de templates prêts à l'emploi.\nFaites attention au cache lorsque vous mettez à jour les fichiers de traduction.\nLe cache peut être vidé avec la commande suivante :\nphp cecil.phar cache:clear:translations`\nLocalisation de la date\nUtilise le filtre Twig format_date pour localiser une date dans les templates.\n{{ page.date|format_date('long') }}\n{# September 30, 2022 #}\nLes valeurs prises en charge sont : short, medium, long et full.\nSi vous souhaitez utiliser le filtre format_date avec des paramètres régionaux autres que \"en\", vous devez installer l'extension PHP internationale.", "content_html": "

Localisation

\n

Cecil prend en charge traduction du texte et localisation de la date.

\n

Traduction de texte

\n

Utilise le trans tag ou filter pour traduire des textes dans des templates.

\n
{% trans with variables into locale %}{% endtrans %}
\n
{{ message|trans(variables = []) }}
\n

Exemples

\n
{% trans %}Hello World!{% endtrans %}
\n
{{ message|trans }}
\n

Inclure des variables :

\n
{% trans with {'%name%': 'Arnaud'} %}Hello %name%!{% endtrans %}
\n
{{ message|trans({'%name%': 'Arnaud'}) }}
\n

Forcer les paramètres régionaux :

\n
{% trans into 'fr_FR' %}Hello World!{% endtrans %}
\n

Pluraliser :

\n
{% trans with {'%count%': 42}%}{0}I don't have apples|{1}I have one apple|]1,Inf[I have %count% apples{% endtrans %}
\n

Fichiers de traduction

\n

Les fichiers de traduction doivent être nommés messages.<locale>.<extension> et stockés dans le répertoire translations.\nLes extensions prises en charge sont définies pour chaque format de traduction dans layouts.translations.formats.

\n

Le code locale (ex. : fr_FR) d'une langue est défini dans les entrées languages de la configuration.

\n

Exemple:

\n
<mywebsite>\n└─ translations\n   ├─ messages.fr_FR.mo   <- Machine Object format\n   └─ messages.fr_FR.yaml <- Yaml format
\n\n\n\n

Localisation de la date

\n

Utilise le filtre Twig format_date pour localiser une date dans les templates.

\n
{{ page.date|format_date('long') }}\n{# September 30, 2022 #}
\n

Les valeurs prises en charge sont : short, medium, long et full.

\n", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/templates/cache/", "url": "https://cecil-945.pages.dev/fr/documentation/templates/cache/", "title": "Cache", "summary": "Cache des templates et cache de fragments.", "date_published": "2026-05-26T00:00:00+00:00", "date_modified": "2026-10-05T00:00:00+00:00","content_text": "Cache\nCecil utilise un système de cache pour accélérer le processus de génération, il peut être désactivé ou effacé.\nIl existe trois types de cache dans le cas du rendu des templates : les templates eux-mêmes, assets et translations.\nVider le cache\nVous pouvez vider le cache avec les commandes suivantes :\nphp cecil.phar cache:clear # clear all caches\nphp cecil.phar cache:clear:assets # clear assets cache\nphp cecil.phar cache:clear:templates # clear templates cache\nphp cecil.phar cache:clear:translations # clear translations cache\nEn pratique, vous n'avez pas besoin de vider le cache manuellement, Cecil le fait pour vous en cas de besoin (par exemple lorsque des fichiers changent).\nFragments de cache\nCecil fournit un moyen de mettre en cache des parties du rendu des templates pour éviter de restituer plusieurs fois le même contenu partiel.\nPour utiliser les fragments de cache, vous devez envelopper le contenu que vous souhaitez mettre en cache avec la balise cache.\n{% cache 'unique-key' %}\n {# cacheable content #}\n{% endcache %}\nVous devez utiliser la fonction cache_key pour être sûr d'avoir une clé de cache unique pour chaque contenu que vous souhaitez mettre en cache.\nLes fragments de cache sont persistants, donc si la clé de cache est trop générique, vous risquez de vous retrouver avec un mauvais contenu affiché.\nPour vider uniquement le cache des fragments, vous pouvez utiliser la commande suivante :\nphp cecil.phar cache:clear:templates --fragments\nDésactiver le cache\nVous pouvez désactiver le cache avec la configuration.\nLa désactivation du cache peut ralentir le processus de génération, ce n'est donc pas recommandé.\nLors du développement local, si vous devez vider le cache avant chaque génération, vous pouvez utiliser l'option suivante :\nphp cecil.phar serve --clear-cache # clear all caches\nphp cecil.phar serve --clear-cache=<regex> # clear cache for cache key matches with the regular expression <regex>\nExemple:\nphp cecil.phar serve --clear-cache=css # clear cache for all CSS files", "content_html": "

Cache

\n

Cecil utilise un système de cache pour accélérer le processus de génération, il peut être désactivé ou effacé.

\n

Il existe trois types de cache dans le cas du rendu des templates : les templates eux-mêmes, assets et translations.

\n

Vider le cache

\n

Vous pouvez vider le cache avec les commandes suivantes :

\n
php cecil.phar cache:clear               # clear all caches\nphp cecil.phar cache:clear:assets        # clear assets cache\nphp cecil.phar cache:clear:templates     # clear templates cache\nphp cecil.phar cache:clear:translations  # clear translations cache
\n\n

Fragments de cache

\n

Cecil fournit un moyen de mettre en cache des parties du rendu des templates pour éviter de restituer plusieurs fois le même contenu partiel.

\n

Pour utiliser les fragments de cache, vous devez envelopper le contenu que vous souhaitez mettre en cache avec la balise cache.

\n
{% cache 'unique-key' %}\n  {# cacheable content #}\n{% endcache %}
\n\n\n

Pour vider uniquement le cache des fragments, vous pouvez utiliser la commande suivante :

\n
php cecil.phar cache:clear:templates --fragments
\n

Désactiver le cache

\n

Vous pouvez désactiver le cache avec la configuration.

\n", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/templates/etendre/", "url": "https://cecil-945.pages.dev/fr/documentation/templates/etendre/", "title": "Étendre", "summary": "Ajoutez des fonctions et filtres personnalisés, ou utilisez un thème.", "date_published": "2026-05-26T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "Étendre\nLes templates peuvent être étendus avec des fonctions et filtres personnalisés, ou regroupés dans un thème réutilisable.\nFonctions et filtres\nVous pouvez ajouter des fonctions et des filtres personnalisés avec une extension Twig.\nThème\nC'est simple de construire un thème, il suffit de créer un dossier <theme> avec la structure suivante (comme un site web mais sans pages) :\n<mywebsite>\n└─ themes\n └─ <theme>\n ├─ config.yml\n ├─ assets\n ├─ layouts\n ├─ static\n └─ translations", "content_html": "

Étendre

\n

Les templates peuvent être étendus avec des fonctions et filtres personnalisés, ou regroupés dans un thème réutilisable.

\n

Fonctions et filtres

\n

Vous pouvez ajouter des fonctions et des filtres personnalisés avec une extension Twig.

\n

Thème

\n

C'est simple de construire un thème, il suffit de créer un dossier <theme> avec la structure suivante (comme un site web mais sans pages) :

\n
<mywebsite>\n└─ themes\n   └─ <theme>\n      ├─ config.yml\n      ├─ assets\n      ├─ layouts\n      ├─ static\n      └─ translations
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/commandes/new-site/", "url": "https://cecil-945.pages.dev/fr/documentation/commandes/new-site/", "title": "new:site", "summary": "Créer un nouveau site.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "new:site\nCrée un nouveau site.\nUtilisation\nDescription:\n Creates a new website\n\nUsage:\n new:site [options] [--] [<path>]\n\nArguments:\n path Use the given path as working directory\n\nOptions:\n -f, --force Override directory if it already exists\n --demo Add demo content (pages, templates and assets)\n -h, --help Display help for the given command. When no command is given display help for the list command\n -q, --quiet Do not output any message\n -V, --version Display this application version\n --ansi|--no-ansi Force (or disable --no-ansi) ANSI output\n -n, --no-interaction Do not ask any interactive question\n -v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug\n\nHelp:\n The new:site command creates a new website in the current directory, or in <path> if provided.\n If you run this command without any options, it will ask you for the website title, baseline, base URL, description, etc.\n\n cecil.phar new:site\n cecil.phar new:site path\/to\/the\/working\/directory\n\n To create a new website with demo content, run:\n\n cecil.phar new:site --demo\n\n To override an existing website, run:\n\n cecil.phar new:site --force", "content_html": "

new:site

\n

Crée un nouveau site.

\n

Utilisation

\n
Description:\n  Creates a new website\n\nUsage:\n  new:site [options] [--] [<path>]\n\nArguments:\n  path                  Use the given path as working directory\n\nOptions:\n  -f, --force           Override directory if it already exists\n      --demo            Add demo content (pages, templates and assets)\n  -h, --help            Display help for the given command. When no command is given display help for the list command\n  -q, --quiet           Do not output any message\n  -V, --version         Display this application version\n      --ansi|--no-ansi  Force (or disable --no-ansi) ANSI output\n  -n, --no-interaction  Do not ask any interactive question\n  -v|vv|vvv, --verbose  Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug\n\nHelp:\n  The new:site command creates a new website in the current directory, or in <path> if provided.\n  If you run this command without any options, it will ask you for the website title, baseline, base URL, description, etc.\n\n    cecil.phar new:site\n    cecil.phar new:site path/to/the/working/directory\n\n  To create a new website with demo content, run:\n\n    cecil.phar new:site --demo\n\n  To override an existing website, run:\n\n    cecil.phar new:site --force
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/configuration/site/", "url": "https://cecil-945.pages.dev/fr/documentation/configuration/site/", "title": "Options du site", "summary": "title, baseurl, menus, taxonomies, theme, date, metatags, debug, etc.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "Options du site\nCes options définissent les réglages principaux du site : titre, URL, description, menus, taxonomies, thème, métadonnées, etc.\ntitle\nTitre principal du site.\ntitle: \"<site title>\"\nbaseline\nDescription courte (~ 20 caractères).\nbaseline: \"<baseline>\"\nbaseurl\nURL de base.\nbaseurl: <url>\nExemple :\nbaseurl: http:\/\/localhost:8000\/\nbaseurl doit se terminer par un slash final (\/).\ncanonicalurl\nSi la valeur est true, la fonction url() renverra l’URL absolue (false par défaut).\ncanonicalurl: <true|false> # false by default\ndescription\nDescription du site (~ 250 caractères).\ndescription: \"<description>\"\nmenus\nLes menus sont utilisés pour créer des liens de navigation dans les templates.\nUn menu est composé d’un identifiant unique et des propriétés des entrées (nom, URL, poids).\nmenus:\n <name>:\n - id: <unique-id> # unique identifier (required)\n name: \"<name>\" # name displayed in templates\n url: <url> # relative or absolute URL\n weight: <integer> # integer value used to sort entries (lighter first)\nExemple :\nmenus:\n main:\n - id: about\n name: \"About\"\n url: \/about\/\n weight: 1\n footer:\n - id: author\n name: The author\n url: https:\/\/arnaudligny.fr\n weight: 99\nUn menu main est créé automatiquement avec l’entrée de la page d’accueil et toutes les entrées de sections (Voir la gestion du contenu).\nUne page peut être ajoutée à un menu en définissant la variable menu dans son front matter.\nSurcharger une entrée\nUne entrée de menu de page peut être surchargée : utilisez l’ID de la page comme id.\nExemple :\nmenus:\n main:\n - id: index\n name: \"My amazing homepage!\"\n weight: 1\nDésactiver une entrée\nUne entrée de menu peut être désactivée avec enabled: false.\nExemple :\nmenus:\n main:\n - id: about\n enabled: false\ntaxonomies\nListe des vocabulaires, associant une valeur au pluriel à une valeur au singulier.\ntaxonomies:\n <plural>: <singular>\nExemple :\ntaxonomies:\n categories: category\n tags: tag\nVous pouvez ensuite utiliser ces vocabulaires dans le front matter de votre contenu.\nDepuis la version 8.37.0, les vocabulaires par défaut category et tag ont été supprimés. Vous devez les définir dans le fichier de configuration si vous souhaitez les utiliser.\nUn vocabulaire peut être désactivé avec la valeur spéciale disabled. Exemple : tags: disabled.\ntheme\nThème à utiliser, ou liste de thèmes.\ntheme: <theme> # theme name\n# or\ntheme:\n - <theme1> # theme name\n - <theme2>\nLe premier thème surcharge les suivants, et ainsi de suite.\nExemples :\ntheme: hyde\ntheme:\n - serviceworker\n - hyde\nVoir les thèmes sur GitHub ou la section thèmes du site.\ndate\nFormat de date et fuseau horaire.\ndate:\n format: <format> # date format (optional, `F j, Y` by default)\n timezone: <timezone> # date timezone (optional, local time zone by default)\n\nformat : spécificateur de format de date PHP\ntimezone : voir les fuseaux horaires\n\nExemple :\ndate:\n format: 'j F, Y'\n timezone: 'Europe\/Paris'\nmetatags\nLes metatags sont des aides SEO et réseaux sociaux qui peuvent être injectées automatiquement dans le <head>, via le template partials\/metatags.html.twig.\nCe template ajoute les balises meta suivantes :\n\nTitre de page + titre du site, ou titre du site + baseline du site\nDescription de la page\/du site\nMots-clés de la page\/du site\nAuteur de la page\/du site\nDirectives des robots des moteurs de recherche (robots)\nLiens de favicon\nLiens de navigation (premier, précédent, suivant, dernier)\nURL canonique\nLiens alternatifs (ex. : flux RSS, autres langues)\nLiens rel=me\nOpen Graph\nIdentifiant de profil Facebook\nTwitter\/X Card\nFediverse tag\nDublin Core\nStructured data (JSON-LD)\n\noptions metatags\nCecil utilise le front matter de la page pour alimenter les meta tags, avec repli sur les options du site si nécessaire.\ntitle: \"Page\/Site title\" # used by title meta\ndescription: \"Page\/Site description\" # used by description meta\ntags: [tag1, tag2] # used by keywords meta\nkeywords: [keyword1, keyword2] # obsolete\nauthor: # used by author meta\n name: <name> # author name\n url: <url> # author URL\n email: <email> # author email\nimage: image.jpg # used by Open Graph and social networks cards\ncanonical: # used to override the generated canonical URL\n url: <URL> # absolute URL\n title: \"<URL title>\" # optional canonical title\nsocial: # used by social networks meta\n twitter: # used by Twitter\/X Card\n url: <URL> # used for `rel=me` link\n site: username # site username\n creator: username # page author username\n mastodon: # used by Mastodon meta\n url: <URL> # used for `rel=me` link\n creator: handle # page author account\n facebook: # used by Facebook meta\n url: <URL> # used for `rel=me` link\n id: 123456789 # Facebook profile ID\n username: username # page author username\nSi besoin, title et image peuvent être surchargés :\n{{ include('partials\/metatags.html.twig', {title: 'Custom title', image: og_image}) }}\nconfiguration metatags\nmetatags:\n title: # title options\n divider: \" &middot; \" # string between page title and site title\n only: false # displays page title only (`false` by default)\n pagination: # pagination options\n shownumber: true # displays page number in title (`true` by default)\n label: \"Page %s\" # how to display page number (`Page %s` by default)\n robots: \"index,follow\" # web crawlers directives (`index,follow` by default)\n favicon: # favicon options\n enabled: true # includes favicon (`true` by default)\n image: favicon.png # path to favicon image\n sizes: # sizes by device\n - \"icon\": [32, 57, 76, 96, 128, 192, 228] # web browsers\n - \"shortcut icon\": [196] # Android\n - \"apple-touch-icon\": [120, 152, 180] # iOS\n navigation: true # includes previous and next links (`true` by default)\n image: true # includes image (`true` by default)\n og: true # includes Open Graph meta tags (`true` by default)\n articles: \"blog\" # articles' section (`blog` by default)\n twitter: true # includes Twitter\/X Card meta tags (`true` by default)\n mastodon: true # includes Mastodon meta tags (`true` by default)\n dc: false # includes Dublin Core meta tags (`false` by default)\n data: false # includes JSON-LD structured data (`false` by default)\ndebug\nActive le mode debug, utilisé pour afficher des informations de débogage comme des journaux très verbeux, le dump Twig, le profileur Twig, le sourcemap SCSS, etc.\ndebug: true\nIl existe deux autres façons d’activer le mode debug :\n\nExécuter une commande avec l’option -vvv\nDéfinir la variable d’environnement CECIL_DEBUG à true\n\n", "content_html": "

Options du site

\n

Ces options définissent les réglages principaux du site : titre, URL, description, menus, taxonomies, thème, métadonnées, etc.

\n

title

\n

Titre principal du site.

\n
title: \"<site title>\"
\n

baseline

\n

Description courte (~ 20 caractères).

\n
baseline: \"<baseline>\"
\n

baseurl

\n

URL de base.

\n
baseurl: <url>
\n

Exemple :

\n
baseurl: http://localhost:8000/
\n\n

canonicalurl

\n

Si la valeur est true, la fonction url() renverra l’URL absolue (false par défaut).

\n
canonicalurl: <true|false> # false by default
\n

description

\n

Description du site (~ 250 caractères).

\n
description: \"<description>\"
\n

menus

\n

Les menus sont utilisés pour créer des liens de navigation dans les templates.

\n

Un menu est composé d’un identifiant unique et des propriétés des entrées (nom, URL, poids).

\n
menus:\n  <name>:\n    - id: <unique-id>   # unique identifier (required)\n      name: \"<name>\"    # name displayed in templates\n      url: <url>        # relative or absolute URL\n      weight: <integer> # integer value used to sort entries (lighter first)
\n

Exemple :

\n
menus:\n  main:\n    - id: about\n      name: \"About\"\n      url: /about/\n      weight: 1\n  footer:\n    - id: author\n      name: The author\n      url: https://arnaudligny.fr\n      weight: 99
\n\n\n

Surcharger une entrée

\n

Une entrée de menu de page peut être surchargée : utilisez l’ID de la page comme id.

\n

Exemple :

\n
menus:\n  main:\n    - id: index\n      name: \"My amazing homepage!\"\n      weight: 1
\n

Désactiver une entrée

\n

Une entrée de menu peut être désactivée avec enabled: false.

\n

Exemple :

\n
menus:\n  main:\n    - id: about\n      enabled: false
\n

taxonomies

\n

Liste des vocabulaires, associant une valeur au pluriel à une valeur au singulier.

\n
taxonomies:\n  <plural>: <singular>
\n

Exemple :

\n
taxonomies:\n  categories: category\n  tags: tag
\n

Vous pouvez ensuite utiliser ces vocabulaires dans le front matter de votre contenu.

\n\n\n

theme

\n

Thème à utiliser, ou liste de thèmes.

\n
theme: <theme> # theme name\n# or\ntheme:\n  - <theme1> # theme name\n  - <theme2>
\n\n

Exemples :

\n
theme: hyde
\n
theme:\n  - serviceworker\n  - hyde
\n\n

date

\n

Format de date et fuseau horaire.

\n
date:\n  format: <format>     # date format (optional, `F j, Y` by default)\n  timezone: <timezone> # date timezone (optional, local time zone by default)
\n\n

Exemple :

\n
date:\n  format: 'j F, Y'\n  timezone: 'Europe/Paris'
\n

metatags

\n

Les metatags sont des aides SEO et réseaux sociaux qui peuvent être injectées automatiquement dans le <head>, via le template partials/metatags.html.twig.

\n

Ce template ajoute les balises meta suivantes :

\n\n

options metatags

\n

Cecil utilise le front matter de la page pour alimenter les meta tags, avec repli sur les options du site si nécessaire.

\n
title: \"Page/Site title\"              # used by title meta\ndescription: \"Page/Site description\"  # used by description meta\ntags: [tag1, tag2]                    # used by keywords meta\nkeywords: [keyword1, keyword2]        # obsolete\nauthor:                               # used by author meta\n  name: <name>                          # author name\n  url: <url>                            # author URL\n  email: <email>                        # author email\nimage: image.jpg                      # used by Open Graph and social networks cards\ncanonical:                            # used to override the generated canonical URL\n  url: <URL>                            # absolute URL\n  title: \"<URL title>\"                  # optional canonical title\nsocial:                               # used by social networks meta\n  twitter:                              # used by Twitter/X Card\n    url: <URL>                            # used for `rel=me` link\n    site: username                        # site username\n    creator: username                     # page author username\n  mastodon:                             # used by Mastodon meta\n    url: <URL>                            # used for `rel=me` link\n    creator: handle                       # page author account\n  facebook:                             # used by Facebook meta\n    url: <URL>                            # used for `rel=me` link\n    id: 123456789                         # Facebook profile ID\n    username: username                    # page author username
\n\n

configuration metatags

\n
metatags:\n  title:                   # title options\n    divider: \" &middot; \"    # string between page title and site title\n    only: false              # displays page title only (`false` by default)\n    pagination:              # pagination options\n      shownumber: true         # displays page number in title (`true` by default)\n      label: \"Page %s\"         # how to display page number (`Page %s` by default)\n  robots: \"index,follow\"   # web crawlers directives (`index,follow` by default)\n  favicon:                 # favicon options\n    enabled: true            # includes favicon (`true` by default)\n    image: favicon.png       # path to favicon image\n    sizes:                   # sizes by device\n      - \"icon\": [32, 57, 76, 96, 128, 192, 228]  # web browsers\n      - \"shortcut icon\": [196]                   # Android\n      - \"apple-touch-icon\": [120, 152, 180]      # iOS\n  navigation: true         # includes previous and next links (`true` by default)\n  image: true              # includes image (`true` by default)\n  og: true                 # includes Open Graph meta tags (`true` by default)\n  articles: \"blog\"         # articles' section (`blog` by default)\n  twitter: true            # includes Twitter/X Card meta tags (`true` by default)\n  mastodon: true           # includes Mastodon meta tags (`true` by default)\n  dc: false                # includes Dublin Core meta tags (`false` by default)\n  data: false              # includes JSON-LD structured data (`false` by default)
\n

debug

\n

Active le mode debug, utilisé pour afficher des informations de débogage comme des journaux très verbeux, le dump Twig, le profileur Twig, le sourcemap SCSS, etc.

\n
debug: true
\n

Il existe deux autres façons d’activer le mode debug :

\n
    \n
  1. Exécuter une commande avec l’option -vvv
    2. \n
  2. Définir la variable d’environnement CECIL_DEBUG à true
    3. \n
\n
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/contenu/pages/", "url": "https://cecil-945.pages.dev/fr/documentation/contenu/pages/", "title": "Pages et sections", "summary": "Anatomie d’une page, préfixe de fichier, sections, sous-sections et page d’accueil.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-06T00:00:00+00:00","content_text": "Pages et sections\nUne page est un fichier composé d’un front matter et d’un body.\nFront matter\nLe front matter est une collection de variables (au format clé\/valeur) entourée par ---.\nExemple :\n---\ntitle: \"The title\"\ndate: 2019-02-21\ntags: [tag 1, tag 2]\ncustomvar: \"Value of customvar\"\n---\nVous pouvez aussi utiliser <!-- --> ou +++ comme séparateur.\nCorps (body)\nLe body est le contenu principal d’une page ; il peut être écrit en Markdown ou en texte brut.\nExemple :\n# Header\n\n[toc]\n\n## Sub-Header 1\n\nLorem ipsum dolor [sit amet](https:\/\/example.com), consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.\n<!-- excerpt -->\nUt enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.\n\n## Sub-Header 2\n\n![Description](\/image.jpg \"Title\")\n\n## Sub-Header 3\n\n:::tip\nThis is advice.\n:::\nPréfixe de fichier\nLe nom de fichier peut contenir un préfixe pour définir les variables date ou weight de la page (utilisé par sortby).\nSéparateurs de préfixe par défaut : _ et -.\nVous pouvez les personnaliser avec l’option pages.prefix.separator.\ndate\nLe date prefix est utilisé pour définir la date de la page et doit être un format de date valide (c.-à-d. : « YYYY-MM-DD »).\nExemple :\nDans « 2019-04-23_My blog post.md » :\n\nle préfixe est « 2019-04-23 »\nla date de la page est « 2019-04-23 »\nle title de la page est « My blog post »\n\nweight\nLe weight prefix est utilisé pour définir l’ordre de tri de la page et doit être une valeur entière valide.\nExemple :\nDans « 1_The first project.md » :\n\nle préfixe est « 1 »\nle weight de la page est « 1 »\nle title de la page est « The first project »\n\nSection\nCertaines variables dédiées peuvent être utilisées dans une Section personnalisée (c.-à-d. : <section>\/index.md).\nsortby\nL’ordre des pages dans une Section peut être modifié.\nValeurs disponibles :\n\ndate: plus récentes en premier\ntitle: ordre alphabétique\nweight: plus léger en premier\n\nExemple :\n---\nsortby: title\n---\nMore options:\n---\nsortby:\n variable: date # \"date\", \"updated\", \"title\" or \"weight\"\n desc_title: false # used with \"date\" or \"updated\" variable value to sort by desc title order if items have the same date\n reverse: false # reversed if true\n---\npagination\nLa configuration globale de pagination est utilisée par défaut, mais vous pouvez la modifier pour une Section donnée.\nExemple :\n---\npagination:\n max: 5\n path: \"page\"\n---\nLa pagination peut être désactivée pour une Section :\n---\npagination: false\n---\ncascade\nToutes les variables de cascade sont ajoutées au front matter de toutes les sous-pages.\nExemple :\n---\ncascade:\n banner: image.jpg\n---\nLes variables existantes ne sont pas écrasées.\ncircular\nDéfinissez circular à true pour activer la navigation circulaire avec page.<prev\/next>.\nAvec des sous-sections, seule la valeur circular de la Section de premier niveau est utilisée.\nExemple :\n---\ncircular: true\n---\nSous-section\nUn dossier imbriqué qui contient explicitement un fichier index.md devient une sous-section de sa Section parente.\n<monsiteweb>\n└─ pages\n └─ blog <- Section\n ├─ index.md\n ├─ post-1.md <- Page de la Section « blog »\n └─ 2024 <- Sous-section (contient un « index.md »)\n ├─ index.md\n └─ post-2.md <- Page de la Section « blog » *et* de la sous-section « blog\/2024 »\nUne sous-section :\n\nest une Section (même type, mêmes variables et même résolution de gabarit) accessible à sa propre URL (ex. : \/blog\/2024\/)\nest rendue avec les gabarits de ses Sections parentes si elle n'a pas les siens (ex. : blog\/list.html.twig)\npeut être imbriquée à n'importe quelle profondeur (ex. : blog\/2024\/06\/)\nliste ses propres pages, et ses pages appartiennent aussi à chacune de leurs Sections parentes\nn'est pas listée dans sa Section parente\nest placée dans la navigation page.<prev\/next> de sa Section parente (selon son sortby), suivie de ses propres pages\n\nUn dossier imbriqué sans fichier index.md n'est pas une sous-section : ses pages appartiennent simplement à la Section parente.\nPage d'accueil\nComme une autre section, la Page d'accueil prend en charge la configuration sortby et pagination.\npagesfrom\nDéfinissez un nom de Section valide dans pagesfrom pour utiliser la collection de pages de cette Section dans la Page d'accueil.\nExemple :\n---\npagesfrom: blog\n---", "content_html": "

Pages et sections

\n

Une page est un fichier composé d’un front matter et d’un body.

\n

Front matter

\n

Le front matter est une collection de variables (au format clé/valeur) entourée par ---.

\n

Exemple :

\n
---\ntitle: \"The title\"\ndate: 2019-02-21\ntags: [tag 1, tag 2]\ncustomvar: \"Value of customvar\"\n---
\n\n

Corps (body)

\n

Le body est le contenu principal d’une page ; il peut être écrit en Markdown ou en texte brut.

\n

Exemple :

\n
# Header\n\n[toc]\n\n## Sub-Header 1\n\nLorem ipsum dolor [sit amet](https://example.com), consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.\n<!-- excerpt -->\nUt enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.\n\n## Sub-Header 2\n\n![Description](/image.jpg \"Title\")\n\n## Sub-Header 3\n\n:::tip\nThis is advice.\n:::
\n

Préfixe de fichier

\n

Le nom de fichier peut contenir un préfixe pour définir les variables date ou weight de la page (utilisé par sortby).

\n\n

date

\n

Le date prefix est utilisé pour définir la date de la page et doit être un format de date valide (c.-à-d. : « YYYY-MM-DD »).

\n

Exemple :

\n

Dans « 2019-04-23_My blog post.md » :

\n\n

weight

\n

Le weight prefix est utilisé pour définir l’ordre de tri de la page et doit être une valeur entière valide.

\n

Exemple :

\n

Dans « 1_The first project.md » :

\n\n

Section

\n

Certaines variables dédiées peuvent être utilisées dans une Section personnalisée (c.-à-d. : <section>/index.md).

\n

sortby

\n

L’ordre des pages dans une Section peut être modifié.

\n

Valeurs disponibles :

\n\n

Exemple :

\n
---\nsortby: title\n---
\n

More options:

\n
---\nsortby:\n  variable: date    # \"date\", \"updated\", \"title\" or \"weight\"\n  desc_title: false # used with \"date\" or \"updated\" variable value to sort by desc title order if items have the same date\n  reverse: false    # reversed if true\n---
\n

pagination

\n

La configuration globale de pagination est utilisée par défaut, mais vous pouvez la modifier pour une Section donnée.

\n

Exemple :

\n
---\npagination:\n  max: 5\n  path: \"page\"\n---
\n

La pagination peut être désactivée pour une Section :

\n
---\npagination: false\n---
\n

cascade

\n

Toutes les variables de cascade sont ajoutées au front matter de toutes les sous-pages.

\n

Exemple :

\n
---\ncascade:\n  banner: image.jpg\n---
\n\n

circular

\n

Définissez circular à true pour activer la navigation circulaire avec page.<prev/next>.

\n\n

Exemple :

\n
---\ncircular: true\n---
\n

Sous-section

\n

Un dossier imbriqué qui contient explicitement un fichier index.md devient une sous-section de sa Section parente.

\n
<monsiteweb>\n└─ pages\n   └─ blog                 <- Section\n      ├─ index.md\n      ├─ post-1.md         <- Page de la Section « blog »\n      └─ 2024              <- Sous-section (contient un « index.md »)\n         ├─ index.md\n         └─ post-2.md      <- Page de la Section « blog » *et* de la sous-section « blog/2024 »
\n

Une sous-section :

\n\n\n

Page d'accueil

\n

Comme une autre section, la Page d'accueil prend en charge la configuration sortby et pagination.

\n

pagesfrom

\n

Définissez un nom de Section valide dans pagesfrom pour utiliser la collection de pages de cette Section dans la Page d'accueil.

\n

Exemple :

\n
---\npagesfrom: blog\n---
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/deployer/plateformes-jamstack/", "url": "https://cecil-945.pages.dev/fr/documentation/deployer/plateformes-jamstack/", "title": "Plateformes Jamstack", "summary": "Netlify, Vercel, statichost, Cloudflare Pages, Render.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-14T00:00:00+00:00","content_text": "Plateformes Jamstack\nLes plateformes Jamstack peuvent construire et déployer automatiquement votre site Cecil à chaque push dans votre dépôt Git.\nNetlify\n\nUne puissante plateforme serverless avec un flux de travail intuitif basé sur Git. Déploiements automatisés, aperçus partageables, et bien plus encore.\n\n➡️ https:\/\/www.netlify.com\nnetlify.toml:\n[build]\n publish = \"_site\"\n command = \"curl -sSOL https:\/\/cecil.app\/build.sh && bash .\/build.sh\"\n[context.production.environment]\n CECIL_ENV = \"production\"\n[context.deploy-preview.environment]\n CECIL_ENV = \"preview\"\nDocumentation officielle\nVercel\n\nVercel associe une excellente expérience développeur à une attention obsessionnelle portée aux performances côté utilisateur final.\n\n➡️ https:\/\/vercel.com\nvercel.json:\n{\n \"buildCommand\": \"curl -sSOL https:\/\/cecil.app\/build.sh && bash .\/build.sh\",\n \"outputDirectory\": \"_site\"\n}\nDocumentation officielle\nstatichost\n\nHébergement moderne de sites statiques avec des serveurs européens et absolument aucune collecte de données personnelles !\n\n➡️ https:\/\/statichost.eu\nstatichost.yml:\nimage: wordpress:cli-php8.4\ncommand: curl -sSOL https:\/\/cecil.app\/build.sh && bash .\/build.sh\npublic: _site\nDocumentation officielle\nCloudflare Pages\nCloudflare Pages ne fournit pas PHP : le script de build utilise alors le binaire autonome de Cecil, et installe les thèmes à partir de composer.lock.\n\nCloudflare Pages est une plateforme JAMstack qui permet aux développeurs frontend de collaborer et de déployer des sites web.\n\n➡️ https:\/\/pages.cloudflare.com\nConfigurations de build :\n\nPréréglage de framework : None\nCommande de build : curl -sSOL https:\/\/cecil.app\/build.sh && bash .\/build.sh\nRépertoire de sortie du build : _site\n\nDocumentation officielle\nRender\nRender ne fournit que PHP 7.3 : le script de build utilise alors le binaire autonome de Cecil, et installe les thèmes à partir de composer.lock.\n\nRender est un cloud unifié pour créer et exécuter toutes vos applications et tous vos sites web, avec certificats TLS gratuits, CDN global, réseaux privés et déploiements automatiques depuis Git.\n\n➡️ https:\/\/render.com\nrender.yaml:\npreviewsEnabled: true\nservices:\n - type: web\n name: Cecil\n env: static\n buildCommand: curl -sSOL https:\/\/cecil.app\/build.sh && bash .\/build.sh\n staticPublishPath: _site\n pullRequestPreviewsEnabled: true\nDocumentation officielle", "content_html": "

Plateformes Jamstack

\n

Les plateformes Jamstack peuvent construire et déployer automatiquement votre site Cecil à chaque push dans votre dépôt Git.

\n

Netlify

\n
\n

Une puissante plateforme serverless avec un flux de travail intuitif basé sur Git. Déploiements automatisés, aperçus partageables, et bien plus encore.

\n
\n

➡️ https://www.netlify.com

\n

netlify.toml:

\n
[build]\n  publish = \"_site\"\n  command = \"curl -sSOL https://cecil.app/build.sh && bash ./build.sh\"\n[context.production.environment]\n  CECIL_ENV = \"production\"\n[context.deploy-preview.environment]\n  CECIL_ENV = \"preview\"
\n

Documentation officielle

\n

Vercel

\n
\n

Vercel associe une excellente expérience développeur à une attention obsessionnelle portée aux performances côté utilisateur final.

\n
\n

➡️ https://vercel.com

\n

vercel.json:

\n
{\n  \"buildCommand\": \"curl -sSOL https://cecil.app/build.sh && bash ./build.sh\",\n  \"outputDirectory\": \"_site\"\n}
\n

Documentation officielle

\n

statichost

\n
\n

Hébergement moderne de sites statiques avec des serveurs européens et absolument aucune collecte de données personnelles !

\n
\n

➡️ https://statichost.eu

\n

statichost.yml:

\n
image: wordpress:cli-php8.4\ncommand: curl -sSOL https://cecil.app/build.sh && bash ./build.sh\npublic: _site
\n

Documentation officielle

\n

Cloudflare Pages

\n\n
\n

Cloudflare Pages est une plateforme JAMstack qui permet aux développeurs frontend de collaborer et de déployer des sites web.

\n
\n

➡️ https://pages.cloudflare.com

\n

Configurations de build :

\n\n

Documentation officielle

\n

Render

\n\n
\n

Render est un cloud unifié pour créer et exécuter toutes vos applications et tous vos sites web, avec certificats TLS gratuits, CDN global, réseaux privés et déploiements automatiques depuis Git.

\n
\n

➡️ https://render.com

\n

render.yaml:

\n
previewsEnabled: true\nservices:\n  - type: web\n    name: Cecil\n    env: static\n    buildCommand: curl -sSOL https://cecil.app/build.sh && bash ./build.sh\n    staticPublishPath: _site\n    pullRequestPreviewsEnabled: true
\n

Documentation officielle

", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/developpeurs/etendre/", "url": "https://cecil-945.pages.dev/fr/documentation/developpeurs/etendre/", "title": "Étendre", "summary": "Créez des générateurs de pages, ajoutez des extensions Twig et post-traitez les fichiers de sortie.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-02T00:00:00+00:00","content_text": "Étendre\nComme Cecil repose sur PHP, il est facile d'en étendre les capacités.\nGénérateur de pages\nUn générateur permet de créer des pages sans fichiers Markdown (avec des données provenant d'une API ou d'une base de données, par exemple), ou de modifier des pages existantes.\nCréez simplement une nouvelle classe PHP dans l'espace de noms Cecil\\Generator, puis ajoutez le nom de la classe à la liste pages.generators.\nExemple:\n\/extensions\/Cecil\/Generator\/DummyPage.php\n<?php\nnamespace Cecil\\Generator;\n\nuse Cecil\\Collection\\Page\\Page;\nuse Cecil\\Collection\\Page\\Type;\n\nclass DummyPage extends AbstractGenerator implements GeneratorInterface\n{\n public function generate(): void\n {\n \/\/ create a new page $page, then add it to the site collection\n $page = (new Page('my-page'))\n ->setType(Type::PAGE->value)\n ->setPath('mypage')\n ->setBodyHtml('<p>My page body<\/p>')\n ->setVariable('language', 'en')\n ->setVariable('title', 'My page')\n ->setVariable('date', now())\n ->setVariable('menu', ['main' => ['weight' => 99]]);\n $this->generatedPages->add($page);\n }\n}\n\/extensions\/Cecil\/Generator\/Database.php\n<?php\nnamespace Cecil\\Generator;\n\nuse Cecil\\Collection\\Page\\Page;\nuse Cecil\\Collection\\Page\\Type;\n\nclass Database extends AbstractGenerator implements GeneratorInterface\n{\n public function generate(): void\n {\n \/\/ create pages from a SQLite database\n $db = new SQLite3('database.sqlite');\n $statement = $db->prepare('SELECT * FROM blog');\n $result = $statement->execute();\n while ($row = $result->fetchArray(SQLITE3_ASSOC)) {\n $page = (new Page($row['page-id']))\n ->setType(Type::PAGE->value)\n ->setPath($row['path'])\n ->setBodyHtml($row['html'])\n ->setVariable('title', $row['title'])\n ->setVariable('date', $row['date']);\n $this->generatedPages->add($page);\n }\n $result->finalize();\n $db->close();\n }\n}\nconfiguration\npages:\n generators:\n # priority: class name\n 99: Cecil\\Generator\\DummyPage\n 35: Cecil\\Generator\\Database\nExtension Twig\nVous pouvez ajouter des fonctions et des filtres personnalisés :\n\ncréez une extension Twig dans l'espace de noms Cecil\\Renderer\\Extension\najoutez le fichier PHP dans le répertoire extensions\najoutez le nom de la classe à la configuration\n\nExemple:\n\/extensions\/Cecil\/Renderer\/Extension\/MyTwigExtension.php\n<?php\nnamespace Cecil\\Renderer\\Extension;\n\nclass MyTwigExtension extends \\Twig\\Extension\\AbstractExtension\n{\n public function getFilters()\n {\n \/\/ add a new filter named 'md5'\n return [\n new \\Twig\\TwigFilter('md5', 'md5'),\n ];\n }\n}\nconfiguration\nlayouts:\n extensions:\n MyExtension: Cecil\\Renderer\\Extension\\MyTwigExtension\nPost-processeur de rendu\nVous pouvez post-traiter le rendu des pages.\nCréez simplement une nouvelle classe PHP dans l'espace de noms Cecil\\Renderer\\PostProcessor et ajoutez le nom de la classe à la liste output.postprocessors.\nExemple:\n\/extensions\/Cecil\/Renderer\/PostProcessor\/MyProcessor.php\n<?php\nnamespace Cecil\\Renderer\\PostProcessor;\n\nuse Cecil\\Collection\\Page\\Page;\n\nclass MyProcessor extends AbstractPostProcessor\n{\n public function process(Page $page, string $output, string $format): string\n {\n \/\/ add a meta tag to the head of the HTML output\n if ($format == 'html') {\n if (!preg_match('\/<meta name=\"test\".*\/i', $output)) {\n $meta = \\sprintf('<meta name=\"test\" content=\"Test\">');\n $output = preg_replace_callback('\/([[:blank:]]*)(<\\\/head>)\/i', function ($matches) use ($meta) {\n return str_repeat($matches[1] ?: ' ', 2) . $meta . \"\\n\" . $matches[1] . $matches[2];\n }, $output);\n }\n }\n\n return $output;\n }\n}\nconfiguration\noutput:\n postprocessors:\n MyProcessor: Cecil\\Renderer\\PostProcessor\\MyProcessor", "content_html": "

Étendre

\n

Comme Cecil repose sur PHP, il est facile d'en étendre les capacités.

\n

Générateur de pages

\n

Un générateur permet de créer des pages sans fichiers Markdown (avec des données provenant d'une API ou d'une base de données, par exemple), ou de modifier des pages existantes.

\n

Créez simplement une nouvelle classe PHP dans l'espace de noms Cecil\\Generator, puis ajoutez le nom de la classe à la liste pages.generators.

\n

Exemple:

\n

/extensions/Cecil/Generator/DummyPage.php

\n
<?php\nnamespace Cecil\\Generator;\n\nuse Cecil\\Collection\\Page\\Page;\nuse Cecil\\Collection\\Page\\Type;\n\nclass DummyPage extends AbstractGenerator implements GeneratorInterface\n{\n    public function generate(): void\n    {\n        // create a new page $page, then add it to the site collection\n        $page = (new Page('my-page'))\n            ->setType(Type::PAGE->value)\n            ->setPath('mypage')\n            ->setBodyHtml('<p>My page body</p>')\n            ->setVariable('language', 'en')\n            ->setVariable('title', 'My page')\n            ->setVariable('date', now())\n            ->setVariable('menu', ['main' => ['weight' => 99]]);\n        $this->generatedPages->add($page);\n    }\n}
\n

/extensions/Cecil/Generator/Database.php

\n
<?php\nnamespace Cecil\\Generator;\n\nuse Cecil\\Collection\\Page\\Page;\nuse Cecil\\Collection\\Page\\Type;\n\nclass Database extends AbstractGenerator implements GeneratorInterface\n{\n    public function generate(): void\n    {\n        // create pages from a SQLite database\n        $db = new SQLite3('database.sqlite');\n        $statement = $db->prepare('SELECT * FROM blog');\n        $result = $statement->execute();\n        while ($row = $result->fetchArray(SQLITE3_ASSOC)) {\n            $page = (new Page($row['page-id']))\n                ->setType(Type::PAGE->value)\n                ->setPath($row['path'])\n                ->setBodyHtml($row['html'])\n                ->setVariable('title', $row['title'])\n                ->setVariable('date', $row['date']);\n            $this->generatedPages->add($page);\n        }\n        $result->finalize();\n        $db->close();\n    }\n}
\n

configuration

\n
pages:\n  generators:\n    # priority: class name\n    99: Cecil\\Generator\\DummyPage\n    35: Cecil\\Generator\\Database
\n

Extension Twig

\n

Vous pouvez ajouter des fonctions et des filtres personnalisés :

\n
    \n
  1. créez une extension Twig dans l'espace de noms Cecil\\Renderer\\Extension
    2. \n
  2. ajoutez le fichier PHP dans le répertoire extensions
    3. \n
  3. ajoutez le nom de la classe à la configuration
    4. \n
\n

Exemple:

\n

/extensions/Cecil/Renderer/Extension/MyTwigExtension.php

\n
<?php\nnamespace Cecil\\Renderer\\Extension;\n\nclass MyTwigExtension extends \\Twig\\Extension\\AbstractExtension\n{\n    public function getFilters()\n    {\n        // add a new filter named 'md5'\n        return [\n            new \\Twig\\TwigFilter('md5', 'md5'),\n        ];\n    }\n}
\n

configuration

\n
layouts:\n  extensions:\n    MyExtension: Cecil\\Renderer\\Extension\\MyTwigExtension
\n

Post-processeur de rendu

\n

Vous pouvez post-traiter le rendu des pages.

\n

Créez simplement une nouvelle classe PHP dans l'espace de noms Cecil\\Renderer\\PostProcessor et ajoutez le nom de la classe à la liste output.postprocessors.

\n

Exemple:

\n

/extensions/Cecil/Renderer/PostProcessor/MyProcessor.php

\n
<?php\nnamespace Cecil\\Renderer\\PostProcessor;\n\nuse Cecil\\Collection\\Page\\Page;\n\nclass MyProcessor extends AbstractPostProcessor\n{\n    public function process(Page $page, string $output, string $format): string\n    {\n        // add a meta tag to the head of the HTML output\n        if ($format == 'html') {\n            if (!preg_match('/<meta name=\"test\".*/i', $output)) {\n                $meta = \\sprintf('<meta name=\"test\" content=\"Test\">');\n                $output = preg_replace_callback('/([[:blank:]]*)(<\\/head>)/i', function ($matches) use ($meta) {\n                    return str_repeat($matches[1] ?: ' ', 2) . $meta . \"\\n\" . $matches[1] . $matches[2];\n                }, $output);\n            }\n        }\n\n        return $output;\n    }\n}
\n

configuration

\n
output:\n  postprocessors:\n    MyProcessor: Cecil\\Renderer\\PostProcessor\\MyProcessor
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/commandes/new-page/", "url": "https://cecil-945.pages.dev/fr/documentation/commandes/new-page/", "title": "new:page", "summary": "Créer une nouvelle page, éventuellement à partir d’un modèle.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "new:page\nCrée une nouvelle page.\nUtilisation\nDescription:\n Creates a new page\n\nUsage:\n new:page [options] [--] [<path>]\n\nArguments:\n path Use the given path as working directory\n\nOptions:\n --name=NAME Page path name\n --slugify|--no-slugify Slugify file name (or disable --no-slugify)\n -p, --prefix Prefix the file name with the current date (`YYYY-MM-DD`)\n -f, --force Override the file if already exist\n -o, --open Open editor automatically\n --editor=EDITOR Editor to use with open option\n -h, --help Display help for the given command. When no command is given display help for the list command\n -q, --quiet Do not output any message\n -V, --version Display this application version\n --ansi|--no-ansi Force (or disable --no-ansi) ANSI output\n -n, --no-interaction Do not ask any interactive question\n -v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug\n\nHelp:\n The new:page command creates a new page file.\n If you run this command without any options, it will ask you for the page name and other options.\n\n cecil.phar new:page\n cecil.phar new:page --name=path\/to\/a-page.md\n cecil.phar new:page --name=path\/to\/A Page.md --slugify\n\n To create a new page with a date prefix (i.e: `YYYY-MM-DD`), run:\n\n cecil.phar new:page --prefix\n\n To create a new page and open it with an editor, run:\n\n cecil.phar new:page --open --editor=editor\n\n To override an existing page, run:\n\n cecil.phar new:page --force\nModèles de page\nVous pouvez définir vos propres modèles pour vos nouvelles pages dans le répertoire models :\n\nLe nom doit être basé sur le nom de la section (par exemple : blog.md)\nLe modèle par défaut doit être nommé default.md (pour les pages racine ou les sections de pages sans modèle)\n\nDeux variables dynamiques sont disponibles :\n\n%title% : le nom du fichier\n%date% : la date actuelle\n\nOuvrir avec votre éditeur\nAvec l’option --open, l’éditeur s’ouvrira automatiquement. Utilisez donc la clé editor dans votre fichier de configuration pour définir l’éditeur par défaut (par exemple : editor: typora).", "content_html": "

new:page

\n

Crée une nouvelle page.

\n

Utilisation

\n
Description:\n  Creates a new page\n\nUsage:\n  new:page [options] [--] [<path>]\n\nArguments:\n  path                        Use the given path as working directory\n\nOptions:\n      --name=NAME             Page path name\n      --slugify|--no-slugify  Slugify file name (or disable --no-slugify)\n  -p, --prefix                Prefix the file name with the current date (`YYYY-MM-DD`)\n  -f, --force                 Override the file if already exist\n  -o, --open                  Open editor automatically\n      --editor=EDITOR         Editor to use with open option\n  -h, --help                  Display help for the given command. When no command is given display help for the list command\n  -q, --quiet                 Do not output any message\n  -V, --version               Display this application version\n      --ansi|--no-ansi        Force (or disable --no-ansi) ANSI output\n  -n, --no-interaction        Do not ask any interactive question\n  -v|vv|vvv, --verbose        Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug\n\nHelp:\n  The new:page command creates a new page file.\n  If you run this command without any options, it will ask you for the page name and other options.\n\n    cecil.phar new:page\n    cecil.phar new:page --name=path/to/a-page.md\n    cecil.phar new:page --name=path/to/A Page.md --slugify\n\n  To create a new page with a date prefix (i.e: `YYYY-MM-DD`), run:\n\n    cecil.phar new:page --prefix\n\n  To create a new page and open it with an editor, run:\n\n    cecil.phar new:page --open --editor=editor\n\n  To override an existing page, run:\n\n    cecil.phar new:page --force
\n

Modèles de page

\n

Vous pouvez définir vos propres modèles pour vos nouvelles pages dans le répertoire models :

\n
    \n
  1. Le nom doit être basé sur le nom de la section (par exemple : blog.md)
    2. \n
  2. Le modèle par défaut doit être nommé default.md (pour les pages racine ou les sections de pages sans modèle)
    3. \n
\n

Deux variables dynamiques sont disponibles :

\n
    \n
  1. %title% : le nom du fichier
    2. \n
  2. %date% : la date actuelle
    3. \n
\n

Ouvrir avec votre éditeur

\n

Avec l’option --open, l’éditeur s’ouvrira automatiquement. Utilisez donc la clé editor dans votre fichier de configuration pour définir l’éditeur par défaut (par exemple : editor: typora).

", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/configuration/langues/", "url": "https://cecil-945.pages.dev/fr/documentation/configuration/langues/", "title": "Langues", "summary": "Langue principale et langues supplémentaires d’un site multilingue.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "Langues\nCes options définissent la langue principale du site et, pour un site multilingue, ses langues supplémentaires.\nlanguage\nLangue principale, définie par son code.\nlanguage: <code> # unique code (`en` by default)\nPar défaut, seuls les chemins des pages des autres langues sont préfixés par leur code de langue, mais vous pouvez préfixer le chemin des pages de la langue principale avec l’option suivante :\n#language: <code>\nlanguage:\n code: <code>\n prefix: true\nQuand prefix est défini à true, un alias est automatiquement créé pour la page d’accueil afin de rediriger de \/ vers \/<code>\/.\nlanguages\nOptions des langues disponibles, utilisées pour la localisation des pages et des templates.\nlanguages:\n - code: <code> # unique code (e.g.: `en`, `fr`, 'en-US', `fr-CA`)\n name: <name> # human readable name (e.g.: `Français`)\n locale: <locale> # locale code (`language_COUNTRY`, e.g.: `en_US`, `fr_FR`, `fr_CA`)\n enabled: <true|false> # enabled or not (`true` by default)\nExemple :\nlanguage: en\nlanguages:\n - code: en\n name: English\n locale: en_US\n - code: fr\n name: Français\n locale: fr_FR\nUne liste des codes de locale est disponible si nécessaire.\nLocaliser\nPour localiser des options de configuration, vous devez les stocker sous la clé config de la langue.\nExemple :\ntitle: \"Cecil in english\"\nlanguages:\n - code: en\n name: English\n locale: en_US\n - code: fr\n name: Français\n locale: fr_FR\n config:\n title: \"Cecil en français\"\nDans les templates, vous pouvez accéder à une option avec {{ site.<option> }}, par exemple {{ site.title }}.\nSi une option n’est pas disponible dans la langue actuelle (ex. : fr), elle revient à la valeur globale (ex. : en).", "content_html": "

Langues

\n

Ces options définissent la langue principale du site et, pour un site multilingue, ses langues supplémentaires.

\n

language

\n

Langue principale, définie par son code.

\n
language: <code> # unique code (`en` by default)
\n

Par défaut, seuls les chemins des pages des autres langues sont préfixés par leur code de langue, mais vous pouvez préfixer le chemin des pages de la langue principale avec l’option suivante :

\n
#language: <code>\nlanguage:\n  code: <code>\n  prefix: true
\n\n

languages

\n

Options des langues disponibles, utilisées pour la localisation des pages et des templates.

\n
languages:\n  - code: <code>          # unique code (e.g.: `en`, `fr`, 'en-US', `fr-CA`)\n    name: <name>          # human readable name (e.g.: `Français`)\n    locale: <locale>      # locale code (`language_COUNTRY`, e.g.: `en_US`, `fr_FR`, `fr_CA`)\n    enabled: <true|false> # enabled or not (`true` by default)
\n

Exemple :

\n
language: en\nlanguages:\n  - code: en\n    name: English\n    locale: en_US\n  - code: fr\n    name: Français\n    locale: fr_FR
\n\n

Localiser

\n

Pour localiser des options de configuration, vous devez les stocker sous la clé config de la langue.

\n

Exemple :

\n
title: \"Cecil in english\"\nlanguages:\n  - code: en\n    name: English\n    locale: en_US\n  - code: fr\n    name: Français\n    locale: fr_FR\n    config:\n      title: \"Cecil en français\"
\n", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/contenu/front-matter/", "url": "https://cecil-945.pages.dev/fr/documentation/contenu/front-matter/", "title": "Front matter", "summary": "Variables de page personnalisées et prédéfinies : menu, taxonomie, planification, redirection, alias, sortie, etc.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-03T00:00:00+00:00","content_text": "Front matter\nLe front matter peut contenir des variables personnalisées appliquées à la page courante.\nIl doit se trouver au tout début du fichier et être un YAML valide.\nVariables prédéfinies\n\n\n\nVariable\nDescription\nValeur par défaut\nExemple\n\n\n\n\ntitle\nTitre\nNom de fichier sans extension.\nPost 1\n\n\nlayout\nTemplate\nVoir Lookup rules.\n404\n\n\ndate\nDate de création\nDate de création du fichier (objet PHP DateTime).\n2019\/04\/15\n\n\nsection\nSection\nSection de la page.\nblog\n\n\npath\nChemin\nPath de la page.\nblog\/post-1\n\n\nslug\nSlug\nSlug de la page.\npost-1\n\n\npublished\nPublié ou non\ntrue.\nfalse\n\n\ndraft\nBrouillon ou non\nfalse.\ntrue\n\n\n\nToutes les variables prédéfinies peuvent être surchargées, sauf section.\nupdated\nLa variable updated sert à définir la date de dernière modification d’une page.\nExemple :\n---\nupdated: 2026-02-02\n---\nAvant la version 8.80.1, la variable updated était une variable prédéfinie. Elle est désormais optionnelle (et doit être définie dans le front matter pour être utilisée).\nmenu\nUne page peut être ajoutée à un menu.\nLe nom de l’entrée est le title de la page et l’URL est le path de la page.\nLa même page peut être ajoutée à plusieurs menus, et la position de chaque entrée peut être définie avec la clé weight (la plus faible en premier). La clé name peut être utilisée pour personnaliser le nom de l’entrée par menu.\nExemples :\n---\nmenu: main\n---\n---\nmenu: [main, navigation] # same page in multiple menus\n---\n---\nmenu:\n main:\n weight: 10\n navigation:\n weight: 20\n---\n---\ntitle: 'Notre expertise'\nmenu:\n main:\n weight: 15\n footer:\n weight: 15\n name: \"Expertise\" # personnalise le nom de l'entrée dans ce menu\n---\nTaxonomie\nLa taxonomie permet de connecter, relier et classer le contenu de votre site Web.\nDans Cecil, ces termes sont regroupés dans des vocabulaires.\nLes vocabulaires sont déclarés dans la Configuration.\n\nVocabulaire\nUne catégorisation du contenu (ex. : tags, categories, etc.).\nTerme\nUn terme est un élément d’un vocabulaire (ex. : Développement, PHP, etc.).\n\nExemple :\n---\ntags: [\"Développement\", \"PHP\"]\n---\nCecil génère ensuite, pour chaque vocabulaire :\n\nune page listant ses termes, ex. : \/tags\/\nune page par terme listant ses pages, ex. : \/tags\/developpement\/ et \/tags\/php\/\n\nVoir les règles de recherche des templates et les variables de taxonomie pour personnaliser ces pages.\nPlanification\nPlanifie la publication des pages.\nExemple :\nLa page sera publiée si la date courante est >= 2023-02-07 :\nschedule:\n publish: 2023-02-07\nCette page est publiée si la date courante est <= 2022-04-28 :\nschedule:\n expiry: 2022-04-28\nredirect\nComme son nom l’indique, la variable redirect sert à rediriger une page vers une URL dédiée.\nExemple :\n---\nredirect: \"https:\/\/arnaudligny.fr\"\n---\nLa redirection fonctionne avec le template redirect.html.twig.\nalias\nUn alias est une redirection vers la page courante.\nExemple :\n---\ntitle: \"About\"\nalias:\n - contact\n---\nDans l’exemple précédent, contact\/ redirige vers about\/.\noutput\nDéfinit le format de sortie de la page.\nLes formats disponibles sont : html, atom, rss, json, xml, etc.\nVous pouvez définir un ou plusieurs formats dans un tableau.\nIl n’est pas obligatoire de définir un format de sortie, mais si vous le faites, il doit correspondre à l’un des formats disponibles définis dans la Configuration.\nExemple :\n---\noutput: [html, atom]\n---\nexternal\nUne page avec une variable external tente de récupérer le contenu de la ressource ciblée.\nExemple :\n---\nexternal: \"https:\/\/raw.githubusercontent.com\/Cecilapp\/Cecil\/main\/README.md\"\n---\nexcluded\nDéfinissez excluded à true pour masquer une page des pages de liste (c.-à-d. : Home page, Section, Sitemap, etc.).\nExemple :\n---\nexcluded: true\n---\nexcluded est différent de published : une page exclue est publiée, mais masquée des pages de liste.\nDepuis la version 8.49.0, l’ancienne variable exclude a été remplacée par excluded.", "content_html": "

Front matter

\n

Le front matter peut contenir des variables personnalisées appliquées à la page courante.

\n

Il doit se trouver au tout début du fichier et être un YAML valide.

\n

Variables prédéfinies

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
VariableDescriptionValeur par défautExemple
titleTitreNom de fichier sans extension.Post 1
layoutTemplateVoir Lookup rules.404
dateDate de créationDate de création du fichier (objet PHP DateTime).2019/04/15
sectionSectionSection de la page.blog
pathCheminPath de la page.blog/post-1
slugSlugSlug de la page.post-1
publishedPublié ou nontrue.false
draftBrouillon ou nonfalse.true
\n\n

updated

\n

La variable updated sert à définir la date de dernière modification d’une page.

\n

Exemple :

\n
---\nupdated: 2026-02-02\n---
\n\n

menu

\n

Une page peut être ajoutée à un menu.

\n

Le nom de l’entrée est le title de la page et l’URL est le path de la page.

\n

La même page peut être ajoutée à plusieurs menus, et la position de chaque entrée peut être définie avec la clé weight (la plus faible en premier). La clé name peut être utilisée pour personnaliser le nom de l’entrée par menu.

\n

Exemples :

\n
---\nmenu: main\n---
\n
---\nmenu: [main, navigation] # same page in multiple menus\n---
\n
---\nmenu:\n  main:\n    weight: 10\n  navigation:\n    weight: 20\n---
\n
---\ntitle: 'Notre expertise'\nmenu:\n  main:\n    weight: 15\n  footer:\n    weight: 15\n    name: \"Expertise\" # personnalise le nom de l'entrée dans ce menu\n---
\n

Taxonomie

\n

La taxonomie permet de connecter, relier et classer le contenu de votre site Web.
\nDans Cecil, ces termes sont regroupés dans des vocabulaires.

\n

Les vocabulaires sont déclarés dans la Configuration.

\n
\n
Vocabulaire
\n
Une catégorisation du contenu (ex. : tags, categories, etc.).
\n
Terme
\n
Un terme est un élément d’un vocabulaire (ex. : Développement, PHP, etc.).
\n
\n

Exemple :

\n
---\ntags: [\"Développement\", \"PHP\"]\n---
\n

Cecil génère ensuite, pour chaque vocabulaire :

\n\n

Voir les règles de recherche des templates et les variables de taxonomie pour personnaliser ces pages.

\n

Planification

\n

Planifie la publication des pages.

\n

Exemple :

\n

La page sera publiée si la date courante est >= 2023-02-07 :

\n
schedule:\n  publish: 2023-02-07
\n

Cette page est publiée si la date courante est <= 2022-04-28 :

\n
schedule:\n  expiry: 2022-04-28
\n

redirect

\n

Comme son nom l’indique, la variable redirect sert à rediriger une page vers une URL dédiée.

\n

Exemple :

\n
---\nredirect: \"https://arnaudligny.fr\"\n---
\n\n

alias

\n

Un alias est une redirection vers la page courante.

\n

Exemple :

\n
---\ntitle: \"About\"\nalias:\n  - contact\n---
\n

Dans l’exemple précédent, contact/ redirige vers about/.

\n

output

\n

Définit le format de sortie de la page.

\n

Les formats disponibles sont : html, atom, rss, json, xml, etc.
\nVous pouvez définir un ou plusieurs formats dans un tableau.

\n

Il n’est pas obligatoire de définir un format de sortie, mais si vous le faites, il doit correspondre à l’un des formats disponibles définis dans la Configuration.

\n

Exemple :

\n
---\noutput: [html, atom]\n---
\n

external

\n

Une page avec une variable external tente de récupérer le contenu de la ressource ciblée.

\n

Exemple :

\n
---\nexternal: \"https://raw.githubusercontent.com/Cecilapp/Cecil/main/README.md\"\n---
\n

excluded

\n

Définissez excluded à true pour masquer une page des pages de liste (c.-à-d. : Home page, Section, Sitemap, etc.).

\n

Exemple :

\n
---\nexcluded: true\n---
\n\n", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/deployer/deploiement-continu/", "url": "https://cecil-945.pages.dev/fr/documentation/deployer/deploiement-continu/", "title": "Build et déploiement continus", "summary": "GitHub Pages et GitLab CI.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "Build et déploiement continus\nLes services d’intégration continue peuvent construire votre site avec Cecil et le déployer à chaque modification de votre dépôt.\nGitHub Pages\n\nDes sites web pour vous et vos projets, hébergés directement depuis votre dépôt GitHub. Il suffit de modifier, pousser, et vos changements sont en ligne.\n\n➡️ https:\/\/pages.github.com\n.github\/workflows\/build-and-deploy.yml:\nname: Build and deploy to GitHub Pages\non:\n push:\n branches: [master, main]\n workflow_dispatch:\nconcurrency:\n group: pages\n cancel-in-progress: true\njobs:\n build:\n runs-on: ubuntu-latest\n steps:\n - name: Checkout source\n uses: actions\/checkout@v6\n - name: Restore Cecil cache\n uses: actions\/cache\/restore@v5\n with:\n path: .\/.cache\n key: cecil-cache-\n restore-keys: |\n cecil-cache-\n - name: Build site\n uses: Cecilapp\/Cecil-Action@v4\n - name: Save Cecil cache\n uses: actions\/cache\/save@v5\n with:\n path: .\/.cache\n key: cecil-cache-${{ hashFiles('.\/.cache\/**\/*') }}\n deploy:\n needs: build\n permissions:\n pages: write\n id-token: write\n environment:\n name: github-pages\n url: ${{ steps.deployment.outputs.page_url }}\n runs-on: ubuntu-latest\n steps:\n - name: Deploy to GitHub Pages\n id: deployment\n uses: actions\/deploy-pages@v5\nDocumentation officielle\nGitLab CI\n\nAvec GitLab Pages, vous pouvez publier des sites web statiques directement depuis un dépôt GitLab.\n\n➡️ https:\/\/about.gitlab.com\/solutions\/continuous-integration\/\n.gitlab-ci.yml:\nimage: wordpress:cli-php8.4\ntest:\n stage: test\n variables:\n CECIL_OUTPUT_DIR: test\n script:\n - curl -sSOL https:\/\/cecil.app\/build.sh && bash .\/build.sh\n artifacts:\n paths:\n - test\n except:\n - master\npages:\n stage: deploy\n variables:\n CECIL_ENV: production\n CECIL_OUTPUT_DIR: public\n script:\n - curl -sSOL https:\/\/cecil.app\/build.sh && bash .\/build.sh\n artifacts:\n paths:\n - public\n only:\n - master\ncache:\n paths:\n - composer-cache\/\n - vendor\/\n - .cache\/\nDocumentation officielle", "content_html": "

Build et déploiement continus

\n

Les services d’intégration continue peuvent construire votre site avec Cecil et le déployer à chaque modification de votre dépôt.

\n

GitHub Pages

\n
\n

Des sites web pour vous et vos projets, hébergés directement depuis votre dépôt GitHub. Il suffit de modifier, pousser, et vos changements sont en ligne.

\n
\n

➡️ https://pages.github.com

\n

.github/workflows/build-and-deploy.yml:

\n
name: Build and deploy to GitHub Pages\non:\n  push:\n    branches: [master, main]\n  workflow_dispatch:\nconcurrency:\n  group: pages\n  cancel-in-progress: true\njobs:\n  build:\n    runs-on: ubuntu-latest\n    steps:\n      - name: Checkout source\n        uses: actions/checkout@v6\n      - name: Restore Cecil cache\n        uses: actions/cache/restore@v5\n        with:\n          path: ./.cache\n          key: cecil-cache-\n          restore-keys: |\n            cecil-cache-\n      - name: Build site\n        uses: Cecilapp/Cecil-Action@v4\n      - name: Save Cecil cache\n        uses: actions/cache/save@v5\n        with:\n          path: ./.cache\n          key: cecil-cache-${{ hashFiles('./.cache/**/*') }}\n  deploy:\n    needs: build\n    permissions:\n      pages: write\n      id-token: write\n    environment:\n      name: github-pages\n      url: ${{ steps.deployment.outputs.page_url }}\n    runs-on: ubuntu-latest\n    steps:\n      - name: Deploy to GitHub Pages\n        id: deployment\n        uses: actions/deploy-pages@v5
\n

Documentation officielle

\n

GitLab CI

\n
\n

Avec GitLab Pages, vous pouvez publier des sites web statiques directement depuis un dépôt GitLab.

\n
\n

➡️ https://about.gitlab.com/solutions/continuous-integration/

\n

.gitlab-ci.yml:

\n
image: wordpress:cli-php8.4\ntest:\n  stage: test\n  variables:\n    CECIL_OUTPUT_DIR: test\n  script:\n    - curl -sSOL https://cecil.app/build.sh && bash ./build.sh\n  artifacts:\n    paths:\n     - test\n  except:\n   - master\npages:\n  stage: deploy\n  variables:\n    CECIL_ENV: production\n    CECIL_OUTPUT_DIR: public\n  script:\n    - curl -sSOL https://cecil.app/build.sh && bash ./build.sh\n  artifacts:\n    paths:\n      - public\n  only:\n    - master\ncache:\n  paths:\n    - composer-cache/\n    - vendor/\n    - .cache/
\n

Documentation officielle

", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/developpeurs/bibliotheque/", "url": "https://cecil-945.pages.dev/fr/documentation/developpeurs/bibliotheque/", "title": "Bibliothèque", "summary": "Utilisez Cecil comme bibliothèque PHP : installez-le avec Composer, puis générez et diagnostiquez par programmation.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-03T00:00:00+00:00","content_text": "Bibliothèque\nCecil propose une API PHP simple pour générer votre site web.\nVous pouvez consulter la documentation de l'API pour plus de détails.\nInstallation\ncomposer require cecil\/cecil\nSupport de libvips\nPour traiter les images avec libvips (optionnel), installez le driver libvips dans votre projet :\ncomposer require intervention\/image-driver-vips\nCe driver nécessite libvips installé sur le système et l’extension PHP FFI activée.\nSans lui, Cecil utilise Imagick ou GD à la place.\nUtilisation\nConstruction\nConstruisez un nouveau site web avec une configuration personnalisée :\nrequire_once 'vendor\/autoload.php';\n\nuse Cecil\\Builder;\n\n$config = [\n 'title' => \"My website\",\n 'baseurl' => 'https:\/\/domain.tld\/',\n];\n\nBuilder::create($config)->build();\n\nexec('php -S localhost:8000 -t _site'); \/\/ prévisualisation locale\nLe paramètre principal de la méthode create doit être un array PHP ou une instance de Cecil\\Config.\nDiagnostic\nVous pouvez aussi exécuter les vérifications doctor via des services de domaine dédiés, sans utiliser les commandes CLI.\n<?php\n\nrequire_once 'vendor\/autoload.php';\n\nuse Cecil\\Builder;\nuse Cecil\\Doctor\\SeoDoctor;\nuse Cecil\\Doctor\\SiteDoctor;\n\n$builder = Builder::create(require 'config.php')\n ->setSourceDir(__DIR__)\n ->setDestinationDir(__DIR__);\n\n$siteDoctor = new SiteDoctor();\n$diagnosis = $siteDoctor->diagnose($builder, __DIR__, ['cecil.yml']);\n\n$seoDoctor = new SeoDoctor();\n$seoAudit = $seoDoctor->audit($builder, [\n 'page' => '',\n 'include_virtual' => false,\n]);\n\nvar_dump($diagnosis['errors'], $seoAudit['summary']);", "content_html": "

Bibliothèque

\n

Cecil propose une API PHP simple pour générer votre site web.

\n

Vous pouvez consulter la documentation de l'API pour plus de détails.

\n

Installation

\n
composer require cecil/cecil
\n

Support de libvips

\n

Pour traiter les images avec libvips (optionnel), installez le driver libvips dans votre projet :

\n
composer require intervention/image-driver-vips
\n\n

Utilisation

\n

Construction

\n

Construisez un nouveau site web avec une configuration personnalisée :

\n
require_once 'vendor/autoload.php';\n\nuse Cecil\\Builder;\n\n$config = [\n    'title'   => \"My website\",\n    'baseurl' => 'https://domain.tld/',\n];\n\nBuilder::create($config)->build();\n\nexec('php -S localhost:8000 -t _site'); // prévisualisation locale
\n\n

Diagnostic

\n

Vous pouvez aussi exécuter les vérifications doctor via des services de domaine dédiés, sans utiliser les commandes CLI.

\n
<?php\n\nrequire_once 'vendor/autoload.php';\n\nuse Cecil\\Builder;\nuse Cecil\\Doctor\\SeoDoctor;\nuse Cecil\\Doctor\\SiteDoctor;\n\n$builder = Builder::create(require 'config.php')\n    ->setSourceDir(__DIR__)\n    ->setDestinationDir(__DIR__);\n\n$siteDoctor = new SiteDoctor();\n$diagnosis = $siteDoctor->diagnose($builder, __DIR__, ['cecil.yml']);\n\n$seoDoctor = new SeoDoctor();\n$seoAudit = $seoDoctor->audit($builder, [\n    'page' => '',\n    'include_virtual' => false,\n]);\n\nvar_dump($diagnosis['errors'], $seoAudit['summary']);
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/commandes/serve/", "url": "https://cecil-945.pages.dev/fr/documentation/commandes/serve/", "title": "serve", "summary": "Prévisualiser le site avec le serveur intégré.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "serve\nConstruit et sert le site en local.\nLe serveur web est conçu pour faciliter les tests d’un site. Il n’a pas vocation à être un serveur web complet et ne doit pas être utilisé sur un réseau public.\nUtilisation\nDescription:\n Starts the built-in server\n\nUsage:\n serve [options] [--] [<path>]\n\nArguments:\n path Use the given path as working directory\n\nOptions:\n -o, --open Open web browser automatically\n --host=HOST Server host [default: \"localhost\"]\n --port=PORT Server port [default: \"8000\"]\n -w, --watch|--no-watch Enable (or disable --no-watch) changes watcher (enabled by default)\n -i, --incremental Enable incremental builds (rebuild only changed pages)\n -d, --drafts Include drafts\n --optimize|--no-optimize Enable (or disable --no-optimize) optimization of generated files\n -c, --config=CONFIG Set the path to extra config files (comma-separated)\n --clear-cache[=CLEAR-CACHE] Clear cache before build (optional cache key as regular expression) [default: false]\n -p, --page=PAGE Build a specific page\n --no-ignore-vcs Changes watcher must not ignore VCS directories\n -m, --metrics Show build metrics (duration and memory) of each step\n --timeout=TIMEOUT Sets the process timeout (max. runtime) in seconds [default: 7200]\n --notify Send desktop notification on server start\n -b, --background Run the server in the background\n -h, --help Display help for the given command. When no command is given display help for the list command\n -q, --quiet Do not output any message\n -V, --version Display this application version\n --ansi|--no-ansi Force (or disable --no-ansi) ANSI output\n -n, --no-interaction Do not ask any interactive question\n -v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug\n\nHelp:\n The serve command starts the live-reloading-built-in web server.\n\n cecil.phar serve\n cecil.phar serve path\/to\/the\/working\/directory\n cecil.phar serve --open\n cecil.phar serve --drafts\n cecil.phar serve --no-watch\n\n To speed up local development you can enable incremental builds with the --incremental option.\n When content pages change, Cecil rebuilds just those pages.\n When templates change, Cecil rebuilds only pages using those templates (including Twig dependencies such as extends\/include).\n Any other change (data, config, static or asset file, or file deletion) triggers a full rebuild:\n\n cecil.phar serve --incremental\n\n You can use a custom host and port by using the --host and --port options:\n\n cecil.phar serve --host=127.0.0.1 --port=8080\n\n To build the website with an extra configuration file, you can use the --config option.\n This is useful during local development to override some settings without modifying the main configuration:\n\n cecil.phar serve --config=config\/dev.yml\n\n To start the server with changes watcher not ignoring VCS directories, run:\n\n cecil.phar serve --no-ignore-vcs\n\n To define the process timeout (in seconds), run:\n\n cecil.phar serve --timeout=7200\n\n To run the server in the background, run:\n\n cecil.phar serve --background\n cecil.phar serve -b\n\n Then stop it with:\n\n cecil.phar serve:stop\n\n In background mode, file changes are not watched automatically.\nserve:background\nAlias de serve --background : démarre le serveur intégré en arrière-plan sans occuper le terminal.\nDescription:\n Starts the built-in server in the background (alias of `serve --background`)\n\nUsage:\n serve:background [options] [--] [<path>]\n\nHelp:\n The serve:background command starts the built-in web server in the background.\n\n cecil.phar serve:background\n cecil.phar serve:background path\/to\/the\/working\/directory\n\n This command is an alias of serve --background.\n\n Stop the server with:\n\n cecil.phar serve:stop\nserve:log\nAffiche les logs combinés du serveur et des erreurs, triés par date.\nDescription:\n Shows combined server and error logs\n\nUsage:\n serve:log [options] [--] [<path>]\n\nArguments:\n path Use the given path as working directory\n\nOptions:\n -l, --lines=LINES Number of entries to display (default: 25)\n\nHelp:\n The serve:log command displays entries from combined server and error logs, sorted by date.\n\n cecil.phar serve:log\n cecil.phar serve:log path\/to\/the\/working\/directory\n cecil.phar serve:log --lines=100\n cecil.phar serve:log -l 100\n\n This command shows logs from `.cecil\/errors.log` and `.cecil\/server.log`.\n It is useful for debugging issues with your local development server.", "content_html": "

serve

\n

Construit et sert le site en local.

\n\n

Utilisation

\n
Description:\n  Starts the built-in server\n\nUsage:\n  serve [options] [--] [<path>]\n\nArguments:\n  path                             Use the given path as working directory\n\nOptions:\n  -o, --open                       Open web browser automatically\n      --host=HOST                  Server host [default: \"localhost\"]\n      --port=PORT                  Server port [default: \"8000\"]\n  -w, --watch|--no-watch           Enable (or disable --no-watch) changes watcher (enabled by default)\n  -i, --incremental                Enable incremental builds (rebuild only changed pages)\n  -d, --drafts                     Include drafts\n      --optimize|--no-optimize     Enable (or disable --no-optimize) optimization of generated files\n  -c, --config=CONFIG              Set the path to extra config files (comma-separated)\n      --clear-cache[=CLEAR-CACHE]  Clear cache before build (optional cache key as regular expression) [default: false]\n  -p, --page=PAGE                  Build a specific page\n      --no-ignore-vcs              Changes watcher must not ignore VCS directories\n  -m, --metrics                    Show build metrics (duration and memory) of each step\n      --timeout=TIMEOUT            Sets the process timeout (max. runtime) in seconds [default: 7200]\n      --notify                     Send desktop notification on server start\n  -b, --background                 Run the server in the background\n  -h, --help                       Display help for the given command. When no command is given display help for the list command\n  -q, --quiet                      Do not output any message\n  -V, --version                    Display this application version\n      --ansi|--no-ansi             Force (or disable --no-ansi) ANSI output\n  -n, --no-interaction             Do not ask any interactive question\n  -v|vv|vvv, --verbose             Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug\n\nHelp:\n  The serve command starts the live-reloading-built-in web server.\n\n    cecil.phar serve\n    cecil.phar serve path/to/the/working/directory\n    cecil.phar serve --open\n    cecil.phar serve --drafts\n    cecil.phar serve --no-watch\n\n  To speed up local development you can enable incremental builds with the --incremental option.\n  When content pages change, Cecil rebuilds just those pages.\n  When templates change, Cecil rebuilds only pages using those templates (including Twig dependencies such as extends/include).\n  Any other change (data, config, static or asset file, or file deletion) triggers a full rebuild:\n\n    cecil.phar serve --incremental\n\n  You can use a custom host and port by using the --host and --port options:\n\n    cecil.phar serve --host=127.0.0.1 --port=8080\n\n  To build the website with an extra configuration file, you can use the --config option.\n  This is useful during local development to override some settings without modifying the main configuration:\n\n    cecil.phar serve --config=config/dev.yml\n\n  To start the server with changes watcher not ignoring VCS directories, run:\n\n    cecil.phar serve --no-ignore-vcs\n\n  To define the process timeout (in seconds), run:\n\n    cecil.phar serve --timeout=7200\n\n  To run the server in the background, run:\n\n    cecil.phar serve --background\n    cecil.phar serve -b\n\n  Then stop it with:\n\n    cecil.phar serve:stop\n\n  In background mode, file changes are not watched automatically.
\n

serve:background

\n

Alias de serve --background : démarre le serveur intégré en arrière-plan sans occuper le terminal.

\n
Description:\n  Starts the built-in server in the background (alias of `serve --background`)\n\nUsage:\n  serve:background [options] [--] [<path>]\n\nHelp:\n  The serve:background command starts the built-in web server in the background.\n\n    cecil.phar serve:background\n    cecil.phar serve:background path/to/the/working/directory\n\n  This command is an alias of serve --background.\n\n  Stop the server with:\n\n    cecil.phar serve:stop
\n

serve:log

\n

Affiche les logs combinés du serveur et des erreurs, triés par date.

\n
Description:\n  Shows combined server and error logs\n\nUsage:\n  serve:log [options] [--] [<path>]\n\nArguments:\n  path                  Use the given path as working directory\n\nOptions:\n  -l, --lines=LINES     Number of entries to display (default: 25)\n\nHelp:\n  The serve:log command displays entries from combined server and error logs, sorted by date.\n\n    cecil.phar serve:log\n    cecil.phar serve:log path/to/the/working/directory\n    cecil.phar serve:log --lines=100\n    cecil.phar serve:log -l 100\n\n  This command shows logs from `.cecil/errors.log` and `.cecil/server.log`.\n  It is useful for debugging issues with your local development server.
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/contenu/markdown/", "url": "https://cecil-945.pages.dev/fr/documentation/contenu/markdown/", "title": "Markdown", "summary": "Syntaxe et extensions Markdown : attributs, liens, images, table des matières, notes, coloration syntaxique, etc.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-12T00:00:00+00:00","content_text": "Markdown\nCecil prend en charge le format Markdown, ainsi que Markdown Extra.\nCecil fournit aussi des fonctionnalités supplémentaires pour enrichir votre contenu, voir ci-dessous.\nAttributs\nAvec Markdown Extra, vous pouvez définir un id, une classe et des attributs personnalisés sur certains éléments à l’aide d’un bloc d’attributs.\nPar exemple, placez le(s) attribut(s) souhaité(s) après un en-tête, un bloc de code délimité, un lien ou une image en fin de ligne, entre accolades, comme ceci :\n## En-tête {#id .class attribute=value}\nPour un élément en ligne, comme un lien, vous devez utiliser un retour à la ligne après l’accolade fermante :\nLorem ipsum [dolor](url){attribute=value} \nsit amet.\nLiens\nVous pouvez créer un lien avec la syntaxe [Texte](url) ; url peut être un chemin, un chemin relatif vers un fichier Markdown, une URL externe, etc.\nExemple :\n[Link to a path](\/about\/)\n[Link to a Markdown file](\/fr\/a-propos\/)\n[Link to Cecil website](https:\/\/cecil.app)\nUn lien relatif vers un fichier Markdown est résolu depuis le dossier du fichier courant (comme sur GitHub), puis remplacé par l’URL de la page ciblée.\nLien vers une page\nVous pouvez facilement créer un lien vers une page avec la syntaxe [Titre de page](page:page-id).\nExemple :\n[Link to a blog post](page:blog\/post-1)\nExterne\nPar défaut, les liens externes ont la valeur suivante pour l’attribut rel : noopener noreferrer.\nExemple :\n<a href=\"<url>\" rel=\"noopener noreferrer\">Link to another website<\/a>\nVous pouvez modifier ce comportement avec les options pages.body.links.external.\nLiens intégrés\nVous pouvez laisser Cecil essayer de transformer un lien en contenu embarqué en utilisant l’attribut {embed} ou en activant l’option de configuration globale pages.body.links.embed.enabled à true.\nSeuls les liens YouTube, Vimeo, Dailymotion et GitHub Gists sont pris en charge.\nExemple :\n[CECIL : LE générateur de SITES STATIQUES en PHP](https:\/\/www.youtube.com\/watch?v=ur8koU0iYvc){embed}\n\n\n\nLocal video\/audio files\nCecil peut aussi créer des éléments HTML vidéo et audio, selon l’extension du fichier.\nExemple :\n[Video file](video.mp4){embed controls poster=\/images\/video-test.png}\n[Audio file](song.mp3){embed controls}\nEst converti en :\n<video src=\"\/video.mp4\" controls poster=\"\/images\/video-test.png\" style=\"max-width:100%;height:auto;\"><\/video>\n<audio src=\"\/song.mp3\" controls><\/audio>\nAvec {embed=false} (ou lorsque l’intégration est désactivée), un fichier vidéo\/audio local reste un lien, mais son URL pointe vers le fichier publié (avec empreinte si assets.fingerprint est activé).\nImages\nPour ajouter une image, utilisez un point d’exclamation (!) suivi d’une description alternative entre crochets ([]), puis du chemin ou de l’URL de l’image entre parenthèses (()).\nVous pouvez facultativement ajouter un titre entre guillemets.\n![Alternative description](\/image.jpg \"Image title\")\nLe chemin doit être relatif à la racine de votre site Web (ex. : \/image.jpg), mais Cecil est capable de normaliser un chemin relatif aux répertoires assets et static (ex. : ..\/..\/assets\/image.jpg).\nLazy loading\nCecil ajoute l’attribut loading=\"lazy\" à chaque image.\nExemple :\n![](\/image.jpg)\nEst converti en :\n<img src=\"\/image.jpg\" loading=\"lazy\">\nVous pouvez désactiver ce comportement avec l’attribut {loading=eager} ou avec l’option lazy.\nDecoding\nCecil ajoute l’attribut decoding=\"async\" à chaque image.\nExemple :\n![](\/image.jpg)\nEst converti en :\n<img src=\"\/image.jpg\" decoding=\"async\">\nVous pouvez désactiver ce comportement avec l’attribut {decoding=auto} ou avec l’option decoding.\nRedimensionnement\nChaque image du body peut être redimensionnée automatiquement en définissant une largeur inférieure à celle d’origine, avec l’attribut additionnel {width=X}.\nExemple :\n![](\/image.jpg){width=800}\nEst converti en :\n<img src=\"\/thumbnails\/800\/image.jpg\" width=\"800\" height=\"600\">\nLe ratio est conservé (l’attribut height est calculé automatiquement), le fichier original n’est pas modifié et la version redimensionnée est stockée dans \/thumbnails\/<width>\/.\nCette fonctionnalité nécessite une bibliothèque de traitement d’images : Imagick est utilisé en priorité s’il est disponible (et capable de lire le JPEG et le PNG), puis libvips (via l’extension PHP FFI), et enfin GD en dernier recours ; sinon, elle ajoute seulement un attribut HTML width à la balise img.\nLe support de libvips est optionnel et n’est pas inclus dans cecil.phar. Pour l’utiliser, Cecil doit être installé avec Composer et il faut :\n\nlibvips installé sur le système\nl’extension PHP FFI activée\nle paquet intervention\/image-driver-vips installé avec Cecil\n\nSi Cecil est une dépendance de votre projet (voir Bibliothèque) :\ncomposer require intervention\/image-driver-vips\nSi Cecil est installé globalement :\ncomposer global require cecil\/cecil intervention\/image-driver-vips\nFormats\nSi l’option formats est définie, des images alternatives sont créées et ajoutées.\nExemple :\n![](\/image.jpg)\nPeut être converti en :\n<picture>\n <source srcset=\"\/image.avif\" type=\"image\/avif\">\n <source srcset=\"\/image.webp\" type=\"image\/webp\">\n <img src=\"\/image.jpg\">\n<\/picture>\nVeuillez noter que tous les formats d’image ne sont pas toujours inclus dans les extensions d’image PHP.\nResponsive\nSi l’option responsive est activée, alors toutes les images du body seront automatiquement rendues « responsive ».\nExemple :\n![](\/image.jpg){width=800}\nsera converti en :\n<img src=\"\/thumbnails\/800\/image.jpg\" width=\"800\" height=\"600\"\n srcset=\"\/thumbnails\/320\/image.jpg 320w,\n \/thumbnails\/640\/image.jpg 640w,\n \/thumbnails\/800\/image.jpg 800w\"\n sizes=\"100vw\"\n>\nComme une image du body est convertie en Asset, les différentes largeurs doivent être définies dans la configuration des assets.\nL’attribut sizes prend la valeur de l’option de configuration assets.images.responsive.sizes.default, mais peut être modifié en créant une nouvelle entrée nommée d’après une class ajoutée à l’image.\nExemple :\nassets:\n images:\n responsive:\n sizes:\n default: 100vw\n my_class: \"(max-width: 800px) 768px, 1024px\"\n![](\/image.jpg){.my_class}\nVous pouvez combiner les options formats et responsive.\nCSS class\nVous pouvez définir une valeur par défaut pour l’attribut class de chaque image avec l’option class.\nCaption\nLe titre optionnel peut être utilisé pour créer automatiquement une légende (figcaption) en activant l’option caption.\nExemple :\n![](\/images\/img.jpg \"Title\")\nEst converti en :\n<figure>\n <img src=\"\/image.jpg\" title=\"Title\">\n <figcaption>Title<\/figcaption>\n<\/figure>\nLa légende prend en charge le contenu Markdown.\nImage localisée\nPour les pages traduites, Cecil recherche d’abord un fichier suffixé par la langue lors de la résolution des chemins d’image Markdown.\nExemple :\n![](\/images\/cecil-logo.png)\nAvec une page française (fr), Cecil essaie d’abord \/images\/cecil-logo.fr.png, puis revient à \/images\/cecil-logo.png.\nPlaceholder\nComme les images sont généralement des ressources plus lourdes et plus lentes, et qu’elles ne bloquent pas le rendu, il est préférable de donner aux utilisateurs quelque chose à voir pendant qu’ils attendent leur chargement.\nL’attribut placeholder accepte 2 options :\n\ncolor: affiche un fond coloré (basé sur la couleur dominante de l’image)\nlqip: Low-Quality Image Placeholder\n\nExemples :\n![](\/images\/img.jpg){placeholder=color}\n![](\/images\/img.jpg){placeholder=lqip}\nVous pouvez définir une valeur pour l’attribut placeholder de chaque image avec l’option placeholder.\nL’option lqip n’est pas compatible avec les GIF animés.\nTable des matières\nVous pouvez ajouter une table des matières avec la syntaxe Markdown suivante :\n[toc]\nPar défaut, la ToC extrait les en-têtes H2 et H3. Vous pouvez modifier ce comportement avec les options de body.\nExtrait\nUn extrait peut être défini dans le body avec l’une des balises suivantes : excerpt ou break.\nExemple :\nIntroduction.\n<!-- excerpt -->\nMain content.\nUtilisez ensuite le filtre excerpt_html dans votre template.\nNotes\nCréez un bloc de Note (info, astuce, important, etc.).\nExemple :\n:::tip\n**Tip:** This is advice.\n:::\nEst converti en :\n<aside class=\"note note-tip\">\n <p>\n <strong>Tip:<\/strong> This is advice.\n <\/p>\n<\/aside>\nTip: This is advice.\nAutres exemples :\nempty\ninfo\ntip\nimportant\nwarning\ncaution\nColoration syntaxique\nLa coloration syntaxique des blocs de code est activée par défaut avec l’option pages.body.highlight.\nSi besoin, vous pouvez la désactiver avec :\npages:\n body:\n highlight: false\nExemple :\n\n```php\necho \"Hello world\";\n```\n\nEst rendu en :\necho \"Hello world\";\nVous pouvez personnaliser le style de coloration syntaxique en créant votre propre thème. Consultez le guide des thèmes de Highlight.js.\nTexte inséré\nReprésente une plage de texte qui a été ajoutée.\n++text++\nEst converti en :\n<ins>text<\/ins>", "content_html": "

Markdown

\n

Cecil prend en charge le format Markdown, ainsi que Markdown Extra.

\n

Cecil fournit aussi des fonctionnalités supplémentaires pour enrichir votre contenu, voir ci-dessous.

\n

Attributs

\n

Avec Markdown Extra, vous pouvez définir un id, une classe et des attributs personnalisés sur certains éléments à l’aide d’un bloc d’attributs.
\nPar exemple, placez le(s) attribut(s) souhaité(s) après un en-tête, un bloc de code délimité, un lien ou une image en fin de ligne, entre accolades, comme ceci :

\n
## En-tête {#id .class attribute=value}
\n\n

Liens

\n

Vous pouvez créer un lien avec la syntaxe [Texte](url) ; url peut être un chemin, un chemin relatif vers un fichier Markdown, une URL externe, etc.

\n

Exemple :

\n
[Link to a path](/about/)\n[Link to a Markdown file](/fr/a-propos/)\n[Link to Cecil website](https://cecil.app)
\n\n

Lien vers une page

\n

Vous pouvez facilement créer un lien vers une page avec la syntaxe [Titre de page](page:page-id).

\n

Exemple :

\n
[Link to a blog post](page:blog/post-1)
\n

Externe

\n

Par défaut, les liens externes ont la valeur suivante pour l’attribut rel : noopener noreferrer.

\n

Exemple :

\n
<a href=\"<url>\" rel=\"noopener noreferrer\">Link to another website</a>
\n

Vous pouvez modifier ce comportement avec les options pages.body.links.external.

\n

Liens intégrés

\n

Vous pouvez laisser Cecil essayer de transformer un lien en contenu embarqué en utilisant l’attribut {embed} ou en activant l’option de configuration globale pages.body.links.embed.enabled à true.

\n\n

Exemple :

\n
[CECIL : LE générateur de SITES STATIQUES en PHP](https://www.youtube.com/watch?v=ur8koU0iYvc){embed}
\n

\n\n

\n

Local video/audio files

\n

Cecil peut aussi créer des éléments HTML vidéo et audio, selon l’extension du fichier.

\n

Exemple :

\n
[Video file](video.mp4){embed controls poster=/images/video-test.png}\n[Audio file](song.mp3){embed controls}
\n

Est converti en :

\n
<video src=\"/video.mp4\" controls poster=\"/images/video-test.png\" style=\"max-width:100%;height:auto;\"></video>\n<audio src=\"/song.mp3\" controls></audio>
\n

Avec {embed=false} (ou lorsque l’intégration est désactivée), un fichier vidéo/audio local reste un lien, mais son URL pointe vers le fichier publié (avec empreinte si assets.fingerprint est activé).

\n

Images

\n

Pour ajouter une image, utilisez un point d’exclamation (!) suivi d’une description alternative entre crochets ([]), puis du chemin ou de l’URL de l’image entre parenthèses (()).
\nVous pouvez facultativement ajouter un titre entre guillemets.

\n
![Alternative description](/image.jpg \"Image title\")
\n\n

Lazy loading

\n

Cecil ajoute l’attribut loading=\"lazy\" à chaque image.

\n

Exemple :

\n
![](/image.jpg)
\n

Est converti en :

\n
<img src=\"/image.jpg\" loading=\"lazy\">
\n\n

Decoding

\n

Cecil ajoute l’attribut decoding=\"async\" à chaque image.

\n

Exemple :

\n
![](/image.jpg)
\n

Est converti en :

\n
<img src=\"/image.jpg\" decoding=\"async\">
\n\n

Redimensionnement

\n

Chaque image du body peut être redimensionnée automatiquement en définissant une largeur inférieure à celle d’origine, avec l’attribut additionnel {width=X}.

\n

Exemple :

\n
![](/image.jpg){width=800}
\n

Est converti en :

\n
<img src=\"/thumbnails/800/image.jpg\" width=\"800\" height=\"600\">
\n\n\n\n

Formats

\n

Si l’option formats est définie, des images alternatives sont créées et ajoutées.

\n

Exemple :

\n
![](/image.jpg)
\n

Peut être converti en :

\n
<picture>\n  <source srcset=\"/image.avif\" type=\"image/avif\">\n  <source srcset=\"/image.webp\" type=\"image/webp\">\n  <img src=\"/image.jpg\">\n</picture>
\n\n

Responsive

\n

Si l’option responsive est activée, alors toutes les images du body seront automatiquement rendues « responsive ».

\n

Exemple :

\n
![](/image.jpg){width=800}
\n

sera converti en :

\n
<img src=\"/thumbnails/800/image.jpg\" width=\"800\" height=\"600\"\n  srcset=\"/thumbnails/320/image.jpg 320w,\n          /thumbnails/640/image.jpg 640w,\n          /thumbnails/800/image.jpg 800w\"\n  sizes=\"100vw\"\n>
\n\n

L’attribut sizes prend la valeur de l’option de configuration assets.images.responsive.sizes.default, mais peut être modifié en créant une nouvelle entrée nommée d’après une class ajoutée à l’image.

\n

Exemple :

\n
assets:\n  images:\n    responsive:\n      sizes:\n        default: 100vw\n        my_class: \"(max-width: 800px) 768px, 1024px\"
\n
![](/image.jpg){.my_class}
\n\n

CSS class

\n

Vous pouvez définir une valeur par défaut pour l’attribut class de chaque image avec l’option class.

\n

Caption

\n

Le titre optionnel peut être utilisé pour créer automatiquement une légende (figcaption) en activant l’option caption.

\n

Exemple :

\n
![](/images/img.jpg \"Title\")
\n

Est converti en :

\n
<figure>\n  <img src=\"/image.jpg\" title=\"Title\">\n  <figcaption>Title</figcaption>\n</figure>
\n\n

Image localisée

\n

Pour les pages traduites, Cecil recherche d’abord un fichier suffixé par la langue lors de la résolution des chemins d’image Markdown.

\n

Exemple :

\n
![](/images/cecil-logo.png)
\n

Avec une page française (fr), Cecil essaie d’abord /images/cecil-logo.fr.png, puis revient à /images/cecil-logo.png.

\n

Placeholder

\n

Comme les images sont généralement des ressources plus lourdes et plus lentes, et qu’elles ne bloquent pas le rendu, il est préférable de donner aux utilisateurs quelque chose à voir pendant qu’ils attendent leur chargement.

\n

L’attribut placeholder accepte 2 options :

\n
    \n
  1. color: affiche un fond coloré (basé sur la couleur dominante de l’image)
    2. \n
  2. lqip: Low-Quality Image Placeholder
    3. \n
\n

Exemples :

\n
![](/images/img.jpg){placeholder=color}\n![](/images/img.jpg){placeholder=lqip}
\n\n\n

Table des matières

\n

Vous pouvez ajouter une table des matières avec la syntaxe Markdown suivante :

\n
[toc]
\n\n

Extrait

\n

Un extrait peut être défini dans le body avec l’une des balises suivantes : excerpt ou break.

\n

Exemple :

\n
Introduction.\n<!-- excerpt -->\nMain content.
\n

Utilisez ensuite le filtre excerpt_html dans votre template.

\n

Notes

\n

Créez un bloc de Note (info, astuce, important, etc.).

\n

Exemple :

\n
:::tip\n**Tip:** This is advice.\n:::
\n

Est converti en :

\n
<aside class=\"note note-tip\">\n  <p>\n    <strong>Tip:</strong> This is advice.\n  </p>\n</aside>
\n\n

Autres exemples :

\n\n\n\n\n\n\n

Coloration syntaxique

\n

La coloration syntaxique des blocs de code est activée par défaut avec l’option pages.body.highlight.

\n

Si besoin, vous pouvez la désactiver avec :

\n
pages:\n  body:\n    highlight: false
\n

Exemple :

\n
\n```php\necho \"Hello world\";\n```\n
\n

Est rendu en :

\n
echo \"Hello world\";
\n\n

Texte inséré

\n

Représente une plage de texte qui a été ajoutée.

\n
++text++
\n

Est converti en :

\n
<ins>text</ins>
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/deployer/hebergement-statique/", "url": "https://cecil-945.pages.dev/fr/documentation/deployer/hebergement-statique/", "title": "Hébergement statique", "summary": "Déployer sur un hébergement statique (Surge).", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "Hébergement statique\nLe site construit peut être envoyé tel quel vers n’importe quel service d’hébergement statique.\nSurge\n\nPublier des projets web doit être rapide, simple et peu risqué. Surge est un service de publication de sites statiques pour les développeurs frontend, directement depuis la CLI.\n\n➡️ https:\/\/surge.sh\nTerminal:\nnpm install -g surge\nsurge _site\/\nDocumentation officielle", "content_html": "

Hébergement statique

\n

Le site construit peut être envoyé tel quel vers n’importe quel service d’hébergement statique.

\n

Surge

\n
\n

Publier des projets web doit être rapide, simple et peu risqué. Surge est un service de publication de sites statiques pour les développeurs frontend, directement depuis la CLI.

\n
\n

➡️ https://surge.sh

\n

Terminal:

\n
npm install -g surge\nsurge _site/
\n

Documentation officielle

", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/bien-demarrer/structure-des-dossiers/", "url": "https://cecil-945.pages.dev/fr/documentation/bien-demarrer/structure-des-dossiers/", "title": "Structure des dossiers", "summary": "Organisation des fichiers sources, arborescence du site généré et routage des fichiers vers les URL.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "Structure des dossiers\nCette page décrit l’organisation d’un projet Cecil, la structure du site construit et la façon dont les fichiers sont associés aux URL.\nArborescence du système de fichiers\nOrganisation des fichiers du projet.\n<monsiteweb>\n├─ pages\n| ├─ blog <- Section\n| | ├─ billet-1.md <- Page dans Section\n| | └─ billet-2.md\n| ├─ projets\n| | └─ projet-a.md\n| └─ about.md <- Page racine\n├─ assets\n| ├─ styles.scss <- Fichier d'asset\n| └─ logo.png\n├─ static\n| └─ fichier.pdf <- Fichier statique\n└─ data\n └─ auteurs.yml <- Collection de données\nArborescence du site généré\nRésultat de la génération.\n<monsiteweb>\n└─ _site\n ├─ index.html <- Page d'accueil générée\n ├─ blog\/\n | ├─ index.html <- Liste des articles générée\n | ├─ billet-1\/index.html <- Article de blog\n | └─ billet-2\/index.html\n ├─ projets\/\n | ├─ index.html <- Liste des projets générée\n | └─ projet-a\/index.html <- Projet individuel\n ├─ about\/index.html <- Page \"À propos\"\n ├─ styles.css\n ├─ logo.png\n └─ fichier.pdf\nPar défaut, chaque page est générée sous la forme nomdufichier-sluglifié\/index.html pour obtenir une « belle » URL comme https:\/\/monsiteweb.tld\/section\/nomdufichier-sluglifié\/.\nPour obtenir une URL « ugly » (comme 404.html au lieu de 404\/), définissez uglyurl: true dans le front matter de la page.\nRoutage basé sur les fichiers\nLes fichiers Markdown du répertoire pages activent un routage basé sur les fichiers. Cela signifie que l’ajout, par exemple, de pages\/mon-projet\/projet-a.md le rendra accessible à l’URL \/projet-a dans votre navigateur.\nFichier :\n pages\/mon-projet\/projet-a.md\n └───── filepath ──────┘\nURL :\n ┌───── baseurl ─────┬─────── path ────────┐\n https:\/\/exemple.com\/mon-projet\/projet-a\/index.html\n └─ section ─┴─ slug ──┘\nDeux types de préfixes peuvent modifier l’URL, voir la section Préfixe de fichier ci-dessous.", "content_html": "

Structure des dossiers

\n

Cette page décrit l’organisation d’un projet Cecil, la structure du site construit et la façon dont les fichiers sont associés aux URL.

\n

Arborescence du système de fichiers

\n

Organisation des fichiers du projet.

\n
<monsiteweb>\n├─ pages\n|  ├─ blog            <- Section\n|  |  ├─ billet-1.md  <- Page dans Section\n|  |  └─ billet-2.md\n|  ├─ projets\n|  |  └─ projet-a.md\n|  └─ about.md        <- Page racine\n├─ assets\n|  ├─ styles.scss     <- Fichier d'asset\n|  └─ logo.png\n├─ static\n|  └─ fichier.pdf     <- Fichier statique\n└─ data\n   └─ auteurs.yml     <- Collection de données
\n

Arborescence du site généré

\n

Résultat de la génération.

\n
<monsiteweb>\n└─ _site\n   ├─ index.html               <- Page d'accueil générée\n   ├─ blog/\n   |  ├─ index.html            <- Liste des articles générée\n   |  ├─ billet-1/index.html   <- Article de blog\n   |  └─ billet-2/index.html\n   ├─ projets/\n   |  ├─ index.html            <- Liste des projets générée\n   |  └─ projet-a/index.html   <- Projet individuel\n   ├─ about/index.html         <- Page \"À propos\"\n   ├─ styles.css\n   ├─ logo.png\n   └─ fichier.pdf
\n\n

Routage basé sur les fichiers

\n

Les fichiers Markdown du répertoire pages activent un routage basé sur les fichiers. Cela signifie que l’ajout, par exemple, de pages/mon-projet/projet-a.md le rendra accessible à l’URL /projet-a dans votre navigateur.

\n
Fichier :\n                   pages/mon-projet/projet-a.md\n                        └───── filepath ──────┘\nURL :\n    ┌───── baseurl ─────┬─────── path ────────┐\n     https://exemple.com/mon-projet/projet-a/index.html\n                        └─ section ─┴─ slug ──┘
\n", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/commandes/build/", "url": "https://cecil-945.pages.dev/fr/documentation/commandes/build/", "title": "build", "summary": "Générer le site.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "build\nConstruit le site.\nUtilisation\nDescription:\n Builds the website\n\nUsage:\n build [options] [--] [<path>]\n\nArguments:\n path Use the given path as working directory\n\nOptions:\n -d, --drafts Include drafts\n -u, --baseurl=BASEURL Set the base URL\n -o, --output=OUTPUT Set the output directory\n --optimize|--no-optimize Enable (or disable --no-optimize) optimization of generated files\n --dry-run Build without saving\n -c, --config=CONFIG Set the path to extra config files (comma-separated)\n --clear-cache[=CLEAR-CACHE] Clear cache before build (optional cache key as regular expression) [default: false]\n -p, --page=PAGE Build a specific page\n --render-subset=RENDER-SUBSET Render a subset of pages\n --show-pages Show list of built pages in a table\n -m, --metrics Show build metrics (duration and memory) of each step\n --notify Send desktop notification on build completion\n -h, --help Display help for the given command. When no command is given display help for the list command\n -q, --quiet Do not output any message\n -V, --version Display this application version\n --ansi|--no-ansi Force (or disable --no-ansi) ANSI output\n -n, --no-interaction Do not ask any interactive question\n -v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug\n\nHelp:\n The build command generates the website in the output directory.\n\n cecil.phar build\n cecil.phar build path\/to\/the\/working\/directory\n cecil.phar build --baseurl=https:\/\/example.com\/\n cecil.phar build --output=_site\n\n To build the website with optimization of generated files, you can use the --optimize option.\n This is useful to reduce the size of the generated files and improve performance:\n\n cecil.phar build --optimize\n cecil.phar build --no-optimize\n\n To build the website without overwriting files in the output directory, you can use the --dry-run option.\n This is useful to check what would be built without actually writing files:\n\n cecil.phar build --dry-run\n\n To build the website with a specific subset of rendered pages, you can use the --render-subset option.\n This is useful to build only a part of the website, for example, only \"hot\" pages or a specific section:\n\n cecil.phar build --render-subset=subset\n\n To show build steps metrics, run:\n\n cecil.phar build --metrics", "content_html": "

build

\n

Construit le site.

\n

Utilisation

\n
Description:\n  Builds the website\n\nUsage:\n  build [options] [--] [<path>]\n\nArguments:\n  path                               Use the given path as working directory\n\nOptions:\n  -d, --drafts                       Include drafts\n  -u, --baseurl=BASEURL              Set the base URL\n  -o, --output=OUTPUT                Set the output directory\n      --optimize|--no-optimize       Enable (or disable --no-optimize) optimization of generated files\n      --dry-run                      Build without saving\n  -c, --config=CONFIG                Set the path to extra config files (comma-separated)\n      --clear-cache[=CLEAR-CACHE]    Clear cache before build (optional cache key as regular expression) [default: false]\n  -p, --page=PAGE                    Build a specific page\n      --render-subset=RENDER-SUBSET  Render a subset of pages\n      --show-pages                   Show list of built pages in a table\n  -m, --metrics                      Show build metrics (duration and memory) of each step\n      --notify                       Send desktop notification on build completion\n  -h, --help                         Display help for the given command. When no command is given display help for the list command\n  -q, --quiet                        Do not output any message\n  -V, --version                      Display this application version\n      --ansi|--no-ansi               Force (or disable --no-ansi) ANSI output\n  -n, --no-interaction               Do not ask any interactive question\n  -v|vv|vvv, --verbose               Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug\n\nHelp:\n  The build command generates the website in the output directory.\n\n    cecil.phar build\n    cecil.phar build path/to/the/working/directory\n    cecil.phar build --baseurl=https://example.com/\n    cecil.phar build --output=_site\n\n  To build the website with optimization of generated files, you can use the --optimize option.\n  This is useful to reduce the size of the generated files and improve performance:\n\n    cecil.phar build --optimize\n    cecil.phar build --no-optimize\n\n  To build the website without overwriting files in the output directory, you can use the --dry-run option.\n  This is useful to check what would be built without actually writing files:\n\n    cecil.phar build --dry-run\n\n  To build the website with a specific subset of rendered pages, you can use the --render-subset option.\n  This is useful to build only a part of the website, for example, only \"hot\" pages or a specific section:\n\n    cecil.phar build --render-subset=subset\n\n  To show build steps metrics, run:\n\n    cecil.phar build --metrics
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/configuration/pages/", "url": "https://cecil-945.pages.dev/fr/documentation/configuration/pages/", "title": "Pages", "summary": "Dossier des pages, tri, pagination, chemins, corps, pages virtuelles, générateurs, etc.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "Pages\nCes options contrôlent la façon dont les pages sont chargées, triées, paginées, routées et générées.\npages.dir\nRépertoire source des pages (pages par défaut).\npages:\n dir: pages\npages.ext\nExtensions des fichiers de pages.\npages:\n ext: [md, markdown, mdown, mkdn, mkd, text, txt]\npages.exclude\nRépertoires, chemins et noms de fichiers à exclure (accepte les glob, les chaînes et les expressions régulières).\npages:\n exclude: ['vendor', 'node_modules', '*.scss', '\/\\.bck$\/']\npages.prefix.separator\nListe des caractères utilisés comme séparateur entre un préfixe de nom de fichier (date ou weight) et le slug.\npages:\n prefix:\n separator: ['-', '_']\npages.sortby\nMéthode de tri par défaut des collections.\npages:\n sortby: date # `date`, `updated`, `title` ou `weight`\n # ou\n sortby:\n variable: date # `date`, `updated`, `title` ou `weight`\n desc_title: false # tri par titre décroissant\n reverse: false # inverse l’ordre de tri\npages.pagination\nLa pagination est disponible pour les pages de liste (type homepage, section ou term).\npages:\n pagination:\n max: 5 # nombre maximum d’entrées par page\n path: page # chemin de la page paginée\nDésactiver la pagination\nLa pagination peut être désactivée :\npages:\n pagination: false\npages.paths\nApplique un path personnalisé à toutes les pages d’une section.\npages:\n paths:\n - section: <section’s ID>\n path: <path of pages>\nEmplacements des variables de chemin\n\n:year\n:month\n:day\n:section\n:slug\n\nExemple :\npages:\n paths:\n - section: Blog\n path: :section\/:year\/:month\/:day\/:slug # ex. : \/blog\/2020\/12\/01\/my-post\/\n# localized\nlanguages:\n - code: fr\n name: Français\n locale: fr_FR\n config:\n pages:\n paths:\n - section: Blog\n path: blogue\/:year\/:month\/:day\/:slug # ex. : \/blogue\/2020\/12\/01\/mon-billet\/\npages.frontmatter\nFormat du front matter des pages (yaml par défaut, accepte aussi ini, toml et json).\npages:\n frontmatter: yaml\npages.body\nOptions du corps des pages.\nPour savoir comment ces options influencent votre contenu, voir la documentation Contenu > Markdown.\npages.body.toc\nEn-têtes utilisés pour construire la table des matières ([h2, h3] par défaut).\npages:\n body:\n toc: [h2, h3]\npages.body.highlight\nActive la coloration syntaxique du code (true par défaut).\npages:\n body:\n highlight: false # définissez à false pour désactiver la coloration syntaxique\npages.body.images\nOptions de gestion des images.\npages:\n body:\n images:\n formats: [] # ajoute des formats d’image alternatifs comme `source` (ex. `[avif, webp]`, tableau vide par défaut)\n resize: 0 # redimensionne toutes les images à <width> (en pixels, `0` pour désactiver)\n responsive: false # ajoute des variantes responsives à l’attribut `srcset` (`false` par défaut)\n lazy: true # ajoute l’attribut `loading=\"lazy\"` (`true` par défaut)\n decoding: true # ajoute l’attribut `decoding=\"async\"` (`true` par défaut)\n caption: false # place l’image dans un élément <figure> et ajoute une <figcaption> contenant le titre (`false` par défaut)\n placeholder: '' # remplit l’arrière-plan de <img> avant le chargement ('color' ou 'lqip', vide par défaut)\n class: '' # définit une classe par défaut sur chaque image (vide par défaut)\n dark_suffix: '' # suffixe de l’image variante sombre (ex. `.dark`), désactivé par défaut\n mobile_suffix: '' # suffixe de l’image variante mobile (ex. `.mobile`), désactivé par défaut\n mobile_media_query: '(max-width: 767px)' # media query de la `<source>` de la variante mobile\n remote: # traitement des images distantes (mettre à `false` pour désactiver)\n fallback: # chemin de l’image de secours, stockée dans le répertoire assets (vide par défaut)\nDepuis la version 8.41.0, l’option pages.body.images.resize sert à redimensionner les images à une largeur précise, et non plus à activer la fonctionnalité de redimensionnement (activée systématiquement).\nLes options globales, comme les largeurs et tailles des images responsives, sont configurables dans la section assets.images.\nLes images distantes sont téléchargées et converties en Assets pour être manipulées. Vous pouvez désactiver ce comportement en définissant l’option pages.body.images.remote.enabled à false.\nLorsque dark_suffix est défini (par ex. dark_suffix: .dark), Cecil cherche automatiquement une variante sombre de chaque image (par ex. photo.dark.jpg à côté de photo.jpg). Si elle est trouvée, l’image est entourée d’un élément <picture> avec une balise <source media=\"(prefers-color-scheme: dark)\"> pour un basculement automatique clair\/sombre. Cela fonctionne avec formats et responsive.\nDe la même manière, lorsque mobile_suffix est défini (par ex. mobile_suffix: .mobile), Cecil cherche une variante mobile de chaque image (par ex. photo.mobile.jpg à côté de photo.jpg) et ajoute une balise <source> avec la media query mobile_media_query ((max-width: 767px) par défaut). Si dark_suffix est également défini, la variante sombre de l’image mobile (par ex. photo.mobile.dark.jpg) est utilisée sur mobile en mode sombre. Les sources mobiles sont placées avant les sources sombres, afin que la variante mobile soit prioritaire.\npages.body.links\nOptions de gestion des liens.\npages:\n body:\n links:\n embed:\n enabled: false # transforme les liens en contenu embarqué si possible (`false` par défaut)\n video: [mp4, webm] # extensions des fichiers vidéo\n audio: [mp3] # extensions des fichiers audio\n external:\n blank: false # si `true`, ouvre le lien externe dans un nouvel onglet\n noopener: true # si `true`, ajoute `noopener` à l’attribut `rel`\n noreferrer: true # si `true`, ajoute `noreferrer` à l’attribut `rel`\n nofollow: false # si `true`, ajoute `nofollow` à l’attribut `rel`\npages.body.excerpt\nOptions de gestion des extraits.\npages:\n body:\n excerpt:\n separator: excerpt|break # chaîne utilisée comme séparateur (`excerpt|break` par défaut)\n capture: before # partie à capturer, `before` ou `after` le séparateur (`before` par défaut)\npages.virtual\nLes pages virtuelles sont la meilleure façon de créer des pages sans contenu (front matter uniquement).\nElles consistent en une liste de pages avec un path et quelques variables de front matter.\nExemple :\npages:\n virtual:\n - path: code\n redirect: https:\/\/github.com\/ArnaudLigny\npages.default\nLes pages par défaut sont des pages créées automatiquement par Cecil (à partir de modèles intégrés) :\npages:\n default:\n index:\n path: ''\n title: Accueil\n published: true\n 404:\n path: 404\n title: Page introuvable\n layout: 404\n uglyurl: true\n published: true\n excluded: true\n robots:\n path: robots\n title: Robots.txt\n layout: robots\n output: txt\n published: true\n excluded: true\n multilingual: false\n sitemap:\n path: sitemap\n title: Plan de site XML\n layout: sitemap\n output: xml\n changefreq: monthly\n priority: 0.5\n published: true\n excluded: true\n multilingual: false\n xsl\/atom:\n path: xsl\/atom\n layout: feed\n output: xsl\n uglyurl: true\n published: true\n excluded: true\n xsl\/rss:\n path: xsl\/rss\n layout: feed\n output: xsl\n uglyurl: true\n published: false\n excluded: true\nLa structure est presque identique à celle de pages.virtual, à l’exception de la clé nommée.\nChaque page peut être :\n\ndésactivée : published: false\nexclue des pages de liste : excluded: true\nexclue de la localisation : multilingual: false\n\nDepuis la version 8.68.0, vous pouvez surcharger la page robots.txt par défaut en créant une page avec le même path :\npages\/robots.md\n---\nlayout: robots\noutput: txt\n---\nUser-agent: AI-bot\nDisallow: \/\npages.generators\nLes générateurs servent à Cecil pour créer des pages supplémentaires (par ex. sitemap, flux, pagination, etc.) à partir de pages existantes, ou à partir d’autres sources comme le fichier de configuration ou des sources externes.\nVoici la liste des générateurs fournis par Cecil, dans un ordre défini :\npages:\n generators:\n 10: 'Cecil\\Generator\\DefaultPages'\n 20: 'Cecil\\Generator\\VirtualPages'\n 30: 'Cecil\\Generator\\ExternalBody'\n 40: 'Cecil\\Generator\\Section'\n 50: 'Cecil\\Generator\\Taxonomy'\n 60: 'Cecil\\Generator\\Homepage'\n 70: 'Cecil\\Generator\\Pagination'\n 80: 'Cecil\\Generator\\Alias'\n 90: 'Cecil\\Generator\\Redirect'\nVous pouvez étendre Cecil avec un générateur de pages.\npages.subsets\nLes sous-ensembles servent à rendre une partie de la collection de pages, selon un chemin, une langue ou un format de sortie spécifique, avec la commande :\ncecil build --render-subset=<name>\npages:\n subsets:\n <name>:\n path: <path> # chemin glob ou chaîne (ex. `blog\/*`, `blog`)\n language: <language> # code de langue (ex. `en`, `fr`)\n output: <output> # format de sortie (ex. `html`, `atom`)\nExemple :\npages:\n subsets:\n blog_en:\n path: blog\n language: en\n output: html\n search_index:\n path: '*'\n output: json\n", "content_html": "

Pages

\n

Ces options contrôlent la façon dont les pages sont chargées, triées, paginées, routées et générées.

\n

pages.dir

\n

Répertoire source des pages (pages par défaut).

\n
pages:\n  dir: pages
\n

pages.ext

\n

Extensions des fichiers de pages.

\n
pages:\n  ext: [md, markdown, mdown, mkdn, mkd, text, txt]
\n

pages.exclude

\n

Répertoires, chemins et noms de fichiers à exclure (accepte les glob, les chaînes et les expressions régulières).

\n
pages:\n  exclude: ['vendor', 'node_modules', '*.scss', '/\\.bck$/']
\n

pages.prefix.separator

\n

Liste des caractères utilisés comme séparateur entre un préfixe de nom de fichier (date ou weight) et le slug.

\n
pages:\n  prefix:\n    separator: ['-', '_']
\n

pages.sortby

\n

Méthode de tri par défaut des collections.

\n
pages:\n  sortby: date # `date`, `updated`, `title` ou `weight`\n  # ou\n  sortby:\n    variable: date    # `date`, `updated`, `title` ou `weight`\n    desc_title: false # tri par titre décroissant\n    reverse: false    # inverse l’ordre de tri
\n

pages.pagination

\n

La pagination est disponible pour les pages de liste (type homepage, section ou term).

\n
pages:\n  pagination:\n    max: 5     # nombre maximum d’entrées par page\n    path: page # chemin de la page paginée
\n

Désactiver la pagination

\n

La pagination peut être désactivée :

\n
pages:\n  pagination: false
\n

pages.paths

\n

Applique un path personnalisé à toutes les pages d’une section.

\n
pages:\n  paths:\n    - section: <section’s ID>\n      path: <path of pages>
\n

Emplacements des variables de chemin

\n\n

Exemple :

\n
pages:\n  paths:\n    - section: Blog\n      path: :section/:year/:month/:day/:slug # ex. : /blog/2020/12/01/my-post/\n# localized\nlanguages:\n  - code: fr\n    name: Français\n    locale: fr_FR\n    config:\n      pages:\n        paths:\n          - section: Blog\n            path: blogue/:year/:month/:day/:slug # ex. : /blogue/2020/12/01/mon-billet/
\n

pages.frontmatter

\n

Format du front matter des pages (yaml par défaut, accepte aussi ini, toml et json).

\n
pages:\n  frontmatter: yaml
\n

pages.body

\n

Options du corps des pages.

\n\n

pages.body.toc

\n

En-têtes utilisés pour construire la table des matières ([h2, h3] par défaut).

\n
pages:\n  body:\n    toc: [h2, h3]
\n

pages.body.highlight

\n

Active la coloration syntaxique du code (true par défaut).

\n
pages:\n  body:\n    highlight: false # définissez à false pour désactiver la coloration syntaxique
\n

pages.body.images

\n

Options de gestion des images.

\n
pages:\n  body:\n    images:\n      formats: []       # ajoute des formats d’image alternatifs comme `source` (ex. `[avif, webp]`, tableau vide par défaut)\n      resize: 0         # redimensionne toutes les images à <width> (en pixels, `0` pour désactiver)\n      responsive: false # ajoute des variantes responsives à l’attribut `srcset` (`false` par défaut)\n      lazy: true        # ajoute l’attribut `loading=\"lazy\"` (`true` par défaut)\n      decoding: true    # ajoute l’attribut `decoding=\"async\"` (`true` par défaut)\n      caption: false    # place l’image dans un élément <figure> et ajoute une <figcaption> contenant le titre (`false` par défaut)\n      placeholder: ''   # remplit l’arrière-plan de <img> avant le chargement ('color' ou 'lqip', vide par défaut)\n      class: ''         # définit une classe par défaut sur chaque image (vide par défaut)\n      dark_suffix: ''   # suffixe de l’image variante sombre (ex. `.dark`), désactivé par défaut\n      mobile_suffix: '' # suffixe de l’image variante mobile (ex. `.mobile`), désactivé par défaut\n      mobile_media_query: '(max-width: 767px)' # media query de la `<source>` de la variante mobile\n      remote:           # traitement des images distantes (mettre à `false` pour désactiver)\n        fallback:         # chemin de l’image de secours, stockée dans le répertoire assets (vide par défaut)
\n\n\n\n\n

pages.body.links

\n

Options de gestion des liens.

\n
pages:\n  body:\n    links:\n      embed:\n        enabled: false     # transforme les liens en contenu embarqué si possible (`false` par défaut)\n        video: [mp4, webm] # extensions des fichiers vidéo\n        audio: [mp3]       # extensions des fichiers audio\n      external:\n        blank: false     # si `true`, ouvre le lien externe dans un nouvel onglet\n        noopener: true   # si `true`, ajoute `noopener` à l’attribut `rel`\n        noreferrer: true # si `true`, ajoute `noreferrer` à l’attribut `rel`\n        nofollow: false  # si `true`, ajoute `nofollow` à l’attribut `rel`
\n

pages.body.excerpt

\n

Options de gestion des extraits.

\n
pages:\n  body:\n    excerpt:\n      separator: excerpt|break # chaîne utilisée comme séparateur (`excerpt|break` par défaut)\n      capture: before          # partie à capturer, `before` ou `after` le séparateur (`before` par défaut)
\n

pages.virtual

\n

Les pages virtuelles sont la meilleure façon de créer des pages sans contenu (front matter uniquement).

\n

Elles consistent en une liste de pages avec un path et quelques variables de front matter.

\n

Exemple :

\n
pages:\n  virtual:\n    - path: code\n      redirect: https://github.com/ArnaudLigny
\n

pages.default

\n

Les pages par défaut sont des pages créées automatiquement par Cecil (à partir de modèles intégrés) :

\n
pages:\n  default:\n    index:\n      path: ''\n      title: Accueil\n      published: true\n    404:\n      path: 404\n      title: Page introuvable\n      layout: 404\n      uglyurl: true\n      published: true\n      excluded: true\n    robots:\n      path: robots\n      title: Robots.txt\n      layout: robots\n      output: txt\n      published: true\n      excluded: true\n      multilingual: false\n    sitemap:\n      path: sitemap\n      title: Plan de site XML\n      layout: sitemap\n      output: xml\n      changefreq: monthly\n      priority: 0.5\n      published: true\n      excluded: true\n      multilingual: false\n    xsl/atom:\n      path: xsl/atom\n      layout: feed\n      output: xsl\n      uglyurl: true\n      published: true\n      excluded: true\n    xsl/rss:\n      path: xsl/rss\n      layout: feed\n      output: xsl\n      uglyurl: true\n      published: false\n      excluded: true
\n\n

Chaque page peut être :

\n
    \n
  1. désactivée : published: false
    2. \n
  2. exclue des pages de liste : excluded: true
    3. \n
  3. exclue de la localisation : multilingual: false
    4. \n
\n\n

pages.generators

\n

Les générateurs servent à Cecil pour créer des pages supplémentaires (par ex. sitemap, flux, pagination, etc.) à partir de pages existantes, ou à partir d’autres sources comme le fichier de configuration ou des sources externes.

\n

Voici la liste des générateurs fournis par Cecil, dans un ordre défini :

\n
pages:\n  generators:\n    10: 'Cecil\\Generator\\DefaultPages'\n    20: 'Cecil\\Generator\\VirtualPages'\n    30: 'Cecil\\Generator\\ExternalBody'\n    40: 'Cecil\\Generator\\Section'\n    50: 'Cecil\\Generator\\Taxonomy'\n    60: 'Cecil\\Generator\\Homepage'\n    70: 'Cecil\\Generator\\Pagination'\n    80: 'Cecil\\Generator\\Alias'\n    90: 'Cecil\\Generator\\Redirect'
\n\n

pages.subsets

\n

Les sous-ensembles servent à rendre une partie de la collection de pages, selon un chemin, une langue ou un format de sortie spécifique, avec la commande :

\n
cecil build --render-subset=<name>
\n
pages:\n  subsets:\n    <name>:\n      path: <path> # chemin glob ou chaîne (ex. `blog/*`, `blog`)\n      language: <language> # code de langue (ex. `en`, `fr`)\n      output: <output> # format de sortie (ex. `html`, `atom`)
\n

Exemple :

\n
pages:\n  subsets:\n    blog_en:\n      path: blog\n      language: en\n      output: html\n    search_index:\n      path: '*'\n      output: json
\n
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/contenu/multilingue/", "url": "https://cecil-945.pages.dev/fr/documentation/contenu/multilingue/", "title": "Multilingue", "summary": "Traduisez les pages via le nom de fichier ou le front matter et liez les pages traduites.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-03T00:00:00+00:00","content_text": "Multilingue\nSi vos pages sont disponibles en plusieurs langues, il existe 2 façons différentes de le définir :\nVia le nom de fichier\nC’est la méthode la plus courante pour traduire une page depuis la langue principale vers une autre langue.\nIl suffit de dupliquer la page de référence et de lui ajouter en suffixe le code de la langue cible (ex. : fr).\nExemple :\n├─ about.md # the reference page\n└─ about.fr.md # the french version (`fr`)\nVous pouvez changer l’URL de la page traduite avec la variable slug dans le front matter. Par exemple :\n---\nslug: a-propos\n---\n# about.md -> \/about\/\n# about.fr.md -> \/fr\/a-propos\/\nVia le front matter\nSi vous souhaitez créer une page dans une langue autre que la langue principale, sans qu’elle soit la traduction d’une page existante, vous pouvez utiliser la variable language dans son front matter.\nExemple :\n---\nlanguage: fr\n---\nLier les pages traduites\nChaque page traduite référence les pages dans les autres langues.\nCette collection de pages est disponible dans les templates via la variable suivante :\n{{ page.translations }}\nLa variable langref est fournie par défaut, mais vous pouvez la modifier dans le front matter :\n---\nlangref: my-page-ref\n---", "content_html": "

Multilingue

\n

Si vos pages sont disponibles en plusieurs langues, il existe 2 façons différentes de le définir :

\n

Via le nom de fichier

\n

C’est la méthode la plus courante pour traduire une page depuis la langue principale vers une autre langue.

\n

Il suffit de dupliquer la page de référence et de lui ajouter en suffixe le code de la langue cible (ex. : fr).

\n

Exemple :

\n
├─ about.md    # the reference page\n└─ about.fr.md # the french version (`fr`)
\n\n

Via le front matter

\n

Si vous souhaitez créer une page dans une langue autre que la langue principale, sans qu’elle soit la traduction d’une page existante, vous pouvez utiliser la variable language dans son front matter.

\n

Exemple :

\n
---\nlanguage: fr\n---
\n

Lier les pages traduites

\n

Chaque page traduite référence les pages dans les autres langues.

\n

Cette collection de pages est disponible dans les templates via la variable suivante :

\n
{{ page.translations }}
\n", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/commandes/doctor/", "url": "https://cecil-945.pages.dev/fr/documentation/commandes/doctor/", "title": "doctor", "summary": "Diagnostiquer la configuration, le front matter, le SEO et les liens.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-11T00:00:00+00:00","content_text": "doctor\nDiagnostique le site courant et l'environnement Cecil.\nUtilisation\nDescription:\n Diagnoses the site configuration\n\nUsage:\n doctor [options] [--] [<path>]\n\nArguments:\n path Use the given path as working directory\n\nOptions:\n -c, --config=CONFIG Set the path to an extra configuration file\n -h, --help Display help for the given command. When no command is given display help for the list command\n -q, --quiet Do not output any message\n -V, --version Display this application version\n --ansi|--no-ansi Force (or disable --no-ansi) ANSI output\n -n, --no-interaction Do not ask any interactive question\n -v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug\n\nHelp:\n The doctor command diagnoses the current site and Cecil environment.\n\n cecil.phar doctor\n cecil.phar doctor path\/to\/the\/working\/directory\n\n To inspect a site with an extra configuration file, run:\n\n cecil.phar doctor --config=config.yml\ndoctor:frontmatter\nValide la syntaxe du front matter des pages.\nDescription:\n Validates pages front matter syntax\n\nUsage:\n doctor:frontmatter|doctor:fm [options] [--] [<path>]\n\nArguments:\n path Use the given path as working directory\n\nOptions:\n -c, --config=CONFIG Set the path to an extra configuration file\n -p, --page=PAGE Validate a single page relative to the pages directory\n --ansi|--no-ansi Force (or disable --no-ansi) ANSI output\n -n, --no-interaction Do not ask any interactive question\n -h, --help Display help for the given command. When no command is given display help for the list command\n -q, --quiet Do not output any message\n -V, --version Display this application version\n -v|vv|vvv Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug\ndoctor:seo\nAudite les pages HTML rendues pour détecter les problèmes SEO courants.\nDescription:\n Audits rendered HTML pages for common SEO issues\n\nUsage:\n doctor:seo [options] [--] [<path>]\n\nArguments:\n path Use the given path as working directory\n\nOptions:\n -c, --config=CONFIG Set the path to an extra configuration file\n -p, --page=PAGE Audit a single page relative to the pages directory\n --format=FORMAT Output format: text (default) or json\n --feedback Include findings with feedback level\n --include-virtual Include virtual pages (paginated, taxonomies) in audit\n --fail-on=FAIL-ON Return a failure exit code when findings of this level or higher are found: bad (default), ok, feedback or never\nLa commande construit le site en mode dry-run, puis audite le HTML rendu avec un jeu de contrôles ciblés : balise title, meta description, URL canonique, structure des titres, balises Open Graph, attributs alt des images et longueur estimée du contenu.\nPar défaut, les pages virtuelles (paginées, pages de taxonomie) sont exclues de l'audit. Utilisez --include-virtual pour les inclure.\nPar défaut, les findings de niveau feedback ne sont pas listés.\nUtilisez --feedback pour inclure les findings de niveau feedback en plus des autres findings.\nExportez les résultats en JSON pour l'intégration CI en utilisant --format=json.\nPar défaut, la commande retourne un code de sortie en échec (1) lorsque des findings de niveau bad sont trouvés. Utilisez --fail-on=ok pour échouer également sur les findings ok, --fail-on=feedback pour échouer sur n'importe quel finding, ou --fail-on=never pour toujours réussir.\nConfiguration\nPersonnalisez les seuils d'audit et les contrôles activés dans votre fichier de configuration :\ndoctor:\n seo:\n title: { min: 30, max: 60 }\n description: { min: 120, max: 160 }\n content: { min_words: 300 }\n checks:\n title: true\n description: true\n canonical: true\n h1: true\n og_tags: true\n img_alt: true\n content_length: true\n lang_attribute: true\ndoctor:links\nContrôle les liens internes et externes des pages rendues.\nDescription:\n Checks internal and external links of the rendered pages\n\nUsage:\n doctor:links [options] [--] [<path>]\n\nArguments:\n path Use the given path as working directory\n\nOptions:\n -c, --config=CONFIG Set the path to an extra configuration file\n -p, --page=PAGE Check links of a single page relative to the pages directory\n --internal Check internal links\n --external Check external links\n --exclude=EXCLUDE Exclude links matching this regular expression (multiple values allowed)\n --timeout=TIMEOUT External links request timeout, in seconds\n --concurrency=CONCURRENCY Number of concurrent external links requests\n --no-cache Do not use cached external links results\n --format=FORMAT Output format: text (default) or json\n --include-virtual Include virtual pages (paginated, taxonomies) in audit\n --feedback Include findings with feedback level\n --fail-on=FAIL-ON Return a failure exit code when findings of this level or higher are found: bad (default), ok, feedback or never\nLa commande construit le site en mode dry-run, puis contrôle les liens trouvés dans les pages HTML rendues : liens (<a>, <area>, <link>), images (src et srcset), scripts, iframes, médias et styles en ligne. Les fichiers CSS liés depuis les pages sont également analysés (url() et @import).\n\nLiens internes : ils doivent cibler une page générée, un fichier statique ou un asset. Les fragments (#ancre) doivent correspondre à l'ID d'un élément de la page cible. Les URL absolues commençant par baseurl sont considérées comme des liens internes.\nLiens externes : ils sont requêtés en HTTP (HEAD, puis GET si le serveur refuse HEAD), en parallèle. Les résultats en succès sont mis en cache (24 heures par défaut) : utilisez --no-cache pour les contrôler à nouveau.\n\nPar défaut, seuls les liens internes sont contrôlés :\nphp cecil.phar doctor:links # liens internes (par défaut)\nphp cecil.phar doctor:links --external # liens externes uniquement\nphp cecil.phar doctor:links --internal --external # les deux\nNiveaux des findings :\n\n\n\nNiveau\nSignification\n\n\n\n\nbad\nLien cassé : cible introuvable, ancre manquante, erreur HTTP (4xx, 5xx), hôte introuvable, etc.\n\n\nok\nLien fonctionnel mais améliorable : redirection, slash final manquant\n\n\nfeedback\nLien invérifiable : accès refusé (401, 403, 429), probablement par une protection anti-bot, ou timeout\n\n\n\nLes liens utilisant d'autres schémas que HTTP (ex. : mailto:, tel:, data:) sont ignorés. Utilisez --exclude (expression régulière, insensible à la casse) pour ignorer d'autres liens.\nLes options --page, --include-virtual, --feedback, --format et --fail-on se comportent comme avec doctor:seo (voir ci-dessus).\nLe contrôle des liens externes nécessite l'extension PHP cURL.\nConfiguration\nPersonnalisez les réglages par défaut dans votre fichier de configuration :\ndoctor:\n links:\n internal: true # contrôle des liens internes\n external: false # contrôle des liens externes\n timeout: 10 # timeout des requêtes des liens externes, en secondes\n concurrency: 10 # nombre de requêtes simultanées des liens externes\n cache_ttl: 86400 # durée de mise en cache des résultats en succès des liens externes, en secondes\n exclude: [] # liens à ignorer (liste d'expressions régulières), ex. : ['linkedin\\.com', '^https:\/\/localhost']\n useragent: ~ # en-tête User-Agent des requêtes des liens externes (`assets.remote.useragent.default` par défaut)", "content_html": "

doctor

\n

Diagnostique le site courant et l'environnement Cecil.

\n

Utilisation

\n
Description:\n  Diagnoses the site configuration\n\nUsage:\n  doctor [options] [--] [<path>]\n\nArguments:\n  path                       Use the given path as working directory\n\nOptions:\n  -c, --config=CONFIG        Set the path to an extra configuration file\n  -h, --help                 Display help for the given command. When no command is given display help for the list command\n  -q, --quiet                Do not output any message\n  -V, --version              Display this application version\n      --ansi|--no-ansi       Force (or disable --no-ansi) ANSI output\n  -n, --no-interaction       Do not ask any interactive question\n  -v|vv|vvv, --verbose       Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug\n\nHelp:\n  The doctor command diagnoses the current site and Cecil environment.\n\n    cecil.phar doctor\n    cecil.phar doctor path/to/the/working/directory\n\n  To inspect a site with an extra configuration file, run:\n\n    cecil.phar doctor --config=config.yml
\n

doctor:frontmatter

\n

Valide la syntaxe du front matter des pages.

\n
Description:\n  Validates pages front matter syntax\n\nUsage:\n  doctor:frontmatter|doctor:fm [options] [--] [<path>]\n\nArguments:\n  path                  Use the given path as working directory\n\nOptions:\n  -c, --config=CONFIG   Set the path to an extra configuration file\n  -p, --page=PAGE       Validate a single page relative to the pages directory\n      --ansi|--no-ansi  Force (or disable --no-ansi) ANSI output\n  -n, --no-interaction  Do not ask any interactive question\n  -h, --help            Display help for the given command. When no command is given display help for the list command\n  -q, --quiet           Do not output any message\n  -V, --version         Display this application version\n  -v|vv|vvv             Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
\n

doctor:seo

\n

Audite les pages HTML rendues pour détecter les problèmes SEO courants.

\n
Description:\n  Audits rendered HTML pages for common SEO issues\n\nUsage:\n  doctor:seo [options] [--] [<path>]\n\nArguments:\n  path                  Use the given path as working directory\n\nOptions:\n  -c, --config=CONFIG   Set the path to an extra configuration file\n  -p, --page=PAGE       Audit a single page relative to the pages directory\n      --format=FORMAT   Output format: text (default) or json\n      --feedback        Include findings with feedback level\n      --include-virtual Include virtual pages (paginated, taxonomies) in audit\n      --fail-on=FAIL-ON Return a failure exit code when findings of this level or higher are found: bad (default), ok, feedback or never
\n

La commande construit le site en mode dry-run, puis audite le HTML rendu avec un jeu de contrôles ciblés : balise title, meta description, URL canonique, structure des titres, balises Open Graph, attributs alt des images et longueur estimée du contenu.

\n

Par défaut, les pages virtuelles (paginées, pages de taxonomie) sont exclues de l'audit. Utilisez --include-virtual pour les inclure.

\n

Par défaut, les findings de niveau feedback ne sont pas listés.

\n

Utilisez --feedback pour inclure les findings de niveau feedback en plus des autres findings.

\n

Exportez les résultats en JSON pour l'intégration CI en utilisant --format=json.

\n

Par défaut, la commande retourne un code de sortie en échec (1) lorsque des findings de niveau bad sont trouvés. Utilisez --fail-on=ok pour échouer également sur les findings ok, --fail-on=feedback pour échouer sur n'importe quel finding, ou --fail-on=never pour toujours réussir.

\n

Configuration

\n

Personnalisez les seuils d'audit et les contrôles activés dans votre fichier de configuration :

\n
doctor:\n  seo:\n    title: { min: 30, max: 60 }\n    description: { min: 120, max: 160 }\n    content: { min_words: 300 }\n    checks:\n      title: true\n      description: true\n      canonical: true\n      h1: true\n      og_tags: true\n      img_alt: true\n      content_length: true\n      lang_attribute: true
\n

doctor:links

\n

Contrôle les liens internes et externes des pages rendues.

\n
Description:\n  Checks internal and external links of the rendered pages\n\nUsage:\n  doctor:links [options] [--] [<path>]\n\nArguments:\n  path                           Use the given path as working directory\n\nOptions:\n  -c, --config=CONFIG            Set the path to an extra configuration file\n  -p, --page=PAGE                Check links of a single page relative to the pages directory\n      --internal                 Check internal links\n      --external                 Check external links\n      --exclude=EXCLUDE          Exclude links matching this regular expression (multiple values allowed)\n      --timeout=TIMEOUT          External links request timeout, in seconds\n      --concurrency=CONCURRENCY  Number of concurrent external links requests\n      --no-cache                 Do not use cached external links results\n      --format=FORMAT            Output format: text (default) or json\n      --include-virtual          Include virtual pages (paginated, taxonomies) in audit\n      --feedback                 Include findings with feedback level\n      --fail-on=FAIL-ON          Return a failure exit code when findings of this level or higher are found: bad (default), ok, feedback or never
\n

La commande construit le site en mode dry-run, puis contrôle les liens trouvés dans les pages HTML rendues : liens (<a>, <area>, <link>), images (src et srcset), scripts, iframes, médias et styles en ligne. Les fichiers CSS liés depuis les pages sont également analysés (url() et @import).

\n\n

Par défaut, seuls les liens internes sont contrôlés :

\n
php cecil.phar doctor:links                       # liens internes (par défaut)\nphp cecil.phar doctor:links --external            # liens externes uniquement\nphp cecil.phar doctor:links --internal --external # les deux
\n

Niveaux des findings :

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
NiveauSignification
badLien cassé : cible introuvable, ancre manquante, erreur HTTP (4xx, 5xx), hôte introuvable, etc.
okLien fonctionnel mais améliorable : redirection, slash final manquant
feedbackLien invérifiable : accès refusé (401, 403, 429), probablement par une protection anti-bot, ou timeout
\n

Les liens utilisant d'autres schémas que HTTP (ex. : mailto:, tel:, data:) sont ignorés. Utilisez --exclude (expression régulière, insensible à la casse) pour ignorer d'autres liens.

\n

Les options --page, --include-virtual, --feedback, --format et --fail-on se comportent comme avec doctor:seo (voir ci-dessus).

\n\n

Configuration

\n

Personnalisez les réglages par défaut dans votre fichier de configuration :

\n
doctor:\n  links:\n    internal: true    # contrôle des liens internes\n    external: false   # contrôle des liens externes\n    timeout: 10       # timeout des requêtes des liens externes, en secondes\n    concurrency: 10   # nombre de requêtes simultanées des liens externes\n    cache_ttl: 86400  # durée de mise en cache des résultats en succès des liens externes, en secondes\n    exclude: []       # liens à ignorer (liste d'expressions régulières), ex. : ['linkedin\\.com', '^https://localhost']\n    useragent: ~      # en-tête User-Agent des requêtes des liens externes (`assets.remote.useragent.default` par défaut)
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/configuration/donnees-et-statiques/", "url": "https://cecil-945.pages.dev/fr/documentation/configuration/donnees-et-statiques/", "title": "Données et fichiers statiques", "summary": "Options des fichiers de données et des fichiers statiques.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "Données et fichiers statiques\nCes options définissent où sont stockés les fichiers de données et les fichiers statiques, et comment ils sont traités.\nDonnées\nEmplacement des fichiers de données et types d’extensions pris en charge.\nFormats pris en charge : YAML, JSON, XML et CSV.\ndata.dir\nRépertoire source des données (data par défaut).\ndata:\n dir: data\ndata.ext\nTableau des extensions de fichiers.\ndata:\n ext: [yaml, yml, json, xml, csv]\ndata.load\nActive la collection site.data (true par défaut).\ndata:\n load: true\n\nFichiers statiques\nGestion des fichiers statiques copiés (PDF, polices, etc.).\nVous devez placer les fichiers d’assets, utilisés par asset(), dans le répertoire assets afin d’éviter des copies de fichiers inutiles.\nstatic.dir\nRépertoire source des fichiers statiques (static par défaut).\nstatic:\n dir: static\nstatic.target\nRépertoire vers lequel les fichiers statiques sont copiés (root par défaut).\nstatic:\n target: ''\nstatic.exclude\nListe des fichiers exclus. Accepte les glob, les chaînes et les expressions régulières.\nstatic:\n exclude: ['sass', 'scss', '*.scss', 'package*.json', 'node_modules']\nSi vous utilisez Bootstrap Icons, vous pouvez exclure node_modules sauf node_modules\/bootstrap-icons avec une expression régulière :\nexclude: ['sass', 'scss', '*.scss', 'package*.json', '#node_modules\/(?!bootstrap-icons)#']\nstatic.load\nActive la collection site.static (false par défaut).\nstatic:\n load: false\nstatic.mounts\nPermet de copier des fichiers ou répertoires spécifiques vers une destination spécifique.\nstatic:\n mounts: []\nexemple de static\nstatic:\n dir: docs\n target: docs\n exclude: ['sass', '*.scss', '\/\\.bck$\/']\n load: true\n mounts:\n - source\/path\/file.ext: dest\/path\/file.ext\n - node_modules\/bootstrap-icons\/font\/fonts: fonts", "content_html": "

Données et fichiers statiques

\n

Ces options définissent où sont stockés les fichiers de données et les fichiers statiques, et comment ils sont traités.

\n

Données

\n

Emplacement des fichiers de données et types d’extensions pris en charge.

\n

Formats pris en charge : YAML, JSON, XML et CSV.

\n

data.dir

\n

Répertoire source des données (data par défaut).

\n
data:\n  dir: data
\n

data.ext

\n

Tableau des extensions de fichiers.

\n
data:\n  ext: [yaml, yml, json, xml, csv]
\n

data.load

\n

Active la collection site.data (true par défaut).

\n
data:\n  load: true
\n
\n

Fichiers statiques

\n

Gestion des fichiers statiques copiés (PDF, polices, etc.).

\n\n

static.dir

\n

Répertoire source des fichiers statiques (static par défaut).

\n
static:\n  dir: static
\n

static.target

\n

Répertoire vers lequel les fichiers statiques sont copiés (root par défaut).

\n
static:\n  target: ''
\n

static.exclude

\n

Liste des fichiers exclus. Accepte les glob, les chaînes et les expressions régulières.

\n
static:\n  exclude: ['sass', 'scss', '*.scss', 'package*.json', 'node_modules']
\n\n

static.load

\n

Active la collection site.static (false par défaut).

\n
static:\n  load: false
\n

static.mounts

\n

Permet de copier des fichiers ou répertoires spécifiques vers une destination spécifique.

\n
static:\n  mounts: []
\n

exemple de static

\n
static:\n  dir: docs\n  target: docs\n  exclude: ['sass', '*.scss', '/\\.bck$/']\n  load: true\n  mounts:\n    - source/path/file.ext: dest/path/file.ext\n    - node_modules/bootstrap-icons/font/fonts: fonts
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/contenu/contenu-dynamique/", "url": "https://cecil-945.pages.dev/fr/documentation/contenu/contenu-dynamique/", "title": "Contenu dynamique", "summary": "Utilisez des variables et expressions Twig dans le contenu des pages.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-09T00:00:00+00:00","content_text": "Contenu dynamique\nPar défaut, le corps d’une page est statique : la syntaxe Twig écrite dans un fichier Markdown est affichée telle quelle.\nVous pouvez créer du contenu dynamique dans une page en utilisant la fonction Twig template_from_string, qui interprète le contenu de la page comme un template Twig.\n{{ include(template_from_string(page.content, \"contenu dynamique pour la page \" ~ page.id)) }}\nAvec cette approche, vous pouvez utiliser n’importe quelle variable de page dans le body de la page.\n---\nvar: 'value'\n---\nLa valeur de `var` est {{ page.var }}.\nActiver le contenu dynamique\nLa méthode recommandée consiste à créer un layout dédié qui surcharge le bloc content, et à ne l’utiliser que pour les pages qui en ont besoin.\n{# layouts\/dynamic.html.twig #}\n{% extends '_default\/page.html.twig' %}\n\n{% block content %}\n{{ include(template_from_string(page.content, \"contenu dynamique pour la page \" ~ page.id)) }}\n{% endblock content %}\nPuis définissez la variable layout dans le front matter de la page :\n---\ntitle: \"Ma page dynamique\"\nlayout: dynamic\n---\nLe second argument de template_from_string est le nom du template : il est affiché dans les messages d’erreur, inclure page.id permet donc de retrouver la page en erreur.\nVariables disponibles\nLe contenu de la page est rendu avec le même contexte que le layout, vous pouvez donc utiliser :\n\nles variables de page : page.title, page.date, page.<variable personnalisée>, etc.\nles variables du site : site.title, site.pages, site.data, etc.\ntoutes les fonctions, filtres et tris disponibles dans les templates ;\nles tags Twig : {% set %}, {% if %}, {% for %}, {% include %}, etc.\n\nFonctionnement\nLe corps Markdown est d’abord converti en HTML, puis le résultat (page.content) est rendu par Twig. Cet ordre a quelques conséquences :\n\nMarkdown échappe les caractères < et >, les opérateurs de comparaison (>, <=) et les fonctions fléchées (=>) ne peuvent donc pas être utilisés dans le corps : le build échoue avec une erreur Unexpected character \"&\".\nUne expression Twig utilisée dans un attribut HTML (ex. : href=\"{{ url(post) }}\") est encodée (URL) par le convertisseur Markdown et ne sera pas évaluée.\nUne expression Twig seule sur sa ligne est encapsulée dans un élément <p>.\nLa syntaxe Twig écrite dans un bloc ou une portion de code est également évaluée.\n\nGardez le corps simple (variables, filtres, conditions courtes) et déplacez le balisage et la logique complexes dans un template partiel ou une macro.\nPour afficher la syntaxe Twig telle quelle, encadrez-la avec le tag verbatim :\n{% verbatim %}`{{ page.title }}`{% endverbatim %}\nPour éviter un élément <p> superflu autour d’un bloc HTML, encadrez l’expression dans un élément HTML, séparé par des retours à la ligne :\n<div>\n{{ include('partials\/latest-posts.html.twig') }}\n<\/div>\nExemple : variables, données et template partiel\nCet exemple montre une page affichant des variables du site et de la page, des données issues d’un fichier de données, ainsi que les derniers articles du blog via un template partiel réutilisable.\nFichier de données :\n# data\/team.yml\n- name: Alice\n role: Développeuse\n- name: Bob\n role: Designer\nTemplate partiel, qui reçoit section et limit en paramètres :\n{# layouts\/partials\/latest-posts.html.twig #}\n{% set posts = site.pages.showable|filter_by('section', section|default('blog'))|sort_by_date|slice(0, limit|default(5)) %}\n{% if posts|length > 0 %}\n<ul class=\"latest-posts\">\n {% for post in posts %}\n <li><a href=\"{{ url(post) }}\">{{ post.title }}<\/a> <time datetime=\"{{ post.date|date('Y-m-d') }}\">{{ post.date|format_date('long') }}<\/time><\/li>\n {% endfor %}\n<\/ul>\n{% else %}\n<p>Aucun article pour le moment.<\/p>\n{% endif %}\nPage :\n---\ntitle: À propos\nlayout: dynamic\n---\nBienvenue sur **{{ site.title }}** ! Cette page a été publiée le {{ page.date|format_date('long') }}.\n\nNotre équipe compte {{ site.data.team|length }} membres : {{ site.data.team|column('name')|join(', ') }}.\n\n## Derniers articles\n\n<div>\n{{ include('partials\/latest-posts.html.twig', {section: 'blog', limit: 3}) }}\n<\/div>\nRésultat :\n<p>Bienvenue sur <strong>Mon site<\/strong> ! Cette page a été publiée le 9 octobre 2026.<\/p>\n<p>Notre équipe compte 2 membres : Alice, Bob.<\/p>\n<h2 id=\"derniers-articles\">Derniers articles<\/h2>\n<div>\n<ul class=\"latest-posts\">\n <li><a href=\"\/blog\/post-3\/\">Post 3<\/a> <time datetime=\"2026-03-01\">1 mars 2026<\/time><\/li>\n <li><a href=\"\/blog\/post-2\/\">Post 2<\/a> <time datetime=\"2026-02-01\">1 février 2026<\/time><\/li>\n <li><a href=\"\/blog\/post-1\/\">Post 1<\/a> <time datetime=\"2026-01-01\">1 janvier 2026<\/time><\/li>\n<\/ul>\n<\/div>\nL’opérateur > et l’attribut href=\"{{ … }}\" fonctionnent ici car ils sont écrits dans le template partiel, et non dans le corps Markdown.\nExemple : shortcodes avec des macros\nLes macros Twig peuvent être utilisées comme shortcodes pour insérer des fragments HTML riches dans le corps d’une page.\nCréez les macros :\n{# layouts\/macros\/shortcodes.html.twig #}\n{% macro youtube(id, title = 'Vidéo YouTube') %}\n<iframe src=\"https:\/\/www.youtube-nocookie.com\/embed\/{{ id }}\" title=\"{{ title }}\" width=\"560\" height=\"315\" loading=\"lazy\" allowfullscreen><\/iframe>\n{% endmacro %}\n\n{% macro alert(message, type = 'info') %}\n<div class=\"alert alert-{{ type }}\" role=\"alert\">{{ message }}<\/div>\n{% endmacro %}\nCréez un layout qui importe les macros avant de rendre le contenu :\n{# layouts\/shortcodes.html.twig #}\n{% extends '_default\/page.html.twig' %}\n\n{% block content %}\n{% set imports = \"{% import 'macros\/shortcodes.html.twig' as sc %}\" %}\n{{ include(template_from_string(imports ~ page.content, \"contenu dynamique pour la page \" ~ page.id)) }}\n{% endblock content %}\nUtilisez les shortcodes dans une page :\n---\ntitle: \"Vidéo de démo\"\nlayout: shortcodes\n---\n<div>\n {{ sc.alert('Cette vidéo est en anglais.', 'warning') }}\n<\/div>\n\n## Démo\n\n<div>\n {{ sc.youtube('NaB8JBfE7DY', 'Démo de Cecil') }}\n<\/div>\nRésultat :\n<div>\n <div class=\"alert alert-warning\" role=\"alert\">Cette vidéo est en anglais.<\/div>\n<\/div>\n<h2 id=\"demo\">Démo<\/h2>\n<div>\n <iframe src=\"https:\/\/www.youtube-nocookie.com\/embed\/NaB8JBfE7DY\" title=\"Démo de Cecil\" width=\"560\" height=\"315\" loading=\"lazy\" allowfullscreen><\/iframe>\n<\/div>\nPour réutiliser des éléments d’interface entre templates et pages, voir aussi les composants.", "content_html": "

Contenu dynamique

\n

Par défaut, le corps d’une page est statique : la syntaxe Twig écrite dans un fichier Markdown est affichée telle quelle.

\n

Vous pouvez créer du contenu dynamique dans une page en utilisant la fonction Twig template_from_string, qui interprète le contenu de la page comme un template Twig.

\n
{{ include(template_from_string(page.content, \"contenu dynamique pour la page \" ~ page.id)) }}
\n

Avec cette approche, vous pouvez utiliser n’importe quelle variable de page dans le body de la page.

\n
---\nvar: 'value'\n---\nLa valeur de `var` est {{ page.var }}.
\n

Activer le contenu dynamique

\n

La méthode recommandée consiste à créer un layout dédié qui surcharge le bloc content, et à ne l’utiliser que pour les pages qui en ont besoin.

\n
{# layouts/dynamic.html.twig #}\n{% extends '_default/page.html.twig' %}\n\n{% block content %}\n{{ include(template_from_string(page.content, \"contenu dynamique pour la page \" ~ page.id)) }}\n{% endblock content %}
\n

Puis définissez la variable layout dans le front matter de la page :

\n
---\ntitle: \"Ma page dynamique\"\nlayout: dynamic\n---
\n\n

Variables disponibles

\n

Le contenu de la page est rendu avec le même contexte que le layout, vous pouvez donc utiliser :

\n\n

Fonctionnement

\n

Le corps Markdown est d’abord converti en HTML, puis le résultat (page.content) est rendu par Twig. Cet ordre a quelques conséquences :

\n\n\n

Pour afficher la syntaxe Twig telle quelle, encadrez-la avec le tag verbatim :

\n
{% verbatim %}`{{ page.title }}`{% endverbatim %}
\n

Pour éviter un élément <p> superflu autour d’un bloc HTML, encadrez l’expression dans un élément HTML, séparé par des retours à la ligne :

\n
<div>\n{{ include('partials/latest-posts.html.twig') }}\n</div>
\n

Exemple : variables, données et template partiel

\n

Cet exemple montre une page affichant des variables du site et de la page, des données issues d’un fichier de données, ainsi que les derniers articles du blog via un template partiel réutilisable.

\n

Fichier de données :

\n
# data/team.yml\n- name: Alice\n  role: Développeuse\n- name: Bob\n  role: Designer
\n

Template partiel, qui reçoit section et limit en paramètres :

\n
{# layouts/partials/latest-posts.html.twig #}\n{% set posts = site.pages.showable|filter_by('section', section|default('blog'))|sort_by_date|slice(0, limit|default(5)) %}\n{% if posts|length > 0 %}\n<ul class=\"latest-posts\">\n  {% for post in posts %}\n  <li><a href=\"{{ url(post) }}\">{{ post.title }}</a> <time datetime=\"{{ post.date|date('Y-m-d') }}\">{{ post.date|format_date('long') }}</time></li>\n  {% endfor %}\n</ul>\n{% else %}\n<p>Aucun article pour le moment.</p>\n{% endif %}
\n

Page :

\n
---\ntitle: À propos\nlayout: dynamic\n---\nBienvenue sur **{{ site.title }}** ! Cette page a été publiée le {{ page.date|format_date('long') }}.\n\nNotre équipe compte {{ site.data.team|length }} membres : {{ site.data.team|column('name')|join(', ') }}.\n\n## Derniers articles\n\n<div>\n{{ include('partials/latest-posts.html.twig', {section: 'blog', limit: 3}) }}\n</div>
\n

Résultat :

\n
<p>Bienvenue sur <strong>Mon site</strong> ! Cette page a été publiée le 9 octobre 2026.</p>\n<p>Notre équipe compte 2 membres : Alice, Bob.</p>\n<h2 id=\"derniers-articles\">Derniers articles</h2>\n<div>\n<ul class=\"latest-posts\">\n  <li><a href=\"/blog/post-3/\">Post 3</a> <time datetime=\"2026-03-01\">1 mars 2026</time></li>\n  <li><a href=\"/blog/post-2/\">Post 2</a> <time datetime=\"2026-02-01\">1 février 2026</time></li>\n  <li><a href=\"/blog/post-1/\">Post 1</a> <time datetime=\"2026-01-01\">1 janvier 2026</time></li>\n</ul>\n</div>
\n\n

Exemple : shortcodes avec des macros

\n

Les macros Twig peuvent être utilisées comme shortcodes pour insérer des fragments HTML riches dans le corps d’une page.

\n

Créez les macros :

\n
{# layouts/macros/shortcodes.html.twig #}\n{% macro youtube(id, title = 'Vidéo YouTube') %}\n<iframe src=\"https://www.youtube-nocookie.com/embed/{{ id }}\" title=\"{{ title }}\" width=\"560\" height=\"315\" loading=\"lazy\" allowfullscreen></iframe>\n{% endmacro %}\n\n{% macro alert(message, type = 'info') %}\n<div class=\"alert alert-{{ type }}\" role=\"alert\">{{ message }}</div>\n{% endmacro %}
\n

Créez un layout qui importe les macros avant de rendre le contenu :

\n
{# layouts/shortcodes.html.twig #}\n{% extends '_default/page.html.twig' %}\n\n{% block content %}\n{% set imports = \"{% import 'macros/shortcodes.html.twig' as sc %}\" %}\n{{ include(template_from_string(imports ~ page.content, \"contenu dynamique pour la page \" ~ page.id)) }}\n{% endblock content %}
\n

Utilisez les shortcodes dans une page :

\n
---\ntitle: \"Vidéo de démo\"\nlayout: shortcodes\n---\n<div>\n  {{ sc.alert('Cette vidéo est en anglais.', 'warning') }}\n</div>\n\n## Démo\n\n<div>\n  {{ sc.youtube('NaB8JBfE7DY', 'Démo de Cecil') }}\n</div>
\n

Résultat :

\n
<div>\n  <div class=\"alert alert-warning\" role=\"alert\">Cette vidéo est en anglais.</div>\n</div>\n<h2 id=\"demo\">Démo</h2>\n<div>\n  <iframe src=\"https://www.youtube-nocookie.com/embed/NaB8JBfE7DY\" title=\"Démo de Cecil\" width=\"560\" height=\"315\" loading=\"lazy\" allowfullscreen></iframe>\n</div>
\n", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/configuration/assets/", "url": "https://cecil-945.pages.dev/fr/documentation/configuration/assets/", "title": "Assets", "summary": "Dossier des assets, compilation, minification, images et CDN.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-05T00:00:00+00:00","content_text": "Assets\nGestion des ressources (images, fichiers CSS et JS).\nassets.dir\nRépertoire source des ressources (assets par défaut).\nassets:\n dir: assets\nassets.target\nRépertoire où les fichiers de ressources distants et redimensionnés sont enregistrés (root par défaut).\nassets:\n target: ''\nassets.fingerprint\nActive le fingerprinting (cache busting) pour les fichiers de ressources (true par défaut).\nassets:\n fingerprint: true\nassets.compile\nActive la compilation des fichiers Sass (true par défaut). Voir la documentation de scssphp pour les détails des options.\nassets:\n compile:\n style: expanded # style de compilation (`expanded` ou `compressed`, `expanded` par défaut)\n import: [sass, scss] # liste des chemins importés (`[sass, scss, node_modules]` par défaut)\n sourcemap: false # active les sourcemaps en mode debug (`false` par défaut)\n variables: [] # liste de variables préconfigurées (vide par défaut)\nsourcemap sert à déboguer la compilation SCSS (mode debug requis).\nassets.minify\nActive la minification CSS et JS (true par défaut).\nassets:\n minify: true\nassets.images\nGestion des images.\nassets:\n images:\n optimize: false # active l’optimisation d’images avec JpegOptim, Optipng, Pngquant 2, SVGO 1, Gifsicle, cwebp, avifenc (`false` par défaut)\n quality: 75 # qualité d’image pour `optimize` et `resize` (`75` par défaut)\n responsive:\n widths: [480, 640, 768, 1024, 1366, 1600, 1920] # largeurs d’image pour l’attribut `srcset`\n sizes:\n default: '100vw' # attribut `sizes` par défaut (`100vw` par défaut)\nassets.images.cdn\nL’URL des ressources image peut être facilement remplacée par une url de CDN fournie.\nassets:\n images:\n cdn:\n enabled: false # active Image CDN (`false` par défaut)\n canonical: true # `image_url` est canonique (au lieu d’un chemin relatif) (`true` par défaut)\n remote: true # prend aussi en charge les images non locales (`true` par défaut)\n account: 'xxxx' # compte du fournisseur\n url: 'https:\/\/provider.tld\/%account%\/%image_url%?w=%width%&q=%quality%&format=%format%'\nurl est un modèle qui contient des variables :\n\n%account% remplacé par l’option assets.images.cdn.account\n%image_url% remplacé par l’URL canonique de l’image ou par path\n%width% remplacé par la largeur de l’image\n%quality% remplacé par l’option assets.images.quality\n%format% remplacé par le format de l’image\n\nVoir les fournisseurs CDN.\nassets.remote.useragent\nUser agent utilisé pour télécharger les ressources distantes.\nassets:\n remote:\n useragent:\n default: <string> # user agent par défaut\n useragent1: <string>\n useragent2: <string>", "content_html": "

Assets

\n

Gestion des ressources (images, fichiers CSS et JS).

\n

assets.dir

\n

Répertoire source des ressources (assets par défaut).

\n
assets:\n  dir: assets
\n

assets.target

\n

Répertoire où les fichiers de ressources distants et redimensionnés sont enregistrés (root par défaut).

\n
assets:\n  target: ''
\n

assets.fingerprint

\n

Active le fingerprinting (cache busting) pour les fichiers de ressources (true par défaut).

\n
assets:\n  fingerprint: true
\n

assets.compile

\n

Active la compilation des fichiers Sass (true par défaut). Voir la documentation de scssphp pour les détails des options.

\n
assets:\n  compile:\n    style: expanded      # style de compilation (`expanded` ou `compressed`, `expanded` par défaut)\n    import: [sass, scss] # liste des chemins importés (`[sass, scss, node_modules]` par défaut)\n    sourcemap: false     # active les sourcemaps en mode debug (`false` par défaut)\n    variables: []        # liste de variables préconfigurées (vide par défaut)
\n\n

assets.minify

\n

Active la minification CSS et JS (true par défaut).

\n
assets:\n  minify: true
\n

assets.images

\n

Gestion des images.

\n
assets:\n  images:\n    optimize: false # active l’optimisation d’images avec JpegOptim, Optipng, Pngquant 2, SVGO 1, Gifsicle, cwebp, avifenc (`false` par défaut)\n    quality: 75     # qualité d’image pour `optimize` et `resize` (`75` par défaut)\n    responsive:\n      widths: [480, 640, 768, 1024, 1366, 1600, 1920] # largeurs d’image pour l’attribut `srcset`\n      sizes:\n        default: '100vw' # attribut `sizes` par défaut (`100vw` par défaut)
\n

assets.images.cdn

\n

L’URL des ressources image peut être facilement remplacée par une url de CDN fournie.

\n
assets:\n  images:\n    cdn:\n      enabled: false  # active Image CDN (`false` par défaut)\n      canonical: true # `image_url` est canonique (au lieu d’un chemin relatif) (`true` par défaut)\n      remote: true    # prend aussi en charge les images non locales (`true` par défaut)\n      account: 'xxxx' # compte du fournisseur\n      url: 'https://provider.tld/%account%/%image_url%?w=%width%&q=%quality%&format=%format%'
\n

url est un modèle qui contient des variables :

\n\n

Voir les fournisseurs CDN.

\n

assets.remote.useragent

\n

User agent utilisé pour télécharger les ressources distantes.

\n
assets:\n  remote:\n    useragent:\n      default: <string> # user agent par défaut\n      useragent1: <string>\n      useragent2: <string>
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/configuration/layouts/", "url": "https://cecil-945.pages.dev/fr/documentation/configuration/layouts/", "title": "Layouts", "summary": "Dossier des templates, échappement, images, traductions et composants.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-05T00:00:00+00:00","content_text": "Layouts\nOptions des templates.\nlayouts.dir\nRépertoire source des templates (layouts par défaut).\nlayouts:\n dir: layouts\nlayouts.autoescape\nSurcharge l’option Twig autoescape (false par défaut).\nSi la valeur est null, Cecil applique une stratégie basée sur l’extension du nom de template :\n\n*.js.twig -> js\n*.css.twig -> css\n*.html.twig et *.twig -> html\ntoute autre extension -> false\n\nlayouts:\n autoescape: false # désactive l’échappement automatique (par défaut)\n #autoescape: null # utilise la stratégie automatique Cecil selon l’extension du template\n #autoescape: html\n #autoescape: js\nlayouts.images\nOptions de gestion des images.\nlayouts:\n images:\n formats: [] # utilisé par la fonction `html` : ajoute des formats d’image alternatifs comme `source` (ex. `[avif, webp]`, tableau vide par défaut)\n responsive: false # utilisé par la fonction `html` : ajoute des images responsives ('width' ou 'density', `false` par défaut)\n placeholder: '' # utilisé par la fonction `html` : remplit l’arrière-plan de l’image avant son chargement (`color` ou `lqip`, désactivé par défaut)\n dark_suffix: '' # suffixe de l’image variante sombre (ex. `.dark`), désactivé par défaut\n mobile_suffix: '' # suffixe de l’image variante mobile (ex. `.mobile`), désactivé par défaut\n mobile_media_query: '(max-width: 767px)' # media query de la `<source>` de la variante mobile\nlayouts.translations\nOptions de gestion des traductions.\nlayouts:\n translations:\n dir: translations # répertoire source des traductions (`translations` par défaut)\n formats: # formats de traduction pris en charge\n yaml:\n loader: Symfony\\Component\\Translation\\Loader\\YamlFileLoader\n ext: [yml, yaml]\n mo:\n loader: Symfony\\Component\\Translation\\Loader\\MoFileLoader\n ext: [mo]\nChaque format de traduction définit :\n\nloader : classe du chargeur de traduction Symfony\next : une ou plusieurs extensions de fichier associées à ce format\n\nlayouts.components\nOptions des composants de template.\nlayouts:\n components:\n dir: components # répertoire source des composants (`components` par défaut)\n ext: twig # extension des fichiers de composants (`twig` par défaut)\nlayouts.sections\nAssocie une section aux layouts d’une autre section : le nom associé est utilisé à la place de <section> par les règles de recherche de la section et de ses pages.\nlayouts:\n sections:\n news: blog # la section « news » est rendue avec `blog\/list.html.twig` et ses pages avec `blog\/page.html.twig`\nUne sous-section se replie déjà sur les layouts de ses sections parentes : aucune association n’est nécessaire pour cela.\n", "content_html": "

Layouts

\n

Options des templates.

\n

layouts.dir

\n

Répertoire source des templates (layouts par défaut).

\n
layouts:\n  dir: layouts
\n

layouts.autoescape

\n

Surcharge l’option Twig autoescape (false par défaut).

\n

Si la valeur est null, Cecil applique une stratégie basée sur l’extension du nom de template :

\n\n
layouts:\n  autoescape: false  # désactive l’échappement automatique (par défaut)\n  #autoescape: null  # utilise la stratégie automatique Cecil selon l’extension du template\n  #autoescape: html\n  #autoescape: js
\n

layouts.images

\n

Options de gestion des images.

\n
layouts:\n  images:\n    formats: []       # utilisé par la fonction `html` : ajoute des formats d’image alternatifs comme `source` (ex. `[avif, webp]`, tableau vide par défaut)\n    responsive: false # utilisé par la fonction `html` : ajoute des images responsives ('width' ou 'density', `false` par défaut)\n    placeholder: ''   # utilisé par la fonction `html` : remplit l’arrière-plan de l’image avant son chargement (`color` ou `lqip`, désactivé par défaut)\n    dark_suffix: ''   # suffixe de l’image variante sombre (ex. `.dark`), désactivé par défaut\n    mobile_suffix: '' # suffixe de l’image variante mobile (ex. `.mobile`), désactivé par défaut\n    mobile_media_query: '(max-width: 767px)' # media query de la `<source>` de la variante mobile
\n

layouts.translations

\n

Options de gestion des traductions.

\n
layouts:\n  translations:\n    dir: translations # répertoire source des traductions (`translations` par défaut)\n    formats:          # formats de traduction pris en charge\n      yaml:\n        loader: Symfony\\Component\\Translation\\Loader\\YamlFileLoader\n        ext: [yml, yaml]\n      mo:\n        loader: Symfony\\Component\\Translation\\Loader\\MoFileLoader\n        ext: [mo]
\n

Chaque format de traduction définit :

\n\n

layouts.components

\n

Options des composants de template.

\n
layouts:\n  components:\n    dir: components # répertoire source des composants (`components` par défaut)\n    ext: twig       # extension des fichiers de composants (`twig` par défaut)
\n

layouts.sections

\n

Associe une section aux layouts d’une autre section : le nom associé est utilisé à la place de <section> par les règles de recherche de la section et de ses pages.

\n
layouts:\n  sections:\n    news: blog # la section « news » est rendue avec `blog/list.html.twig` et ses pages avec `blog/page.html.twig`
\n\n
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/configuration/sortie/", "url": "https://cecil-945.pages.dev/fr/documentation/configuration/sortie/", "title": "Sortie", "summary": "Dossier de sortie, formats et post-traitement.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-05T00:00:00+00:00","content_text": "Sortie\nDéfinit où et dans quel format les pages sont rendues.\noutput.dir\nRépertoire où les fichiers de pages rendues sont enregistrés (_site par défaut).\noutput:\n dir: _site\noutput.formats\nListe de définition des formats de sortie, utilisés pour rendre les pages (par ex. HTML, Atom, RSS, JSON, XML, etc.).\noutput:\n formats:\n - name: <name> # nom du format, par ex. `html` (requis)\n mediatype: <media type> # type MIME, ex. `text\/html` (facultatif)\n subpath: <sub path> # sous-chemin, ex. `amp` dans `path\/amp\/index.html` (facultatif)\n filename: <file name> # nom du fichier, ex. `index` dans `path\/index.html` (facultatif)\n extension: <extension> # extension du fichier, ex. `html` dans `path\/index.html` (requis)\n exclude: [<variable>] # n’applique pas ce format aux pages identifiées par les variables listées, ex. `[redirect, paginated]` (facultatif)\nCes formats sont utilisés dans la configuration output.pagetypeformats et dans la variable de page output.\nFormats par défaut\nCecil fournit quelques formats par défaut, qui peuvent être surchargés dans le fichier de configuration : html (par défaut), atom, rss, json, xml, txt, amp, js, webmanifest, xsl, jsonfeed, iframe, oembed.\noutput.pagetypeformats\nIl n’est pas nécessaire de définir la variable output pour chaque page, car Cecil applique automatiquement les formats définis pour chaque type de page (homepage, page, section, vocabulary et term).\noutput:\n pagetypeformats:\n page: [<format>]\n homepage: [<format>]\n section: [<format>]\n vocabulary: [<format>]\n term: [<format>]\nPlusieurs formats peuvent être définis pour un même type de page. Par exemple, le type de page section peut être rendu automatiquement en HTML et Atom :\noutput:\n pagetypeformats:\n section: [html, atom]\nPour rendre une page, Cecil recherche un template nommé <layout>.<format>.twig (ex. page.html.twig).\nexemple de output\noutput:\n dir: _site\n formats:\n - name: html\n mediatype: text\/html\n filename: index\n extension: html\n - name: atom\n mediatype: application\/xml\n filename: atom\n extension: xml\n exclude: [redirect, paginated]\n pagetypeformats:\n page: [html]\n homepage: [html, atom]\n section: [html, atom]\n vocabulary: [html]\n term: [html, atom]\nPost-process\nVous pouvez étendre les capacités de Cecil avec un post-processeur de sortie pour modifier les fichiers de sortie après leur génération.\n", "content_html": "

Sortie

\n

Définit où et dans quel format les pages sont rendues.

\n

output.dir

\n

Répertoire où les fichiers de pages rendues sont enregistrés (_site par défaut).

\n
output:\n  dir: _site
\n

output.formats

\n

Liste de définition des formats de sortie, utilisés pour rendre les pages (par ex. HTML, Atom, RSS, JSON, XML, etc.).

\n
output:\n  formats:\n    - name: <name>            # nom du format, par ex. `html` (requis)\n      mediatype: <media type> # type MIME, ex. `text/html` (facultatif)\n      subpath: <sub path>     # sous-chemin, ex. `amp` dans `path/amp/index.html` (facultatif)\n      filename: <file name>   # nom du fichier, ex. `index` dans `path/index.html` (facultatif)\n      extension: <extension>  # extension du fichier, ex. `html` dans `path/index.html` (requis)\n      exclude: [<variable>]   # n’applique pas ce format aux pages identifiées par les variables listées, ex. `[redirect, paginated]` (facultatif)
\n

Ces formats sont utilisés dans la configuration output.pagetypeformats et dans la variable de page output.

\n

Formats par défaut

\n

Cecil fournit quelques formats par défaut, qui peuvent être surchargés dans le fichier de configuration : html (par défaut), atom, rss, json, xml, txt, amp, js, webmanifest, xsl, jsonfeed, iframe, oembed.

\n

output.pagetypeformats

\n

Il n’est pas nécessaire de définir la variable output pour chaque page, car Cecil applique automatiquement les formats définis pour chaque type de page (homepage, page, section, vocabulary et term).

\n
output:\n  pagetypeformats:\n    page: [<format>]\n    homepage: [<format>]\n    section: [<format>]\n    vocabulary: [<format>]\n    term: [<format>]
\n

Plusieurs formats peuvent être définis pour un même type de page. Par exemple, le type de page section peut être rendu automatiquement en HTML et Atom :

\n
output:\n  pagetypeformats:\n    section: [html, atom]
\n\n

exemple de output

\n
output:\n  dir: _site\n  formats:\n    - name: html\n      mediatype: text/html\n      filename: index\n      extension: html\n    - name: atom\n      mediatype: application/xml\n      filename: atom\n      extension: xml\n      exclude: [redirect, paginated]\n  pagetypeformats:\n    page: [html]\n    homepage: [html, atom]\n    section: [html, atom]\n    vocabulary: [html]\n    term: [html, atom]
\n

Post-process

\n

Vous pouvez étendre les capacités de Cecil avec un post-processeur de sortie pour modifier les fichiers de sortie après leur génération.

\n
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/configuration/cache/", "url": "https://cecil-945.pages.dev/fr/documentation/configuration/cache/", "title": "Cache", "summary": "Cache des assets, des templates et des traductions.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-05T00:00:00+00:00","content_text": "Cache\nOptions de cache.\ncache.enabled\nLe cache est activé par défaut (true), mais vous pouvez le désactiver avec :\ncache:\n enabled: false\nIl n’est pas recommandé de désactiver le cache pour des raisons de performance.\ncache.dir\nRépertoire où les fichiers de cache sont stockés (.cache par défaut).\ncache:\n dir: '.cache'\nLe répertoire de cache est relatif au répertoire du site, mais vous pouvez utiliser un chemin absolu : cela peut être utile pour stocker le cache dans un répertoire partagé.\ncache.assets\nOptions du cache des ressources.\ncache.assets.ttl\nTemps de vie du cache des ressources en secondes (null par défaut = aucune expiration).\ncache:\n assets:\n ttl: ~\ncache.assets.remote.ttl\nTemps de vie du cache des ressources distantes en secondes (7 jours par défaut).\ncache:\n assets:\n remotes:\n ttl: 604800 # 7 jours\ncache.templates\nDésactive le cache des templates avec false (true par défaut).\ncache:\n templates: true\nVoir la documentation du cache des templates pour plus de détails.\ncache.translations\nDésactive le cache des traductions avec false (true par défaut).\ncache:\n translations: true\n", "content_html": "

Cache

\n

Options de cache.

\n

cache.enabled

\n

Le cache est activé par défaut (true), mais vous pouvez le désactiver avec :

\n
cache:\n  enabled: false
\n\n

cache.dir

\n

Répertoire où les fichiers de cache sont stockés (.cache par défaut).

\n
cache:\n  dir: '.cache'
\n\n

cache.assets

\n

Options du cache des ressources.

\n

cache.assets.ttl

\n

Temps de vie du cache des ressources en secondes (null par défaut = aucune expiration).

\n
cache:\n  assets:\n    ttl: ~
\n

cache.assets.remote.ttl

\n

Temps de vie du cache des ressources distantes en secondes (7 jours par défaut).

\n
cache:\n  assets:\n    remotes:\n      ttl: 604800 # 7 jours
\n

cache.templates

\n

Désactive le cache des templates avec false (true par défaut).

\n
cache:\n  templates: true
\n\n

cache.translations

\n

Désactive le cache des traductions avec false (true par défaut).

\n
cache:\n  translations: true
\n
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/configuration/serveur/", "url": "https://cecil-945.pages.dev/fr/documentation/configuration/serveur/", "title": "Serveur et optimisation", "summary": "En-têtes du serveur local et optimisation de la sortie.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "Serveur et optimisation\nCes options configurent le serveur de prévisualisation local et l’optimisation des fichiers générés.\nServeur\nserver.headers\nVous pouvez définir des en-têtes HTTP personnalisés, utilisés par le serveur d’aperçu local.\nDepuis la version 8.38.0, l’option headers a été déplacée dans la section server.headers.\nserver:\n headers:\n - path: <path> # chemin relatif, préfixé par un slash. Prend en charge le joker \"*\".\n headers:\n - key: <key>\n value: \"<value>\"\nC’est utile pour tester une Content Security Policy ou Cache-Control personnalisée.\nExemple :\nserver:\n headers:\n - path: \/*\n headers:\n - key: X-Frame-Options\n value: \"SAMEORIGIN\"\n - key: X-XSS-Protection\n value: \"1; mode=block\"\n - key: X-Content-Type-Options\n value: \"nosniff\"\n - key: Content-Security-Policy\n value: \"default-src 'self'; object-src 'self'; img-src 'self'\"\n - key: Strict-Transport-Security\n value: \"max-age=31536000; includeSubDomains; preload\"\n - path: \/assets\/*\n headers:\n - key: Cache-Control\n value: \"public, max-age=31536000\"\n - path: \/foo.html\n headers:\n - key: Foo\n value: \"bar\"\n\nOptimisation\nLes options d’optimisation permettent d’activer la compression des fichiers de sortie : HTML, CSS, JavaScript et images.\noptimize:\n enabled: false # active l’optimisation des fichiers (`false` par défaut)\n html:\n enabled: true # active l’optimisation des fichiers HTML\n ext: [html, htm] # extensions de fichiers prises en charge\n css:\n enabled: true # active l’optimisation des fichiers CSS\n ext: [css] # extensions de fichiers prises en charge\n js:\n enabled: true # active l’optimisation des fichiers JavaScript\n ext: [js] # extensions de fichiers prises en charge\n images:\n enabled: true # active l’optimisation des fichiers images\n ext: [jpeg, jpg, png, gif, webp, svg, avif] # extensions de fichiers prises en charge\nCette option est désactivée par défaut et peut être activée via :\noptimize: true\nUne fois l’option globale activée, les 4 types de fichiers seront traités.\nIl est possible de désactiver chacun d’eux via enabled: false et de modifier l’extension des fichiers traités via ext.\nIl est également possible d’activer cette option via la CLI lors de l’utilisation des commandes \"build\" et \"serve\" avec l’option --optimize.\nLe compresseur d’images utilisera les binaires suivants s’ils sont présents sur le système : JpegOptim, Optipng, Pngquant 2, SVGO, Gifsicle, cwebp et avifenc.\n", "content_html": "

Serveur et optimisation

\n

Ces options configurent le serveur de prévisualisation local et l’optimisation des fichiers générés.

\n

Serveur

\n

server.headers

\n

Vous pouvez définir des en-têtes HTTP personnalisés, utilisés par le serveur d’aperçu local.

\n\n
server:\n  headers:\n    - path: <path> # chemin relatif, préfixé par un slash. Prend en charge le joker \"*\".\n      headers:\n        - key: <key>\n          value: \"<value>\"
\n\n

Exemple :

\n
server:\n  headers:\n    - path: /*\n      headers:\n        - key: X-Frame-Options\n          value: \"SAMEORIGIN\"\n        - key: X-XSS-Protection\n          value: \"1; mode=block\"\n        - key: X-Content-Type-Options\n          value: \"nosniff\"\n        - key: Content-Security-Policy\n          value: \"default-src 'self'; object-src 'self'; img-src 'self'\"\n        - key: Strict-Transport-Security\n          value: \"max-age=31536000; includeSubDomains; preload\"\n    - path: /assets/*\n      headers:\n        - key: Cache-Control\n          value: \"public, max-age=31536000\"\n    - path: /foo.html\n      headers:\n        - key: Foo\n          value: \"bar\"
\n
\n

Optimisation

\n

Les options d’optimisation permettent d’activer la compression des fichiers de sortie : HTML, CSS, JavaScript et images.

\n
optimize:\n  enabled: false     # active l’optimisation des fichiers (`false` par défaut)\n  html:\n    enabled: true    # active l’optimisation des fichiers HTML\n    ext: [html, htm]   # extensions de fichiers prises en charge\n  css:\n    enabled: true    # active l’optimisation des fichiers CSS\n    ext: [css]         # extensions de fichiers prises en charge\n  js:\n    enabled: true    # active l’optimisation des fichiers JavaScript\n    ext: [js]          # extensions de fichiers prises en charge\n  images:\n    enabled: true    # active l’optimisation des fichiers images\n    ext: [jpeg, jpg, png, gif, webp, svg, avif] # extensions de fichiers prises en charge
\n

Cette option est désactivée par défaut et peut être activée via :

\n
optimize: true
\n

Une fois l’option globale activée, les 4 types de fichiers seront traités.
\nIl est possible de désactiver chacun d’eux via enabled: false et de modifier l’extension des fichiers traités via ext.

\n\n\n
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/configuration/surcharge/", "url": "https://cecil-945.pages.dev/fr/documentation/configuration/surcharge/", "title": "Surcharge de configuration", "summary": "Surchargez la configuration avec des variables d’environnement ou une option CLI.", "date_published": "2026-03-27T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "Surcharge de configuration\nLa configuration peut être surchargée sans modifier le fichier de configuration, via des variables d’environnement ou une option de la CLI.\nVariables d’environnement\nLa configuration peut être surchargée via des variables d’environnement.\nAu démarrage, Cecil essaie également de charger un fichier .env depuis le chemin du site courant (le répertoire de travail actuel, ou l’argument <path> s’il est fourni).\n\nSi le fichier .env n’existe pas, Cecil continue normalement.\nLes variables déjà définies par le shell\/système sont conservées.\n\nChaque nom de variable d’environnement doit être préfixé par CECIL_ et la clé de configuration doit être en majuscules.\nPar exemple, la commande suivante définit le baseurl du site :\nexport CECIL_BASEURL=\"https:\/\/example.com\/\"\nVous pouvez stocker la même valeur dans un fichier .env à la racine du projet :\nCECIL_BASEURL=\"https:\/\/example.com\/\"\nCECIL_TITLE=\"Mon site Cecil\"\nOption CLI\nVous pouvez combiner plusieurs fichiers de configuration avec l’option --config (priorité de gauche à droite) :\nphp cecil.phar --config config-1.yml,config-2.yml", "content_html": "

Surcharge de configuration

\n

La configuration peut être surchargée sans modifier le fichier de configuration, via des variables d’environnement ou une option de la CLI.

\n

Variables d’environnement

\n

La configuration peut être surchargée via des variables d’environnement.

\n

Au démarrage, Cecil essaie également de charger un fichier .env depuis le chemin du site courant (le répertoire de travail actuel, ou l’argument <path> s’il est fourni).

\n\n

Chaque nom de variable d’environnement doit être préfixé par CECIL_ et la clé de configuration doit être en majuscules.

\n

Par exemple, la commande suivante définit le baseurl du site :

\n
export CECIL_BASEURL=\"https://example.com/\"
\n

Vous pouvez stocker la même valeur dans un fichier .env à la racine du projet :

\n
CECIL_BASEURL=\"https://example.com/\"\nCECIL_TITLE=\"Mon site Cecil\"
\n

Option CLI

\n

Vous pouvez combiner plusieurs fichiers de configuration avec l’option --config (priorité de gauche à droite) :

\n
php cecil.phar --config config-1.yml,config-2.yml
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/assets/fournisseurs-cdn/", "url": "https://cecil-945.pages.dev/fr/documentation/assets/fournisseurs-cdn/", "title": "Fournisseurs de CDN", "summary": "Exemples de configuration de fournisseurs de CDN d’images (Cloudinary, Cloudimage, TwicPics, imgix, Netlify Image CDN).", "date_published": "2023-10-23T00:00:00+00:00", "date_modified": "2026-10-02T00:00:00+00:00","content_text": "Fournisseurs de CDN\nExemples de configuration de fournisseurs de CDN pour les options de configuration.\nCloudinary\nhttps:\/\/cloudinary.com\nassets:\n images:\n cdn:\n enabled: true\n account: 'xxxx'\n url: 'https:\/\/res.cloudinary.com\/%account%\/image\/fetch\/c_limit,w_%width%,q_%quality%,f_%format%,d_default\/%image_url%'\nCloudimage\nhttps:\/\/www.cloudimage.io\nassets:\n images:\n cdn:\n enabled: true\n account: 'xxxx'\n url: 'https:\/\/%account%.cloudimg.io\/%image_url%?w=%width%&q=%quality%&force_format=%format%'\nTwicPics\nhttps:\/\/www.twicpics.com\nassets:\n images:\n cdn:\n enabled: true\n account: 'xxxx'\n canonical: false\n remote: false\n url: 'https:\/\/%account%.twic.pics\/%image_url%?twic=v1\/resize=%width%\/quality=%quality%\/output=%format%'\nSource URL : URL de base de votre site.\nimgix\nhttps:\/\/imgix.com\nassets:\n images:\n cdn:\n enabled: true\n account: 'xxxx'\n canonical: false\n remote: false\n url: 'https:\/\/%account%.imgix.net\/%image_url%?w=%width%&q=%quality%&fm=%format%'\nBase URL : URL de base de votre site.\nNetlify Image CDN\nhttps:\/\/docs.netlify.com\/image-cdn\/overview\/\nassets:\n images:\n cdn:\n enabled: true\n canonical: false\n url: '\/.netlify\/images?url=%image_url%&w=%width%&fm=%format%'\nExécution en local\nInstaller Netlify CLI\nnpm install netlify-cli -g\nnetlify link\nnetlify.toml :\n[dev]\n targetPort = 8000\nDémarrer le serveur local\nphp cecil.phar serve & netlify dev\nOuvrez http:\/\/localhost:8888", "content_html": "

Fournisseurs de CDN

\n

Exemples de configuration de fournisseurs de CDN pour les options de configuration.

\n

Cloudinary

\n

https://cloudinary.com

\n
assets:\n  images:\n    cdn:\n      enabled: true\n      account: 'xxxx'\n      url: 'https://res.cloudinary.com/%account%/image/fetch/c_limit,w_%width%,q_%quality%,f_%format%,d_default/%image_url%'
\n

Cloudimage

\n

https://www.cloudimage.io

\n
assets:\n  images:\n    cdn:\n      enabled: true\n      account: 'xxxx'\n      url: 'https://%account%.cloudimg.io/%image_url%?w=%width%&q=%quality%&force_format=%format%'
\n

TwicPics

\n

https://www.twicpics.com

\n
assets:\n  images:\n    cdn:\n      enabled: true\n      account: 'xxxx'\n      canonical: false\n      remote: false\n      url: 'https://%account%.twic.pics/%image_url%?twic=v1/resize=%width%/quality=%quality%/output=%format%'
\n

Source URL : URL de base de votre site.

\n

imgix

\n

https://imgix.com

\n
assets:\n  images:\n    cdn:\n      enabled: true\n      account: 'xxxx'\n      canonical: false\n      remote: false\n      url: 'https://%account%.imgix.net/%image_url%?w=%width%&q=%quality%&fm=%format%'
\n

Base URL : URL de base de votre site.

\n

Netlify Image CDN

\n

https://docs.netlify.com/image-cdn/overview/

\n
assets:\n  images:\n    cdn:\n      enabled: true\n      canonical: false\n      url: '/.netlify/images?url=%image_url%&w=%width%&fm=%format%'
\n

Exécution en local

\n

Installer Netlify CLI

\n
npm install netlify-cli -g\nnetlify link
\n

netlify.toml :

\n
[dev]\n  targetPort = 8000
\n

Démarrer le serveur local

\n
php cecil.phar serve & netlify dev
\n

Ouvrez http://localhost:8888

", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/bien-demarrer/demarrage-rapide/", "url": "https://cecil-945.pages.dev/fr/documentation/bien-demarrer/demarrage-rapide/", "title": "Démarrage rapide", "summary": "Installez Cecil, créez un site, ajoutez des pages, prévisualisez-le localement, puis générez-le et déployez-le.", "date_published": "2021-11-03T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "Démarrage rapide\nCe guide vous accompagne dans la création de votre premier site Cecil, sa prévisualisation en local, puis sa construction et son déploiement.\nCréer un site web\nVous pouvez créer un nouveau site web en quelques minutes.\nSuivez les étapes ci-dessous pour créer votre premier site web Cecil.\n\n\n\n\n\n\n\n\nDémo du résultat attendu : https:\/\/cecilapp.github.io\/skeleton\/.\nPrérequis\n\nPHP 8.3+\nTerminal (une compréhension de base du terminal)\nÉditeur de texte, comme VS Code et\/ou Typora\n\n1. Télécharger Cecil\nTéléchargez cecil.phar depuis votre terminal:\ncurl -LO https:\/\/cecil.app\/cecil.phar\nVous pouvez également télécharger Cecil manuellement, ou utiliser :\n\nHomebrew: brew install cecilapp\/tap\/cecil\nScoop: scoop install https:\/\/cecil.app\/scoop\/cecil.json\n\n2. Créer un nouveau site\nCréez un répertoire pour le site Web (ex : <monsiteweb>), placez y cecil.phar, puis exécutez la commande new:site :\nphp cecil.phar new:site\n3. Ajouter une page\nExécutez la commande new:page :\nphp cecil.phar new:page\nVous pouvez maintenant modifier la page nouvellement créée avec votre éditeur Markdown : <monsiteweb>\/pages\/<nouvelle-page>.md.\nNous vous recommandons d’utiliser Typora pour éditer vos fichiers Markdown.\n4. Vérifier l’aperçu\nExécutez la commande suivante pour créer un aperçu du site Web :\nphp cecil.phar serve\nNaviguez ensuite sur http:\/\/localhost:8000.\nLa commande serve démarre un serveur HTTP local et un observateur : si un fichier (une page, un template ou la config) est modifié, la page active du navigateur est automatiquement rechargée.\n5. Générer et déployer\nQuand vous êtes satisfait du résultat, vous pouvez générer le site afin de le déployer sur le Web.\nExécutez la commande suivante pour générer le site :\nphp cecil.phar build\nVous pouvez maintenant copier le contenu du répertoire _site sur un serveur Web 🎉\n", "content_html": "

Démarrage rapide

\n

Ce guide vous accompagne dans la création de votre premier site Cecil, sa prévisualisation en local, puis sa construction et son déploiement.

\n

Créer un site web

\n

Vous pouvez créer un nouveau site web en quelques minutes.

\n

Suivez les étapes ci-dessous pour créer votre premier site web Cecil.

\n

\n\n\n\n\n\n\"Example\n

\n\n

Prérequis

\n\n

1. Télécharger Cecil

\n

Téléchargez cecil.phar depuis votre terminal:

\n
curl -LO https://cecil.app/cecil.phar
\n

Vous pouvez également télécharger Cecil manuellement, ou utiliser :

\n\n

2. Créer un nouveau site

\n

Créez un répertoire pour le site Web (ex : <monsiteweb>), placez y cecil.phar, puis exécutez la commande new:site :

\n
php cecil.phar new:site
\n

3. Ajouter une page

\n

Exécutez la commande new:page :

\n
php cecil.phar new:page
\n

Vous pouvez maintenant modifier la page nouvellement créée avec votre éditeur Markdown : <monsiteweb>/pages/<nouvelle-page>.md.

\n\n

4. Vérifier l’aperçu

\n

Exécutez la commande suivante pour créer un aperçu du site Web :

\n
php cecil.phar serve
\n

Naviguez ensuite sur http://localhost:8000.

\n\n

5. Générer et déployer

\n

Quand vous êtes satisfait du résultat, vous pouvez générer le site afin de le déployer sur le Web.

\n

Exécutez la commande suivante pour générer le site :

\n
php cecil.phar build
\n

Vous pouvez maintenant copier le contenu du répertoire _site sur un serveur Web 🎉

\n
", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/bien-demarrer/kits-de-demarrage/", "url": "https://cecil-945.pages.dev/fr/documentation/bien-demarrer/kits-de-demarrage/", "title": "Kits de démarrage", "summary": "Démarrez rapidement avec un modèle de projet prêt à l’emploi.", "date_published": "2021-11-03T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "Kits de démarrage\nPour démarrer rapidement, utilisez l’un des kits de démarrage Cecil prêts à l’emploi.\nKits de démarrage disponibles\n\nThe Butler : starter blog prêt à publier.\nLinks : alternative open source à Linktree.\nPhoto Stream : flux photo auto-hébergé minimaliste.\nStatidocs : site de documentation prêt à l’emploi.\n\n\n\n\n\n", "content_html": "

Kits de démarrage

\n

Pour démarrer rapidement, utilisez l’un des kits de démarrage Cecil prêts à l’emploi.

\n

Kits de démarrage disponibles

\n\n

\n\n\n\"Exemple\n

", "language": "fr" }, { "id": "https://cecil-945.pages.dev/fr/documentation/configuration/codes-de-locale/", "url": "https://cecil-945.pages.dev/fr/documentation/configuration/codes-de-locale/", "title": "Codes de locale", "summary": "Liste des codes de locale à utiliser avec l’option languages.", "date_published": "2020-12-19T00:00:00+00:00", "date_modified": "2026-10-10T00:00:00+00:00","content_text": "Codes de locale\nCodes de locale disponibles (language_COUNTRY) utilisés par l’option languages.\nListe des codes de locale\n\n\n\nLocale\nCode\n\n\n\n\nAlbanais (Albanie)\nsq_AL\n\n\nAlbanais\nsq\n\n\nArabe (Algérie)\nar_DZ\n\n\nArabe (Bahreïn)\nar_BH\n\n\nArabe (Égypte)\nar_EG\n\n\nArabe (Irak)\nar_IQ\n\n\nArabe (Jordanie)\nar_JO\n\n\nArabe (Koweït)\nar_KW\n\n\nArabe (Liban)\nar_LB\n\n\nArabe (Libye)\nar_LY\n\n\nArabe (Maroc)\nar_MA\n\n\nArabe (Oman)\nar_OM\n\n\nArabe (Qatar)\nar_QA\n\n\nArabe (Arabie saoudite)\nar_SA\n\n\nArabe (Soudan)\nar_SD\n\n\nArabe (Syrie)\nar_SY\n\n\nArabe (Tunisie)\nar_TN\n\n\nArabe (Émirats arabes unis)\nar_AE\n\n\nArabe (Yémen)\nar_YE\n\n\nArabe\nar\n\n\nBiélorusse (Biélorussie)\nbe_BY\n\n\nBiélorusse\nbe\n\n\nBulgare (Bulgarie)\nbg_BG\n\n\nBulgare\nbg\n\n\nCatalan (Espagne)\nca_ES\n\n\nCatalan\nca\n\n\nChinois (Chine)\nzh_CN\n\n\nChinois (Hong Kong)\nzh_HK\n\n\nChinois (Singapour)\nzh_SG\n\n\nChinois (Taïwan)\nzh_TW\n\n\nChinois\nzh\n\n\nCroate (Croatie)\nhr_HR\n\n\nCroate\nhr\n\n\nTchèque (République tchèque)\ncs_CZ\n\n\nTchèque\ncs\n\n\nDanois (Danemark)\nda_DK\n\n\nDanois\nda\n\n\nNéerlandais (Belgique)\nnl_BE\n\n\nNéerlandais (Pays-Bas)\nnl_NL\n\n\nNéerlandais\nnl\n\n\nAnglais (Australie)\nen_AU\n\n\nAnglais (Canada)\nen_CA\n\n\nAnglais (Inde)\nen_IN\n\n\nAnglais (Irlande)\nen_IE\n\n\nAnglais (Malte)\nen_MT\n\n\nAnglais (Nouvelle-Zélande)\nen_NZ\n\n\nAnglais (Philippines)\nen_PH\n\n\nAnglais (Singapour)\nen_SG\n\n\nAnglais (Afrique du Sud)\nen_ZA\n\n\nAnglais (Royaume-Uni)\nen_GB\n\n\nAnglais (États-Unis)\nen_US\n\n\nAnglais\nen\n\n\nEstonien (Estonie)\net_EE\n\n\nEstonien\net\n\n\nFinnois (Finlande)\nfi_FI\n\n\nFinnois\nfi\n\n\nFrançais (Belgique)\nfr_BE\n\n\nFrançais (Canada)\nfr_CA\n\n\nFrançais (France)\nfr_FR\n\n\nFrançais (Luxembourg)\nfr_LU\n\n\nFrançais (Suisse)\nfr_CH\n\n\nFrançais\nfr\n\n\nAllemand (Autriche)\nde_AT\n\n\nAllemand (Allemagne)\nde_DE\n\n\nAllemand (Luxembourg)\nde_LU\n\n\nAllemand (Suisse)\nde_CH\n\n\nAllemand\nde\n\n\nGrec (Chypre)\nel_CY\n\n\nGrec (Grèce)\nel_GR\n\n\nGrec\nel\n\n\nHébreu (Israël)\niw_IL\n\n\nHébreu\niw\n\n\nHindi (Inde)\nhi_IN\n\n\nHongrois (Hongrie)\nhu_HU\n\n\nHongrois\nhu\n\n\nIslandais (Islande)\nis_IS\n\n\nIslandais\nis\n\n\nIndonésien (Indonésie)\nin_ID\n\n\nIndonésien\nin\n\n\nIrlandais (Irlande)\nga_IE\n\n\nIrlandais\nga\n\n\nItalien (Italie)\nit_IT\n\n\nItalien (Suisse)\nit_CH\n\n\nItalien\nit\n\n\nJaponais (Japon)\nja_JP\n\n\nJaponais (Japon,JP)\nja_JP_JP\n\n\nJaponais\nja\n\n\nCoréen (Corée du Sud)\nko_KR\n\n\nCoréen\nko\n\n\nLetton (Lettonie)\nlv_LV\n\n\nLetton\nlv\n\n\nLituanien (Lituanie)\nlt_LT\n\n\nLituanien\nlt\n\n\nMacédonien (Macédoine)\nmk_MK\n\n\nMacédonien\nmk\n\n\nMalais (Malaisie)\nms_MY\n\n\nMalais\nms\n\n\nMaltais (Malte)\nmt_MT\n\n\nMaltais\nmt\n\n\nNorvégien (Norvège)\nno_NO\n\n\nNorvégien (Norvège, Nynorsk)\nno_NO_NY\n\n\nNorvégien\nno\n\n\nPolonais (Pologne)\npl_PL\n\n\nPolonais\npl\n\n\nPortugais (Brésil)\npt_BR\n\n\nPortugais (Portugal)\npt_PT\n\n\nPortugais\npt\n\n\nRoumain (Roumanie)\nro_RO\n\n\nRoumain\nro\n\n\nRusse (Russie)\nru_RU\n\n\nRusse\nru\n\n\nSerbe (Bosnie-Herzégovine)\nsr_BA\n\n\nSerbe (Monténégro)\nsr_ME\n\n\nSerbe (Serbie et Monténégro)\nsr_CS\n\n\nSerbe (Serbie)\nsr_RS\n\n\nSerbe\nsr\n\n\nSlovaque (Slovaquie)\nsk_SK\n\n\nSlovaque\nsk\n\n\nSlovène (Slovénie)\nsl_SI\n\n\nSlovène\nsl\n\n\nEspagnol (Argentine)\nes_AR\n\n\nEspagnol (Bolivie)\nes_BO\n\n\nEspagnol (Chili)\nes_CL\n\n\nEspagnol (Colombie)\nes_CO\n\n\nEspagnol (Costa Rica)\nes_CR\n\n\nEspagnol (République dominicaine)\nes_DO\n\n\nEspagnol (Équateur)\nes_EC\n\n\nEspagnol (Salvador)\nes_SV\n\n\nEspagnol (Guatemala)\nes_GT\n\n\nEspagnol (Honduras)\nes_HN\n\n\nEspagnol (Mexique)\nes_MX\n\n\nEspagnol (Nicaragua)\nes_NI\n\n\nEspagnol (Panama)\nes_PA\n\n\nEspagnol (Paraguay)\nes_PY\n\n\nEspagnol (Pérou)\nes_PE\n\n\nEspagnol (Porto Rico)\nes_PR\n\n\nEspagnol (Espagne)\nes_ES\n\n\nEspagnol (États-Unis)\nes_US\n\n\nEspagnol (Uruguay)\nes_UY\n\n\nEspagnol (Venezuela)\nes_VE\n\n\nEspagnol\nes\n\n\nSuédois (Suède)\nsv_SE\n\n\nSuédois\nsv\n\n\nThaï (Thaïlande)\nth_TH\n\n\nThaï (Thaïlande,TH)\nth_TH_TH\n\n\nThaï\nth\n\n\nTurc (Turquie)\ntr_TR\n\n\nTurc\ntr\n\n\nUkrainien (Ukraine)\nuk_UA\n\n\nUkrainien\nuk\n\n\nVietnamien (Vietnam)\nvi_VN\n\n\nVietnamien\nvi\n\n\n", "content_html": "

Codes de locale

\n

Codes de locale disponibles (language_COUNTRY) utilisés par l’option languages.

\n

Liste des codes de locale

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
LocaleCode
Albanais (Albanie)sq_AL
Albanaissq
Arabe (Algérie)ar_DZ
Arabe (Bahreïn)ar_BH
Arabe (Égypte)ar_EG
Arabe (Irak)ar_IQ
Arabe (Jordanie)ar_JO
Arabe (Koweït)ar_KW
Arabe (Liban)ar_LB
Arabe (Libye)ar_LY
Arabe (Maroc)ar_MA
Arabe (Oman)ar_OM
Arabe (Qatar)ar_QA
Arabe (Arabie saoudite)ar_SA
Arabe (Soudan)ar_SD
Arabe (Syrie)ar_SY
Arabe (Tunisie)ar_TN
Arabe (Émirats arabes unis)ar_AE
Arabe (Yémen)ar_YE
Arabear
Biélorusse (Biélorussie)be_BY
Biélorussebe
Bulgare (Bulgarie)bg_BG
Bulgarebg
Catalan (Espagne)ca_ES
Catalanca
Chinois (Chine)zh_CN
Chinois (Hong Kong)zh_HK
Chinois (Singapour)zh_SG
Chinois (Taïwan)zh_TW
Chinoiszh
Croate (Croatie)hr_HR
Croatehr
Tchèque (République tchèque)cs_CZ
Tchèquecs
Danois (Danemark)da_DK
Danoisda
Néerlandais (Belgique)nl_BE
Néerlandais (Pays-Bas)nl_NL
Néerlandaisnl
Anglais (Australie)en_AU
Anglais (Canada)en_CA
Anglais (Inde)en_IN
Anglais (Irlande)en_IE
Anglais (Malte)en_MT
Anglais (Nouvelle-Zélande)en_NZ
Anglais (Philippines)en_PH
Anglais (Singapour)en_SG
Anglais (Afrique du Sud)en_ZA
Anglais (Royaume-Uni)en_GB
Anglais (États-Unis)en_US
Anglaisen
Estonien (Estonie)et_EE
Estonienet
Finnois (Finlande)fi_FI
Finnoisfi
Français (Belgique)fr_BE
Français (Canada)fr_CA
Français (France)fr_FR
Français (Luxembourg)fr_LU
Français (Suisse)fr_CH
Françaisfr
Allemand (Autriche)de_AT
Allemand (Allemagne)de_DE
Allemand (Luxembourg)de_LU
Allemand (Suisse)de_CH
Allemandde
Grec (Chypre)el_CY
Grec (Grèce)el_GR
Grecel
Hébreu (Israël)iw_IL
Hébreuiw
Hindi (Inde)hi_IN
Hongrois (Hongrie)hu_HU
Hongroishu
Islandais (Islande)is_IS
Islandaisis
Indonésien (Indonésie)in_ID
Indonésienin
Irlandais (Irlande)ga_IE
Irlandaisga
Italien (Italie)it_IT
Italien (Suisse)it_CH
Italienit
Japonais (Japon)ja_JP
Japonais (Japon,JP)ja_JP_JP
Japonaisja
Coréen (Corée du Sud)ko_KR
Coréenko
Letton (Lettonie)lv_LV
Lettonlv
Lituanien (Lituanie)lt_LT
Lituanienlt
Macédonien (Macédoine)mk_MK
Macédonienmk
Malais (Malaisie)ms_MY
Malaisms
Maltais (Malte)mt_MT
Maltaismt
Norvégien (Norvège)no_NO
Norvégien (Norvège, Nynorsk)no_NO_NY
Norvégienno
Polonais (Pologne)pl_PL
Polonaispl
Portugais (Brésil)pt_BR
Portugais (Portugal)pt_PT
Portugaispt
Roumain (Roumanie)ro_RO
Roumainro
Russe (Russie)ru_RU
Russeru
Serbe (Bosnie-Herzégovine)sr_BA
Serbe (Monténégro)sr_ME
Serbe (Serbie et Monténégro)sr_CS
Serbe (Serbie)sr_RS
Serbesr
Slovaque (Slovaquie)sk_SK
Slovaquesk
Slovène (Slovénie)sl_SI
Slovènesl
Espagnol (Argentine)es_AR
Espagnol (Bolivie)es_BO
Espagnol (Chili)es_CL
Espagnol (Colombie)es_CO
Espagnol (Costa Rica)es_CR
Espagnol (République dominicaine)es_DO
Espagnol (Équateur)es_EC
Espagnol (Salvador)es_SV
Espagnol (Guatemala)es_GT
Espagnol (Honduras)es_HN
Espagnol (Mexique)es_MX
Espagnol (Nicaragua)es_NI
Espagnol (Panama)es_PA
Espagnol (Paraguay)es_PY
Espagnol (Pérou)es_PE
Espagnol (Porto Rico)es_PR
Espagnol (Espagne)es_ES
Espagnol (États-Unis)es_US
Espagnol (Uruguay)es_UY
Espagnol (Venezuela)es_VE
Espagnoles
Suédois (Suède)sv_SE
Suédoissv
Thaï (Thaïlande)th_TH
Thaï (Thaïlande,TH)th_TH_TH
Thaïth
Turc (Turquie)tr_TR
Turctr
Ukrainien (Ukraine)uk_UA
Ukrainienuk
Vietnamien (Vietnam)vi_VN
Vietnamienvi
", "language": "fr" } ] }