# Cecil

> Cecil is a command-line PHP application that merges Markdown pages, medias and Twig templates to generate a static website.
    
## Documentation
    
- [Library](https://cecil.app/documentation/library.md): Use Cecil as a PHP library.
- [Extend](https://cecil.app/documentation/extend.md): Extend Cecil.
- [Content](https://cecil.app/documentation/content.md): Create content and organize it.
- [Templates](https://cecil.app/documentation/templates.md): Working with layouts, templates and components.
- [Configuration](https://cecil.app/documentation/configuration.md): Configure your website.
- [Quick Start](https://cecil.app/documentation/quick-start.md): Create a new website and preview it locally.
- [Commands](https://cecil.app/documentation/commands.md): List of available commands.
- [Deploy](https://cecil.app/documentation/deploy.md): Deploy (publish) your website.
      
## How to?
    
- [How to optimize images in Markdown?](https://cecil.app/how-to/markdown-performance-images/)
- [How to generate multiple formats of an images in templates?](https://cecil.app/how-to/templates-image-formats/)
- [How to render responsive images in templates?](https://cecil.app/how-to/templates-responsive-images/)
      
## News
    
- [Cecil 8.79.0 released](https://cecil.app/news/2026/01/14/cecil-8.79.0-released/): This release improves slugification for multilingual content and refactors related code.
- [Cecil 8.77.0 released](https://cecil.app/news/2026/01/14/cecil-8.77.0-released/): Refactors and simplifies image resizing and cropping logic, consolidating functionality into a single, more flexible method.
- [Cecil 8.76.0 released](https://cecil.app/news/2025/12/31/cecil-8.76.0-released/): Upgrades minimum PHP version to 8.2, adds desktop notifications, and improves build and test processes.
- [Cecil 8.75.0 released](https://cecil.app/news/2025/12/09/cecil-8.75.0-released/): Enhances the asset handling system, especially for audio and video files.
- [What's new since version 8.37?](https://cecil.app/news/2025/12/03/whats-new-since-8.37/): List of changes since the release of Cecil 8.37.0.
- [Cecil 8.37.0 released](https://cecil.app/news/2025/04/23/cecil-8.37.0-released/): Configuration simplified and cache mechanics improved
- [Cecil 8.0.0 released](https://cecil.app/news/2023/12/08/cecil-8.0.0-released/): This is a major branch release: its goal is to start the road to PHP 8 🐘
- [Cecil 7.45.0 released](https://cecil.app/news/2023/08/16/cecil-7.45.0-released/): Get dimensions of a video asset.
- [Cecil 7.44.0 released](https://cecil.app/news/2023/08/02/cecil-7.44.0-released/): Disable default metatag image.
- [Cecil 7.43.0 released](https://cecil.app/news/2023/06/22/cecil-7.43.0-released/): New dump function.
- [Cecil 7.40.0 released](https://cecil.app/news/2023/06/04/cecil-7.40.0-released/): i18n for taxonomy.
- [Cecil 7.39.0 released](https://cecil.app/news/2023/05/24/cecil-7.39.0-released/): Processing time and consumed memory.
- [Cecil 7.38.0 released](https://cecil.app/news/2023/05/23/cecil-7.38.0-released/): Changes ID of localized pages.
- [Cecil 7.37.0 released](https://cecil.app/news/2023/05/22/cecil-7.37.0-released/): New variable `page.paginator.links.path`.
- [Cecil 7.36.0 released](https://cecil.app/news/2023/04/15/cecil-7.36.0-released/): New taxonomy template lookup rule.
- [Cecil 7.35.0 released](https://cecil.app/news/2023/04/11/cecil-7.35.0-released/): New asset filter and functions for images.
- [Cecil 7.34.0 released](https://cecil.app/news/2023/04/06/cecil-7.34.0-released/): LQIP filter.
- [Cecil 7.33.0 released](https://cecil.app/news/2023/03/20/cecil-7.33.0-released/): Support of image CDN.
- [Cecil 7.32.0 released](https://cecil.app/news/2023/03/09/cecil-7.32.0-released/): `decoding="async"` added to images.
- [Cecil 7.31.0 released](https://cecil.app/news/2023/03/07/cecil-7.31.0-released/): EXIF and audio data.
- [Cecil 7.30.0 released](https://cecil.app/news/2023/02/23/cecil-7.30.0-released/): Add base page URL to TOC anchor.
- [Cecil 7.29.0 released](https://cecil.app/news/2023/01/04/cecil-7.29.0-released/): JSON Feed output format.
- [Cecil 7.28.0 released](https://cecil.app/news/2022/11/25/cecil-7.28.0-released/): Feeds links available from pages in a section.
- [Cecil 7.27.0 released](https://cecil.app/news/2022/11/05/cecil-7.27.0-released/): Remove cache files by regular expression.
- [Cecil 7.25.0 released](https://cecil.app/news/2022/10/31/cecil-7.25.0-released/): Custom responsive image `sizes`.
- [Cecil 7.26.0 released](https://cecil.app/news/2022/10/31/cecil-7.26.0-released/): Create caption for images and embed links having a title.
- [Cecil 7.24.0 released](https://cecil.app/news/2022/10/30/cecil-7.24.0-released/): Turn a link into a video or audio element.
- [Cecil 7.23.0 released](https://cecil.app/news/2022/10/29/cecil-7.23.0-released/): New option to add default class to body images.
- [Cecil 7.20.0 released](https://cecil.app/news/2022/10/25/cecil-7.20.0-released/): New variable to override the canonical URL.
- [Cecil 7.21.0 released](https://cecil.app/news/2022/10/25/cecil-7.21.0-released/): Local fallback for remote images.
- [Cecil 7.22.0 released](https://cecil.app/news/2022/10/25/cecil-7.22.0-released/): Support of embed GitHub Gist link.
- [Cecil 7.19.0 released](https://cecil.app/news/2022/10/24/cecil-7.19.0-released/): Link to a page in a markdown link.
- [Cecil 7.18.0 released](https://cecil.app/news/2022/10/23/cecil-7.18.0-released/): Embed a YouTube video from a Markdown link.
- [Cecil 7.17.0 released](https://cecil.app/news/2022/10/19/cecil-7.17.0-released/): Normalize asset path in Markdown.
- [Cecil 7.16.0 released](https://cecil.app/news/2022/10/16/cecil-7.16.0-released/): Support of Markdown in `<figcaption>` of an image.
- [Cecil 7.15.0 released](https://cecil.app/news/2022/10/12/cecil-7.15.0-released/): Support of custom Twig extensions.
- [Cecil 7.14.0 released](https://cecil.app/news/2022/10/11/cecil-7.14.0-released/): Options for 'sortby' front matter variable.
- [Cecil 7.13.0 released](https://cecil.app/news/2022/10/05/cecil-7.13.0-released/): Fetch the dominant color of an image.
- [Cecil 7.12.0 released](https://cecil.app/news/2022/10/03/cecil-7.12.0-released/): New 'toc' template filter.
- [Cecil 7.11.0 released](https://cecil.app/news/2022/10/02/cecil-7.11.0-released/): Add 'language' option to template url() function.
- [Cecil 7.9.0 released](https://cecil.app/news/2022/09/30/cecil-7.9.0-released/): New command to extract templates.
- [Cecil 7.10.0 released](https://cecil.app/news/2022/09/30/cecil-7.10.0-released/): Internal translations.
- [Cecil 7.8.0 released](https://cecil.app/news/2022/09/28/cecil-7.8.0-released/): New paginator.
- [Cecil 7.7.0 released](https://cecil.app/news/2022/09/24/cecil-7.7.0-released/): Multiple formats translation.
- [Cecil 7.6.0 released](https://cecil.app/news/2022/09/23/cecil-7.6.0-released/): Print memory usage in verbose mode.
- [Cecil 7.4.0 released](https://cecil.app/news/2022/09/19/cecil-7.4.0-released/): Better prev and next navigation in section.
- [Cecil 7.5.0 released](https://cecil.app/news/2022/09/19/cecil-7.5.0-released/): Checks default language and locale configuration.
- [Cecil 7.3.0 released](https://cecil.app/news/2022/09/18/cecil-7.3.0-released/): Support of custom (localized) `path` for section.
- [Cecil 7.2.0 released](https://cecil.app/news/2022/09/12/cecil-7.2.0-released/): Debug output of translations.
- [Cecil 7.0.0 released](https://cecil.app/news/2022/09/08/cecil-7.0.0-released/): i18n support migrated to Symfony Translation + Twig Intl.
- [Cecil 7.1.0 released](https://cecil.app/news/2022/09/08/cecil-7.1.0-released/): Translations configuration options.
- [Cecil 6.3.0 released](https://cecil.app/news/2022/09/06/cecil-6.3.0-released/): Better front matter variables handling and fixes.
- [Cecil 6.4.0 released](https://cecil.app/news/2022/09/06/cecil-6.4.0-released/): I18n feature for home page
- [Cecil 6.5.0 released](https://cecil.app/news/2022/09/06/cecil-6.5.0-released/): Sort pages collection by `updated` date.
- [Cecil 6.2.0 released](https://cecil.app/news/2022/08/30/cecil-6.2.0-released/): Localizeddate fallback.
- [Cecil 6.1.0 released](https://cecil.app/news/2022/08/11/cecil-6.1.0-released/): Markdown files moved from `content` to `pages`.
- [Cecil 6.0.0 released](https://cecil.app/news/2022/08/04/cecil-6.0.0-released/): Adds support of PHP 8.1.
- [Cecil 5.104.0 released](https://cecil.app/news/2022/07/04/cecil-5.104.0-released/): Adds an XSLT stylesheet to RSS feeds.
- [Cecil 5.103.0 released](https://cecil.app/news/2022/06/27/cecil-5.103.0-released/): Adds an XSLT stylesheet to Atom feeds.
- [Cecil 5.102.0 released](https://cecil.app/news/2022/06/18/cecil-5.102.0-released/): Adds audio and video media support in Markdown.
- [Cecil 5.101.0 released](https://cecil.app/news/2022/06/06/cecil-5.101.0-released/): Code syntax highlight in Markdown.
- [Cecil 5.100.0 released](https://cecil.app/news/2022/06/05/cecil-5.100.0-released/): New template filter: `yaml_parse`.
- [Cecil 5.99.0 released](https://cecil.app/news/2022/06/03/cecil-5.99.0-released/): Get a page in template.
- [Cecil 5.98.0 released](https://cecil.app/news/2022/05/24/cecil-5.98.0-released/): Exclude directories, path or files in content.
- [Cecil 5.97.0 released](https://cecil.app/news/2022/05/08/cecil-5.97.0-released/): Inline "insert" Markdown.
- [Cecil 5.96.0 released](https://cecil.app/news/2022/05/08/cecil-5.96.0-released/): Define responsive images widths.
- [Cecil 5.95.0 released](https://cecil.app/news/2022/04/29/cecil-5.95.0-released/): Converts variables to boolean.
- [Cecil 5.94.0 released](https://cecil.app/news/2022/04/29/cecil-5.94.0-released/): Schedule pages publication.
- [Cecil 5.93.0 released](https://cecil.app/news/2022/04/22/cecil-5.93.0-released/): New template filter: `hex_to_rgb`.
- [Cecil 5.92.0 released](https://cecil.app/news/2022/04/06/cecil-5.92.0-released/): Asking for basic configuration when creating a new site.
- [Cecil 5.91.0 released](https://cecil.app/news/2022/04/03/cecil-5.91.0-released/): Adds support of `SiteNavigationElement` structured data.
- [Cecil 5.90.0 released](https://cecil.app/news/2022/04/02/cecil-5.90.0-released/): Option to disable remote images fetching.
- [Cecil 5.89.0 released](https://cecil.app/news/2022/03/27/cecil-5.89.0-released/): WebP image optimization.
- [Cecil 5.88.0 released](https://cecil.app/news/2022/03/25/cecil-5.88.0-released/): Get width and height of a SVG.
- [Cecil 5.87.0 released](https://cecil.app/news/2022/03/23/cecil-5.87.0-released/): Markdown Note block-level element.
- [Cecil 5.85.0 released](https://cecil.app/news/2022/03/18/cecil-5.85.0-released/): Build and serve a specific page.
- [Cecil 5.84.0 released](https://cecil.app/news/2022/03/10/cecil-5.84.0-released/): Open `content` with the configured editor.
- [Introducing the News section](https://cecil.app/news/2022/03/04/introducing-the-news-section/)
- [Cecil 5.83.0 released](https://cecil.app/news/2022/01/22/cecil-5.83.0-released/): Use a custom image variable in metatags.
- [Cecil 5.82.0 released](https://cecil.app/news/2022/01/13/cecil-5.82.0-released/): Load pages from a specific section in homepage.
- [Cecil 5.81.0 released](https://cecil.app/news/2022/01/08/cecil-5.81.0-released/): Options for `excerpt_html` filter.
- [Cecil 5.79.0 released](https://cecil.app/news/2021/12/14/cecil-5.79.0-released/): Navigation template.
          