Sur cette page

• llms.txt
  • Exclure du contenu
• Pages Markdown
• Templates

Contenu pour les LLM

Les modèles de langage lisent plus facilement le Markdown que le HTML. Cecil leur fournit deux formats de sortie :

• llms : un fichier llms.txt, index du site ;
• markdown : une version Markdown de chaque page.

Les deux sont désactivés par défaut.

llms.txt

Depuis la version 8.114.0, le format llms génère la page d’accueil sous la forme d’un fichier llms.txt à la racine du site. Il contient :

• le titre et la description du site ;
• les liens du menu principal (les URL externes sont ignorées) ;
• les sections de premier niveau et leurs pages (les sous-sections sont imbriquées), avec leur titre et leur description.

Pour l’activer, ajoutez le format à la page d’accueil :

output:
  pagetypeformats:
    homepage:
      llms: true

Avec le template metatags, la page d’accueil HTML référence le fichier avec une balise <link rel="describedby" type="text/markdown">.

Exclure du contenu

Pour exclure une page ou une section (et ses pages) de llms.txt, définissez llms: false dans son front matter :

---
title: "Mentions légales"
llms: false
---

Les sections non publiées et exclues ne sont pas listées.

Pages Markdown

Le format markdown génère une page sous la forme d’un fichier Markdown, à côté de sa version HTML (ex. : blog/post-1.md pour blog/post-1/index.html). Le fichier contient le titre et le corps de la page ; une section liste ses pages.

Pour générer toutes les pages et sections en Markdown :

output:
  pagetypeformats:
    page:
      markdown: true
    section:
      markdown: true

Ou pour une seule page, avec la variable output :

---
output: [html, markdown]
---

Avec le template metatags, la page HTML référence sa version Markdown avec une balise <link rel="alternate" type="text/markdown">. Les liens de llms.txt pointent vers la version Markdown des pages lorsqu’elle existe.

Templates

Pour personnaliser ces sorties, surchargez les templates par défaut dans votre répertoire layouts (voir les règles de recherche) :

• home.llms.twig : le fichier llms.txt ;
• page.markdown.twig, list.markdown.twig et home.markdown.twig : les pages Markdown.