{ "version": "https://jsonfeed.org/version/1.1", "title": "Cecil - Développeurs", "home_page_url": "https://cecil.app/fr/documentation/developpeurs/", "feed_url": "https://cecil.app/fr/documentation/developpeurs/feed.json", "description": "Étendez Cecil avec PHP, utilisez-le comme bibliothèque et comprenez son architecture.", "icon": "https://cecil.app/favicon.7ff4b89eec6dad139a7d2d6561543285.png", "favicon": "https://cecil.app/thumbnails/64x/favicon.7ff4b89eec6dad139a7d2d6561543285.png", "language": "fr", "items": [ { "id": "https://cecil.app/fr/documentation/developpeurs/architecture/", "url": "https://cecil.app/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-02T00:00:00+00:00","content_text": "Architecture\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

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.app/fr/documentation/developpeurs/etendre/", "url": "https://cecil.app/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.app/fr/documentation/developpeurs/bibliotheque/", "url": "https://cecil.app/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" } ] }