discuss: anybody here used DocBook 5.0?
Subject:
Re: anybody here used DocBook 5.0?
From:
Leo Noordergraaf ####@####.####
Date:
9 Feb 2016 19:58:33 +0000
Message-Id: <56BA4526.90600@noordergraaf.net>
Hi Martin,
I used DocBook 5 on the Linux Assembly HOWTO.
I used xmlto with dblatex to generate pdf, xmlto itself is able to
generate epub and html versions.
I haven't used namespaces as I converted an older, no longer maintained,
document to docbook 5.
Commands used (lifted from makefile):
xmlto --with-dblatex pdf Assembly-HOWTO.xml
xmlto epub Assembly-HOWTO.xml
xmlto html Assembly-HOWTO.xml
regards,
Leo
On 02/09/2016 06:09 PM, Martin A. Brown wrote:
>
> Hello all,
>
> Has anybody here used DocBook 5.0 yet? I have not.
>
> I have skimmed through parts of the DocBook 5.0 transition guide:
>
> http://www.docbook.org/docs/howto/
>
> My observations:
>
> * The namespace bits seem powerful and one of the big reasons
> anybody would choose DocBook 5.0. My lay understanding is that
> this allows multiple XML vocabularies to be used intermixed in
> a single document.
>
> * The toolchain looks largely the same as the xsltproc + XSL
> toolchain that I've grown accustomed to using with DocBook XML.
>
> * I saw xlink:href elements in some DocBook 4.x documents in our
> collection and wondered why somebody had used that notation.
> Now, I know. This would be a valid declaration for a DocBook
> 5.0 document in which somebody wanted to included links to,
> let's say, other websites:
>
> <article xmlns="http://docbook.org/ns/docbook" version="5.0"
> xmlns:xlink="http://www.w3.org/1999/xlink">
>
> Anyway, I'm asking if anybody else has used DocBook 5.0 and would
> share any (other) tips, pointers, Makefiles, CLI invocations or such
> jazz.
>
> -Martin
>
> P.S. Yes, I'm also lurking on the public docbook and docbook-apps
> mailing lists where the DocBook standard and some of the
> toolchains are discussed. Hoping to osmotically absorb some
> knowledge there.
>