Configuration
The website configuration is defined in a YAML file named cecil.yml or config.yml stored at the root:
<mywebsite>
└─ cecil.yml
Cecil offers many configuration options, but its defaults are often sufficient. A new site requires only these settings:
title: "My new Cecil site"
baseurl: https://mywebsite.com/
description: "Site description"
The following documentation covers all supported configuration options in Cecil.
In this section
Site options
title, baseurl, menus, taxonomies, theme, date, metatags, debug, etc.
Languages
Main language and additional languages of a multilingual website.
Locale codes
List of available locale codes to use with the languages option.
Pages
Pages directory, sorting, pagination, paths, body, virtual pages, generators, etc.
Data and static files
Data files and static files options.
Assets
Assets directory, compilation, minification, images and CDN.
Layouts
Templates directory, auto-escaping, images, translations and components.
Output
Output directory, formats and post-processing.
Cache
Assets, templates and translations cache.
Server and optimization
Local server headers and output optimization.
Override configuration
Override the configuration with environment variables or a CLI option.