Referencing to a DITA topic, map or to a binary resource (for example: image) which is
located outside of the folder where the main DITA Map is located usually leads to problems
when publishing the content using the DITA Open Toolkit. The DITA OT does not handle well
links to topics which are outside the directory where the published DITA Map is found. By
default it does not even copy the referenced topics to the output directory.
You have the following options:
Create another DITA Map which is located in a folder path above all referenced folders
and reference from it the original DITA Map. Then transform this DITA Map instead.
Edit the transformation scenario and in the Parameters tab edit the
fix.external.refs.com.oxygenxml parameter. This parameter is used
to specify whether the application tries to fix up such references in a temporary files
folder before the DITA Open Toolkit is invoked on the fixed references. The fix up has no
impact on your edited DITA content. Only "false" and "true" are valid values. The default
value is false.