Adding logo to web help clarification

[Joe2]

Hello,

New to Oxygen and trying to follow this discussion (topic 8579) on adding a custom image above the Content and Search tabs in the web help output of dita files. Based on this reply:

As I understand it, the CSS stylesheet for a top logo is:

• Oxygen-install-dir\frameworks\dita\DITA-OT\plugins\com.oxygenxml.webhelp\oxygen-webhelp\resources\css\toc.css

However, when I follow this path, there is no toc.css file in this location. Am I supposed to create the toc.css file and add this code??

Code: Select all

h1:before {

    display:inline;

    content:url('../img/myLogoImage.gif');

}

I already have an image file here that I use to customize the footer: Oxygen > Frameworks > dita > DITA-OT > plugins > com.oxygen.webhelp > oxygen-webhelp > resources > img)

Thank you.

[sorin_ristache]

Hello,

If you don't have a file toc.css in directory Oxygen-install-dir\frameworks\dita\DITA-OT\plugins\com.oxygenxml.webhelp\oxygen-webhelp\resources\css the Oxygen application was not installed correctly. Please reinstall the application.

As specified in that topic you can add the CSS code in a new CSS file that you store in any directory you want and that you set in the args.css parameter of the transformation.


Regards,
Sorin

[Joe2]

Hi Sorin,

Thank you for the reply. I do not think this is an installation issue. I'm using a Mac (OS 10.8 ). There are no installation options. Decompress the zip file and Oxygen is installed and ready to use.

I have tried a 2nd install. I installed Oxygen in a folder called Test2. From my install folder I'm going to frameworks > dita > DITA-OT > plugins > com.oxygenxml.webhelp > oxygen-webhelp > resources > css. Again, there's no toc.css file in this location.

Searching for toc.css shows files named toc.css here:

frameworks > dita > DITA-OT > plugins > com.oxygenxml.webhelp > oxygen-webhelp > resources > skins

The skins directory has 3 folders:

• desktop
• desktop-frames
• mobile

Each one of those has a toc.css. Is this the right .css file?

Thank you.

[sorin_ristache]

Hello,

Sorry, you are right, the toc.css file is located in the frameworks/dita/DITA-OT/plugins/com.oxygenxml.webhelp/oxygen-webhelp/resources/skins subdirectories. You can use one of these toc.css files, depending on your type of Webhelp transformation:

• desktop - for the internal frames output (the index.html output file) of the Webhelp - desktop transformation,
• desktop-frames - for the frameset output (the index_frames.html output file) of the Webhelp - desktop transformation,
• mobile - - for the Webhelp - Mobile transformation.

It is recommended to add your custom code to a custom CSS file that you set in the args.css parameter, but you can use also the toc.css file.


Regards,
Sorin

[Joe2]

Great, and thank you for your help. Really appreciate it!