Fritsch, Michael | 10 Apr 09:54 2014

Profiling with Webhelp



I produce DocBook manuals in WebHelp and PDF format using an adapted docbkx-maven-plugin for generation which uses the XSLT templates in version 1.76.1.

I have an customization layer for PDF and WebHelp generation.  Now I want to use profiling. With PDF everything is fine. I have my customized XSL file which imports profile-docbook.xsl.

Unfortunately, it does not work with WebHelp. I have my customization XSL file which , at the moment, imports the webhelp.xsl style sheet via


  <xsl:import href="urn:docbkx:stylesheet/webhelp.xsl"/>


Now, I’m not sure which (and how) stylesheets I have to import for profiling. I’ve tried for example <xsl:import href="urn:docbkx:stylesheet/xhtml/profile-chunk.xsl"/>

but this does not work.

So, can anyone tell me please which style sheets  I have to import and how the import statement has to look??





Dr. Michael Fritsch

Technical Editor

tel +49.40.325587.214
fax +49.40.325587.999

michael.fritsch <at>

CoreMedia AG

content | conversation | conversion

Ludwig-Erhard-Str. 18
20459 Hamburg, Germany

Executive Board: Gerrit Kolb (CEO), Dr. Klemens Kleiminger (CFO)
Supervisory Board: Prof. Dr. Florian Matthes (Chairman)
Trade Register: Amtsgericht Hamburg, HR B 76277



Bergfrid Skaara | 9 Apr 11:01 2014

Producing interactive PDF forms from DocBook content with XEP

We have a large amount of PDFs generated from modular and singlesourced DocBook XML, and need to expand that portfolio with ineractive PDF forms.

All trails lead back to, but they do not say what we need to do in our DocBook XML and XSL files to achieve this.

Do I need to become an XSL-FO expert and write the .fo file by hand?
Do I need to rewrite the XSL to pull something out of the existing XML files? And do I need to add special markup in the XML for this?

Rogério Rosa | 4 Apr 18:17 2014

foonote and links

Hi everyone,

I am using the xxl version 1.78.1, and the footnotes are not generating any links. Is this the expected
behaviour ?

Thanks in advance.
Best Regards,
natk | 2 Apr 06:23 2014

different gentext for olinks and xref

Is it possible to have different gentext for olinks and xrefs?

<book id="bookId"><title>Book Title</title>
<section id="sectionId"><title>Section Title</title>

For <olink targetdoc="bookId" targetptr="sectionId"/> I would like to see something like:

Section x.y "Section Title" in Book Title

For <xref linkend="sectionId"> I would like to see:

Section Title (which will be hyperlinked to the appropriate internal section)

At the moment, if I customise the section template in the xref-number-and-title context, they both change.

anmol gupta | 31 Mar 20:08 2014

Alternate color of table rows.


i used following syntax as follows:

<xsl:template name="">

  <xsl:variable name="tabstyle">
    <xsl:call-template name="tabstyle"/>

    <xsl:variable name="bgcolor">
        <xsl:call-template name="dbfo-attribute">
            <xsl:with-param name="pis" select="processing-instruction('dbfo')"/>
            <xsl:with-param name="attribute" select="'bgcolor'"/>

    <xsl:variable name="rownum">
        <xsl:number from="d:tgroup" count="d:row"/>

        <xsl:when test="$bgcolor != ''">
            <xsl:attribute name="background-color">
                <xsl:value-of select="$bgcolor"/>

        <!--xsl:when test="$tabstyle = 'striped'"-->
        <xsl:when test="$rownum mod 2 != 0">
            <xsl:attribute name="background-color">#EEEEEE</xsl:attribute>

The problem that i am facing is that the above code is setting the background color of the entry of the thead also which i don't want. 

I think $rownum mod 2 != 0 is treating row 1 of thead also and coloring it. 
How can i prevent this?

Thanks and Regards,
anmol gupta | 31 Mar 20:02 2014

setting note(admonition) property.


Points 1,2 and 3 mentioned below were used to set properties of note

I found xsl customization for note on the link:

<xsl:template name="nongraphical.admonition"> <xsl:variable name="id"> <xsl:call-template name=""/> </xsl:variable> <fo:block space-before.minimum="0.8em" space-before.optimum="1em" space-before.maximum="1.2em" start-indent="0.25in" end-indent="0.25in" border-top="0.5pt solid black" border-bottom="0.5pt solid black" padding-top="4pt" padding-bottom="4pt" id="{$id}"> <xsl:if test="$admon.textlabel != 0 or title"> <fo:block keep-with-next='always' xsl:use-attribute-sets=""> <xsl:apply-templates select="." mode="object.title.markup"/> </fo:block> </xsl:if> <fo:block xsl:use-attribute-sets=""> <xsl:apply-templates/> </fo:block> </fo:block> </xsl:template>Questions: what does this the text in the <xsl:if test="$admon.textlabel"...> imply? What properties of the and admonition,properties are taken? i mean what does this syntax about them explain? 2. Then i had written following code note title:<xsl:attribute-set name=""> <xsl:attribute name="font-size">13pt</xsl:attribute> <xsl:attribute name="color">#eeeeec</xsl:attribute> <xsl:attribute name="font-weight">bold</xsl:attribute> <xsl:attribute name="hyphenate">true</xsl:attribute> <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute> </xsl:attribute-set>
Question: What if i want the title to be bold and italics both? What does "hyphenate" and "keep-with-next.within-column" do? 3. for note body:<xsl:attribute-set name=""> <xsl:attribute name="background-color">#eeeeec</xsl:attribute>
<xsl:attribute name="text-indent">1em</xsl:attribute> </xsl:attribute-set>Finally, I want to use points 2 and 3 in point 1 itself. And define all the properties in just one single block i.e. point 1 Please help me understand this.Thanks and Regards,Anmol

anmol gupta | 31 Mar 15:10 2014

link to entry tag of the table


I have to make an internal and external link to an entry tag of a table in the document. 
What i am seeing currently is that the link goes to the beginning of the page that contains the table (table is actually at the bottom of that page) but not to the entry tag of the table directly.
How should i go about this issue?

Thanks and Regards,
Radu Coravu | 31 Mar 10:53 2014

Re: adding customization layers to Oxygen XML author

Hi Carlos,

If by customization layers you meant XSLT customizations, the folder 
where the Docbook XSLs which come bundled with Oxygen are located is 
this one:

> [Oxygen-install-dir]\frameworks\docbook\xsl

A similar Docbook XSL customization in Oxygen discussion can be found on 
our forum:


If you also want to make changes to the Docbook editing functionality 
(add actions, behaviors, change the way in which the content looks in 
the visual Author editing mode):

Jan's link is a good starting point to see what features our Docbook 
editing customization currently contains. You can also contact us 
directly using "support <at>" and ask us particular questions.
Our Author developer guide is located here:



Radu Coravu
<oXygen/>  XML Editor, Schema Editor and XSLT Editor/Debugger

On 3/29/2014 8:35 AM, Jan Tosovsky wrote:
> On 2014-03-28 Carlos Araya wrote:
>> I've downloaded XML author and after looking at resources I'm drawing a
>> blank as to how to add my customization layers to the editor's
>> workflow.
>> Does anyone have a guide or can point me to resources to get this
>> accomplished?
> All Docbook related stuff is stored in the Frameworkd folder in the Oxygen installation directory.
Browsing this content you'll get a rought idea what can be changed. You can place there your document
templates, stylesheetes, customized DTDs, customized CSS for displaying the content when editing,
customized toolbars, context menus etc.
> A good starting point is e.g. here:
> hth, Jan
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe <at>
> For additional commands, e-mail: docbook-apps-help <at>


Carlos Araya | 28 Mar 23:14 2014

adding customization layers to Oxygen XML author

Good afternoon,

I've downloaded XML author and after looking at resources I'm drawing a blank as to how to add my customization layers to the editor's workflow.

Does anyone have a guide or can point me to resources to get this accomplished?


Olivier Ishacian | 28 Mar 12:03 2014

[ANN] Release of XMLmind XML Editor v5.9

XMLmind is happy to announce the version 5.9 of XMLmind XML Editor.

XMLmind XML Editor Evaluation Edition v5.9 can be downloaded from

Professional Edition users, please upgrade using this form:

(The above form is usually accessed through

XMLmind XML Editor v5.9 (March 27, 2014)

Main enhancements:

* Much improved DITA map and DITA bookmap configurations.

* The "Document Set" tool, which has been renamed to "Navigation Pane",
   is now more convenient to use.

* It's now possible to move the text or node selection within
   a document using drag and drop.

* New CSS extension property "tooltip-content" is used in the XHTML
   and DocBook CSS stylesheets to display the target of internal
   and external links.

More information:
Mario Klebsch | 26 Mar 22:53 2014

dbfo-need changes para spacing


I am new on this list, so please forgive me, if this is a FAQ.

I want to use conditional page breaks, but they seem to change para spacing.

A sample docbook source looks like this:

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE book>
<book version="5.0" xml:lang="de" xmlns="">
		<?dbfo-need height="10cm"?>
		<?dbfo-need height="10cm"?>

When I transform this document source with docbook-xsl-ns-1.78.1/fo/docbook.xsl and FOP Version 1.1 to
pdf, the para spacing between Para4/Para5 and between Para5/Para6 is increased. I need to add 
space-before="0mm" to dbfo-need to make the soft page breaks invisible, when the do not cause a page break.

Is this intentional or is there a mistake in my document, that I do not see.

I looked into pi.xsl and there seems to be a lot of code to determine correct spacing, if space-before is
missing, but I am not that fluent in xslt and docbook, to completely understand that part.

73, Mario

Mario Klebsch
mario <at>
PGP key:
PGP fingerprint: C906 D123 2361 2164 218F 1B52 6258 1853 300B 6C18

Attachment (smime.p7s): application/pkcs7-signature, 5581 bytes