# Publier llms.txt

[llms.txt](https://llmstxt.org) est une convention qui consiste à servir la documentation aux assistants IA en texte brut, à des URL well-known. Lorsque votre application publie du contenu markdown, Sovrium sait l'exposer ainsi sans aucun travail de votre part.

Deux routes sont servies :

| Route            | Contenu                                                                                       |
| ---------------- | --------------------------------------------------------------------------------------------- |
| `/llms.txt`      | Un index compact — le titre du site, une description d'une ligne et des liens vers les pages. |
| `/llms-full.txt` | Le même index, plus le corps markdown complet de chaque page, concaténé.                      |

Les deux sont dérivées de vos [pages de répertoire de contenu](/fr/docs/pages-collections#contentdir) : un site de documentation les obtient donc automatiquement.

## Configuration

Le bloc `llms` est entièrement optionnel. Ne le déclarez que pour désactiver la fonctionnalité, ou pour surcharger ce que dit l'en-tête généré :

```yaml
llms:
  title: Acme Handbook
  description: Everything the team needs to know.
  full: true
```

| Propriété     | Description                                                                                                                |
| ------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `enabled`     | Sert les routes. Vaut `true` par défaut lorsque l'application a des pages de contenu ; `false` fait renvoyer 404 aux deux. |
| `title`       | Le H1 en haut de `/llms.txt`. Vaut par défaut le nom de l'application.                                                     |
| `description` | La citation sous le H1. Vaut par défaut la description de l'application, lorsqu'elle est définie.                          |
| `full`        | Sert `/llms-full.txt`. Vaut `true` par défaut lorsque la fonctionnalité est activée.                                       |

Désactiver `full` est l'ajustement habituel pour un grand corpus — l'index reste utile, tandis que le corps concaténé, qui peut atteindre des milliers de lignes, n'est pas servi.

```yaml
llms:
  full: false
```

## Vérifier

```bash
curl -fsS http://localhost:3000/llms.txt | head -20
```

Chaque page de contenu attendue devrait apparaître sous forme de lien. Une page absente de l'index est une page située hors d'un répertoire de contenu.

:::callout
**C'est le llms.txt de votre application, pas celui de Sovrium.** Sovrium publie le sien sur [sovrium.com/llms.txt](https://sovrium.com/llms.txt) pour que les outils IA puissent vous aider à écrire des configurations — voir [Référence LLM](/fr/docs/llm-reference). Le bloc `llms`, lui, configure celui que _votre_ application sert à _ses_ lecteurs.
:::

## Pages connexes

- [Référence LLM](/fr/docs/llm-reference) — le llms.txt de Sovrium lui-même, pour les outils IA qui écrivent des configurations.
- [Présentation des pages](/fr/docs/pages-overview) — les pages de répertoire de contenu à partir desquelles l'index est construit.
- [SEO et métadonnées](/fr/docs/seo-meta) — la moitié humaine de la même question de découvrabilité.
- [Métadonnées de l'application](/fr/docs/app-metadata) — le nom et la description de l'application utilisés comme valeurs par défaut.