Cecilapp /Cecil
A simple and powerful content-driven static site generator.
★ 300⑂ 31👁 8⑃ 2,404● 156▤ 1,228
+1
日增长
300
stars
31
forks
8
watchers
2,404
prs
156
issues
1,228
releases
README
A simple and powerful content-driven static site generator.
Cecil is a command-line PHP application that merges Markdown pages, media and Twig templates to generate a static website.
🌐 Website · 📄 Documentation · 🎨 Themes · ✨ Showcase · 📰 News · 🐛 Issues · 💬 Discussions
!Cecil CLI animated demo
Features
- Fast & secure: no database, no server-side code, static files offer a minimal attack surface
- Files only: content is stored in flat Markdown files with a front matter
- Customizable: powered by Twig templates, with themes support
- Multiple generators: pagination, taxonomies, sitemap, RSS feeds, robots.txt and redirects are generated automatically
- Image optimization: responsive images, WebP and AVIF conversion, compression
- Assets processing: compile, minify and fingerprint CSS and JavaScript
- Multilingual: content localization and template translation
- SEO-friendly: meta tags, Open Graph, X (Twitter) cards and structured data
- No installation: download a single file and run it with PHP
- Easy to deploy: in minutes on Netlify, Vercel, statichost and others
- Open source: licensed under EUPL-1.2 and developed on GitHub
Quick Start
Requirements: PHP 8.3+ and a terminal.
1. Download Cecil
bash
curl -LO https://github.com/Cecilapp/Cecil/releases/latest/download/cecil.phar
2. Create a new site (in an empty directory containing cecil.phar)
bash
php cecil.phar new:site
3. Add a page, then edit it in pages/
bash
php cecil.phar new:page
4. Preview at http://localhost:8000
bash
php cecil.phar serve
5. Build and copy the content of the _site directory to any web server
bash
php cecil.phar build
Read the Quick Start documentation page for more details.
Or start from a starter kit and deploy a ready-to-use blog in one click:
Installation
Download cecil.phar from your terminal:
bash
curl -LO https://github.com/Cecilapp/Cecil/releases/latest/download/cecil.phar
Other installation methods:
- Homebrew: brew install cecilapp/tap/cecil
- Scoop: scoop install https://cecil.app/scoop/cecil.json
- Standalone binaries (no PHP required): cecil-linux-x64, cecil-macos-arm64, cecil-windows-x64.exe, etc.
- Download page (all releases)
See the Installation documentation page.
Usage
Common commands:
bash
php cecil.phar help Get help
php cecil.phar new:site Create a new website
php cecil.phar new:page Create a new page
php cecil.phar serve Preview your website locally
php cecil.phar build Build your website
php cecil.phar doctor Diagnose your site configuration
See the Commands documentation page.
Contributing
See Contributing.
Thanks goes to these wonderful people:
Arnaud Ligny🐛 📖 🤔 🚧 📣 💬 👀 🌍 📢
Frank Taillandier📖 🤔 📣 🌍 🧑🏫
Martin Szulecki🐛 💻 🤔
Matthieu Vion🐛 💻
Chun-Sheng, Li💻 🛡️
Benjamin Hirsch🐛 💻
Pete Favelle🐛 💻 🤔
Gert de PagteDiscussions
#2482Suggestion: Add a section for examples of nice sites powered by Cecil1 comments · 2026-09-24#2389Superb - new autoescape function0 comments · 2026-05-29#2382`serve` command fail cause of "Permission denied"1 comments · 2026-05-25#2376Gallery and lightbox1 comments · 2026-05-24#2375Support for llms.txt2 comments · 2026-05-20#2485Tags documentation very light8 comments · 2026-03-29#2304create paginator for a specific page2 comments · 2026-01-29#2176How do you override default robots.txt?1 comments · 2025-05-23
Latest release
9.31.0 9.31.0 2026-11-15- 📖 docs(agents): add parallel work with worktrees section 8ee6837 @ArnaudLigny - 💄 chore(vscode): set window title 12c7129 @ArnaudLigny - 🐝 refactor(assets): extract bundle type check from the constructor (2601) ca081d4 @ArnaudLigny - 🌟 feat(config): load front matter schemas from a schemas/ directory (2600) a2c7fe7 @ArnaudLigny --- - Documentation: - Download: - Update: