Case 2 – Topic as Source of navtitle - Fluid Topics - 3.10 - Technical Notes

Empower Metadata with Fluid Topics

Product
Fluid Topics
Fluid Topics Version
3.10
Category
Technical Notes
Language
English
Target Audience
public

The <navtitle> element defined in the topic is used to generate an entry in the ToC if at least one of the following conditions is met:

  • The <navtitle> element is defined in the DITA map and the @locktitle attribute is set to "no".

OR

  • The <navtitle> element is defined in the DITA map and there is no @locktitle attribute.

OR

  • No <navtitle> element is defined in the DITA map.

The following lines show a <navtitle> element declared both at the topicref level of a DITA map with the @locktitle attribute set to "no" and in the topic itself:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN"
"http://docs.oasis-open.org/dita/v1.1/OS/dtd/map.dtd">
<map title="time_machine_configuration_guide">
<title>Time Machine Configuration Guide</title>
<topicref href="time_machine_history.dita"/>
<topicref href="time_machine_principles.dita"/>
<topicref href="time_machine_settings.dita" locktitle="no">
<topicmeta>
<navtitle>How to Time Travel</navtitle>
</topicmeta>
</topicref>
</map>

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN"
"http://docs.oasis-open.org/dita/v1.1/OS/dtd/topic.dtd">
<topic id="time_travel_settings">
<title>Time Travel Settings</title>
<titlealts>
<navtitle>How to Time Travel</navtitle>
</titlealts>
<body>
<p></p>
</body>
</topic>

The entry in the ToC appears as "How to Time Travel," and the topic is renamed to match.