Komponenten als strukturierter Inhalt
Wenn Sie einem Topic Informationen hinzufügen, stellen Sie möglicherweise fest, dass es Teile des Inhalts gibt, die Sie in anderen Topics wiederverwenden können. Sie haben beispielsweise einen Hinweis, der in mehreren anderen Topics wiederholt werden muss. Um Teile eines Topics wiederzuverwenden, müssen Sie diesen Inhalt in einer anderen Art von Komponente erstellen.
Komponenten sind eine spezielle Art von „Container“ für Inhalte und sind so konzipiert, dass sie in Topics eingefügt werden. Die Idee dahinter:
-
Eine Komponente erstellen.
-
Fügen Sie den Inhalt der Komponente hinzu.
-
Fügen Sie die Komponente gegebenenfalls in Ihre Topics ein. Bearbeiten Sie das Topic und wählen Sie Einfügen und dann Komponente.
Die folgenden Bilder zeigen beispielsweise einen Hinweis, der als separate Hinweiskomponente erstellt und dann in zwei verschiedene Topics eingefügt wird.
![]() |
Eine Hinweiskomponente wird in ein Topic „Benutzer hinzufügen“ eingefügt …
![]() |
… Die gleiche Hinweiskomponente wird in ein Topic „Benutzerberechtigungen erteilen“ eingefügt.
Es gibt viele verschiedene Arten von Komponenten, die Sie erstellen können, darunter:
-
Informelle Topics
Verwenden Sie informelle Topics, um ein einzelnes Element oder eine Abfolge von Elementen (und den zugehörigen Inhalt) wiederzuverwenden.
Zum Beispiel möchten Sie vielleicht einen Absatz und ein Bild zusammen wiederverwenden. Dazu würden Sie sie einem informellen Topic hinzufügen. Anschließend fügen Sie das informelle Topic als Komponente in beliebig viele reguläre Topics ein.
-
Hinweis, Tipp, Vorsicht, Warnung und andere Arten von Mahnungen
Für Mahnungen, die Sie in vielen verschiedenen Topics wiederverwenden können. Es ist eine gute Idee, Mahnungen als Komponenten zu erstellen, da dies bedeutet, dass die gleiche Formulierung konsequent verwendet wird.
-
Itemizedlist
Für ganze Aufzählungslisten (Bullet-Listen), die Sie in verschiedenen Topics wiederverwenden möchten.
-
Simplelist
Für wiederverwendbare einfache Listen, die eine Liste von Elementen in einer Zeile anzeigen können.
-
Step
Für wiederverwendbare Schritte, die Sie in Verfahrensstrukturen einfügen können.
-
Example
Für wiederverwendbare Beispiele. Diese sind oft nützlich, wenn Sie mehrere Versionen eines Topics haben und jede Version dasselbe Beispiel enthalten muss.
Wenn Sie eine Komponente erstellen, können Sie sie im Editor öffnen und Inhalte hinzufügen. Der Inhalt einer Komponente muss denselben Inhaltsmodell-Regeln folgen wie der Inhalt eines regulären Topics, sodass Sie Elemente nur an Stellen hinzufügen können, an denen sie gültig sind.
Informationen zum Erstellen von Mahnungen als Komponenten und zum Einfügen in Topics finden Sie unter Wiederverwendbare Warnmeldung erstellen.
Anmerkung
Erstellen Sie für einen Unterabschnitt in einem Topic ein neues Topic für den Unterabschnitt. Fügen Sie den Inhalt zum Unterabschnitt-Topic hinzu und fügen Sie ihn dann als Komponente in das „übergeordnete“ Haupttopic ein. Details hierzu finden Sie unter Unterabschnitte erstellen.