Subject: Re: [boost] [Boost-docs] [quickbook] Thank you Daniel James
From: Daniel James (dnljms_at_[hidden])
Date: 2014-06-04 11:51:33
On 4 June 2014 16:19, Rene Rivera <grafikrobot_at_[hidden]> wrote:
> On Wed, Jun 4, 2014 at 10:12 AM, Peter Dimov <lists_at_[hidden]> wrote:
>> Andrey Semashev wrote:
>>> On Wed, Jun 4, 2014 at 6:51 PM, Peter Dimov <lists_at_[hidden]> wrote:
>>> > Glen Fernandes wrote:
>>> >> On Wed, Jun 4, 2014 at 7:21 AM, Rene Rivera wrote:
>>> >> > Thank Daniel for the continued work on Quickbook.
>>> >> Seconded.
>>> > Is there a tutorial somewhere that explains how, given a .qbk file, one
>>> > obtains viewable .html in the simplest possible way?
A while ago, I started writing some user documentation for the
documentation toolchain, although I stopped work on it for the git
transition. Progress so far is at:
>> Forgive the stupid question, but why does quickbook generate boostbook
>> xml, which then generates html, instead of quickbook generating html
> Not a stupid question.. Just a historical one. The precursor to quickbook
> did generate HTML directly. It was "ported" to generate docbook to have it
> integrate into the then newish Boost documentation toolchain based on
> docbook in order to simplify doc writing with a simpler wiki like syntax.
Yes, boostbook markup is hard-coded into a lot of places.
I had a crude html generator in the abandoned spirit 2 branch, I think
it's the only feature I didn't backport. It could do a passable job of
simple markup, but for complicated documents it wasn't much use.
Especially for documents which use doxygen, as that is used to
generate boostbook. I felt it was more useful to concentrate on
improving the language.
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk