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 ;-)