Excluding certain docbook elements from Webhelp output?

okleven
Posts: 4
Location: France

Excluding certain docbook elements from Webhelp output?

Wed Aug 21, 2013 5:59 pm

I am very new to docbook-webhelp processing, so I hope this is not a dumb question. I have used oXygen and Docbook for transforming to PDF for a few years, and I have developed my xsl customization layer to get the output the way I want.

With Webhelp, I am not sure how to do everything. I have made changes in the frameworks to toc.css and chunk_custom.xml etc. and I see that they work. However, too many of the docbook elements are included from within the <bookinfo> and <articleinfo> tags, such as <authorgroup>, <author> and <revhistory>.

These items I customized for FO/PDF with the "titlepages.xsl" file and my main xsl layer file. How do I define what should be included in the Webhelp output?

The output from these elements is inserted in the "oxygen-main.html" file in the /out/webhelp directory.

Any help will be appreciated.

PS. I was amazed at how well the default DB to Webhelp transformation scenario with ANT in oXygen worked on my existing DB xml files, without any customization or previous knowledge on my part! Well done oXygen.

Thanks,
Oystein
okleven
Posts: 4
Location: France

Re: Excluding certain docbook elements from Webhelp output?

Wed Aug 21, 2013 6:00 pm

I forgot to mention that I am using oXygen version 15.0.

Oystein
sorin_ristache
Posts: 4144

Re: Excluding certain docbook elements from Webhelp output?

Fri Aug 23, 2013 2:46 pm

Hi Oystein,

The starting point for your XSLT customizations to the DocBook Webhelp transformation is the following XSLT stylesheet (for desktop Webhelp output, there is another similar XSLT stylesheet for the Webhelp - mobile devices output):

[Oxygen-install-dir]\frameworks\docbook\xsl\com.oxygenxml.webhelp\xsl\docbook\desktop\chunk_custom.xsl

which is called by the ANT task called "docbook-xhtml-transform" from the Webhelp build file:

[Oxygen-install-dir]\frameworks\docbook\xsl\com.oxygenxml.webhelp\build_docbook.xml

The titlepage customization XSLT should be imported in this chunk_custom.xsl stylesheet in the same way as in the XSLT stylesheet for the PDF output (or as in your own main XSLT layer file that you use instead of this xsl\fo\docbook_custom.xsl file):

[Oxygen-install-dir]\frameworks\docbook\xsl\fo\docbook_custom.xsl

Any CSS customizations should go in one of the following two files or in your own additional custom CSS file set in the Webhelp transformation using the standard Docbook parameter html.stylesheet:

[Oxygen-install-dir]\frameworks\docbook\xsl\com.oxygenxml.webhelp\oxygen-webhelp\resources\skins\desktop\toc.css

[Oxygen-install-dir]\frameworks\docbook\xsl\com.oxygenxml.webhelp\oxygen-webhelp\resources\css\webhelp_topic.css


Regards,
Sorin

Return to “DocBook”

Who is online

Users browsing this forum: No registered users and 0 guests