Assembler des collections

Amaya

## Assembler des collections de documents

Pour activer cette fonctionnalité, choisissez l'entrée Construire un livre du menu Outils.

Amaya vous permet de manipuler des collections de documents. Une telle collection peut, par exemple, représenter une documentation technique constituée de plusieurs pages web. Ce manuel est une collection de documents.

Une des pages de la collection 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 (`li`) 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 commande Outils/Construire un livre. Il vous suffit d'utiliser les liens typés pour lier les chapitres : associez un attribut `rel="chapter"` ou `rel="subdocument`" à l'ancre lien (créez un lien et utilisez l'outil Attributs pour l'attribut `rel`).

Chaque chapitre ou sous-document peut être :

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

Pour référencer une partie d'un document, la méthode habituelle est de définir un élément `div` qui délimite la partie du document que vous voulez inclure vous créez un lien vers cet élément `div`.

Ensuite, lorsque vous activez la commande Outils/Construire un livre, tous les blocs (éléments `li` dans l'exemple ci-dessus) contenant un lien vers un chapitre seront remplacés par les pages Web correspondantes (ou les parties de pages Web). Vous obtiendrez ainsi un unique document contenant la totalité de la collection :

- Si le lien référence une page Web entière, tout le contenu de l'élément `body` du document cible est inclus.

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

- Si le lien référence une ancre cible (élément `a`), le contenu de l'ancre cible est inclus, mais l'ancre elle-même ne l'est pas.

Avant chaque remplacement, la commande Construire un livre engendre un nouvel élément `div` avec un attribut `id`. Ainsi, toutes les parties incluses sont clairement séparées.

Les parties 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.

Les liens externes sont automatiquement mis à jour quand ils se réfèrent à un document externe ou à un e partie de document nouvellement inclus. Par exemple, si un lien pointe vers un document entier externe, ce lien référencera l'élément `div` engendré par la commande Construire un livre. Ainsi, le nouveau document unique contient la totalité de la collection avec l'ensemble de ses liens.

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