Tillämpa egna format på innehållsförteckningsposter och ämnesinnehåll

Ibland kanske du vill använda en egen formatering för innehållsförteckningsposterna eller ett visst ämne. Detta kan uppnås genom att associera ett outputclass-attribut med elementet <topicref> i DITA-kartan. Om du vill använda ett anpassat format för ett helt ämne kan du även göra det genom att utöka attributets formatdefinition i CSS.

Låt oss ta ett exempel på ett nytt ämne som du vill skicka för granskning. För att det uppdaterade ämnet ska bli lätt att identifiera måste du lägga till ett outputclass-attribut till <topicref>-elementet i DITA-kartan och sedan definiera en anpassad formatering för det i CSS.

I följande exempel har ämnet Historik över flygningar tilldelats ett outputclass-attribut med värdet new-topic.

Med klassdefinitionen för new-topic i en CSS kan du definiera formatet för följande objekt:

Låt oss se hur vart och ett av dessa scenarier kan definieras i CSS. I följande CSS-definition för klassen new-topic har textfärgen ändrats.

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

Den här definitionen styr färgen på texten i innehållsförteckningen och ämnestiteln. Följande PDF-utdata visar de olika färger som används för posten i innehållsförteckningen:

Ämnets titel är också formaterad med samma färg.

Om du vill att innehållsförteckningsposten och ämnesrubriken ska ha olika format, kan du definiera dem separat så som visas nedan:

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

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

Slutligen kan du också använda format på hela innehållet i ämnet. För detta måste du lägga till suffixet -content i klassnamnet. I följande exempel har ett ändringsfält lagts till för hela innehållet i ämnet:

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

Med formatattributen ovan läggs ett ändringsfält till till vänster om ämnet Historik för flight, vilket visas nedan: