John Maddock wrote: > David Abrahams wrote: >> I wish I had time to write this message right, so pardon my clumsy >> delivery. >> >> QB has quite a few advantages in terms of semantic capability, >> especialy where C++ is concerned. On the other hand: >> >> I think ReST designers have devoted a little more effort to keeping >> the documents readable as plain text. I wonder if we can learn >> anything from them there? >> >> ReST is written in Python, which is IMO a far superior language to >> C++ for DOM traversal/manipulation (it's too dynamically polymorphic >> a problem to be handled nicely in C++ IMO). Maybe we should be >> thinking about slapping a Python backend on QB? > > Gosh, Python with everything :-) > > I see where you're coming from, but having only scanned the reST docs, it > seems like there's already a lot of similarity between reST and quickbook, > the main differences seem to be: > > Links: at present I think I prefer quickbook. > > Tables: I have problems with quickbook tables once they have more than a few > elements, on the other hand I don't particularly want to start writing ASCII > art in the reST way either: though I accept it's good to look at, I wouldn't > want to come back later and try and insert more text into the middle of a > big table.
What could be a better syntax for tables? > Sections: I'm perfectly happy with quickbook here, although our chunking > needs tweeking a bit. Any chunking suggestion? > Footnotes/references: reST looks superior here (you can define a footnote > the first time you use it, and then refer to it from multiple locations), we > really need this one :-) I have a feeling that templates can help here too. I'll look into sometime. > macro/templates: reST doesn't have them?? Presumably you use a python > script to extend the engine > > Images: reST has more control it appears to me, at present quickbook doesn't > even begin to touch what DocBook can do (for example providing alt text plus > eps for PDF's and png for HTML output), however a template would do the > trick quite nicely here. Good points! Thanks John. Regards, -- Joel de Guzman http://www.boost-consulting.com http://spirit.sf.net _______________________________________________ Boost-docs mailing list [email protected] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
