Query on XML transformation to PDF & WebHelp

Questions about XML that are not covered by the other forums should go here.
tosujoydutta
Posts: 2
Joined: Mon Mar 21, 2011 2:10 pm

Query on XML transformation to PDF & WebHelp

Post by tosujoydutta »

Hi,

Im using the sample xml files. Dockbook>V4/V5 (Oxygen 11.1)
I want to generate the output from the existing XML files to PDF and WebHelp.
Im not getting an idea, how the schema is working and how to edit the css stylesheet.
I feel that if I could work on few sample task to create PDF and WebHelp from multiple XML files, which would ease my worry.
Please help me by giving step-by-step instruction to complete the task.
--
Sujoy
adrian
Posts: 2879
Joined: Tue May 17, 2005 4:01 pm

Re: Query on XML transformation to PDF & WebHelp

Post by adrian »

Hello,

Oxygen 11.x provides default transformations for DocBook to PDF, HTML, XHTML but not to WebHelp. These transformations all rely on XML stylesheets(XSLT), not CSS. The PDF transformation generates an FO and then uses FOP for producing the PDF. By default Apache FOP is used, but any command line FO Processor can be configured.

For transforming to PDF, open a DocBook document and go to Document -> Transformation -> Configure Transformation Scenario(or the corresponding toolbar icon). Select the "Docbook PDF" scenario from the list and press Transform Now. A PDF document will be generated and opened with the default system application associated for PDFs.

Regarding WebHelp, Oxygen 11.x doesn't include the stylesheets for generating it. The included DocBook XSL package(1.75.2) does not have webhelp builtin.
There are a few articles on the web about generating WebHelp with the help of an additional stylesheet that can be added to the existing DocBook XSL package.
http://www.dmncommunications.com/articl ... cbook.html

An alternate solution is to use the latest DocBook XSL package that has built-in WebHelp support(1.76.1).
http://sourceforge.net/projects/docbook/
Details about this WebHelp implementation can be found here:
http://blog.kasunbg.org/2010/08/docbook ... oject.html

Regards,
Adrian
Adrian Buza
<oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
http://www.oxygenxml.com
tosujoydutta
Posts: 2
Joined: Mon Mar 21, 2011 2:10 pm

Re: Query on XML transformation to PDF & WebHelp

Post by tosujoydutta »

Thanks for providing the download link.
Please let me know where to paste the docbook xls files.
sorin_ristache
Posts: 4141
Joined: Fri Mar 28, 2003 2:12 pm

Re: Query on XML transformation to PDF & WebHelp

Post by sorin_ristache »

Hello,

The Docbook XSL stylesheets are already included in the current version (Oxygen 12.1): [Oxygen-install-folder]/frameworks/docbook/xsl. The Docbook to WebHelp stylesheet is located in the webhelp/xsl subfolder, that is: [Oxygen-install-folder]/frameworks/docbook/xsl/webhelp/xsl.

For older versions of Oxygen you should overwrite the content of the [Oxygen-install-folder]/frameworks/docbook/xsl folder with the content of the downloaded Docbook XSL package and look in the webhelp subfolder.


Regards,
Sorin
Post Reply