Use <navtitle> in Fluid Topics - Fluid Topics - Latest

DITA Connector Reference Guide

Category
Reference Guides
Audience
public
Version
Latest

Fluid Topics handles the <navtitle> element according to the following precedence rules:

  • If a <navtitle> element is set at the map level, it is only taken into account if locktitle is set to yes.

  • A <navtitle> element set at the map level takes precedence over a <navtitle> element set at the topic level.

  • If a <navtitle> element is set at the topic level, it does not need a locktitle at the map level.

  • The @navtitle attribute and the <navtitle> element in the <titlealts> of a topic are ignored unless the <topicref> element sets the attribute locktitle="yes".

    The locktitle attribute affects both the table of contents and topic title in Fluid Topics. However, the topic title for HTML output continues to be based on the <title> element.

  • The @navtitle attribute actually changes metadata. When used at the map level, it can override the topic’s title, effectively renaming it in the context of the map.

  • If multiple navtitles are defined, the precedence order is as follow:

    1. <navtitle> element at the map level.

    2. @navtitle attribute at the map level.

    3. <navtitle> element at the topics level.