Editionen ermöglichen es, Wiki-Seiten gesammelt für eine bestimmte Dokumentenversion zu pflegen. Dies ist nützlich zum Beispiel für Software-Dokumentation, bei der es oft sinnvoll ist, parallele Seitenversionen für verschiedene Software-Versionen zu pflegen.
Was ist eine Edition?[Bearbeiten | Quelltext bearbeiten]
Viele Teams dokumentieren ein Produkt, von dem gleichzeitig mehrere Versionen existieren. Während Version 1.0 noch im Einsatz ist, wird bereits an Version 2.0 gearbeitet. Ein einzelner Satz von Seiten kann nicht beide Versionen beschreiben.
ContentEditions verwendet hierfür sogenannte „Editionen“. Eine Edition ist eine Zusammenstellung von Seiten, die zu einem bestimmten Zeitpunkt aus dem Arbeitsbereich (Working Area) kopiert wurden. Jede Edition befindet sich in einem eigenen Namensraum
(Namespace), zum Beispiel Version_1.0:, sodass sich ihre Seiten niemals mit denen einer anderen Edition vermischen. Seiten einer Edition behalten ihren eigenen Textinhalt, selbst wenn jemand später dieselbe Seite im Arbeitsbereich oder in einer anderen Edition ändert.
Der Arbeitsbereich ist der Ort, an dem Sie täglich die aktuelle Dokumentation bearbeiten. Er ist keine Edition. Sobald die Inhalte fertig sind, kann eine Person mit entsprechenden Berechtigungen diese in eine neue Edition kopieren.
Eine Edition befindet sich immer in einem von drei Zuständen: Geplant, Veröffentlicht oder Archiviert.
Geplant bedeutet, dass sich die Inhalte in der Vorbereitung befinden. Veröffentlich bedeutet, dass sie den Lesern zur Verfügung gestellt wurden. Archiviert bedeutet, dass die Inhalte nicht mehr aktiv genutzt, aber weiterhin lesbar sind.
Das Banner[Bearbeiten | Quelltext bearbeiten]
Wenn Sie eine Seite innerhalb einer Edition aufrufen, zeigt Ihnen ein Banner am oberen Rand an, wo Sie sich befinden. Dort steht beispielsweise: „Diese Seite gehört zur Edition ‚1.0‘ (Veröffentlicht, neueste Edition).“ Es werden der Name der Edition sowie deren Zustand angegeben. Handelt es sich um die neueste Edition, wird dies ebenfalls vermerkt. Das Banner wird nicht angezeigt, wenn Sie die Seite bearbeiten oder deren Historie einsehen.
Das Banner enthält zudem den Editionswechsler (mit der Beschriftung „Edition wechseln“). Über diesen können Sie dieselbe Seite in einer anderen Edition aufrufen.
Links im Text einer Seite innerhalb einer Edition verweisen auf Seiten derselben Edition, sofern dort eine Kopie des Zielinhalts existiert. Andere Links behalten ihr ursprüngliches Ziel bei. Bei Vorlagen (Templates) verhält es sich genauso: Verfügt eine Edition über eine eigene Kopie einer Vorlage, so verwendet die Seite diese spezifische Kopie.
Die "Aktuell"-Adresse[Bearbeiten | Quelltext bearbeiten]
Leser suchen häufig nach „der aktuellen Dokumentation“ und nicht nach einer spezifischen Edition. Hierfür gibt es die „Aktuell:“-Adresse. Die Adresse Latest:Installation verweist auf die Seite Installation der aktuellsten Edition. Sobald die Seite geladen ist, zeigt Ihr Browser die Adresse der tatsächlichen Seite an, zum Beispiel
Version_1.0:Installation. Ein Hinweis weist darauf hin: „(Weitergeleitet von Aktuell:Installation)“.
