Sur cette page

Encadrés

Les encadrés mettent une information en valeur. Utilisez :::note, :::info, :::tip, :::warning, :::danger ou :::important :

:::tip
Organisez votre contenu en dossiers imbriqués pour construire la barre latérale.
:::

Onglets

Chaque titre #### démarre un nouvel onglet. Les onglets de même libellé sont synchronisés sur toute la page, et le choix est mémorisé.

macOS

Installez avec Homebrew :

brew install cecil

Windows

Installez avec Scoop :

scoop install cecil

Linux

Téléchargez le Phar :

curl -LO https://cecil.app/cecil.phar
:::tabs
#### macOS
Installez avec Homebrew :

```bash
brew install cecil
```

#### Windows
Installez avec Scoop :

```powershell
scoop install cecil
```

#### Linux
Téléchargez le Phar :

```bash
curl -LO https://cecil.app/cecil.phar
```
:::

Groupes de code

Un groupe de code présente des blocs de code alternatifs dans un même cadre :

macOS

brew install cecil

Windows

scoop install cecil

Linux

curl -LO https://cecil.app/cecil.phar
:::code-group
#### macOS
```bash
brew install cecil
```
#### Windows
```powershell
scoop install cecil
```
#### Linux
```bash
curl -LO https://cecil.app/cecil.phar
```
:::

Sans titres, les onglets prennent le nom du langage de chaque bloc :

YAML

theme:
  - leon

JSON

{"theme": ["leon"]}
:::code-group
```yaml
theme:
  - leon
```
```json
{"theme": ["leon"]}
```
:::

Étapes

  1. Écrire

    Rédigez vos pages en Markdown.

  2. Générer

    Lancez php cecil.phar build.

  3. Publier

    Déployez le dossier _site où vous voulez.

:::steps
#### Écrire
Rédigez vos pages en Markdown.

#### Générer
Lancez `php cecil.phar build`.

#### Publier
Déployez le dossier `_site` où vous voulez.
:::

Accordéons

Qu'est-ce que Cecil ?

Un générateur de site statique, écrit en PHP, qui transforme des fichiers Markdown en site web.

Puis-je utiliser du HTML ?

Oui, et un élément natif <details> est lui aussi mis en forme comme un accordéon.

:::accordion
#### Qu'est-ce que Cecil ?
Un générateur de site statique, écrit en PHP, qui transforme des fichiers Markdown en site web.

#### Puis-je utiliser du HTML ?
Oui, et un élément natif `<details>` est lui aussi mis en forme comme un accordéon.
:::

Cartes

:::cards
- [Démarrage rapide](../../getting-started/quickstart/) : créer un site de zéro
- [Configuration](../../../reference/configuration/) : toutes les options du thème
:::

Imbrication

Un bloc peut en contenir d'autres : sa clôture doit alors être plus longue que la leur (::::steps … ::::).

  1. Installer

    Bash

    brew install cecil

    PowerShell

    scoop install cecil
  2. Configurer

  3. Générer

    Lancez cecil build.

::::steps
#### Installer
:::code-group
```bash
brew install cecil
```
```powershell
scoop install cecil
```
:::

#### Configurer
:::tip
Ajoutez `leon` à la liste `theme` de votre site.
:::

#### Générer
Lancez `cecil build`.
::::

Composer

composer require cecil/theme-leon

Archive

::::tabs
#### Composer
```bash
composer require cecil/theme-leon
```

#### Archive
:::warning
Installez aussi les thèmes de composants requis.
:::
::::

Code

Du code en ligne, des touches de clavier comme Ctrl + K, et des blocs avec coloration syntaxique :

<?php
// génère le site
$builder = Cecil\Builder::create($config);
$builder->build(['drafts' => false]);
{% for page in site.pages|sort_by_date %}
  <a href="{{ url(page) }}">{{ page.title }}</a>
{% endfor %}

Tableaux

Ce que je veux faire Meilleure option
Rechercher dans la documentation Appuyer sur Ctrl + K
Lire une page en Markdown Copier la page → Voir en Markdown
Interroger un assistant IA Copier la page → Ouvrir dans Claude

Diagrammes

flowchart LR
  A[Markdown] --> B(Cecil)
  B --> C{Léon}
  C --> D[HTML]
  C --> E[Markdown]
  C --> F[llms.txt]

Citations et listes

La simplicité est la sophistication suprême.

  1. Premier élément
  2. Deuxième élément
    • Élément imbriqué
    • Un autre
  3. Troisième élément