Re: Sphinx integration

John Maddock <[email protected]>
Newsgroups gmane.comp.lib.boost.documentation
Message-ID <F2EE56FF2748460D8D2D472E965849BA@acerlaptop>
>> 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.

John.

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 ;-)
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.