[Boost-docs] Having fun with Quickbook translations!

From: Matias Capeletto (matias.capeletto_at_[hidden])
Date: 2007-06-21 20:15:03

Hi,

This morning John pointed me a css hacked by Rene Rivera that lets us
"see" a normal html page as quickbook sources. I think it is a
brilliant idea.
I have hacked the missing parts to carry this idea to a neat end.
Please go to:
http://tinyurl.com/3yukos

Use a decent browser like firefox 2. (and make sure the page is not
cached in your pc)
Go in the menu to "View" --> "Page Style" --> "Quickbook Source"

Magic!
:)

You can browse the document because I have not hidden the navigation machinery.
Now you guys have to find a way to copy the result, ctrl-c in firefox
does not work... I do not care. If we have to hack firefox sources,
lets do it ;)

Two cases:

(A) Docbook to quickbook translation
This will be a piece of cake. We convert the boostbook xml into html
using xslt and then see it as quickbook sources with our favourite
browser.

(B) Not docbook based Html translations
We can be made it in two ways:

1) Use a version of this css that lets as see html as quickbook. You
can see the results with a bind page here:
http://tinyurl.com/2jh25t

The results are not so good as before, no navigation support, no
admonitions rendering...

2) A better option is to use a program to convert html docs to docbook
docs. There are plenty of these programs in the web, we must find the
best one for us. And we are back to case (A)!

My next step is to write a "conversion section" to include in quickbook docs.

Thanks you Rene! An amazing idea :)

Hope you like it
Best regards
Matias