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

[Per Thomsen]

On 3/8/06 12:22 PM, Martin Ebourne wrote:
> 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 haven't started yet, so I'll take the baseline from the Wiki instead.
>> 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.
>   
There are stylesheets at fluffy.co.uk, and they are a good starting
point is, but they are minimal, and would need some rework to be able to
style the converted docbook stuff. Still, a tool for converting from
docbook (not necessarily XSLT based), to HTML, including a stylesheet
would be nifty.
> 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. :)
>   
I was sorta hoping that Xalan or Saxon would make it easy. And the idea
would be to convert to static HTML, not use an XSLT stylesheet
dynamically. I don't want a server to have to have mod_xslt (or whatever
it's called) installed to serve Box Docs.

Thanks,
Per

-- 
Per Reedtz Thomsen | Reedtz Consulting, LLC | F: 209 883 4119
V: 209 883 4102    |   pthomsen@reedtz.com  | C: 209 996 9561
GPG ID: 1209784F   |  Yahoo! Chat: pthomsen | AIM: pthomsen