Saved PDF publishing template incomplete

Post here questions and problems related to editing and publishing DITA content.
Frank Ralf
Posts: 508
Joined: Thu Jan 23, 2014 2:29 pm
Location: Hamburg
Contact:

Saved PDF publishing template incomplete

Post by Frank Ralf »

Hi,

I am creating a customized PDF publishing template based on an existing one. This has always worked well with WebHelp templates but now I run into problems with a customization for "DITA Map PDF - based on HTML5 & CSS". I followed the instructions and saved an existing publishing template. However, using the saved template did not work as the original one. On further investigation, I noticed that the saved templates are missing a number of important files. That also shows in the log files, for example:

ERROR AuthorDocumentFacadeImpl$2 - [CH] [ERROR] Error parsing file:/E:/Oxygen/DITA-MAP-PDF-Oxygen/oxygen.css: E:\Oxygen\DITA-MAP-PDF-Oxygen\oxygen.css (Das System kann die angegebene Datei nicht finden)
ERROR AuthorDocumentFacadeImpl$2 - [CH] [ERROR] Error parsing file:/E:/Oxygen/DITA-MAP-PDF-Oxygen_colors/oxygen-print.css: E:\Oxygen\DITA-MAP-PDF-Oxygen_colors\oxygen-print.css (Das System kann die angegebene Datei nicht finden)

I tried with the "Oxygen" and "Oxygen [colors]" templates.

Original template files
Oxygen installation directory/frameworks/dita/DITA-OT/plugins/com.oxygenxml.webhelp.responsive/templates/oxygen/

Saved template files
Oxygen
notes.css
oxygen.png
oxygen-print.css
oxygen-theme.css
PDF Oxygen.opt

Oxygen [colors]
notes.css
oxygen-theme.css
oxygen-with-colors.css
oxygen-with-colors.png
PDF_Oxygen_colors.opt

My solution was to copy over all the required files from the original templates to my customization.

Kind regards,
Frank
Last edited by Frank Ralf on Fri Feb 20, 2026 1:42 pm, edited 1 time in total.
Frank Ralf
parson AG
www.parson-europe.com
Frank Ralf
Posts: 508
Joined: Thu Jan 23, 2014 2:29 pm
Location: Hamburg
Contact:

Re: Saved PDF publishing template incomplete

Post by Frank Ralf »

I looked a bit further into this:

If you mark the checkbox "Include WebHelp customization" when saving the template, all required files are copied. However, when you save one of the "[colors]" templates, the checkbox is greyed out. So I think this is a bug.

Best regards,
Frank

XML Editor 28.0, build 2026020208 - Windows 11
Frank Ralf
parson AG
www.parson-europe.com
julien_lacour
Posts: 779
Joined: Wed Oct 16, 2019 3:47 pm

Re: Saved PDF publishing template incomplete

Post by julien_lacour »

Hi Frank,

It appears that the issue is related to the '@import' rules not being processed, resulting in the imported stylesheets not being included in the final archive. I've added an issue to analyze this. Thank you for reporting.

Regards,
Julien
Frank Ralf
Posts: 508
Joined: Thu Jan 23, 2014 2:29 pm
Location: Hamburg
Contact:

Re: Saved PDF publishing template incomplete

Post by Frank Ralf »

Thanks, Julien. But keep in mind that it is not only CSS files missing but also the cover SVG and the complete "resources" folder.
Frank Ralf
parson AG
www.parson-europe.com
Post Reply