Documentation Center

Troubleshooting DITA

DITA problems you may encounter.

Unexpected browser behavior

  • With conref pushreplace, extra space shows up before the list item in the Chrome browser. Other browsers are okay.

Variations from DITA 1.2 Specification

  • With conref pushreplace, it is illegal to replace a more specialized element with a more general one. For instance, you cannot replace a <step> element with a <li> element. The target element may disappear without replacement.
  • With conref pushreplace, it is an error for two source topics to replace the same element.
  • With conref pushbefore or pushafter, content gets pushed when different element types are used for pushbefore and mark elements. DITA requires that these be elements of the same type.
  • The behavior of conref pushreplace in maps is unspecified. The DITA Technical Committee, in their dita-users forum, states "the use of conref of any form within maps is frowned upon" because there are better alternatives for use in maps.