Stories
Slash Boxes
Comments
NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.

All the Perl that's Practical to Extract and Report

use Perl Log In

Log In

[ Create a new account ]

pjf (2464)

pjf
  (email not shown publicly)
http://pjf.id.au/
AOL IM: miyuki3k (Add Buddy, Send Message)
Jabber: pjf@jabber.org

I run Perl Training Australia [perltraining.com.au].

I help with Melbourne Perl Mongers.

I spend an awful lot of time talking about Perl, and have had my picture in the Australian newspapers with a camel. That's rather scary.

Journal of pjf (2464)

Wednesday September 14, 2005
10:46 PM

No more docbook

[ #26729 ]

No more docbook
For historical reasons, our build environment for our course materials has been docbook, and it's never really agreed with me. Sure, it's open, free, and powerful, but I've never considered it to be at all human friendly. All those tags just get in the way.

Having said that, we still want to use docbook as our build platform; it produces good looking books and we have literally hundreds of thousands of words already written in docbook. I just don't want to have to write any more.

Luckily, Pod::Docbook appears to do a pretty good job of converting POD into docbook. That's a good thing, because POD is what I use for writing articles, program documentation, Perl Tips, and just about everything else except for web content.

The most lovely thing is that I don't lose any power by writing in POD. If I need to jam in some docbook-specific tags, I can do so with =for docbook for a little bit, or =begin docbook for a big chunk. Now I can have my cake and eat it too.

The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
 Full
 Abbreviated
 Hidden
More | Login | Reply
Loading... please wait.