"No CSS file specified" in webhelp template opt file

Post here questions and problems related to editing and publishing DITA content.
sopuli
Posts: 8
Joined: Fri Jul 11, 2025 2:22 pm

"No CSS file specified" in webhelp template opt file

Post by sopuli »

Hi,

After trying out the webhelp function with oxygen templates, I am ready to move on to incorporating our corporate identity. I have been following the webinar "Techniques for Customizing the WebHelp Responsive Output" (https://www.youtube.com/watch?v=RN5oOuydKFo), but I am stuck defining my CSS in the opt file. I get the message "W No CSS file specified" even though I insert the file via the dropdown that opens in oxygen when after typing "css/". The CSS is sitting in a folder called "css" which is right next to the opt file within the Project view. What could be wrong?

Thank you for any hints.
marius
Posts: 59
Joined: Thu Mar 05, 2009 11:44 am

Re: "No CSS file specified" in webhelp template opt file

Post by marius »

Hi,
In your .opt (template descriptor) file, the CSS file must be referenced in the <resources> section, like this:

Code: Select all

<resources>
  <css file="css/your-style.css"/>
</resources>
Is your .opt file still valid after selecting the CSS file? If no validation errors are reported and the CSS file is present in the correct location inside the publishing template, but the issue persists, we will need your publishing template to further investigate the problem.
You can send us a ZIP archive containing the publishing template using our support form.
Regards,
Marius
Marius Ciolacu
Syncro Soft / Oxygen XML
Post Reply