Re: [Boost-docs] The beauty of LATEX

Subject: Re: [Boost-docs] The beauty of LATEX
From: Joel de Guzman (joel_at_[hidden])
Date: 2011-10-26 10:02:09

On 10/26/2011 4:41 PM, Daniel James 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 <matias.capeletto_at_[hidden]> 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. the
> templates have been expanded. So you probably need some form of representation, i.e
> document's 'DOM' (although I'm not suggesting that you copy XML's DOM), which you can
> transform appropriately. As far as I can tell, the language you're proposing isn't
> designed to deal with this. I mentioned the 'block' element not to suggest it should be
> used here, but to point out it's an attempt at dealing the same problem. You'll need a
> much richer representation.

Obviously, we disagree here. I believe the wiki can and should be
a preprocessor without full knowledge of the full document schema.
I think you are overstating the scope of "the problem", which is
simply to know what are to be considered blocks and phrases. There
are various ways to deal with this. Matias suggested a simple
solution. There surely are other solutions.

Regards,
-- 
Joel de Guzman
http://www.boostpro.com
http://boost-spirit.com