Customer Reviews

DocBook Xsl: The Complete Guide

5 star:		(6)
4 star:		(0)
3 star:		(0)
2 star:		(0)
1 star:		(0)

 

 

With this book and "DocBook: The Definitive Guide" in-hand, I
really can't imagine any other DocBook guide you'll ever need.

The book thoroughly covers just about every possible aspect of
DocBook publishing (that is, generating HTML, PDF, HTML Help, man
pages, etc. from your DocBook XML source) -- from general tool
setup down to the level of stuff like fine-tuning content of
headers and footers, title pages, cross-references, indexes, etc.

I have reviewed and used it a lot, and tried hard to come up with
suggestions for Bob for topics that should be added to it. But I
rarely manage to find anything that it doesn't already cover. When
I have a DocBook publishing question, I can almost always find the
answer in this book.

And if you're not familiar with the author, here are some details:
in the DocBook world, Bob is basically "The DocBook Answer Man" --
he is the most active contributor to discussions on the
docbook-apps mailing list (where DocBook publishing and tools
discussion takes place) -- patiently answering "How do I..."
questions posted by new users and following up on DocBook XSLT
stylesheet bug reports.

He's also a member of the DocBook Technical Committee, responsible
for overseeing refinements to the DocBook vocabulary, and he's a
major contributor to development of the actual DocBook XSL
stylesheets themselves.

Which is all a roundabout way of saying that this guy knows his
stuff, and in buying and using this book, you'll be benefitting
from a wealth of knowledge and experience with DocBook that you'll
not find anywhere else.

I purchased that book as soon as it came out: I just knew I'd need it some day. That day came three weeks ago and I got into the book with a vengeance. I needed to utterly customize the docbooks stylesheets and produce 12'000 different pdf's in four languages out of a huge documentation DB. With the book next to me it was a breeze. Extremely well written, knowledgeable, accurate, just verbose enough to get the point across and and and.

Beware: this is a book for people who are already very well versed in docbook in general, and in XSL in particular.

One does wish the author would have offered ant versions of his scripts as well as Make versions. But that's a matter of taste.

This book needs to be beside the computer (and I do mean RIGHT beside) anyone who is attempting to support or modify docbook applications for the first time. Do that, and you may just be able to put away the extra strength excedrin. Without it, you might have a few problems......

Here's why:

Last year, I had the pleasure of implementing docbook for a large company down in Oklahoma. However, I didn't know much about XSL at the time or for that matter docbook; other than how to markup documents and make changes to the DTD. In other words I was a rookie. I had two tools at my disposal; the definative guide and docbook documentation. Any developer would understand what a rookie who is trying to muddle through docbook documentation is trying to go through..... I had a bit of consulting from Arbortext but other than that I was on my own. The definitive guide has very little information on publishing XML information and barely even mentions XSL. Thus, my modifications consisted of looking at existing code and attempting a patch job. Even with the training I'd had on XSLT it did not help me to find files that I didn't know existed. This book solves that problem and gets you off the ground running.

While the book is NOT a tututorial on XSL is does give a brief overview on the subject. This book talks about implementing XSL in a docbook environment as there are plenty of books in the market that teach you how to code XSL. An understanding of XML is expected and knowledge of docbook is certainly helpful. Topics covered include how to find docbooks XSL stylesheets (or obtain them for free, if you don't already have them)and tells you how to set them up, customize them for your environment, use special stylesheet output features and work with docbook options.

In short, if you need to learn how to implement XSL in a docbook environment; get this book in your hands and don't let it go. It's too valuable a commodity!

This book is, without a doubt, one of the most helpful resources available to anyone seeking to understand DocBook XSL. Bob Stayton has done an incredible job gathering everything you need to know regarding this topic, and he presents it in a style that is both easy to navigate and easy to understand.

DocBook XSL: The Complete Guide takes the reader from the very beginnings of how to create custom output (whether print or HTML) using DocBook XSL. It includes information on the tools you need and how to set them up, giving you all the information you need to get started. But this book doesn't stop there--it continues with detailed, organized information on the myriad of ways you can create custom stylesheets that will generate your project precisely the way you want it. Everything is covered--from titlepages to bibliographies, this book leaves no topic unexplained.

It is extremely rare to find a book that truly is a complete guide to its subject matter. DocBook XSL: The Complete Guide more than lives up to its name--you will not find a better resource for understanding DocBook XSL.

Yes, I know there is another manual but it's more of a starter. This is the book you need to help you figure out how to actually make Docbook work. I keep it by my side (and have advised an intern working in Docbook to do so as well). I guarantee if you get on the Docbook-apps discussion list, and ask a question most times the answer will come out of this book.

If you have DocBook markup that you need to turn into html or pdf YOU CANNOT LIVE WITHOUT THIS BOOK! That's right I'm shouting. This book is really that important, and that well written. Do bear in mind that you need to know a thing or two about XSLT and XSL-FO or you won't understand a thing you are reading.

The DocBook stylesheets have been carefully written to be both customizable and extensible; after all, no two organizations are likely to have the same format requirements for their documents. This book describes how you can develop your own customization layer between the DocBook stylesheets and your formatted document. Most developers, even those with a lot of time on their hands, would be unlikely to discover all of the techniques described in this book for accomplishing that task.

This book is especially useful if you need to produce pdf documents using XSL-FO. The html output is nice but you can easily format it with CSS. XSL-FO is a large and complex specification for marking up text and images to produce pdf documents. XSL-FO is so detailed that it takes a ton of markup to create even a modest document. The DocBook stylesheets generate a ton and a half of XSL-FO markup and the beauty of the techniques described in this book is that you only modify those things that represent the special needs of your document. I totally agree with previous reviewers, this book is essential.