Collapse AllExpand All

5.3. Limitations and specificities of the implementation of transclusion in XMLmind XML Editor

Limitations

  • Content inclusion achieved using Copy as Reference/Paste does not perform every possible check on the validity of the reference. That's why it's possible to use Copy as Reference/Paste successfully in a document and still get errors when you'll convert this document to other formats.
  • Content pushed from one topic to another (the conaction attribute Opens in new window) is not transcluded by XMLmind XML Editor.
  • Something like <keyword keyref="product-name"/>, where the definition of key product-name contains <keyword>Thing-O-Matic</keyword> is not transcluded by XMLmind XML Editor.
All these limitations apply only to XMLmind XML Editor as an authoring tool. They do not apply when you'll use XMLmind XML Editor to convert a DITA document to formats such as HTML, PDF, RTF, etc.

Specificities

If your topics make use of attributes keyref and/or conkeyref Opens in new window, it is strongly recommended:
  1. To turn on option "Enable the 'File|Document Set' Submenu" (OptionsPreferences, General|Features section).
  2. If your topics make use of attribute conkeyref, turn on "Automatically update all inclusions in member documents" (OptionsPreferences, Tools|Document Set section).
  3. If your topics make use of attribute keyref to point to image files, turn on "Automatically redraw member documents" (OptionsPreferences, Tools|Document Set section).
  4. To open your DITA map as a document set using FileDocument SetOpen Document Set.
By doing this, you'll instruct XMLmind XML Editor to use your DITA map as a key space for all the topics referenced by this map. More information about document sets in "XMLmind XML Editor - Online Help" Opens in new window.