Unir varios documentos

Amaya te permite gestionar colecciones de documentos. Una colección puede, por ejemplo, ser una documentación técnica dividida en varias páginas web. Una de las páginas web contiene el título de la documentación completa (un elemento <h1>), una introducción (otros elementos) y una lista <ol> o <ul> cuyos items <li> contienen enlaces a cada capítulo. Los capítulos son documentos separados que pueden tener una estructura similar.

Esta organización es adecuada para su navegación, pero resulta incómoda cuando quieres imprimir toda la documentación. Amaya resuelve el problema con el comando Hacer libro (XHTML>Hacer libro).

Para enlazar capítulos, tipifica los enlaces asociándoles el atributo rel="chapter" o rel="subdocument" al ancla que apunta al capítulo (para ello, selecciona el elemento a y utiliza el menú Atributos.

Cada capítulo o subdocumento enlazado puede ser:

• un documento externo
• un subconjunto de un documento externo mayor

Para hacer referencia a un subconjunto de un documento, normalmente debe definir un elemento div para identificar la parte del documento destino que quieres incluir y enlazar a este elemento.

Al utilizar el comando Hacer libro, los bloques (los elementos <li> en el ejemplo anterior) que contienen un enlace tipificado a un capítulo se sustituirán por las páginas web correspondientes (o por los subconjuntos de páginas web) y Amaya mostrará un único documento que contiene toda la colección

• Si el enlace apunta a una página web, Amaya incluye todo el contenido de body del documento destino.
• Si el enlace apunta a un elemento destino, Amaya incluye el elemento y su contenido.
• Si el enlace apunta a un ancla destino, Amaya incluye el contenido del ancla, pero no la propia ancla.

Antes de cada sustitución, el comando Hacer libro genera un nuevo elemento div con su atributo id para separar claramente cada porción añadida.

Las porciones añadidas en el documento generado pueden contener enlaces normales, anclas destino y elementos destino. Mientras se hace el libro, Amaya se asegura de que cada atributo name e id tienen un valor único en el nuevo documento. Cuando es necesario, Amaya cambia esos valores y actualiza los enlaces.

Al mismo tiempo, Amaya actualiza automáticamente los enlaces externos a los documentos o subdocumentos incluidos, cambiándolos a enlaces internos al texto incluido. Por ejemplo, si un enlace apuntaba a un documento externo, el enlace apuntará ahora al elemento div creado con el comando Hacer libro. Esto asegura que el documento que contiene toda la documentación es coherente.

Este documento puede a continuación numerarse e imprimirse con su tabla de contenido y la lista de todos los enlaces.