Cecil

A simple and powerful content-driven static site generator.

252
27
PHP

Cecil's logo, created by CΓ©cile Ricordeau

Cecil, a simple and powerful content-driven static site generator.

Latest stable version
PHP version require
License
Tests status
Release status
Documentation status
Scrutinizer score
Codacy badge
Coverage score
StyleCI status
SymfonyInsight badge

Cecil is a CLI application that merges plain text files (written in Markdown), images and Twig templates to generate a static website.

πŸ“„ Documentation | πŸ’» Demo | πŸ› Issue tracker | πŸ’¬ Discussion

Cecil CLI animated demo

Quick Start

Read the Quick Start documentation page.

Create and deploy a blog site:
Deploy to Netlify Deploy with Vercel

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://cecil.app/cecil.phar

Then install the binary globally:

mv cecil.phar /usr/local/bin/cecil
chmod +x /usr/local/bin/cecil

[!IMPORTANT]
PHP 8.1+ is required.

Usage

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

Contributing

See Contributing.

Thanks goes to these wonderful people (emoji key):

Arnaud Ligny
Arnaud Ligny

πŸ› πŸ“– πŸ€” 🚧 πŸ“£ πŸ’¬ πŸ‘€ 🌍 πŸ“’
Frank Taillandier
Frank Taillandier

πŸ“– πŸ€” πŸ“£ 🌍 πŸ§‘β€πŸ«
Martin Szulecki
Martin Szulecki

πŸ› πŸ’» πŸ€”
Matthieu Vion
Matthieu Vion

πŸ› πŸ’»
Chun-Sheng, Li
Chun-Sheng, Li

πŸ’» πŸ›‘οΈ
Benjamin Hirsch
Benjamin Hirsch

πŸ› πŸ’»
Pete Favelle
Pete Favelle

πŸ› πŸ’» πŸ€”
Gert de Pagter
Gert de Pagter

πŸ› πŸš‡
Joe Vallender
Joe Vallender

πŸ›
Jawira Portugal
Jawira Portugal

πŸ›
Yufan You
Yufan You

πŸ›‘οΈ
Mathieu Santostefano
Mathieu Santostefano

πŸ“– πŸ›

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

npx all-contributors add
npx all-contributors generate

Sponsors

studio cecilliestudio cecillieΒ Β Β Β Β Β Β Β Vercel Vercel

License

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

Cecil Β© Arnaud Ligny
Logo Β© CΓ©cile Ricordeau