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.