Anwenden eines benutzerdefinierten Stils auf Inhaltsverzeichniseinträge und Themeninhalte

Manchmal können Sie benutzerdefinierte Stile auf die TOC-Einträge oder ein bestimmtes Thema anwenden. Dies kann erreicht werden, indem ein outputclass -Attribut mit dem <topicref> -Element in Ihrer DITA-Zuordnung verknüpft wird. Wenn Sie ein benutzerdefiniertes Format auf ein ganzes Thema anwenden möchten, kann dies auch durch Erweitern der Stildefinition des Attributs in der CSS erreicht werden.

Nehmen wir ein Beispiel für ein neues Thema, das Sie zur Überprüfung senden möchten. Zur einfachen Identifizierung des aktualisierten Themas müssen Sie dem Element <topicref> in Ihrer DITA-Zuordnung ein Attribut outputclass hinzufügen und dann in der CSS einen benutzerdefinierten Stil für dasselbe definieren.

Im folgenden Beispiel wurde dem Thema Verlauf der Flüge das Attribut outputclass mit dem Wert new-topic zugewiesen.

Mit der Klassendefinition von new-topic in einem CSS können Sie den Stil für die folgenden Elemente definieren:

  • Der Haupteintrag im Inhaltsverzeichnis oder im Mini-Inhaltsverzeichnis
  • Der Titel des Themas im Hauptinhalt
  • Der gesamte Inhalt des Themas, einschließlich des Titels

Sehen wir uns an, wie jedes dieser Szenarien in CSS definiert werden kann. In der folgenden CSS-Definition der Klasse new-topic wurde die Textfarbe geändert.

…
.new-topic {
  color: #CC5309
}
…

Diese Definition steuert die Farbe des Texts im Inhaltsverzeichnis und den Titel des Themas. Die folgende PDF-Ausgabe zeigt die unterschiedliche Farbe, die auf den TOC-Eintrag angewendet wird:

Der Titel des Themas wird ebenfalls mit derselben Farbe formatiert.

Wenn Sie möchten, dass der TOC-Eintrag und der Titel des Themas unterschiedliche Stile aufweisen, können Sie sie wie unten gezeigt separat definieren:

...
/*for styling TOC entry */
.new-topic {
  color: #CC3509
}

/* for styling topic's title */
.new-topic.title {
  color: #092ACC
}
...

Schließlich können Sie auch Stile auf den gesamten Inhalt innerhalb des Themas anwenden. Dazu müssen Sie dem Klassennamen das Suffix "-content" hinzufügen. Im folgenden Beispiel wurde eine Änderungsleiste für den gesamten Inhalt des Themas hinzugefügt:

...
/* for styling the topic's content */
.new-topic-content {
  -ro-change-bar-color: #A609CC;
}
...

Unter Verwendung der oben genannten Stilattribute wird links neben dem Thema Verlauf des Fluges eine Änderungsleiste hinzugefügt, wie unten dargestellt:

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178