PHPackages cecil/cecil - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Templating & Views](/categories/templating) 4. / 5. cecil/cecil ActiveLibrary[Templating & Views](/categories/templating) cecil/cecil =========== A simple and powerful content-driven static site generator. 8.88.0(1mo ago)28960031[15 PRs](https://github.com/Cecilapp/Cecil/pulls)MITPHPPHP ^8.2||^8.3||^8.4||^8.5CI passing Since Oct 20Pushed 1mo ago9 watchersCompare [ Source](https://github.com/Cecilapp/Cecil)[ Packagist](https://packagist.org/packages/cecil/cecil)[ Docs](https://cecil.app)[ GitHub Sponsors](https://github.com/ArnaudLigny)[ Fund](https://opencollective.com/cecil)[ RSS](/packages/cecil-cecil/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (88)Versions (1112)Used By (0)Security (2) [![Cecil's logo, created by CΓ©cile Ricordeau](https://camo.githubusercontent.com/e153c45d65ad821322101787558bd5c273e154a449b86e7f478f2fbe1722a8bc/68747470733a2f2f636563696c2e6170702f696d616765732f6c6f676f2d636563696c2e706e67)](https://cecil.app) A simple and powerful content-driven static site generator. [![Latest stable version](https://camo.githubusercontent.com/f44fd16f73b86181e1c8b57873d0f5e0796977c20e41da9166c69a13274f30fa/68747470733a2f2f706f7365722e707567782e6f72672f636563696c2f636563696c2f762f737461626c65)](https://github.com/Cecilapp/Cecil/releases/latest)[![License](https://camo.githubusercontent.com/c99b9887f7d86c017875923e972acd7ec19a5d416edd8aa297e9242eccd5a82a/68747470733a2f2f706f7365722e707567782e6f72672f636563696c2f636563696c2f6c6963656e7365)](https://github.com/Cecilapp/Cecil/blob/master/LICENSE) Cecil is a CLI application that merges plain text files (written in [Markdown](http://daringfireball.net/projects/markdown/)), images and [Twig](https://twig.symfony.com) templates to generate a [static website](https://en.wikipedia.org/wiki/Static_web_page). πŸ“„[Documentation](https://cecil.app/documentation) Β· πŸ’»[Demo](https://the-butler-demo.cecil.app) Β· πŸ›[Issues tracker](https://github.com/Cecilapp/Cecil/issues) Β· πŸ’¬[Discussions](https://github.com/Cecilapp/Cecil/discussions) [![Cecil CLI animated demo](docs/cecil-cli-demo.gif "Cecil CLI demo")](docs/cecil-cli-demo.gif) [![Continuous Integration status](https://github.com/Cecilapp/Cecil/actions/workflows/continuous-integration.yml/badge.svg)](https://github.com/Cecilapp/Cecil/actions/workflows/continuous-integration.yml)[![Release status](https://github.com/Cecilapp/Cecil/actions/workflows/release.yml/badge.svg)](https://github.com/Cecilapp/Cecil/actions/workflows/release.yml)[![Documentation status](https://github.com/Cecilapp/Cecil/actions/workflows/documentation.yml/badge.svg)](https://github.com/Cecilapp/Cecil/actions/workflows/documentation.yml) [![Scrutinizer score](https://camo.githubusercontent.com/d9d3c4181fa9ad921d60077a139cb291c4698b7f4232583d66114dbf33994fad/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f436563696c6170702f436563696c2f6261646765732f7175616c6974792d73636f72652e706e67)](https://scrutinizer-ci.com/g/Cecilapp/Cecil/)[![Codacy badge](https://camo.githubusercontent.com/36bcfb8a019353dd7c3ea2775d174389d537c2fe06955a75099a1f8553804e32/68747470733a2f2f6170702e636f646163792e636f6d2f70726f6a6563742f62616467652f47726164652f3037323332643363376666333466336461356162646163386633616432636565)](https://app.codacy.com/gh/Cecilapp/Cecil/dashboard)[![Coverage score](https://camo.githubusercontent.com/3a0adb6b287eeb12fd42f2b9204b6353388c29f7ecca55ab34d46d61c9d0a3cd/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f436563696c6170702f436563696c2f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/Cecilapp/Cecil?branch=master)[![StyleCI status](https://camo.githubusercontent.com/9ce6a93a0d820f0f5dee2cb56bab943cfab9738142ec24a09bdfbeb3c28af19d/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f373534383938362f736869656c643f7374796c653d706c6173746963)](https://styleci.io/repos/12738012) Quick Start ----------- [](#quick-start) Read the [Quick Start](https://cecil.app/documentation/quick-start/) documentation page. Create and deploy a blog site: [![Deploy to Netlify](https://camo.githubusercontent.com/de47084e2d5a8948486a2238f1517e465560ec293c4a2cba80020472f8d5c80a/68747470733a2f2f7777772e6e65746c6966792e636f6d2f696d672f6465706c6f792f627574746f6e2e737667 "Deploy to Netlify")](https://cecil.app/hosting/netlify/deploy/) [![Deploy with Vercel](https://camo.githubusercontent.com/4fb0483041fff9dc5f254fc27dd11ca1d27b282bee360e5c26cc8ebaf5e337d9/68747470733a2f2f76657263656c2e636f6d2f627574746f6e2f64656661756c742e737667 "Deploy with Vercel")](https://cecil.app/hosting/vercel/deploy/) Features -------- [](#features) - No database, no server, no dependency: performance and security - Your pages are stored in [Markdown](https://cecil.app/documentation/content/#body) flat files with a [YAML front matter](https://cecil.app/documentation/content/#front-matter) - Powered by [Twig](https://cecil.app/documentation/templates/), a flexible template engine, with [themes](https://cecil.app/themes) support - Pagination, sitemap, redirections, robots.txt, taxonomies, RSS are generated automatically - Handles and optimizes assets for you - [Download one file](https://github.com/Cecilapp/Cecil/releases/latest/download/cecil.phar) and run it - Easy to deploy Installation ------------ [](#installation) [Download `cecil.phar`](https://github.com/Cecilapp/Cecil/releases/latest/download/cecil.phar) from your browser or from your terminal: ``` curl -LO https://github.com/Cecilapp/Cecil/releases/latest/download/cecil.phar ``` Important [PHP](https://www.php.net) 8.2+ is required. Usage ----- [](#usage) - Get help: `php cecil.phar help` - Create a new website: `php cecil.phar new:site` - Preview your website: `php cecil.phar serve` Contributing ------------ [](#contributing) See [Contributing](CONTRIBUTING.md). Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)): [![Arnaud Ligny](https://avatars.githubusercontent.com/u/80580?v=4?s=100) **Arnaud Ligny**](https://ligny.fr) [πŸ›](https://github.com/Cecilapp/Cecil/issues?q=author%3AArnaudLigny "Bug reports") [πŸ“–](https://github.com/Cecilapp/Cecil/commits?author=ArnaudLigny "Documentation") [πŸ€”](#ideas-ArnaudLigny "Ideas, Planning, & Feedback") [🚧](#maintenance-ArnaudLigny "Maintenance") [πŸ“£](#promotion-ArnaudLigny "Promotion") [πŸ’¬](#question-ArnaudLigny "Answering Questions") [πŸ‘€](https://github.com/Cecilapp/Cecil/pulls?q=is%3Apr+reviewed-by%3AArnaudLigny "Reviewed Pull Requests") [🌍](#translation-ArnaudLigny "Translation") [πŸ“’](#talk-ArnaudLigny "Talks") [![Frank Taillandier](https://avatars.githubusercontent.com/u/103008?v=4?s=100) **Frank Taillandier**](https://frank.taillandier.me) [πŸ“–](https://github.com/Cecilapp/Cecil/commits?author=DirtyF "Documentation") [πŸ€”](#ideas-DirtyF "Ideas, Planning, & Feedback") [πŸ“£](#promotion-DirtyF "Promotion") [🌍](#translation-DirtyF "Translation") [πŸ§‘β€πŸ«](#mentoring-DirtyF "Mentoring") [![Martin Szulecki](https://avatars.githubusercontent.com/u/1871867?v=4?s=100) **Martin Szulecki**](https://mirell.com) [πŸ›](https://github.com/Cecilapp/Cecil/issues?q=author%3AFunkyM "Bug reports") [πŸ’»](https://github.com/Cecilapp/Cecil/commits?author=FunkyM "Code") [πŸ€”](#ideas-FunkyM "Ideas, Planning, & Feedback") [![Matthieu Vion](https://avatars.githubusercontent.com/u/346889?v=4?s=100) **Matthieu Vion**](https://www.magentix.fr) [πŸ›](https://github.com/Cecilapp/Cecil/issues?q=author%3Amagentix "Bug reports") [πŸ’»](https://github.com/Cecilapp/Cecil/commits?author=magentix "Code") [![Chun-Sheng, Li](https://avatars.githubusercontent.com/u/9021747?v=4?s=100) **Chun-Sheng, Li**](https://github.com/peter279k) [πŸ’»](https://github.com/Cecilapp/Cecil/commits?author=peter279k "Code") [πŸ›‘οΈ](#security-peter279k "Security") [![Benjamin Hirsch](https://avatars.githubusercontent.com/u/2293943?v=4?s=100) **Benjamin Hirsch**](https://www.benjaminhirsch.net) [πŸ›](https://github.com/Cecilapp/Cecil/issues?q=author%3Abenjaminhirsch "Bug reports") [πŸ’»](https://github.com/Cecilapp/Cecil/commits?author=benjaminhirsch "Code") [![Pete Favelle](https://avatars.githubusercontent.com/u/730245?v=4?s=100) **Pete Favelle**](http://kavlak.uk/@ahnlak) [πŸ›](https://github.com/Cecilapp/Cecil/issues?q=author%3Aahnlak "Bug reports") [πŸ’»](https://github.com/Cecilapp/Cecil/commits?author=ahnlak "Code") [πŸ€”](#ideas-ahnlak "Ideas, Planning, & Feedback") [![Gert de Pagter](https://avatars.githubusercontent.com/u/14289961?v=4?s=100) **Gert de Pagter**](https://backendtea.com) [πŸ›](https://github.com/Cecilapp/Cecil/issues?q=author%3ABackEndTea "Bug reports") [πŸš‡](#infra-BackEndTea "Infrastructure (Hosting, Build-Tools, etc)") [![Joe Vallender](https://avatars.githubusercontent.com/u/1137938?v=4?s=100) **Joe Vallender**](https://aboutweb.dev) [πŸ›](https://github.com/Cecilapp/Cecil/issues?q=author%3Ajoevallender "Bug reports") [![Jawira Portugal](https://avatars.githubusercontent.com/u/496541?v=4?s=100) **Jawira Portugal**](https://jawira.com/) [πŸ›](https://github.com/Cecilapp/Cecil/issues?q=author%3Ajawira "Bug reports") [![Yufan You](https://avatars.githubusercontent.com/u/30581822?v=4?s=100) **Yufan You**](https://ouuan.moe/about) [πŸ›‘οΈ](#security-ouuan "Security") [![Mathieu Santostefano](https://avatars.githubusercontent.com/u/773875?v=4?s=100) **Mathieu Santostefano**](https://blog.welcomattic.com) [πŸ“–](https://github.com/Cecilapp/Cecil/commits?author=welcoMattic "Documentation") [πŸ›](https://github.com/Cecilapp/Cecil/issues?q=author%3AwelcoMattic "Bug reports") [![Max](https://avatars.githubusercontent.com/u/12385704?v=4?s=100) **Max**](https://github.com/maxalmonte14) [πŸ“–](https://github.com/Cecilapp/Cecil/commits?author=maxalmonte14 "Documentation") [![Progi1984](https://avatars.githubusercontent.com/u/1533248?v=4?s=100) **Progi1984**](https://lefevre.dev) [πŸ’»](https://github.com/Cecilapp/Cecil/commits?author=Progi1984 "Code") [πŸ€”](#ideas-Progi1984 "Ideas, Planning, & Feedback") [![Franck Matsos](https://avatars.githubusercontent.com/u/805227?v=4?s=100) **Franck Matsos**](https://franck.matsos.fr) [πŸ’»](https://github.com/Cecilapp/Cecil/commits?author=fmatsos "Code") This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome! ``` npx all-contributors add npx all-contributors generate ``` Development ----------- [](#development) ### Build binaries [](#build-binaries) Build binaries with [Box](https://github.com/box-project/box/) and [phpacker](https://github.com/phpacker/phpacker): ``` # Install globally composer global require humbug/box composer global require phpacker/phpacker # Add to your PATH export PATH=~/.composer/vendor/bin:$PATH ``` ``` # Build the PHAR file composer run build:phar # Check the PHAR file php dist/cecil.phar about # Build the package (with PHP binary included) composer run build:package # Check the package ./dist/build//- about ``` ### Build API documentation [](#build-api-documentation) Build the API documentation with [phpDocumentor](https://www.phpdoc.org): ``` # Install phpDocumentor globally curl -Lo phpdoc https://phpdoc.org/phpDocumentor.phar # Build the API documentation php phpdoc ``` Release ------- [](#release) To release a new version, create a new Git tag with the version number (e.g. `1.0.0`), push it to GitHub and the release will be automatically published by GitHub Actions. ``` git tag 1.0.0 git push origin 1.0.0 ``` Tip To create a **pre-release**, add a suffix to the version number (e.g. `1.0.0-beta.1`). The automated workflow also will publish the release to the [website](https://cecil.app/download), update the [Homebrew formula](https://github.com/Cecilapp/homebrew-tap) and the [Scoop manifest](https://cecil.app/scoop/cecil.json). Sponsors -------- [](#sponsors) [![studio cecillie](https://raw.githubusercontent.com/Cecilapp/website/master/static/images/logos/cecillie.png)](https://studio.cecillie.fr#gh-light-mode-only)[![studio cecillie](https://raw.githubusercontent.com/Cecilapp/website/master/static/images/logos/cecillie-dark.png)](https://studio.cecillie.fr#gh-dark-mode-only) [![Netlify](https://raw.githubusercontent.com/Cecilapp/website/master/static/images/logos/netlify.png)](https://www.netlify.com#gh-light-mode-only)[![Netlify](https://raw.githubusercontent.com/Cecilapp/website/master/static/images/logos/netlify-dark.png)](https://www.netlify.com#gh-dark-mode-only) License ------- [](#license) Cecil is a free software licensed under the [EUPL-1.2](https://interoperable-europe.ec.europa.eu/collection/eupl/eupl-text-eupl-12) license. Cecil Β© [Arnaud Ligny](https://arnaudligny.fr) Logo Β© [CΓ©cile Ricordeau](https://www.cecillie.fr) ### Health Score 67 β€” FairBetter than 100% of packages Maintenance89 Actively maintained with recent releases Popularity36 Limited adoption so far Community27 Small or concentrated contributor base Maturity100 Battle-tested with a long release history Bus Factor1 Top contributor holds 81.9% of commits β€” single point of failure How is this calculated?**Maintenance (25%)** β€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** β€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** β€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** β€” Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~4 days Total 1085 Last Release 53d ago Major Versions 6.5.1 β†’ 7.0.02022-09-08 7.36.1 β†’ 8.0.0-beta.12023-04-19 7.36.4 β†’ 8.0.0-beta.32023-04-27 7.36.6 β†’ 8.0.0-beta.52023-05-09 7.x-dev β†’ 8.0.0-beta.62023-12-07 PHP version history (17 changes)1.0.0-alpha.1PHP >=5.3 1.0.0-alpha.2PHP >=5.4 2.0.0-beta.1PHP ^5.5|^7.0 2.0.0-beta.4PHP ^5.6|^7.0 2.2.0PHP ^5.6 || ^7.1 2.3.1PHP ^5.6|^7.1 3.0.0PHP ^7.1 4.16.2PHP ^7.1.3 5.34.1PHP >=7.1 6.0.0-beta.1PHP >=7.4 5.104.3PHP ^7.1||^7.2||^7.3||^7.4||^8.0 6.0.0-beta.7PHP ^7.4||^8.0||^8.1 8.0.0-beta.3PHP ^7.4||^8.0||^8.1||^8.2 8.0.0-beta.6PHP ^8.1||^8.2||^8.3 8.16.0PHP ^8.1||^8.2||^8.3||^8.4 8.73.0PHP ^8.1||^8.2||^8.3||^8.4||^8.5 8.76.0PHP ^8.2||^8.3||^8.4||^8.5 ### Community Maintainers ![](https://www.gravatar.com/avatar/52a734f97ce4ef72fb07b59e5d0f7f6a26a0b322da49b881bedc3896c5e7f128?d=identicon)[aligny](/maintainers/aligny) --- Top Contributors [![ArnaudLigny](https://avatars.githubusercontent.com/u/80580?v=4)](https://github.com/ArnaudLigny "ArnaudLigny (4158 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (428 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (400 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (44 commits)")[![allcontributors[bot]](https://avatars.githubusercontent.com/in/23186?v=4)](https://github.com/allcontributors[bot] "allcontributors[bot] (16 commits)")[![dependabot-support](https://avatars.githubusercontent.com/u/112581971?v=4)](https://github.com/dependabot-support "dependabot-support (8 commits)")[![Progi1984](https://avatars.githubusercontent.com/u/1533248?v=4)](https://github.com/Progi1984 "Progi1984 (4 commits)")[![welcoMattic](https://avatars.githubusercontent.com/u/773875?v=4)](https://github.com/welcoMattic "welcoMattic (2 commits)")[![dependencies-bot](https://avatars.githubusercontent.com/u/28956703?v=4)](https://github.com/dependencies-bot "dependencies-bot (2 commits)")[![maxalmonte14](https://avatars.githubusercontent.com/u/12385704?v=4)](https://github.com/maxalmonte14 "maxalmonte14 (1 commits)")[![odolbeau](https://avatars.githubusercontent.com/u/680206?v=4)](https://github.com/odolbeau "odolbeau (1 commits)")[![peter279k](https://avatars.githubusercontent.com/u/9021747?v=4)](https://github.com/peter279k "peter279k (1 commits)")[![DirtyF](https://avatars.githubusercontent.com/u/103008?v=4)](https://github.com/DirtyF "DirtyF (1 commits)")[![BackEndTea](https://avatars.githubusercontent.com/u/14289961?v=4)](https://github.com/BackEndTea "BackEndTea (1 commits)")[![benjaminhirsch](https://avatars.githubusercontent.com/u/2293943?v=4)](https://github.com/benjaminhirsch "benjaminhirsch (1 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (1 commits)")[![ahnlak](https://avatars.githubusercontent.com/u/730245?v=4)](https://github.com/ahnlak "ahnlak (1 commits)")[![fmatsos](https://avatars.githubusercontent.com/u/805227?v=4)](https://github.com/fmatsos "fmatsos (1 commits)")[![FunkyM](https://avatars.githubusercontent.com/u/1871867?v=4)](https://github.com/FunkyM "FunkyM (1 commits)")[![joevallender](https://avatars.githubusercontent.com/u/1137938?v=4)](https://github.com/joevallender "joevallender (1 commits)") --- Tags flat-filemarkdownphpstatic-site-generatortwigtwigmarkdownstatic-site-generator ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/cecil-cecil/health.svg) ``` [![Health](https://phpackages.com/badges/cecil-cecil/health.svg)](https://phpackages.com/packages/cecil-cecil) ``` ### Alternatives [shopware/platform The Shopware e-commerce core 3.3k1.5M3](/packages/shopware-platform)[contao/core-bundle Contao Open Source CMS 1231.6M2.4k](/packages/contao-core-bundle)[shopware/core Shopware platform is the core for all Shopware ecommerce products. 595.2M386](/packages/shopware-core)[sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.4k5.6M651](/packages/sylius-sylius)[prestashop/prestashop PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers. 9.0k15.4k](/packages/prestashop-prestashop)[ec-cube/ec-cube EC-CUBE EC open platform. 78527.0k1](/packages/ec-cube-ec-cube) PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)