Documentation Center

Content of the <title> element is modified

After you import a DITA topic into the repository, you notice that the content of the <title> element has been modified.

Problem

This might occur in the following situations:
  • The <title> element contained a conrefed or conkeyrefed element.
  • The filemap.xml file contained a value for the FTITLE field that was different from the content of the <title> element.

Explanation

When topics are imported into DITA2Trisoft, the SETTITLE plugin is, by default, configured to copy the value from the metadata field FTITLE into the title element, overwriting anything that is in the title.

<plugin name="SETTITLE" handler="BlobSetXmlNode" ishcondition="EDT='EDTXML' and VERSION='1' and CurrentAction='Create'">
  <description>Set title for new objects using the metadata title</description>
  <workingset>
	<ishfields>
	  <ishfield name="FTITLE" level="logical" />
	</ishfields>
  </workingset>
  <initialize>
	<parameters>
	  <parameter name="OnNodeXPath">(/*[contains(@class,' map/map ')][title]) | (/*[contains(@class,' topic/topic ')][title])</parameter>
	  <parameter name="NodeType">node</parameter>
	  <parameter name="NodeName">title</parameter>
	  <parameter name="OverwriteExisting">Yes</parameter>
	  <parameter name="Value">
		<value type="MetadataField">
		  <parameter name="MetadataField">FTITLE</parameter>
		  <parameter name="MetadataFieldLevel">logical</parameter>
		</value>
	  </parameter>
	</parameters>
  </initialize>
</plugin>

Resolution

You can do one of the following:
  • Disable the SETTITLE plug-in. This ensures that content of the <title> element is not overwritten.However, it also prevents SDL LiveContent Architect from automatically populating the <title> element when an author creates a new topic.
  • Modify the SETTITLE plugin and set <Parameter name="OverwriteExisting">Yes</Parameter> from Yes to No:

<Parameter name="OverwriteExisting">No</Parameter>