docbook-apps

  • 1.  DocBook stylesheets 2.0 customization

    Posted 05-17-2012 04:33
    Hi all,
    I’m looking for information about customizing the DocBook stylesheets 2.0.x <http://norman.walsh.name/2011/12/01/docbook-xslt2-2-0-3>. More precisely I’d like to produce html5 pages and I haven’t found for a way to add a class to heading tags. This is only an example, I have many other things to tweak or customize. I’ve searched on <http://www.sagehill.net/docbookxsl/> but I haven’t found much information and maybe it’s outdated, too.

    Is there some documentation about these issues? These are my first steps with DocBook publishing and I don’t exactly where and what to look for.

    Thank you in advance.


    --
    Giorgio Valoti




  • 2.  Re: [docbook-apps] DocBook stylesheets 2.0 customization

    Posted 05-17-2012 08:55
    On 17.5.2012 6:32, Giorgio Valoti wrote:

    > I’m looking for information about customizing the DocBook stylesheets
    > 2.0.x <http://norman.walsh.name/2011/12/01/docbook-xslt2-2-0-3>. More
    > precisely I’d like to produce html5 pages and I haven’t found for a
    > way to add a class to heading tags. This is only an example, I have
    > many other things to tweak or customize. I’ve searched on
    > <http://www.sagehill.net/docbookxsl/> but I haven’t found much
    > information and maybe it’s outdated, too.

    Unfortunatelly XSLT 2.0 based stylesheet you are referring are not
    covered in excellent Bob Stayton's book. This book covers customization
    of XSLT 1.0 based stylesheets available at
    http://docbook.sourceforge.net/ which are mature, stable and proven
    solution.

    XSLT 2.0 stylesheets are bleeding edge, under development, so you will
    not find that many information about them around.

    Regarding classes on headings -- there is no easy way for such
    customization now. Please fill feature request at GitHub. Meanwhile you
    can change template from xslt/base/html/titlepage-mode.xsl in your
    customization layer to add class attribute.

    Jirka

    --
    ------------------------------------------------------------------
    Jirka Kosek e-mail: jirka@kosek.cz http://xmlguru.cz
    ------------------------------------------------------------------
    Professional XML consulting and training services
    DocBook customization, custom XSLT/XSL-FO document processing
    ------------------------------------------------------------------
    OASIS DocBook TC member, W3C Invited Expert, ISO JTC1/SC34 member
    ------------------------------------------------------------------




  • 3.  Re: [docbook-apps] DocBook stylesheets 2.0 customization

    Posted 05-17-2012 10:56


    Il giorno 17/mag/2012, alle ore 10:55, Jirka Kosek <jirka@kosek.cz> ha scritto:

    > On 17.5.2012 6:32, Giorgio Valoti wrote:
    >
    >> I’m looking for information about customizing the DocBook stylesheets
    >> 2.0.x <http://norman.walsh.name/2011/12/01/docbook-xslt2-2-0-3>. More
    >> precisely I’d like to produce html5 pages and I haven’t found for a
    >> way to add a class to heading tags. This is only an example, I have
    >> many other things to tweak or customize. I’ve searched on
    >> <http://www.sagehill.net/docbookxsl/> but I haven’t found much
    >> information and maybe it’s outdated, too.
    >
    > Unfortunatelly XSLT 2.0 based stylesheet you are referring are not
    > covered in excellent Bob Stayton's book. This book covers customization
    > of XSLT 1.0 based stylesheets available at
    > http://docbook.sourceforge.net/ which are mature, stable and proven
    > solution.
    >
    > XSLT 2.0 stylesheets are bleeding edge, under development, so you will
    > not find that many information about them around.
    >
    > Regarding classes on headings -- there is no easy way for such
    > customization now. Please fill feature request at GitHub. Meanwhile you
    > can change template from xslt/base/html/titlepage-mode.xsl in your
    > customization layer to add class attribute.


    Excuse me for the dumb question: are you referring to XSLT 1.0 or 2.0?

    --
    Giorgio Valoti




  • 4.  Re: [docbook-apps] DocBook stylesheets 2.0 customization

    Posted 05-17-2012 12:34
    On 17.5.2012 12:56, Giorgio Valoti wrote:

    >> Regarding classes on headings -- there is no easy way for such
    >> customization now. Please fill feature request at GitHub. Meanwhile you
    >> can change template from xslt/base/html/titlepage-mode.xsl in your
    >> customization layer to add class attribute.
    >
    >
    > Excuse me for the dumb question: are you referring to XSLT 1.0 or 2.0?

    I'm referring to XSLT 2.0 version of stylesheets as you have asked
    question about them.

    --
    ------------------------------------------------------------------
    Jirka Kosek e-mail: jirka@kosek.cz http://xmlguru.cz
    ------------------------------------------------------------------
    Professional XML consulting and training services
    DocBook customization, custom XSLT/XSL-FO document processing
    ------------------------------------------------------------------
    OASIS DocBook TC member, W3C Invited Expert, ISO JTC1/SC34 member
    ------------------------------------------------------------------