<?xml version="1.0" encoding="UTF-8"?>
<essay xml:lang="en" version="pto" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:gal="http://norman.walsh.name/rdf/gallery#">
<info>
    
    
    
    
    
    
    
    
    
<title>Buy This Book!</title><biblioid class="uri">http://norman.walsh.name/2003/07/08/buythisbook</biblioid>
<volumenum>6</volumenum>
<issuenum>54</issuenum>
<pubdate>2003-07-08</pubdate>
<date>$Date: 2005-09-11 10:27:02 -0400 (Sun, 11 Sep 2005) $</date>
<author>
      <personname>
<firstname>Norman</firstname>
	<surname>Walsh</surname>
</personname>
    </author>
<copyright>
      <year>2003</year>
      <holder>Norman Walsh</holder>
    </copyright>
<abstract>
<para>If you use DocBook, odds are good that you use the DocBook XSL Stylesheets.
If you use the stylesheets, odds are better than good that you'll want this book.</para>
</abstract>
<dc:subject rdf:resource="http://norman.walsh.name/knows/taxonomy#DocBook"/>
</info>
<epigraph>
<attribution>J. R. Lowell</attribution>
<para xml:id="p1"><indexterm>
	<primary>Lowell</primary>
<secondary>J. R.</secondary>
      </indexterm>The intellect is a
diœcious plant, and books are the bees which carry the
quickening pollen from one to another mind.
</para>
</epigraph>

<para xml:id="p2">Authoring in XML is a two-step process: first you put
information into XML, then you get it back out. The advantage of XML
over other authoring processes is that you have a lot more flexibility
in how you get it back out.</para>

<para xml:id="p3">Turning that flexibility from thoretical possibility into
practical reality requires tools with enough power to do
interesting work and a thorough understanding of how to customize those tools
to do the work that's actually interesting to you.</para>

<para xml:id="p4">In the DocBook world, the
<link xlink:href="http://docbook.sourceforge.net/">DocBook XSL Stylesheets</link>
are a very commonly chosen tool. I won't assert that they're the most commonly
chosen, but neither would I be surprised to find that they were.</para>

<para xml:id="p5">The best way to gain a thorough understanding of the stylesheets it to
buy <personname>
      <firstname>Bob</firstname>
      <surname>Stayton</surname>
    </personname>'s
excellent
<link xlink:href="http://www.sagehill.net/book-description.html">
      <citetitle>DocBook XSL:
The Complete Guide</citetitle>
    </link> and read it.</para>

<para xml:id="p6">The guide provides a well-paced introduction to stylesheet
customization<footnote>
      <para xml:id="p7">In fact, it's likely a useful book for any XSL
practitioner, whether you use DocBook or not.</para>
    </footnote> leading the reader
from the simple, straightforward changes that can be achieved simply by setting
parameters, to quite complex topics like title page layout and configuring
internationalized generated text. The guide covers both HTML and XSL FO (print)
customizations.</para>

<para xml:id="p8">Bob is a long-standing contributor to the stylesheets themselves
and a generous and diligent participant on the DocBook and
DocBook-apps
<link xlink:href="http://lists.oasis-open.org/ob/adm.pl">mailing lists</link>.
This has given him keen insight into the areas where inexperienced
authors and stylesheet writers are most likely to stumble. The guide
pays special attention to those areas, offering detailed explanations of
modularity, profiling, cross-document linking, verbatim listings, and table
handling, for example. There's even a discussion of <application>Website</application>, a
fairly radical customization of DocBook designed for producing web sites instead
of documents.</para>

<para xml:id="p9">As someone who cares a lot about DocBook, I think it would
difficult to overestimate the value of <citetitle>DocBook XSL: The
Complete Guide</citetitle>. I'm confident it will make the stylesheets
accessible to a whole new community of users.</para>

<para xml:id="p10">Congratulations, Bob!</para>

</essay>

