Un document est composé d'un ou plusieurs blocs. Un bloc correspond à peu près à une page html, mais il est aussi possible d'insérer un ou plusieurs blocs dans un autre.

Chaque bloc doit avoir un nom (un mot unique) et un titre. Le point d'entrée du document est un bloc sous le nom main. C'est ce bloc qui conduira les lecteurs au contenu entier du document.

### Création d'un bloc

Pour créer un nouveau bloc (excepté le bloc d'entrée main), vous devez d'abord le citer dans un bloc existant. Quand vous lisez ce dernier bloc, la citation deviendra un lien qui vous conduit à la création du nouveau bloc.

Il y a trois façons pour un bloc d'en citer un autre.

1. Par un lien. \link{link,La syntaxe du lien} est très simple : il suffit de donner le nom du bloc cité.
   On peut aussi utiliser des liens pour citer des blocs d'autres documents.
2. Comme une partie pliable du bloc citant. Cette partie peut être dépliée ou repliée à volonté par le lecteur. \link{fold,La syntaxe}.
3. Comme une partie intégrante de la page du bloc citant. L'insertion est transparente au lecteur. \link{embed, La syntaxe}.

### Champs "précédent", "suivant" et "parent" d'un bloc

Dans les champs "précédent", "suivant" et "parent" de chaque bloc, on écrit le nom d'un bloc du document. Ces champs servent

- à définir la structure du document ;
- à proposer un ordre de lecture de l'ensemble des pages du document (en utilisant la flèche Suiv par exemple, le lecteur passera au bloc suivant du bloc où il se trouve, la flèche Sup lui permettra de remonter au bloc "parent" du bloc qu'il lit) ;
- à fixer les blocs qui apparaitront dans la version imprimable du document : la version imprimable ne se déroule pas selon l'ordre de navigation défini par les champs "précédent" et "suivant". Les blocs apparaissent dans la version imprimable si et seulement s'il y a un lien vers eux dans leur bloc parent et ils apparaissent dans l'ordre des liens (la version imprimable est utile par exemple pour faire une recherche d'un mot dans un document).