[Box Backup-dev] [Doc] Pulling fluffy.co.uk documentation into DocBook

Martin Ebourne boxbackup-dev at fluffy.co.uk
Wed Mar 8 20:22:58 GMT 2006


On Wed, 2006-03-08 at 11:49 -0800, Per Thomsen wrote:
> Doc-enthusiasts, :-)
> After a busy couple of weeks, I now have some time to dedicate to the
> project again. I am starting to pull all the documents from Ben's web
> site into DocBook as a starting point.

Sounds like its already done, but the wiki docs are more up to date than
what is on Ben's site, so they would be a better place to start from.
eg. I've updated the wiki docs to cover the autoconf changes in 0.10.

> I have questions that I have yet to figure out about the HTML
> conversion. I would like to make the HTML docs look as much as possible
> like Ben's web site. I haven't looked at XSLT tools like Xalan, Saxon or
> any of those tools yet, so if anyone has good/bad experiences, let me know.

I would think that using stylesheets would be the best way of getting
the formatting you want. That way the html output from docbook can be
quite simple. I haven't checked to see if Ben is using stylesheets
already, but if he is then that would make it really easy.

As to xslt, it's all good fun, but a bit of a paradigm shift from most
other things, and complex ones can mess with your sanity. :)

Cheers,

Martin.




More information about the Boxbackup-dev mailing list