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

Quick Start

Read the Quick Start documentation page.

Create and deploy a blog site:

Features

• 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

Installation

Download cecil.phar from your browser or from your terminal:

curl -LO https://github.com/Cecilapp/Cecil/releases/latest/download/cecil.phar

Important

PHP 8.2+ is required.

Usage

• Get help: php cecil.phar help
• Create a new website: php cecil.phar new:site
• Preview your website: php cecil.phar serve

Contributing

See Contributing.

Thanks goes to these wonderful people (emoji key):

Arnaud Ligny 🐛 📖 🤔 🚧 📣 💬 👀 🌍 📢	Frank Taillandier 📖 🤔 📣 🌍 🧑‍🏫	Martin Szulecki 🐛 💻 🤔	Matthieu Vion 🐛 💻
Chun-Sheng, Li 💻 🛡️	Benjamin Hirsch 🐛 💻	Pete Favelle 🐛 💻 🤔	Gert de Pagter 🐛 🚇
Joe Vallender 🐛	Jawira Portugal 🐛	Yufan You 🛡️	Mathieu Santostefano 📖 🐛
Max 📖	Progi1984 💻 🤔	Franck Matsos 💻

This project follows the all-contributors specification. Contributions of any kind welcome!

npx all-contributors add
npx all-contributors generate

Development

Build binaries

Build 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> about

Build API documentation

Build the API documentation with phpDocumentor:

# Install phpDocumentor globally
curl -Lo phpdoc https://phpdoc.org/phpDocumentor.phar
# Build the API documentation
php phpdoc

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, update the Homebrew formula and the Scoop manifest.

Sponsors

                

License

Cecil is a free software distributed under the terms of the MIT license.

Cecil © Arnaud Ligny
Logo © Cécile Ricordeau