Robert Nagle | 30 Nov 09:32 2015

embedding fonts in epub? (and docbook for publishers -- hurrah!)

I'm at the final stages of making an epub file, and I was wondering if  there's an easy way to declare a font file for embedding.

I generally am fine with manually moving over assets into the output folder. But apparently a reference appears in the opf manifest file.

To add the reference you need to declare the location in the css (check!) and declare it in the OPF manifest (oops!)


When the epub stylesheets were written, support for embedding fonts was practically nonexistent, but now I think all the major platforms support font-embedding.

(By the way, a great reference on all aspects of using embedded fonts in ebooks is here: )

Perhaps -- if it's not already done, this could be handled as a parameter. I'll be happy to write up a feature request.

Wow, the most recent stylesheets  have been written to support Docbook for Publishers... That's a big deal for me and greatly appreciated. (I just learned this .... 5 minutes ago!) Too bad, because it would have helped with my current ebook (whose deadline is rapidly approaching). But I have several other ebooks to try it out on over the next few months. In 2013 I used Docbook to produce a dramatic text... and some of those elements could have come in handy at the time......

Robert Nagle
3000 Greenridge Dr #2204, Houston TX 77057-6037  
(Cell) 832-251-7522   Carbon Neutral Since Jan 2010

Olivier Ishacian | 19 Nov 21:16 2015

[ANN]XMLmind XML Editor users, directly import DOCX files as simple, clean, valid DITA, DocBook, XHTML

XMLmind XML Editor users, directly import DOCX files as  simple, clean, valid DITA, DocBook, XHTML
using new "Word To XML" add-on.
Simply use "Options|Install Add-ons" to download and install this new add-on.
Olivier Ishacian | 19 Nov 21:11 2015

[ANN] Automatically convert DOCX to simple, clean, valid HTML, DITA, DocBook, XHTML

Automatically convert DOCX to simple, clean, valid HTML, DITA, DocBook, 
XHTML using new XMLmind Word To XML product.
Rob Flynn | 18 Nov 16:51 2015

docbook-xsl-ns-1.76.1 fo numbered list issue



I’ll start by saying that I don’t know a lot about docbook fo, and that I’m stumped after searching Google and stackoverflow. I’m assuming that everyone on this list knows more than I ;]


I’m having an issue with my PDF output where numbered lists greater than a single digit (10+) are formatted with the number too close to the text.


The internet tells me that this can be adjusted using the provisional-label-separation attribute in a list-block. I looked at:




but can’t find where all numbered lists are set.


Do anyone know how to adjust this?


Rob Flynn



Frank Arensmeier | 6 Nov 16:59 2015

Chunking options for HTML output


I am wondering. DITA has the attribute "chunk" that gives the user some control about how a topic/section is
treated when it comes to output chunking. Setting that attribute to "to-content", the topic (including
its children) is "… rendered as a single chunk of content". Is there something similar in DocBook? I know
that I can control the chunking level – but that’s a different story. I need a more fine-grain control
for the chunking mechanism. Could this be achieved in a customisation? Which "key" stylesheets in
DocBook XSLT would be promising candidates to look at?

Thank you!
Lars Vogel | 2 Nov 15:57 2015

Correct usage of the copyright tag


what is the "correct" way of using the copyright tag for multiple years?

I used to use the following:


But that results in the PDF output to:

Copyright © 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015 Someone

Should I only write the following?

            <year>2007 - 2015</year>

Best regards, Lars

Niels Müller | 29 Oct 10:09 2015

Slides with Docbook

Hi everyone

Does anyone make slides with docbook 5? If yes, how?
Don't get much info via Google, and what I get is old ;(
I need a good ref or an alternative idea.




Niels Muller Larsen, MSc
Programmer, Assoc Professor

<Mercury> knghtbrd: Eww, find a better name, the movie sucked.. <G>
<Knghtbrd> Mercury: The engine is better than the movie
Karl O. Pinc | 28 Oct 19:23 2015

Getting more output from <author> & <othercredit>


Is there a handy way of getting more of the elements
contained in <author> or <othercredit> into the output?
I'm interested in elements like <email>, <uri>,
and the content of <affiliation>, like <orgname>.


Karl <kop <at>>
Free Software:  "You don't pay back, you pay forward."
                 -- Robert A. Heinlein
Karl O. Pinc | 28 Oct 03:16 2015

Output order of elements contained in <personname>


I'm using DocBook 5.0.

Elements contained in <personname> can come 
in any order within a document
but they are not output in the order input.
Right now they are always output in the
order <honorific> <firstname> <surname>
<lineage>.   (At least from inside an
<author> element.)

This fixed output order is not suitable
in the general case.  Better
would be to output in the order input,
as with para.

Having brought forward the issue, what
happens next?


Karl <kop <at>>
Free Software:  "You don't pay back, you pay forward."
                 -- Robert A. Heinlein
Mark Craig | 24 Oct 09:00 2015

mark.optional.procedure.steps for HTML in 1.79.0?


In testing 1.79.0, I was pleased to find this turned on by default:

What is the equivalent parameter for HTML output?

Peter Desjardins | 22 Oct 03:58 2015

Re: [docbook] TOC with parents

I think reverse engineering might work well. The template that writes
the full TOC is here (I think):

The "docbook" list is for discussing DocBook XML semantics and
structure. The "docbook-apps" list is for discussing publishing and


On Wed, Oct 21, 2015 at 9:51 PM, Aristedes Maniatis <ari <at>> wrote:
> Thanks for that hint. I didn't know that, and perhaps I should try to reverse engineer how webhelp works in
this regard. But I'd rather not start from scratch since I have extensive styling already around the
existing html output and I don't want to change anything other than generating the TOC in a different way.
> Ari
> BTW: what is the difference between docbook and docbook-apps mailing lists? Are they meant to represent
docbook-dev and docbook-users?
> On 22/10/2015 12:46pm, Peter Desjardins wrote:
>> [moving to docbook-apps]
>> What you are describing sounds like the webhelp output. Did you
>> consider using that?
>> Webhelp produces HTML pages with the full TOC on each page. I have
>> customized the HTML and CSS significantly to match different web sites
>> and branding.
>> Peter
>> On Wed, Oct 21, 2015 at 9:39 PM, Aristedes Maniatis <ari <at>> wrote:
>>> 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="."/>
>>>             </xsl:apply-templates>
>>>         </xsl:for-each>
>>>     </xsl:template>
>>> but it doesn't work. I'm a bit out of my depth with this level of XSLT hackery. Any help would be welcome...
>>> Ari
>>> --
>>> -------------------------->
>>> Aristedes Maniatis
>>> ish
>>> 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
> --
> -------------------------->
> Aristedes Maniatis
> ish
> 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