# Fichiers publiés

Le build écrit un site statique. Chaque fichier ci-dessous est servi à la racine de la doc, ou sous son `base` s’il est déclaré.

## Contenu de `dist/`

| Fichier ou dossier                | Contenu                                                                                                                                    |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `index.html`, `<page>/index.html` | Les pages du site.                                                                                                                         |
| `<page>.md`                       | Chaque page en Markdown. Par exemple `/guides/publier/` a sa version à `/guides/publier.md`.                                               |
| `llms.txt`                        | L’index de la doc au format [llmstxt.org](https://llmstxt.org) : une ligne par page, avec sa description, rangée par onglet et par groupe. |
| `.well-known/llms.txt`            | Le même fichier, à l’adresse conventionnelle.                                                                                              |
| `llms-full.txt`                   | Toute la doc en un seul fichier Markdown.                                                                                                  |
| `pagefind/`                       | L’index de la recherche du site.                                                                                                           |
| `_hgdc/corpus.json`               | Le contenu publié, lu par la console pour indexer l’assistant.                                                                             |

Chaque page annonce sa version Markdown dans son `<head>`, avec `rel="alternate"` et le type `text/markdown`.

## Ce qui est publié

- Les pages MDX et `.md` du dossier de la doc.
- Les médias des dossiers d’images : `images/`, `img/`, `logo/`, `assets/` et `static/`.
- Tout le contenu de `public/`, servi à la racine.
- Le logo et le favicon déclarés dans `docs.json`, même hors de ces dossiers.

## Ce qui n’est pas publié

- Les fichiers dont le nom commence par `_`.
- Les dossiers `node_modules`, `dist`, `.git`, `.github`, `.vercel` et `.hgdc-docs`, ainsi que tous les dossiers cachés.
- Les médias rangés hors d’un dossier d’images ou de `public/`, sauf le logo et le favicon déclarés.

Le dossier `.hgdc-docs/` contient le cache du build. Ne le publie pas et ajoute-le à ton `.gitignore`.

## Ce que lit la console

La console relit `/_hgdc/corpus.json` sur l’adresse du site, toutes les quinze minutes et à chaque synchronisation demandée. Ce fichier doit être accessible sans authentification. Voir [Synchroniser et vérifier l’index](/docs/guides/synchroniser-et-verifier/).

## Ce que lisent les agents

- `llms.txt` et `llms-full.txt` pour découvrir la doc.
- Les pages `.md` pour lire une page sans son habillage.
- Le [serveur MCP](/docs/reference/serveur-mcp/) pour chercher, sans passer par le site.

Le contenu de [`llms.txt`](/docs/concepts/llms-txt-et-agents/) et de `llms-full.txt` suit la navigation : la version par défaut passe en premier, les autres versions sont rangées dans une section `Optional`.