Aplicar estilo personalizado em entradas de índice e conteúdo de tópico

Às vezes, você pode aplicar um estilo personalizado às entradas do índice ou a um tópico específico. Isso pode ser feito associando um atributo outputclass ao elemento <topicref> no mapa DITA. Além disso, caso você queira aplicar um formato personalizado a um tópico inteiro, isso também pode ser obtido estendendo a definição de estilo do atributo no CSS.

Vamos ver um exemplo de um novo tópico que você deseja enviar para revisão. Para facilitar a identificação do tópico atualizado, é necessário adicionar um atributo outputclass ao elemento <topicref> em seu mapa DITA e, em seguida, definir um estilo personalizado para o mesmo no CSS.

No exemplo a seguir, o tópico Histórico de voos recebeu um atributo outputclass com o valor de new-topic.

A definição de classe de new-topic em um CSS pode permitir a definição do estilo dos seguintes itens:

  • A entrada principal no sumário ou minisumário
  • O título do tópico no conteúdo principal
  • Todo o conteúdo do tópico, incluindo o título

Vamos ver como cada um desses cenários pode ser definido no CSS. Na seguinte definição CSS da classe new-topic, a cor do texto foi alterada.

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

Essa definição controla a cor do texto no índice e o título do tópico. A saída de PDF a seguir mostra a cor diferente aplicada na entrada de índice:

O título do tópico também é estilizado com a mesma cor.

Se você quiser que a entrada do sumário e o título do tópico tenham estilos diferentes, poderá defini-los separadamente, conforme mostrado abaixo:

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

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

Por fim, também é possível aplicar estilos a todo o conteúdo do tópico. Para isso, você precisa adicionar um sufixo "-content" ao nome da classe. No exemplo a seguir, uma barra de alteração foi adicionada em todo o conteúdo do tópico:

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

Usando os atributos de estilo acima, uma barra de alteração é adicionada à esquerda do tópico Histórico do voo, conforme mostrado abaixo:

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