Monday, November 9, 2009

Before I was interrupted...

Hmm, as I was saying before I was interrupted, I've been learning more about DocBook, and as should be obvious to anyone following this blog or my microbloging outlet, I have also been learning XSLT.

DocBook is a good format, it seems to have all the attributes from LaTeX and troff that I desire, it's as easy as HTML (in which I am generally fluent), and just like it, is available in XML-based variants ;). Personally, I consider RST the easiest method of preparing documents. The principal problem with RST, being the available formatters: it works good for generating HTML output for the web, but not quite ready for manual pages just yet.


Some people might have issues with writing in XML/SGML like markup languages, but I do not; in fact, I feel more comfortable with DocBook, because there is *no* real presentational crap bloated into it, not to the level that HTML has been mutilated beyond permanent scaring... so yeah, I like it. Even better is being able to use DocBook with XSL/CSS related data to control the outputs. I'm a freak, I like to have central sources for documents, that I can keep under version control, unlike Word docs; and preferably a document that I can read, either in my text editor, a document viewer (ala PDF & PostScript), or copy/paste into a web page. DocBook is a very highly structured way of describing the contents of a document, which further mates well with my insane mind.


Likely I'll be writing new HOWTO, guides, manuals, reviews, and so on in DocBook; any pertinent documents in existence now, will likely be converted over to DocBook. I will probably write suitable stylesheets for creating posts on my Live Journal here, and forum posts in BB Code.

No comments:

Post a Comment