Structured Technical Writing: Does It Support the Translation of DITA XML Maps and Topics?
“DITA documentation is highly fragmented and makes extensive use of `conref` for content reuse. If only individual files are translated without considering reference relationships, contextual integrity will be lost.”
Root Cause Analysis
DITA Map Parsing Capability
Business Translation AI supports the upload of `.ditamap` files or packaged ZIP archives. The system first parses the map file, establishes all hierarchical relationships and reading order among topics, and provides the AI with complete global context, rather than translating each XML fragment in isolation.
Conref (Content Reference) Protection
For reference tags such as `<ph conref="...">`, the system treats them as placeholders and locks them. If the user uploads the referenced source file, the AI will ensure that the translation of the referenced content remains consistent across all occurrences.
Attribute Filtering
DITA tags contain extensive metadata (such as `audience="expert"`). The AI engine is configured to translate only element content while strictly preserving all functional attributes, ensuring that publishing systems (such as Oxygen XML) can compile without issue.
Final Solution Summary
Seamlessly integrates into modern technical documentation CI/CD workflows, supporting large-scale translation of fragmented content.