Adding external ref causes output to build entire project structure.

<oXygen/> general issues.
Zystral
Posts: 2
Joined: Thu Jan 09, 2020 8:02 pm

Adding external ref causes output to build entire project structure.

Post by Zystral » Thu Jan 09, 2020 8:18 pm

Using:
oxygen 21.1 build 2019120214 / DITA OT Built-in 3.x

My project structure looks like this:
Folder A -> Folder B -> Folder C

Inside Folder A is a generic.dita file that I want multiple different projects to access.
Folder B is my Project Folder, and is where my .xpr file lives.
Folder C is where my ditamap lives.

When I build my final HTML with WebHelp Responsive, it outputs to Folder C/out/webhelp-responsive and everything works.
I have a particular page that outputs to Folder C/out/webhelp-responsive/dita/target.html
It looks exactly like I want it to.

When I add a chapter href in my ditamap to refer to generic.dita, my output changes to Folder C/out/webhelp-responsive/Folder A/Folder B/Folder C/target.html. This obviously breaks my css and other references.

If I set the parameter fix.eternal.refs.com/oxygenxml to be true, I get the following fatal error:
Transformation failed. C:\Program Files\Oxygen XML Editor 21\frameworks\dita\DITA-OT3.x\plugins\org.dita.base\build_preprocess.xml:264: Failed to run pipeline: Failed to merge map
C:\Users\{directory}\Folder A\Folder B\Folder C\temp\webhelp-responsive\oxygen_dita_temp\C:\Users\{directory}\AppData\Local\Temp\OxygenXMLTemp\ditaTemporaryOutputDir-{numbers}\t1\t2\t3\t4\t5\map.ditamap : C:\Users\{directory}\Folder A\Folder B\Folder C\temp\webhelp-responsive\oxygen_dita_temp\C:\Users\{directory}\AppData\Local\Temp\OxygenXMLTemp\ditaTemporaryOutputDir-{numbers}\t1\t2\t3\t4\t5\map.ditamap (The filename, directory name, or volume label syntax is incorrect)
Even commenting out the external refs but keeping the paramater set to true gives me an error here.

Radu
Posts: 7094
Joined: Fri Jul 09, 2004 5:18 pm

Re: Adding external ref causes output to build entire project structure.

Post by Radu » Fri Jan 10, 2020 2:06 pm

Hi,

So if you want to refer to resources outside of the DITA Map folder you will definitely need to enable the "fix.external.refs..." parameter:

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

I'm not sure why it does not work for you though, did you make any other changes to the transformation scenario, change for example the locations of the temporary and output folders?
After the transformation fails there is a "DITA OT" console tab view at the bottom of Oxygen containing all the logging received from the ANT process, can you copy all that information from there and paste it in a reply in a code block?

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

Zystral
Posts: 2
Joined: Thu Jan 09, 2020 8:02 pm

Re: Adding external ref causes output to build entire project structure.

Post by Zystral » Fri Jan 10, 2020 5:03 pm

Hi,

I figured out what the issue was. It was as you thought, I had some other parameters set to force the output and temp directories that was causing the "fix.external.refs" parameter to break. After resetting my transformation options and only re-enabling the necessary ones, I was able to have it outputting as I expected.

Post Reply