## Assembler des collections de document

Amaya vous permet de manipuler des collections de document. Une telle collection peut, par exemple, représenter une documentation technique constituée de plusieurs pages web. Une de ces pages contient le titre de toute la documentation (un élément `H1`), une introduction (d'autres éléments), et une liste (`OL` ou `UL`) dont les items contiennent les liens vers chaque chapitre. Les chapitres sont des documents séparés qui peuvent aussi avoir le même type de structure.

Une telle organisation est utile pour naviguer, mais elle a un certain nombre d'inconvénients lorsque la totalité de la documentation doit être imprimée. Amaya règle ce problème à l'aide de la fonction "construire un livre". Il vous suffit d'utiliser les liens tapés pour lier les chapitres : associez un attribut `rel="chapter"` ou `rel="subdocument`" à l'ancre lien (sélectionnez l'élément `A` et utilisez le menu Attributs).

Chaque chapitre ou sous-document référé peut être :

- soit un document entier externe.
- soit une sous-partie d'un document entier externe.

Pour référencer une sous-partie d'un document, la méthode habituelle est de définir un élément DIV qui délimite la partie du document cible que vous voulez inclure et lier à cet élément cible.

Ensuite, lorsque vous activez la fonction "construire un livre", tous les blocs (éléments `LI` dans l'exemple plus haut) contenant un lien vers un chapitre seront remplacés par les pages Web correspondantes (ou sous-parties de pages Web). Vous obtiendrez ainsi un unique document contenant la totalité de la collection :

- Quand un lien référence une page Web, tout le contenu BODY du document cible est inclus.

- Si le lien référence un élément cible, cet élément et son contenu sont inclus.

- Si le lien référence une ancre cible, le contenu de l'ancre cible est incluse, mais l'ancre elle-même ne l'est pas.

Avant chaque remplacement, la fonction "construire un livre" engendre un nouvel élément DIV avec un attribut ID. Ainsi, toutes les parties ajoutées sont clairement séparées.

Les parties précédentes du nouveau document engendré peuvent contenir des liens, des ancres cibles et des éléments cibles. Pendant cette opération, Amaya vérifie que chaque valeur des attributs NAME et ID reste unique dans le nouveau document. Si besoin est, Amaya change ces valeurs et met à jour les liens relatifs. Au même moment, les liens externes sont automatiquement mis à jour quand ils se réfèrent à un document externe ou à un sous-document nouvellement inclus. Par exemple, si un lien pointe vers un document entier externe, ce lien référence l'élément incluant DIV parés l'opération. Ainsi, le nouveau document unique contenant la totalité de la collection reste cohérent.

Ce gros document peut être numéroté et impriméavec une table des matières complète et une liste de tous les liens.

Pour activer cet outil, choisissez l'item Construire un livre du menu XHTML.