<!-- page:69470 -->
# Fonctionnement interne

Tout Wikilayer repose sur l’arbre de nœuds décrit ci-dessous : chaque bloc a une adresse stable, chaque page montre quelles pages pointent vers elle, et une page se lit toujours comme un seul document. [MCP](page:69499) est la voie par laquelle les agents atteignent ce même arbre.

<!-- block:69534 -->
## Nœuds

Wikilayer range les textes dans un seul arbre. Chaque nœud a un titre et un corps en Markdown ; une page contient les blocs qui forment ses sections et se place sous le wiki ou sous une autre page, et cet arbre de pages constitue la navigation du wiki. Le navigateur affiche la page pour les personnes, et [MCP](page:69499) expose les mêmes nœuds aux agents.

<!-- block:69537 -->
### Les niveaux de titre viennent de l’arbre

Un bloc placé directement sous une page s’affiche en h2 ; un bloc placé sous celui-ci, en h3. Un titre saisi dans un corps Markdown n’a pas de nœud à lui, et les outils le refusent donc. Chaque section est un bloc à part entière : elle apparaît dans le sommaire de la page et peut recevoir un lien direct.

<!-- block:69535 -->
## Ce que les nœuds apportent

Chaque nœud a un identifiant stable, un nœud parent et son propre historique des modifications.

<!-- block:69538 -->
### Les liens survivent aux renommages

Une référence `block:N` utilise l’identifiant stable du nœud. Renommer, réécrire ou déplacer ce nœud laisse le lien intact.

<!-- block:69539 -->
### Les liens entrants sont automatiques

Comme les liens visent des identifiants de nœuds, Wikilayer peut lister les pages qui pointent vers un nœud. La liste apparaît sur la page et dans son document Markdown assemblé.

<!-- block:69540 -->
### Un déplacement emporte le sous-arbre

`move_node` change le nœud parent d’un nœud. Ses descendants le suivent, et leurs niveaux de titre s’adaptent à la nouvelle profondeur. Une clé `sort_key` place le nœud parmi ses frères sans modifier leur corps. `migrate` peut déplacer un sous-arbre vers un autre wiki lorsqu’aucun lien ne franchirait la limite du wiki.

<!-- block:69541 -->
### L’historique appartient à chaque nœud

Chaque nœud conserve ses propres versions et son `updated_at`. Modifier un bloc ajoute une entrée d’historique pour ce bloc sans toucher à ses voisins.

<!-- block:69542 -->
### Le plan évite de lire tout le wiki

`get_outline` cartographie un wiki par ses titres, ses identifiants et ses nombres de tokens, sans transmettre tous les corps.

<!-- block:69543 -->
### Les liens relient les branches

L’arbre donne à chaque nœud un seul nœud parent. Les références courtes relient des nœuds apparentés ailleurs dans le wiki, et les liens entrants montrent les connexions inverses sans dupliquer le contenu.

<!-- block:69536 -->
## Lecture et export

<!-- block:69544 -->
### Une page se lit comme un seul document

Le navigateur affiche une page avec ses sections dans l’ordre. `get_page_markdown` renvoie la même page à un agent, avec avant chaque nœud un commentaire qui porte son identifiant. Les wikis publics proposent aussi le document assemblé sous forme de [vue Markdown](page:69491).

<!-- block:69545 -->
### Le contenu est portable

Un [export de wiki](page:69489) contient son Markdown, ses fichiers et sa structure, si bien que le contenu peut être conservé hors de Wikilayer.

---

## Links here

- [Manuel Wikilayer](/smee-again/wikilayer-howto/fr)
- [Markdown](page:69498)
- [Vue Markdown](page:69491)

---

[All pages](https://wikilayer.org/smee-again/wikilayer-howto/fr/index.md)
