Re: [Boost-docs] [Improving Boost Docs] Help request, html to docbook

From: Matias Capeletto (matias.capeletto_at_[hidden])
Date: 2007-06-24 17:07:30

On 6/24/07, Glyn Matthews <glyn.matthews_at_[hidden]> wrote:
> Hello,

Hi!

> On 22/06/07, Matias Capeletto <matias.capeletto_at_[hidden]> wrote:
> >
> > In order to have a complete conversion tool chain we need to find a
> > good open source tool that converts html to docbook.
> >
> > The task will be to investigate available options and came up with the
> > best solution for us, testing it doing a proof of concept html to
> > quickbook conversion.
>
> Is this still a project looking for an owner?  I'm willing to donate some
> time to this.

Big yes!
(you do not have an idea how happy you just make me!)

> What kind of thing are you looking for exactly?

I have in my local copy a version of the Quickbook Source css that
works in Opera, a browser that let us copy and paste the result.
Translating docbook based docs is now very very easy.

docbook --[ boostbook+xsltproc ]--> html ---[ Quickbook source
stylesshet ]--> quickbook

There are a lot of tools to convert html to docbook. If we find one
that it is easy to use and produces a decent result we can do
conversions like:

html ---[ Tool missing ]---> docbook ---( above conversion chain )---> quickbook

The project involves finding the best open source html to docbook
conversion tool.
In order to work together as a group we need to use the wiki a lot.
Please create the page of this subproject and showcase the problem,
the possibilities, your rationales and the proposed solution, once you
have one ;)
Try to write this page in a way we can easily extract it from the wiki
and use it for our docs. I think it can be a good subsection inside a
"converting your project to Quickbook" section in Quickbook docs.

Thanks a lot!
Best regards
Matias