Fluid Topics uses the <navtitle> element defined for a topicref in a DITA map to generate an entry in the Table of Contents (ToC) if both of the following conditions are met:
- The <navtitle> element is defined in the DITA map.
- The @locktitle attribute is set to "yes".
- The title defined for the topic in the DITA map overrides the one defined in the topic itself.
- The <navtitle> element is not defined in the topic referenced by the <topicref> element.
If the @locktitle attribute is set to "yes", the content of the <navtitle> element or @navtitle attribute is used for a navigation title, if it is present. If the @locktitle attribute is not present or set to "no", the content of the <navtitle> element or @navtitle attribute is ignored, and the title of the referenced topic is used as a navigation title.
The following lines show a <navtitle> element declared at the topicref level of a DITA map and the associated topic displayed after it.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN"
<title>Time Machine Configuration Guide</title>
<topicref href="time_travel_settings.dita" locktitle="yes">
<navtitle>How to Time Travel</navtitle>
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN"
<title>Time Travel Settings</title>
The entry in the ToC appears as "How to Time Travel," and the topic is renamed to match.