Home Forums DITA and XMetaL Discussion Preventing insertion of <linktext> in related links Reply To: Preventing insertion of <linktext> in related links

Derek Read

Reply to: Preventing insertion of <linktext> in related links

This can be done but you must be careful.

1. Open the corresponding CTM file for the topic type you wish to change this for in a text editor (like Notepad).


“topic” DTD for DITA 1.2
C:Program FilesXMetaL 7.0AuthorDITAXACs1.2topictopic_ditabase.ctm

“concept” DTD for DITA 1.1
C:Program FilesXMetaL 7.0AuthorDITAXACs1.1conceptconcept_ditabase.ctm

2. Locate the following section:

3. Change to:

4. Save the CTM file.
5. Repeat as necessary for each DITA document type you need to alter.

If you mess this up somehow then reinstalling the software should restore any CTM files you have broken.

Note: This may not work for every “template” due to the way the DITA functionality has been scripted. In most cases the code that inserts elements uses the template in the CTM file (by calling the API “InsertWithTemplate”) but in some cases it does not. It just happens that for it does.

Officially this type of change is not supported, even though it should work in this case. What “unsupported” means here is that if an end user contacts saying that the is not being inserted (without letting anyone know CTM changes were made, which is very likely) we won't be able to reproduce the issue. XMetaL Support (if that channel is used) would end up having the end user reinstall the software to put it into a standard state, at which point the issue would go away, but any customizations would disappear as well. So, if you make these types of changes make sure your end users contact you for help.