A restructured documentation

The documentation has been restructured: the long single pages (some of them over 1,500 lines!) have been split into sections made of shorter, focused pages.

This restructuring was made possible by the nested sections introduced in Cecil 9: any folder containing an index.md file becomes a sub-section of its parent section, with its own pages, layout fallback and breadcrumb. This website is built with Cecil, so the documentation is the first to benefit from it!

New structure

The documentation is now organized into 8 sections:

1. Getting started: quick start, installation, directory structure and starter kits
2. Content: pages, front matter, Markdown, multilingual and dynamic content
3. Templates: lookup rules, variables, components, localization, cache, extension, and a reference of functions and filters
4. Assets: images, processing and CDN providers (a brand new section, previously part of Templates)
5. Configuration: one page per configuration topic (site, languages, pages, assets, output, cache, server, etc.)
6. Commands: new:site, new:page, serve, build and doctor
7. Deploy: Jamstack platforms, continuous deployment and static hosting
8. Developers: extend Cecil, use it as a library and understand its architecture

Easier navigation

• A navigation tree in the sidebar shows where you are and lets you unfold each section.
• Each section's home page lists its pages with a short description.
• The search now indexes every page and its introduction, so results point directly to the right topic.

The documentation is available in English and French. If you spot something wrong or missing, use the “Suggest a modification” link at the bottom of each page.