Re: A downside of qbk
Stuart Dootson <[email protected]>
| Newsgroups | gmane.comp.lib.boost.documentation |
|---|---|
| Message-ID | <CA+L+JkuSu-VDPXe_wRfhkqOzMpi3skY8oFbq6Kzjk0hngigmZA@mail.gmail.com> |
On 8 November 2011 04:04, Dave Abrahams <[email protected]> wrote: > > on Sun Nov 06 2011, Joel de Guzman <joel-AT-boost-consulting.com> wrote: > > > On 11/7/2011 5:21 AM, Dave Abrahams wrote: > >> > > > >> on Sun Nov 06 2011, Dave Abrahams <dave-AT-boostpro.com> wrote: > >> > >>> I've been meaning to point out the difference between > >>> > >>> https://github.com/boost-lib/parameter/blob/master/doc/index.rst > >>> https://github.com/boost-lib/spirit/blob/master/doc/introduction.qbk > >>> > >>> As long as qbk is a full-fledged programming language, we may never be > >>> able to expect better. Any ideas? Does anyone think we can possibly > >>> convince GitHub to include a qbk processor? > >> > >> Actually, I just had an idea: make sure that qbk is an extension of > >> markdown syntax, which IMO is winning the wiki-like syntax wars. Then > >> we could get reasonable rendering for many things even where there's no > >> qbk support at all. > > > > markdown has similarities to qbk syntax. But then we have to > > tweak our qbk source to conform to its syntax. That would be > > tedious unless done automatically. Also, the markdown syntax > > will be a very small subset (e.g. does it even have tables at > > all? http://tinyurl.com/3qvtr). > > Yeah, sort of. > > http://michelf.com/projects/php-markdown/extra/#table > > maybe there are too many flavors of Markdown; I don't know. Maybe ReST > would be a better choice. > > -- > Dave Abrahams > BoostPro Computing > http://www.boostpro.com > > Might be worth having a look at MultiMarkdown ( http://fletcherpenney.net/multimarkdown/) - it seems to be gaining traction as 'the' extended Markdown, with quite a few features (including tables) over and above standard Markdown... It also has support for combining multiple MMD files (using an index file) to produce a single resultant document, which may be of use... Stuart Dootson _______________________________________________ Boost-docs mailing list [email protected] http://lists.boost.org/mailman/listinfo.cgi/boost-docs