Page 1 of 1
Customizing the XHTML output
Posted: Thu Jun 16, 2016 4:18 pm
by 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
Re: Customizing the XHTML output
Posted: Thu Jun 16, 2016 4:35 pm
by 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
Re: Customizing the XHTML output
Posted: Thu Jun 16, 2016 4:48 pm
by 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