Unterstützte Attribute

Paligo basiert auf DocBook 5.1 und unterstützt die meisten Attribute, die in diesem Content-Modell enthalten sind. Erfahren Sie mehr über DocBook 5.1. Zu berücksichten sind allerdings einige Unterschiede, nämlich dass in Paligo

das Element <article> für Publikations-Topics verwendet wird, siehe Unterstützte Info-Elemente,
<section> für Topics verwendet wird und
keine anderen Elemente auf Stamm-Ebene unterstützt werden, wie <book> oder <set>.

Achtung

Paligo unterstützt auch einige „interne Attribute“ wie xinfo:image, xinfo:resource und xinfo:text. Diese „internen Attribute“ werden von Paligo automatisch erstellt und gepflegt und dienen der Zuordnung von IDs zu Elementen. Sie sollten diese unberührt lassen.

Jedes Element verfügt über eine Reihe von Attributen, d. h. Eigenschaften, die die Eigenschaften des Elements definieren. Für jedes Attribut gibt es einen Wert, und durch Ändern des Werts können Sie beeinflussen, wie das Element in Paligo verwendet werden soll. Typische Einsatzgebiete sind:

Attribute filtern Einbeziehen oder Ausschließen von Inhalten, siehe Filterung/Profiling und ???.
width-Attribute zur Anpassung von Bildgrößen.
role-Attribute für verschiedene Features, einschließlich einklappbare Abschnitte und Hinzufügen von Klassennamen zu HTML, siehe role-Attributwerte.

Element attributes panel. The td element is selected and it has a style attribute. The value of the style attribute is set to background-color:bg1

Im vorstehenden Bild ist style das Attribut und background-color:bg1 ist dessen Wert.

Paligo unterstützt Attribute filtern sowie die folgenden Attribute:

Attribut	Beschreibung
Tiefe	Wird in `imagedata`-Elementen verwendet, um den Wert für die Bildtiefe (-höhe) im Verhältnis zum Ansichtsfenster einzustellen. Das Ansichtsfenster ist die Fläche, die für das `imageobject` zur Verfügung steht. Erfahren Sie mehr über Bildgrößenbestimmung.
contentdepth	Wird in `imagedata`-Elementen verwendet, um den Wert für die Bildtiefe (-höhe) einzustellen, und hat keine Auswirkungen auf das Ansichtsfenster. Das Ansichtsfenster ist die Fläche, die für das `imageobject` zur Verfügung steht. Erfahren Sie mehr über Bildgrößenbestimmung.
contentwidth	Wird in `imagedata`-Elementen verwendet, um den Wert für die Bildbreite einzustellen, und hat keine Auswirkungen auf das Ansichtsfenster. Das Ansichtsfenster ist die Fläche, die für das `imageobject` zur Verfügung steht. Erfahren Sie mehr über Bildgrößenbestimmung.
continuation	Für eine fortlaufende Nummerierung in Seitenleisten, siehe Verwenden von Nummerierungen in Seitenleisten.
label	Wird auf das `section`-Element eines Topics angewendet, um zu verhindern, dass es in einer PDF-Ausgabe nummeriert wird (ein Wert von `0` bedeutet keine Nummerierung).
language	Wird in `programlisting`-Elementen verwendet, um die Sprache für ein Codebeispiel einzustellen, siehe Syntax-Hervorhebung.
role	Für das role-Attribut werden spezifische Werte eingegeben, um eine bestimmte Funktionalität in Paligo zu erreichen, siehe role-Attributwerte
scalefit	Hiermit lässt sich die Größe eines Bildes an die jeweils verfügbare Fläche anpassen. Lautet der Wert `scalefit="1"`, wird das Bild skaliert (mit demselben Faktor für beide Dimensionen), sodass die Grafik nur innerhalb der verfügbaren Höhe oder Breite passt (je nachdem, was stärker einschränkt). Wird ein anderes Bildgrößenattribut angegeben, bestimmen diese Attribute die Grafikgröße, und `scalefit` wird ignoriert.
style	Legen Sie den Stil der Hintergrundfarben für einzelne Tabellenzellen (`td` oder `th`) für die PDF-Ausgabe fest, siehe Formatieren des Tabellenkörpers (PDF).
tabstyle	Gestalten Sie das `table`-Element mit kompakten Absatzabständen, siehe Festlegen des Absatzabstands von Tabellenzellen.
width	Wird in `imagedata`-Elementen verwendet, um den Wert für die Bildbreite width im Verhältnis zum Ansichtsfenster einzustellen. Das Ansichtsfenster ist die Fläche, die für das `imageobject` zur Verfügung steht. Erfahren Sie mehr über Bildgrößenbestimmung.
xinfo:appid	Wird bei der Einrichtung einer kontextsensitiven Hilfe auf das `section`-Element angewendet, siehe Kontextsensitive Hilfe. Das Präfix `@xinfo:` gibt an, dass es sich um ein Erweiterungsattribut handelt.
xinfo:chunk	Wird auf das `section`-Element angewendet, um Paligo anzuweisen, ein Topic in HTML-Ausgaben als separate Seite anzuzeigen, siehe Unterabschnitte erstellen. Das Präfix `@xinfo:` gibt an, dass es sich um ein Erweiterungsattribut handelt.
xinfo:keep-together	Dient zur Steuerung von Elementen über zwei Seiten in PDF-Ausgaben, siehe Weiche Seitenumbrüche. Das Präfix `@xinfo:` gibt an, dass es sich um ein Erweiterungsattribut handelt.
xinfo:keep-with-next	Dient zur Steuerung von Elementen über zwei Seiten in PDF-Ausgaben, siehe Weiche Seitenumbrüche. Das Präfix `@xinfo:` gibt an, dass es sich um ein Erweiterungsattribut handelt.
xinfo:outname	Wird im `section`-Element angewendet, um die URL für das Topic zu steuern, wenn es für HTML-Ausgaben in eine Seite konvertiert wird. Der von Ihnen eingegebene Wert wird als URL verwendet, siehe Dateinamen von Topics. Das Präfix `@xinfo:` gibt an, dass es sich um ein Erweiterungsattribut handelt.
xinfo:pagebreak	Zum Festlegen eines Seitenumbruchs in PDF-Ausgaben, siehe Harte Seitenumbrüche. Das Präfix `@xinfo:` gibt an, dass es sich um ein Erweiterungsattribut handelt.
xlink:href	Hiermit können Bilder als Links verwendet werden, siehe Bilder und andere Elemente in Links verwandeln.
xlink:show	Überschreibt das Standard-Linkverhalten für einzelne Links, siehe Individuelles Verknüpfungsverhalten aktualisieren.

Tipp

Informationen zum Hinzufügen eines Elementattributs finden Sie unter Attribute.

role-Attributwerte

Sie können für das role-Attribut spezifische Werte eingeben, um eine bestimmte Funktionalität in Paligo zu erzielen. Zu den zahlreichen Möglichkeiten zählt das Hinzufügen von Klassennamen zu HTML-Ausgaben, das Hinzufügen von besonders reaktionsschnellen Funktionen zu HTML-Tabellen oder die Steuerung von Seitenumbrüchen in PDF-Ausgaben.

Element attributes panel. The role attribute is added and it has a value of extra-responsive

Tipp

Wenn bereits ein role-Attribut vorhanden ist, trennen Sie die Werte mit einem Semikolon.

Die folgende Tabelle enthält die role-Attribute und -Werte, die Sie in Paligo verwenden können.

Attributwert	Beschreibung
accordion	Hiermit lassen sich Abschnitte (`section`) ein- und ausklappen. Der Abschnittstitel ist sichtbar und wenn der Benutzer darauf klickt, wird der Abschnitt erweitert, um den Inhalt anzuzeigen, siehe Akkordeons (einklappbare Abschnitte).
column-count	Dient zum Einstellen der Spaltenanzahl in einem `sidebar`-Element in PDFs, siehe Aktivieren mehrerer Spalten (PDF).
column-gap	Wird verwendet, um den Spaltenabstand in einem `sidebar`-Element für PDFs einzustellen, siehe Aktivieren mehrerer Spalten (PDF)).
extra-responsive	Dient in `table`-Elementen zum Hinzufügen einer festen Kopfleiste („Sticky Header“) und von Spaltenfiltern zu Tabellen für HTML5-Ausgaben, siehe Aktivieren des Spaltenfilters und des Sticky Headers.
font-size	Wird verwendet, um die Größe der Beschriftung eines verbatim-Elements, z. B. `programlisting`, einzustellen, siehe Verbatim (Code und Software).
<free text>	Kann für jedes Element verwendet werden und Sie können beliebigen Text als Wert eingeben, z. B. role: online-image. Der Wert wird als Klassenname in HTML-Ausgaben verwendet, allerdings nur, wenn das HTML-Layout so eingestellt ist, dass das role-Attribut als Klassenname aufgenommen wird, siehe Klassen und Attribute, HTML5.
img-thumbnail	Wird für `mediaobject`-Elemente verwendet, um diese in HTML-Ausgaben als kleine „Miniaturansichten“ einzustellen, siehe Miniaturansichten.
img-thumbnail-reset	Wird für `mediaobject`-Elemente verwendet, um zu verhindern, dass diese in HTML-Ausgaben als Miniaturansicht dargestellt werden, siehe Miniaturansichten.
multi-publication-portal	Wird für `article`Elemente verwendet, wenn Sie im selben Helpcenter mehrere Publikationen veröffentlichen, siehe Portal für Mehrfach-Veröffentlichungen.
notintoc	Wird in `section`-Elementen verwendet, um ein bestimmtes Topic aus dem Inhaltsverzeichnis von PDF-Ausgaben auszuschließen, siehe Optionen im PDF-Layout-Editor.
portal-category	Hiermit werden in `section`-Elementen Kategorie-Panels für Topics in HTML-Helpcenter-Ausgaben erstellt, siehe Topics für Kategorie-Panels.
promoted-content	Dient in `section`-Elementen dazu, ein Topic als „Hervorgehobener Inhalt“ festzulegen, siehe Topics für ausgewählte Inhalte.
reuse-range	Dient in `procedure`- und `orderedlist`-Elementen dazu, die Nummerierung der Schritte/Elemente eines vorherigen Verfahrens oder einer vorherigen Liste fortzusetzen, siehe Listenelemente wiederverwenden.
swagger-topic	Dient in `section`-Elementen zum Einbetten von Swagger/Open-API-Inhalten in Paligo für die Veröffentlichung als: HTML-Helpcenter, siehe Swagger OpenAPI einbetten Zendesk, siehe Swagger OpenAPI für Zendesk einbetten
top-nav-link	Wird im `section`-Element verwendet, um zu einem Topic aus dem oberen Navigationsmenü zu verlinken, siehe Hinzufügen von Top-Navigationslinks zu Topics.
wrap-option	Dient in verbatim-Elementen, wie z. B. `programlisting`, zur Steuerung von Zeilenumbrüchen, siehe Verbatim (Code und Software).

Unterstützte Attribute

Achtung

Tipp

role-Attributwerte

Tipp

Suchresultat