12 August 2010

A geek at heart

I'm learning how to write documentation using the DocBook format... and it's quite a learning curve, but I'm enjoying the challenge. The XML aspects are fine – I've got a fairly good grasp of that side of things – but the practicalities are proving interesting.

I've got a number of files to convert from unstructured FrameMaker files to DocBook format. That is relatively straightforward, although I think there's going to be a fair amount of manual intervention involved one way or another.

I've then got to work out how I'm going to publish the resulting book as a PDF. I can use FrameMaker to do that bit, but part of the reason for the change is to remove reliance on any one tool. There are a lot of other products out there that do the same thing, but in slightly different ways.

I'm enjoying working within the constraints of the schema, and the construction of the documents is (obviously) very logical. Watch this space and I'll let you know how I get on...

No comments:

Post a comment

Comments are welcome - but we will delete any that appear to be spam. If you need an answer to a specific question, please visit the website and send it using our contact form (links on the right of the blog).