Warning message: Reference dita file outside of dita/map directory
Post here questions and problems related to editing and publishing DITA content.
-
- 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
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.
-
- 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
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
-
- 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 

Return to “DITA (Editing and Publishing DITA Content)”
Jump to
- Oxygen XML Editor/Author/Developer
- ↳ Feature Request
- ↳ Common Problems
- ↳ DITA (Editing and Publishing DITA Content)
- ↳ Artificial Intelligence (AI Positron Assistant add-on)
- ↳ SDK-API, Frameworks - Document Types
- ↳ DocBook
- ↳ TEI
- ↳ XHTML
- ↳ Other Issues
- Oxygen XML Web Author
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Content Fusion
- ↳ Feature Request
- ↳ Common Problems
- Oxygen JSON Editor
- ↳ Feature Request
- ↳ Common Problems
- Oxygen PDF Chemistry
- ↳ Feature Request
- ↳ Common Problems
- Oxygen Feedback
- ↳ Feature Request
- ↳ Common Problems
- Oxygen XML WebHelp
- ↳ Feature Request
- ↳ Common Problems
- XML
- ↳ General XML Questions
- ↳ XSLT and FOP
- ↳ XML Schemas
- ↳ XQuery
- NVDL
- ↳ General NVDL Issues
- ↳ oNVDL Related Issues
- XML Services Market
- ↳ Offer a Service