Re: The beauty of LATEX
Dave Abrahams <[email protected]>
| Newsgroups | gmane.comp.lib.boost.documentation |
|---|---|
| Message-ID | <[email protected]> |
on Wed Oct 26 2011, Daniel James <dnljms-AT-gmail.com> wrote: > On Tuesday, 25 October 2011, Joel de Guzman wrote: > > On 10/25/2011 6:02 PM, Daniel James wrote: > > On 25 October 2011 10:14, Matias Capeletto < > [email protected]> wrote: > >> > >> [custom_section This is not] > >> > >> The only thing that it will change for the user is that he > will have > >> to wrap this kind of lines: > >> > >> [custom_bold This is not a paragraph] > > > > If anyone doesn't realise, I proposed a 'block' element in > another > > thread to deal with this issue. > > I think I'm still confused with it and the whole lot of issues > including how it was before and how it is now, etc. Can we do a > reset and tell us how this 'block' element can help with the > issues we are discussing (namely the wiki as a decoupled > preprocessor and a template engine that does not know anything > about wiki style markups), please? > > > The problem is that to do a decent job of generating documentation, > the engine needs to understand the document structure (for > chunking, generating paragraphs, anchor placement, footnotes etc.), > and that can't be known until after templates have been expanded. So > you probably need some form of representation, i.e. the document's > 'DOM' (although I'm not suggesting that you copy XML's DOM), which you > can transform appropriately. I'm not sure I follow Daniel's argument, but I agree that any attempt to do this without a DOM or AST or some other structured abstract representation would be a step backwards from best existing practices in this domain. -- Dave Abrahams BoostPro Computing http://www.boostpro.com _______________________________________________ Boost-docs mailing list [email protected] http://lists.boost.org/mailman/listinfo.cgi/boost-docs