Skip to main content

Unterabschnitte mit Chunking steuern

Mit der Chunking-Funktion von Paligo legen Sie fest, ob ein Topic als Unterabschnitt oder als separate Webseite in der HTML-/HTML5-Ausgabe erscheinen soll. Der Begriff „Chunk“ bedeutet, dass ein Topic für sich allein stehen muss. Die Einstellungen für xinfo:chunk in einem Topic wirken sich wie folgt aus:

  • Ja – das Topic darf kein Unterabschnitt innerhalb eines anderen Topics sein und erscheint bei Veröffentlichung stets auf einer separaten Seite. Es darf kein Unterabschnitt auf einer anderen Seite sein.

  • Nein – das Topic darf ein Unterabschnitt innerhalb eines anderen Topics sein.

Anmerkung

Weitere Informationen zu Chunking-Einstellungen finden Sie unter Chunking.

So stellen Sie den Chunking-Wert ein:

  1. Wählen Sie das Topic oder die Komponente im Content Manager aus, um es/sie im Editor zu öffnen.

    Content Manager in Paligo. It shows the Documents section contains an Acme 100 Topics folder. Inside the folder there is a publication and many topics, including "Connect to Network (100).

    Alternativ können Sie Topics erstellen und dieses bearbeiten.

  2. Wählen Sie das section-Element im Menü „Elementstruktur“ aus.

    Close up of Element Structure Menu. It shows the section element is selected and the Go to element option is selected.

  3. Wählen Sie Zu Element wechseln aus.

  4. Fügen Sie das Attribut xinfo:chunk im Panel „Elementattribute“ hinzu und setzen Sie dessen Wert auf:

    • Ja, um zu verhindern, dass das Topic als Unterabschnitt fungiert.

    • Nein, damit das Topic auch ein Unterabschnitt sein kann.

    Element attributes side panel. It shows the section element has an xinfo:chunk attribute that is set to yes.

  5. Drücken Sie Speichern. Save icon.

Wichtig

Der Wert xinfo:chunk hat Vorrang vor der Einstellung Chunk-Abschnittstiefe im Layout-Editor. Wenn Sie die Chunk-Abschnittstiefe beispielsweise auf 3 festlegen, bedeutet dies normalerweise, dass alle Topics auf Ebene 4 oder darunter zu Unterabschnitten des „übergeordneten“ Topics der Ebene 3 werden. Wurde für Ihr Topic der Ebene 4 jedoch xinfo:chunk = yes festgelegt, wird dieses Topic nicht als Unterabschnitt seines „übergeordneten“ Topics der Ebene 3 aufgenommen. Stattdessen wird es ein separates Topic sein.

Es gibt zwei Möglichkeiten, Chunking zu verwenden (diese sind auch miteinander kombinierbar):

  • Legen Sie im Layout-Editor unter „Inhaltsverzeichnis und Chunking“ die Standardebene fest, ab der Topics abgeschnitten werden sollen.

  • Fügen Sie dem section-Element in einem Topic über den Panel „Elementattribute“ das Attribut xinfo:chunk hinzu.

Beispiel 1. Chunk-Abschnittstiefe und xinfo:chunk gemeinsam verwenden

Angenommen, Ihre englischsprachige Publikation heißt „Mars Travel Manual“ und ist in Topics strukturiert, die sich auf verschiedenen Ebenen befinden.

Image shows structure view of Mars Travel Manual publication. There are topics in the publication and some are at the top-level, some are at the second level, and some are at the third level.

Sie veröffentlichen in HTML5 und haben die Chunk-Abschnittstiefe für Ihr Layout auf 2 festgelegt.

HTML5 layout with the Chunk section depth option set to 2.

In der veröffentlichten Ausgabe erscheinen die Topics der ersten und zweiten Ebene auf getrennten Seiten. Die Seiten der dritten Ebene oder tiefer sind Unterabschnitte.

A publication structure with 3 tiers. At the top is a topic called "The Mission Control Center" and is it labelled as 1. At the next level down is a topic called "Command Center" and it is labelled as 2. At the next level down are two more topics and these are labelled as 3.

Beispielsweise werden das Topic „The Mission Control Center“ sowie dessen untergeordnete Topics in der Ausgabe wie folgt dargestellt:

  1. „The Mission Control Center“ ist ein Topic der obersten Ebene. Es ist höher als die Chunk-Abschnittstiefe von 2, daher hat es in der Ausgabe seine eigene Seite.

  2. „Command Center“ ist ein Topic der zweiten Ebene. Es befindet sich auf derselben Ebene (2) wie die eingestellte Chunk-Abschnittstiefe und wird in der Ausgabe ebenfalls auf einer eigenen Seite dargestellt.

  3. „Controls System“ und „Control Room“ sind Topics der dritten Ebene. Ihr Wert liegt unter der Einstellung für die Chunk-Abschnittstiefe von 2, sodass sie keine eigene Seite erhalten. Vielmehr sind sie Unterabschnitte des Topics „Command Center“, da dies der ihnen unmittelbar übergeordnete Abschnitt („Parent“) in der Publikationsstruktur ist.

Anmerkung

Die grüne Strichellinie im Bild steht für die eingestellte Chunk-Abschnittstiefe von 2.

Doch wenn Sie stattdessen möchten, dass „Controls System“ ein Unterabschnitt von „Command Center“ sein und „Control Room“ eine eigene Seite haben soll? Dann würden Sie zum Topic „Control Room“ folgendes Attribut hinzufügen:

xinfo:chunk = yes

Paligo platziert daraufhin das Topic „Controls System“ in der veröffentlichten Ausgabe auf einer eigenen Seite, da xinfo:chunk Vorrang vor den Chunk-Abschnittstiefe-Einstellungen hat. Im Ergebnis werden in der Ausgabe

  • die Topics „The Mission Control Center“ und „Command Center“ jeweils auf eigenen Seiten dargestellt, da ihre Ebene höher ist als die Chunk-Abschnittstiefe.

  • „Control Room“ steht auf einer separaten Seite, da hierfür xinfo:chunk=yes festgelegt wurde. Die Einstellung Chunk-Abschnittstiefe gilt nicht für dieses Topic.

  • „Controls System“ ist ein Unterabschnitt von „Command Center“, da er keine Einstellung xinfo:chunk=yes besitzt und daher die Chunk-Abschnittstiefe Anwendung findet.