# Eine Dokumentensammlung erstellen

Mit Amaya kann man Dokumentensammlungen handhaben. Solch eine Sammlung kann beispielsweise ein Satz technischer Dokumentation sein, die durch mehrere Dokumente repräsentiert wird. Eine dieser Seiten enthält den Titel des ganzen Dokumentensatzes (das Element `h1`), eine Einführung (einige andere Elemente) und eine Liste, geordnet und/oder ungeordnet, deren Einträge Verweise auf jedes Kapitel darstellen. Kapitel sind separate Dokumente, die die gleiche Struktur haben können.

Diese Organisation ist beim Browsen hilfreich hat aber mehrere Nachteile, wenn der Dokumentensatz gedruckt werden soll. Amaya stellt hierzu die Funktion Buch erstellen im Menü Extras bereit.

Man verwendet Verweise um Kapitel oder Abschnitte eines Dokuments oder das ganze Dokument selbst zu verknüpfen. Diese werden in den Attributen `rel="Kapitel"`, `rel="Abschnitt"` oder `rel="Unterdokument"` mit den Verweiszielen, die sich auf ein Kapitel oder Abschnitt beziehen verknüpft.

Jedes Kapitel oder jeder Abschnitt, auf die man sich bezieht, kann ein

- externes Dokument oder eine
- Abschnitt eines großen, externen Dokuments

sein.

Um sich auf einen Abschnitt zu beziehen, setzt man gewöhnlich das Element `div` ein, der den Teil des Dokuments identifiziert, welchen man einfügen möchte und um dieses Zielelement zu verknüpfen (es muss das Attribut `id` haben).

Aktiviert man dann die Funktion Buch erstellen, dann werden alle Blockelemente, die einen Verweis auf ein Kapitel oder einen Abschnitt haben (im Verweis existiert das Attribut `rel`) durch die entsprechenden Dokumente (oder Teile davon) ersetzt. Amaya zeigt dann das so erstellte, gesammte Dokument an, welches aus der Zusammenstellung der einzelnen Dokumente besteht:

- Bezieht sich der Verweis auf ein Dokument, dann fügt Amaya den gesammten Inhalt von dessem `body`-Element ein.
- Bezieht sich der Verweis auf ein Zielelement, dann fügt Amaya dieses Element und dessen gesammten Inhalt ein.
- Bezieht sich der Verweis auf einen Anker, dann fügt Amaya dessen Inhalt, nicht aber den Anker selbst ein.

Vor dem Einfügen wird von Amaya im so erstellten Dokument ein neues `div`-Element mit dem Attribut `id` erzeugt, um jedes eingefügte Teil klar unterscheiden zu können.

Die eingefügten Teile können selbst Verweise, Anker und Ankerelemente enthalten. Amaya stellt, während der Zusammenstellung eines Buches sicher, dass jedes `name`- und `id`-Attribut in der Zusammenstellung unterscheidbar bleibt. Hierbei wird gegebenenfalls dessen Wert geändert und der entsprechende Verweis aktualisiert.

Zur gleichen Zeit werden Verweise, welche sich auf ein externes Dokument oder einen Abschnitt davon beziehen so geändert, dass sie nun auf die eingefügte, mittels eines `div`-Elements eingeschlossene Textstelle verweisen. Dies stellt sicher, dass das zusammengestellte Dokument kohärent bleibt.

Dieses große Dokument kann dann durchnumeriert und mit einem Inhaltsverzeichnis und einer Liste aller Verweise gedruckt werden.