Verzweigungen

9 min read

Was ist eine Verzweigung?

Die Verzweigung dient dazu, mehrere Versionen von zusammenhängenden Inhalten zu erstellen. Diese Funktion ähnelt dem Kopieren, ist aber umfangreicher und bietet Ihnen mehr Möglichkeiten, mit Ihren Inhalten zu arbeiten. Mit einem Zweig erstellen Sie eine neue Version einer Publikation oder eines Topics, der sich wie eine Kopie verhält, von der Paligo jedoch weiß, dass er mit der Originalversion in Verbindung steht. Das bedeutet, dass das Original und der Zweig separat als parallele Versionen verwendet werden können oder später wieder zu einer einzigen Version zusammengeführt werden können. Wählen Sie einen der beiden Verzweigungsmodi von Paligo, siehe Verzweigungsmodus auswählen.

Mit einem Zweig erstellen Sie eine neue Version einer Publikation oder eines Topics. Diese neue Version verhält sich wie eine Kopie, aber Paligo erkennt, dass sie mit der Originalversion verwandt ist. Je nach Ihren Anforderung können Sie Folgendes tun:

  • Originalversion und verzweigte Version separat als Parallelversion verwenden

  • Führen Sie das Original und die verzweigte Version später wieder zu einer einzigen Version zusammen.

In der folgenden Abbildung wurde beispielsweise das Benutzerhandbuch „Acme HomeHub“ verzweigt. Das Original (1) und die verzweigte Version (2) existieren beide als separate Publikationen mit getrennten Topics. Sie können sie weiterhin als separate Versionen verwenden oder sie zu einer Publikation zusammenführen.

1 = Original, 2 = Verzweigte Version

Dies ist nur eine Möglichkeit, Verzweigungen zu verwenden. Sie könnten auch verzweigte Publikationen mit wiederverwendeten Topics oder eine Mischung aus wiederverwendeten und eindeutigen Topics haben. Es gibt unzählige Möglichkeiten.

Tipp

Verzweigungen vorsichtig verwenden. Es ist eine leistungsstarke Funktion, die Ihnen helfen kann, Zeit zu sparen, indem Sie verschiedene Versionen von Inhalten erstellen und zusammenführen. Aber ohne sorgfältige Planung kann es auch dazu führen, dass Ihre Inhalte zu kompliziert und schwieriger zu verwalten sind. Wir empfehlen Ihnen, überkomplizierte Verzweigungsstrukturen zu vermeiden.

Was passiert, wenn ein Zweig erstellt wird?

Wenn Sie einen Zweig in Paligo erstellen, variiert das Ergebnis je nach:

  • der Art des Inhalts, den Sie verzweigen.

  • den Zweigoptionen, für die Sie sich entscheiden.

  • dem Ort, an dem der Zweig erstellt wird. Die Verzweigung eines Topics aus dem Content Manager unterscheidet sich von der Verzweigung eines Topics aus der Strukturansicht.

Wir erklären auch, wie mit der Wiederverwendung von Inhalten, Querverweisen und Bildern bei der Verzweigung von Inhalten umgegangen wird.

Neuer Publikationszweig

Sie können einen Zweig für eine Publikation erstellen (siehe ???). Wenn Sie dies tun, wird Paligo:Zweige erstellen

  • einen Zweig der Publikation erstellen.

  • Ihnen die Wahl lassen, wie Sie wiederverwendete Publikationen behandeln möchten.

    Bei der automatischen Erstellung von Zweigen erstellt Paligo verzweigte Versionen aller wiederverwendeten Publikationen, jedoch nur für diejenigen, die sich auf der obersten Ebene der Originalpublikation befinden. Wenn es wiederverwendete Publikationen gibt, die auch wiederverwendete Publikationen niedrigerer Ebenen enthalten, werden diese nicht automatisch verzweigt.

    Wenn Sie keine automatische Verzweigung verwenden, verwendet Ihre verzweigte Publikation die Originalversionen aller wiederverwendeten Publikationen (Unterpublikationen).

  • Ihnen die Wahl lassen, wie Sie wiederverwendete Topics behandeln möchten.

    Wenn Sie sich für die automatische Verzweigung entscheiden, erstellt Paligo eine verzweigte Version jedes Topics in der Publikation. Alle Änderungen, die Sie in den verzweigten Topics vornehmen, haben keine Auswirkungen auf andere Zweige oder Publikationen.

    Wenn Sie die automatische Verzweigung nicht verwenden, erstellt Paligo nur einen Zweig der Publikation, aber nicht ihrer Topics. In der verzweigten Publikation werden die ursprünglichen Versionen der Topics wiederverwendet.

    Anmerkung

    Die automatische Verzweigung von Topics ist für bestimmte Szenarien gedacht, und in den meisten Fällen empfehlen wir Ihnen, sie zu deaktivieren (Haken in Kontrollkästchen entfernen). Der Grund dafür ist, dass die automatische Verzweigung zu unnötigen Zweigen von Topics führen kann, bei denen die Wiederverwendung von Topics sinnvoller wäre.

Neuer Topiczweig aus einer Publikationsvergabelung

Wenn Sie einen neuen Zweig für ein Topic erstellen und den Zweig aus der „Gabelung“ in der Publikationsstruktur erstellen, wird Paligo:Zweige erstellen

  • einen Zweig des Topics erstellen.

  • die Publikationsgabelung so einstellen, dass sie auf die verzweigte Version des Topics verweist, anstatt auf die ursprüngliche Version des Topics.

  • das ursprüngliche Topic auf Textfragmente überprüfen, die wiederverwendet werden. Diese Textfragmente werden auch in der verzweigten Version des Topics wiederverwendet, sodass die IDs identisch sind. Wenn Sie diese in der verzweigten Version ändern, werden diese Änderungen auch in allen anderen Topics, in denen diese Textfragmente verwendet werden, übernommen.

  • das ursprüngliche Topic auf alle Textfragmente überprüfen, die nicht wiederverwendet werden. Dabei handelt es sich um „reguläre“ Absätze und Inhaltsstrukturen, denen Paligo in der verzweigten Version neue IDs zuweist. Wenn Sie sie also in der verzweigten Version ändern, haben Ihre Änderungen keine Auswirkungen auf den ursprünglichen Zweig.

  • das ursprüngliche Topic auf alle wiederverwendeten Komponenten überprüfen, z. B. Topics, die in andere Topics eingefügt wurden. Diese Komponenten werden auch in der verzweigten Version wiederverwendet und erhalten daher keine neuen IDs.

  • das ursprüngliche Topic auf Verweise auf andere Dateien, wie z. B. Bilder, überprüfen. Die verzweigte Version verwendet dieselben Dateien wie die ursprüngliche Version. Paligo erstellt keine neue, separate Datei. Wenn das ursprüngliche Topic beispielsweise ein Bild enthält, enthält die verzweigte Version dasselbe Bild (sie verweisen beide auf dieselbe Bilddatei in der Medienbibliothek). Wenn Sie das Bild bearbeiten, werden diese Änderungen überall dort übernommen, wo das Bild verwendet wird.

Neuer Topiczweig aus einem Topic

Wenn Sie einen neuen Zweig von einem Topic im Content Manager erstellen (und nicht von einer Gabelung in der Publikationsstruktur), wird Paligo:Zweige erstellen

  • einen Zweig des Topics erstellen.

    Der Zweig ist ein eigenständiger Zweig und wird in keiner Publikation verwendet. Alle Publikationen, die das Topic verwenden, verwenden weiterhin die Originalversion.

  • das ursprüngliche Topic auf Textfragmente überprüfen, die wiederverwendet werden. Diese Textfragmente werden auch in der verzweigten Version des Topics wiederverwendet, sodass die IDs identisch sind. Wenn Sie diese in der verzweigten Version ändern, werden diese Änderungen auch in allen anderen Topics, in denen diese Textfragmente verwendet werden, übernommen.

  • das ursprüngliche Topic auf alle Textfragmente überprüfen, die nicht wiederverwendet werden. Dabei handelt es sich um „reguläre“ Absätze und Inhaltsstrukturen, denen Paligo in der verzweigten Version neue IDs zuweist. Wenn Sie sie also in der verzweigten Version ändern, haben Ihre Änderungen keine Auswirkungen auf den ursprünglichen Zweig.

  • das ursprüngliche Topic auf alle wiederverwendeten Komponenten überprüfen, z. B. Topics, die in andere Topics eingefügt wurden. Diese Komponenten werden auch in der verzweigten Version wiederverwendet und erhalten daher keine neuen IDs.

  • das ursprüngliche Topic auf alle wiederverwendeten Komponenten überprüfen, z. B. Topics, die in andere Topics eingefügt wurden. Diese Komponenten werden auch in der verzweigten Version wiederverwendet und erhalten daher keine neuen IDs.

  • das ursprüngliche Topic auf Verweise auf andere Dateien, wie z. B. Bilder, überprüfen. Die verzweigte Version verwendet dieselben Dateien wie die ursprüngliche Version. Paligo erstellt keine neue, separate Datei. Wenn das ursprüngliche Topic beispielsweise ein Bild enthält, enthält die verzweigte Version dasselbe Bild (sie verweisen beide auf dieselbe Bilddatei in der Medienbibliothek). Wenn Sie das Bild bearbeiten, werden diese Änderungen überall dort übernommen, wo das Bild verwendet wird.

Wiederverwendete Inhalte in Zweigen

Wenn Sie Inhalte in Ihren Publikationen und Topics wiederverwendet haben, geht Paligo folgendermaßen vor, wenn Sie einen neuen Zweig erstellen:Zweige erstellen

  • Textfragmente

    Paligo überprüft das ursprüngliche Topic auf eventuell wiederverwendete Textfragmente. Diese Textfragmente werden auch in der verzweigten Version des Topics wiederverwendet, sodass die IDs identisch sind. Wenn Sie diese in der verzweigten Version ändern, werden diese Änderungen auch in allen anderen Topics, in denen diese Textfragmente verwendet werden, übernommen.

    In der verzweigten Version gibt Paligo nur den Textfragmenten neue IDs, die in der ursprünglichen Version nicht wiederverwendet wurden.

  • Komponenten

    Paligo überprüft das ursprüngliche Topic auf wiederverwendete Komponenten, wie z. B. ein Topic, das in ein anderes Topic eingefügt wurde. Diese Komponenten werden auch in der verzweigten Version wiederverwendet. Wenn Sie sie in der verzweigten Version ändern, werden diese Änderungen auch in allen anderen Topics, in denen diese Komponenten verwendet werden, übernommen.

  • Wiederverwendete Publikationen innerhalb einer Publikation

    Wenn Sie eine Publikation verzweigen, die wiederverwendete „Unterpublikationen“ enthält, können Sie Paligo so einstellen, dass automatisch Zweige für die wiederverwendeten Publikationen erstellt werden.

    Wenn Sie beispielsweise eine Publikation „Dokumentation“ haben, die die Unterpublikation „Erste Schritte“ enthält, können Sie „Dokumentation“ verzweigen und Paligo so einstellen, dass auch die Unterpublikation „Erste Schritte“ automatisch verzweigt wird. Der resultierende Zweig „Dokumentation“ würde die verzweigte Version der Unterpublikation „Erste Schritte“ enthalten.

    Weitere Informationen finden Sie unter ???.Zweige erstellen

Querverweise in Zweigen

Wenn Sie einen Querverweis auf eine Verzweigung einfügen müssen, sollten Sie in der Regel auf die Originalversion des Topics und nicht auf die Verzweigung verweisen. Wenn Sie etwas veröffentlichen, versteht Paligo, dass der Querverweis auf die Version des Topics verweisen sollte, die in der Publikation vorhanden ist.

Bei Publikationen, die mehrere Versionen desselben Topics oder Verzweigung enthalten, sollten Sie sicherstellen, dass Querverweise auf die entsprechende Verzweigung verweisen.

Weitere Informationen finden Sie unter Querverweis zu einer Verzweigung hinzufügen.

Abbildungen in Zweigen

Wenn Sie ???, prüft Paligo, ob die Originalversion des Topics Abbildungen enthält. Ist dies der Fall, behält Paligo die gleichen Verweise auf die Bilddatei in der verzweigten Version bei. Paligo erstellt keine verzweigte Version der Bilddatei.Zweige erstellen

Wenn Sie eine Abbildung bearbeiten, werden diese Änderungen überall dort übernommen, wo diese Abbildung verwendet wird, also auch in anderen Zweigen.

Wenn Sie eine verzweigte Version eines Topics in Kombination mit einem anderen Bild verwenden möchten, fügen Sie die neue Abbildung zur Medienbibliothek hinzu und anschließend in das verzweigte Topic ein.

Wie Sie Abbildungen hinzufügen können, erfahren Sie unter Ein Bild hinzufügen.

Zweige zusammenführen

Beim Zusammenführen wird eine Version einer Verzweigung mit einer früheren Version zusammengeführt. Beim Zusammenführen haben Sie die Möglichkeit, alles zusammenzuführen oder Sie können die Unterschiede zwischen den Verzweigungen vergleichen und auswählen, welche Teile Sie zusammenführen möchten.

Nehmen wir zum Beispiel an, Sie haben ein Topic zum Thema „Temperatursensoren“ und verzweigen es in zwei verschiedene Topics. Sie haben nun das ursprüngliche Topic „Temperatursensoren“ und eine verzweigte Version davon. Diese Zweige sind völlig unabhängig voneinander, und Sie haben nun folgende Möglichkeiten:

  • Lassen Sie die verschiedenen Zweige gleichzeitig in Paligo als separate, aber zusammenhängende Publikationen oder Topics existieren.

  • Führen Sie die Zweige zu einer einzigen Publikation oder einem einzigen Topic zusammen (das Ergebnis einer Zusammenführung wird als „einzelner Zweig“ bezeichnet).

  • Führen Sie Teile der Zweige zusammen. Die Zweige existieren weiterhin gleichzeitig als separate Publikationen oder Topics, aber einige ihrer Inhalte werden zusammengeführt, sodass sie in allen Versionen identisch sind. Sie können wählen, welche Teile Sie zusammenführen möchten und welche Teile getrennt bleiben sollen.

Paligos Dialogfeld „Dokument zusammenführen“. Verwenden Sie diese Option, um alle Unterschiede zusammenzuführen, oder wählen Sie bestimmte Unterschiede aus, die zusammengeführt werden sollen.

Das Verfahren, mit dem das Zusammenführen verwaltet wird, unterscheidet sich geringfügig, je nachdem, ob Sie Einen Topic-Zweig zusammenführen oder Einen Publikationszweig zusammenführen möchten.

Anmerkung

Das Zusammenführen von Zweigen hat keine Auswirkungen auf das Mapping, das Sie für die Publikation in anderen Systemen wie Zendesk und Salesforce eingerichtet haben. Wie Paligo die IDs der Inhalte verwaltet, erfahren Sie unter Was passiert, wenn ein Zweig zusammengeführt wird?.

Was passiert, wenn ein Zweig zusammengeführt wird?

Wenn Sie eine verzweigte Publikation oder ein verzweigtes Topic zusammenführen, verschiebt Paligo Änderungen, die in einem Zweig vorgenommen wurden, in eine andere Version des Inhalts. Wenn Sie sich beispielsweise dafür entscheiden, einen Zweig mit der Quellversion zusammenzuführen, platziert Paligo den Inhalt aus dem Zweig in der Quellversion.

Sie wählen aus, welche Teile des Inhalts aktualisiert, hinzugefügt oder entfernt werden, wenn Sie den Zusammenführungsprozess einrichten (siehe Zweige zusammenführen. Paligo verfügt über ein Dialogfeld zur Zusammenführung, in dem Sie sehen können, was in die Publikation /das Topic die bzw. das den zusammengeführten Inhalt erhält, aufgenommen wird.

Das Dialogfeld zeigt die verschiedenen Versionen und eine Vorschau des Endergebnisses an:

  • Der Zweig „Zusammenführen von“ enthält den Inhalt, der zur Aktualisierung des Zweigs „Zusammenführen nach“ verwendet wird.

  • Der Zweig „Zusammenführen nach“ erhält die Änderungen, die während des Zusammenführens vorgenommen wurden.

Wenn bei der Zusammenführung ein neues Element, z. B. ein Absatz, zur Version „Zusammenführen nach“ hinzugefügt wird, verwendet das neue Element seine ID aus der Version „Zusammenführen von“. Der Inhalt von „Zusammenführen nach“ erhält also ein neues Element mit einer neuen ID.

Wenn bei der Zusammenführung ein vorhandenes Element in der Version „Zusammenführen nach“ aktualisiert wird, behält der Inhalt seine ursprüngliche ID. Die ID aus der Version „Zusammenführen von“ wird ignoriert. Dies gilt sowohl für die ID der Publikation und der Topics als auch für die einzelnen Komponenten für Absätze, Listen usw.

Anmerkung

Da Paligo die ursprüngliche ID für bereits vorhandene Inhalte beibehält, bedeutet dies, dass das Zusammenführen keine Mappings stört, die Sie für die Publikation in Supportsystemen wie Zendesk-Integration und Salesforce Knowledge-Integration eingerichtet haben.