Customizing the XHTML output

[Gabor]

HI,

I would like to have a better understanding how transformation works in DITA.

I have a ditamap file that references topics and I want to have an XHTML output. There are some HTML fragments that I would want to "inject" to the <header> section of each html file.

Could you please tell me how DITA transformation to XHTML is preformed by oXygen? Where is the configuration file based on which this transformation is executed and how can I modify that?

Thanks for your help.

Gabor

[Radu]

Dear Gabor,

There is an open source tool called the DITA Open Toolkit:

http://www.dita-ot.org/

This tool can be used to generate various output formats from DITA, among which the plain XHTML output format that you are interested in.

Oxygen 17.1 and later (18.0) comes bundled with two DITA Open Toolkits (DITA OT 1.8 and DITA OT 2.x):

Code: Select all

OXYGEN_INSTALL_DIR\frameworks\dita\DITA-OT

OXYGEN_INSTALL_DIR\frameworks\dita\DITA-OT2.x

More information about the DITA OT:

http://blog.oxygenxml.com/2016/04/dita- ... asked.html

About your particular case, you should start by looking at the parameters that you have available. For example if you edit the DITA to XHTML transformation scenario the Parameters list contains params like args.hdf or args.hdr which might be useful to you.
Those params are documented here:

http://www.dita-ot.org/2.0/readme/ant-p ... types.html

For more complex customizations you would need to write a DITA Open Toolkit plugin which adds XSLT customizations for the XHTML processing:

http://blog.oxygenxml.com/2013/12/creat ... olkit.html

In addition to this, the DITA Open Toolkits bundled with Oxygen contain a special Oxygen plugin which adds support to publish to WebHelp or to WebHelp Responsive. This plugin is based on the base XHTML plugin and allows also specific customization via the parameters set in the transformation scenario.

Regards,
Radu

[Gabor]

Hi Radu,

Thanks for your support, I will read these and get back to this topics if I have any more questions.

Thanks,

Gabor