Archive for March, 2011

Save a Dave

Posted in Uncategorized on March 21, 2011 by jkiparsky

I don’t listen to No Means No very much – only under duress – and I don’t really like their music a lot, but I just bought a couple of T-Shirts from them. The money’s going to helping out a guy called Dave Melrose, who has apparently gone and got cancer, the silly goose. This guy, instead of being a jerk like most people, has spent his time teaching kids chess which makes him a fine human being in my book.

You should buy a t-shirt or 7, or else just send the guy a few bucks ’cause after all, this is the sort of guy we want to keep around.

That will be all.

What I Know About DocBook

Posted in Uncategorized on March 15, 2011 by jkiparsky

I’ve started using the Oxygen editor in my work to create documents using the DocBook schema. This seems a pretty useful combination to me, so I’m putting together some of the references that I’ve found, mostly so I can find them easily and also on the off chance that others might find this useful.

Feedback from those who find this useful will of course encourage me to continue adding to this.

DocBook Reference – the home page for the book, and central point for many resources.
The book itself – slightly buried in that page. This is a link to the free online version, which documents DocBook 5.
DocBook XSL: The Complete Guide. This is what you need to know to customize your output. For example, I didn’t want links printed in the PDF version of my documentation – I found the trick for it in a few minutes, in this book. Very handy stuff.

While I’m a free software nut, I don’t object to proprietary stuff on principle. The Oxygen editor is the tool I’m using, and it’s working pretty nicely for me.

I’ve also come across the XMLmind editor, but I haven’t tried it yet. Looks promising, though, and the personal edition is free.

More distantly related references:

The Text Encoding Initiative
– handy stuff about XML, XSL, etc.

More references will be added as I come to them.