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.

Re: Saved PDF publishing template incomplete

Posted: Fri Mar 20, 2026 12:06 pm
by julien_lacour
Hi Frank,

Oxygen 28.1 is now available, in this version we have improved templates saving so you should get both CSSs and fonts.
Now you can add filesets and include the files you need to get when saving:

Code: Select all

<fileset>
    <include name="*.css"/>
    <include name="resources/**/*.ttf"/>
</fileset>
Of course we added these filesets into default templates so you can save them correctly too.

Regards,
Julien

Re: Saved PDF publishing template incomplete

Posted: Fri Mar 20, 2026 12:20 pm
by Frank Ralf
Hi Julien,

Many thanks for fixing this so quickly.

Best regards,
Frank