Page 1 of 1

Fatal Error while publishing PDF

Posted: Wed May 28, 2025 12:44 pm
by digital_nomad
I get the following error while generating a PDF using a custom transformation scenario based on the DITA Map PDF - based on HTML5 and CSS transformation scenario.

System ID: spo://path/Developer-Guide.ditamap
Scenario: PDF
Input file: spo://path/Developer-Guide.ditamap
Engine name: DITA-OT
Severity: fatal
Description: Transformation failed. C:\Program Files\Oxygen XML Editor 27\frameworks\dita\DITA-OT\plugins\org.dita.base\build_preprocess.xml:117: java.lang.RuntimeException: Cannot write outside of the temporary files folder: C:/Users/xyz/AppData/Local/Temp/OxygenXMLTemp/ditaTemporaryOutputDir-czn_jz1_mfc/t1/t2/t3/t4/t5/topics/LIMaaS-User-Token-Provisioning.dita


Other people in my team are able to generate the same PDF without any error. I have tried the following:

1. Reinstall Oxygen.
2. Restart the laptop
3. Set JVM arguments to -Xmx5600m

Please help to fix the issue.

Re: Fatal Error while publishing PDF

Posted: Tue Jun 03, 2025 4:37 pm
by julien_lacour
Hello,

This error can appear when the 'fix.external.refs.com.oxygenxml' parameter is enabled: if you have <xref> elements referencing external resources but without any @scope attribute, the engine will process it as a local resource and search for a common ancestor to all topics, leading to "Cannot write outside of the temporary files folder".

To avoid such error, you should run the Validate and Check for Completeness tool (available in the DITA Maps Manager) with the "Report references to resources outside of the DITA map folder" checked. You will obtain warnings such as:
Reference to external resource "https://..." needs to have the "scope" attributes set to it.
Once these warnings resolved, you will be able to generate the PDF.

Regards,
Julien

Re: Fatal Error while publishing PDF

Posted: Wed Jun 04, 2025 11:17 am
by digital_nomad
Thank you. That has fixed the issue.