Warning message: Reference dita file outside of dita/map directory

Post here questions and problems related to editing and publishing DITA content.
joyceclc23
Posts: 10
Joined: Wed Aug 06, 2025 9:31 am

Warning message: Reference dita file outside of dita/map directory

Post by joyceclc23 »

Hi
Is it ok to ignore the Warning message during transformation that my referenced dita topic is outside the dita/map directory?
The topic appears fine in the pdf though. Just that the transformation message shows the warning that it is outside the current map directory.
Or is there the better way to go about this?
My files are on SharePoint. I would like to reuse a topic that is outside the current map directory..which is located in another folder different from the folder containing my current map. Insert a topic from Map B in folder B into Map A in folder A.
Using Oxygen XML Author v26.1
image.png
You do not have the required permissions to view the files attached to this post.
julien_lacour
Posts: 703
Joined: Wed Oct 16, 2019 3:47 pm

Re: Warning message: Reference dita file outside of dita/map directory

Post by julien_lacour »

Hello,

DITA Open Toolkit usually has problems processing references that point to locations outside of the processed DITA map directory.
To avoid this warning, you can enabled the fix.external.refs.com.oxygenxml parameter in the transformation dialog. This parameter is used to specify whether or not the application should try to fix such references in a temporary files folder before the DITA Open Toolkit is invoked on the fixed references. The fix has no impact on your edited DITA content.

Regards,
Julien
joyceclc23
Posts: 10
Joined: Wed Aug 06, 2025 9:31 am

Re: Warning message: Reference dita file outside of dita/map directory

Post by joyceclc23 »

This works! thank you :)
Post Reply