output files not where expected

Having trouble installing <oXygen/>? Got a bug to report? Post it all here.
Posts: 1
Joined: Fri Mar 08, 2019 3:23 am

output files not where expected

Post by mdevoto » Thu Aug 15, 2019 1:10 am

Hi all. I'm intermittently having trouble with various HTML outputs because even though the build is succeeding, my HTML files aren't outputting to the right place, resulting in the topic links being broken. Specifically, when I run the HTML5 transformation on my ditamap, the CSS and index.html files are in the top-level out folder--but nested inside the Out folder is an entire folder structure all the way up to my Mac's Users folder, with the HTML output at the bottom level. So all the links in the

here's a pic:
nested_folders.jpg (112.46 KiB) Viewed 25 times
If I move the HTML files up to the top level of the out folder, the topic links work fine. But why aren't they being built and outputted at the right level in the first place? I haven't changed output settings that I know of. Has anyone seen this before? We're pretty newly licensed although I've used Oxygen a lot in the past.
image.png (251.11 KiB) Viewed 25 times

Posts: 6392
Joined: Fri Jul 09, 2004 5:18 pm

Re: output files not where expected

Post by Radu » Fri Aug 16, 2019 8:14 am


You probably have inside some of your DITA topics references to locations outside of the main DITA Map folder.
The publishing engine has problems when you have such references because it will try to duplicate in the output folder the entire structure of the input folder and it will try to locate a common path in the input folder where all the input content is located.
There is a transformation parameter called "fix.external.refs.com.oxygenxml" which you can set to "true" in order to fix such problems:

https://www.oxygenxml.com/doc/versions/ ... -refs.html

If you open the main DITA Map in the "DITA Maps Manager" view and use the "Validate and check for completeness" toolbar action, there is a checkbox called "Report references to resources outside of the main DITA Map folder". Maybe you can check that and then run the validation to see what those external references are.

Radu Coravu
<oXygen/> XML Editor

Post Reply