XSL template for Generating Per Page TOC for Docbook HTML Output

Sometime back I worked on this upcoming Ruby On Rails Book and helped the author convert his docbook to various formats like HTML, PDF, EPUB, Kindle etc. While working with the HTML output, I figured that the standard output spewed out by the Docbook XSL stylesheets is quite boring. So I improvised a lil, added per page TOC, pretty css, icons etc. I spent quite some time on the per page TOC feature. Here’s the XSL template that I wrote for the TOC. Continue reading

New Technical Documentation Sites for Open Source Software

I dislike the documentation sites that most open source softwares have, they usually lack character. However the good news is that since a lot of documentation is in docbook it can be easily converted to HTML, PDF etc very easily and you can style it the way you like it. I have been working on docbook and docbook conversion for the past 3 months and have learnt enough to make decent looking documentation. So I decided to convert some open source documentation and slap some css on it. Here are the preliminary results: Continue reading