Peter Fleck | 23 Nov 10:27 2015

RDFa Lite Attributes in Docbook 5.1

Hi all,

I would like to populate my HTML output with

I've  been able to modify the inlines for obvious things like emails etc 
but at the block level I need to add the appropriate RDFa Lite 
Attributes to the XML (indicated here -

My question is how to get the RDF attributes passed through to the HTML. 
Do I need to write a customization or is there a more obvious way?

Many thanks,

Stefan Knorr | 19 Nov 12:32 2015

What is the use of allowing variablelists within variablelists?

Hi all,

Tom (CCd) and I were wondering about a quirk (?) in the DocBook 5 
What is the rationale for allowing the following construct?


(The same works for other kinds of lists within variablelist.)



---                                                                    .
SUSE Linux GmbH, Geschäftsführer: Felix Imendörffer, Jane Smithard,
Graham Norton. HRB 21284 (AG Nürnberg)
Bob Stayton | 18 Nov 19:36 2015

DocBook Technical Committee Meeting Minutes: 18 November 2015

DocBook Technical Committee Meeting Minutes: 18 November 2015

The DocBook Technical Committee met on Wednesday,
18 November 2015 at 1:00pm ET.

1. Roll call

Present: Dick Hamilton, Jirka Kosek, Larry Rowland,
Bob Stayton, Norm Walsh

2. Accepted the minutes [1] of the previous (Sept) meeting.

3. Next meeting: 16 December 2015

No regrets.

4. Review of the agenda.

No additions.

5. Review of open action items

   a.  Norm to convince someone to implement the new XInclude

   b.  Bob to integrate publishers XSL into DocBook XSL.

(Continue reading)

Bob Stayton | 16 Nov 21:21 2015

DocBook Technical Committee Meeting Agenda: 18 November 2015

DocBook Technical Committee Meeting Agenda: 18 November 2015

The DocBook Technical Committee will meet on Wednesday,
18 November 2015 at 1:00pm ET for 90 minutes.

Attendance at teleconferences is restricted to members
(and prospective members) of the committee.

This is the phone number for Wednesday's DocBook TC call:

Phone: +1-719-387-5556
  Code: 902213

The DocBook TC uses the #docbook IRC channel on  The IRC channel is used for exchanging
URIs, providing out-of-band comments, and other aspects
of the teleconference, so please join us there if at
all possible.


1. Roll call
2. Accepting the minutes [1] of the previous (Sept) meeting.
3. Next meeting: 16 December 2015
4. Review of the agenda.
5. Review of open action items

   a.  Norm to convince someone to implement the new XInclude
(Continue reading)

Thad Humphries | 5 Nov 23:31 2015

Adding favicon to HTML5 chunked output

I converting an v5 Docbook XML document to HTML using I would like to add the favicon link (<link rel="shortcut icon" href="favicon.ico" />) to each page in the resulting HTML. Is there a way to do this without modifying the XSL? I'd rather not have to add modified Docbook XSL files to my local source tree when what is available over the net does what I require.

The same can be asked for using, but there I have only one resulting HTML file.

If not, I'll probably opt for a Gradle script to insert the <link> elements into the HTML after it's created.

"Hell hath no limits, nor is circumscrib'd In one self-place; but where we are is hell, And where hell is, there must we ever be" --Christopher Marlowe, Doctor Faustus (v. 121-24)
Chet Ensign | 4 Nov 18:25 2015

A Special Majority Ballot to approve DocBook V5.1 with Non-Material Changes as a Committee Specification has been set up

Members of the DocBook TC,

A Special Majority Ballot to approve DocBook V5.1 with Non-Material Changes as a Committee Specification has been set up. 

The ballot opens 05 November 2015 at 00:00 UTC and closes 11 December 2015 at 23:59 UTC. You can access the ballot[s] at:

Internal link:

Publicly visible link:

This ballot is only open to eligible voting members of the TC. I currently show the following members as eligible to vote:

* Hamilton, Richard,  Individual
* Hudson, Scott,  Comtech Services, Inc.
* Kosek, Jiri,  LexisNexis, a Division of Reed Elsevier
* Rowland, Larry,  Hewlett-Packard
* Stayton, Robert,  Individual
* Walsh, Norman,  Mark Logic Corporation

If you do not see your name on this list and you believe that to be an error, please notify the TC Chair and me so that we can rectify the situation.


Chet Ensign
Director of Standards Development and TC Administration 
OASIS: Advancing open standards for the information society

Primary: +1 973-996-2298
Mobile: +1 201-341-1393 
Shaun McCance | 3 Nov 17:01 2015

Formatting bug in TDG

The blurbs after subscript and superscript are supposed to contain
subscripts and superscripts, but they don't in the TOC. I'm guessing
that the code that builds the TOC just calls xsl:value-of on the
refpurpose instead of applying templates to inline content.

Rahman USTA | 30 Oct 18:10 2015

List exceeds page limits


I have a long list in my document and list exceeds the page limits. How can I solve this issue ?

Note: Attached a PDF output.

Rahman USTA
Attachment (BS_LC.pdf): application/pdf, 117 KiB

To unsubscribe, e-mail: docbook-unsubscribe <at>
For additional commands, e-mail: docbook-help <at>
Eric Streit | 22 Oct 16:38 2015

advices for xml:lang attributes with Chinese


I am formating a document with 3 languages: English (the main language),
Chinese (mandarin 你好 ) and Chinese Pinyin (nǐhǎo)

The Chinese parts are surrounded by  <foreignphrase> tags.

I don't know which xml:lang attributes I have to use for the Pinyin part
and the ideogram part.

I'm looking for this for a long time :(

Thanks for your advices,


Aristedes Maniatis | 22 Oct 03:39 2015

TOC with parents

I have chunked html output from docbook 5, and want to output the entire TOC on every page, including all
parents of the chapter currently being rendered.

I found one approach here:

But it is 11 years old, and not quite right, so I modified it a little...

    <!-- show all sections in TOC, including parents of the current section -->
    <xsl:template match="chapter" mode="toc">
        <xsl:param name="toc-context" select="."/>

        <xsl:for-each select="ancestor::book">
            <xsl:apply-templates select="book" mode="toc">
                <xsl:with-param name="toc-context" select="."/>

but it doesn't work. I'm a bit out of my depth with this level of XSLT hackery. Any help would be welcome...



Aristedes Maniatis
Level 1, 30 Wilson Street Newtown 2042 Australia
phone +61 2 9550 5001   fax +61 2 9550 4001
GPG fingerprint CBFB 84B4 738D 4E87 5E5C  5EFA EF6A 7D2E 3E49 102A

Thomas Schraitle | 19 Oct 14:36 2015

How to Contribute to the DocBook Project on GitHub?

Hi fellow DocBookers,

thanks to the release of the new DocBook XSL stylesheets and the
move from SourceForge to GitHub. Great to see this!

Well, as the move to GitHub is still ongoing, I would like to shed some
light on two questions:

 1. How to contribute?
 2. Which branching model does DocBook follows?

It seems, at least to me, these aren't answered yet completely and
things are still a bit foggy. Be it for a new contributor or for an
old-timer. :) Also I couldn't find any information on GitHub in this
regard (although it is somehow implied coming from SourceForge).

=== 1. How to contribute?
What is the preferred method in regards to collaboration for
DocBook <at> GitHub? I can think of some scenarios:

a. Move all(?) DocBook users on SourceForge to GitHub and give them
   write permissions
b. Only a handful of users get write permissions, others have to create
   pull requests
c. Something completely different?

=== 2. Branching model for DocBook?
Does the DocBook project has decided yet about a branching model?

For example, some projects consider the master branch as "holy" and
only stable releases are published. Others create features in a special
branch and merge them into master after the feature is finished. Some
project use a develop branch etc. So there are almost endless
possibilities with Git in comparison to SourceForge.

Speaking of a develop branch: In this regard, I made some good
experiences with GitFlow[1]. It's "a collection of Git extensions to
provide high-level repository operations for Vincent Driessen's
branching model[2]" according to its home page.

What do you think? :)



    Thomas Schraitle