Re: [Boost-docs] Sphinx integration

Subject: Re: [Boost-docs] Sphinx integration
From: John Maddock (boost.regex_at_[hidden])
Date: 2011-09-28 16:09:22

>> Perhaps quickbook to reStructuredText is a feasible solution.
>> Then all move to writing in reStructuredText, etc.
> But then there's the issue of lossiness.

And lets not forget that some of us really like quickbook ;-)

Also some things like the Math docs have some complex quickbook templates
for generating differing content for PDF and HTML output in order to support
equations etc.

Which is not to say that Boost.Build couldn't support RestructuredText to
facilitate building such docs - then if they can be built as PDF's (I assume
there's a way?) the Boost-wide PDF build could incorporate the Restructured
Text docs as well as the Docbook ones.


PS I don't follow why quickbook "makes you think like a programmer", it
doesn't do for that to me at all (I hope!), what it does do though is force
me to think about the structure of the document as well as the content, and
IMO that's not a bad thing - for me anyway ;-)

This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:41 UTC