Guides

Rédiger du contenu

Léon met en forme le Markdown standard, et ajoute des composants de contenu écrits avec la syntaxe de blocs de Cecil.

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

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

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

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.

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.

Cartes

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.

Composer

composer require cecil/theme-leon

Archive

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

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