No more docbook

(You can suggest changes to this post.)

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.

Bitcoin QR code This site is ad-free, and all text, style, and code may be re-used under a Creative Commons Attribution 3.0 license. If like what I do, please consider supporting me on Patreon, or donating via Bitcoin (1P9iGHMiQwRrnZuA6USp5PNSuJrEcH411f).

comments powered by Disqus