Page 1 of 1

Saved PDF publishing template incomplete

Posted: Fri Feb 20, 2026 1:23 pm
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

Re: Saved PDF publishing template incomplete

Posted: Fri Feb 20, 2026 1:33 pm
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

Re: Saved PDF publishing template incomplete

Posted: Fri Feb 20, 2026 3:24 pm
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

Re: Saved PDF publishing template incomplete

Posted: Fri Feb 20, 2026 4:26 pm
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.