A simple and powerful content-driven static site generator.
Cecil is a CLI application that merges plain text files (written in Markdown), images and Twig templates to generate a static website.
📄Documentation · 💻Demo · 🐛Issues tracker · 💬Discussions
Read the Quick Start documentation page.
Create and deploy a blog site:
- No database, no server, no dependency: performance and security
- Your pages are stored in Markdown flat files with a YAML front matter
- Powered by Twig, a flexible template engine, with themes support
- Pagination, sitemap, redirections, robots.txt, taxonomies, RSS are generated automatically
- Handles and optimizes assets for you
- Download one file and run it
- Easy to deploy
Download cecil.phar from your browser or from your terminal:
curl -LO https://github.com/Cecilapp/Cecil/releases/latest/download/cecil.pharImportant
PHP 8.2+ is required.
- Get help:
php cecil.phar help - Create a new website:
php cecil.phar new:site - Preview your website:
php cecil.phar serve
See Contributing.
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!
npx all-contributors add
npx all-contributors generateBuild binaries with Box and 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 build:phar
# Check the PHAR file
php dist/cecil.phar about
# Build the package (with PHP binary included)
composer build:package
# Check the package
./dist/build/<os>/<os>-<arch> aboutBuild the API documentation with phpDocumentor:
# Install phpDocumentor globally
curl -Lo phpdoc https://phpdoc.org/phpDocumentor.phar
# Build the API documentation
php phpdoc
Cecil is a free software distributed under the terms of the MIT license.
Cecil © Arnaud Ligny
Logo © Cécile Ricordeau
