Re: [Boost-docs] The beauty of LATEX

Subject: Re: [Boost-docs] The beauty of LATEX
From: Matias Capeletto (matias.capeletto_at_[hidden])
Date: 2011-10-25 09:14:06

On Tue, Oct 25, 2011 at 1:43 AM, Joel de Guzman
<joel_at_[hidden]> wrote:
> Currently, the wiki processor detects two newlines as a paragraph.
> I think it should be more smarter than that. It should be able
> to detect non-paragraphs and act accordingly. That means, detecting
> the presence of "[section", in this case, or any other potential
> non-paragraphs.

So the wiki processor will have to know before-hand the names of the
templates that do not have to be treated as a paragraph ( [section
...], [endsect], [table ...], [warning ...], etc). In this case, the
user won't be able to define new templates that require the same
special treatment. ( [custom_section ...], [custom_image ...],
[custom_table ...], etc ), except we devise a mechanism to handle
these names to the wiki processor.

Because this kind of interaction between the template system and the
wiki processor is not very clean, maybe we could solve this problem by
saying that the wiki processor will consider that any lines that are
wrapped by a template are not considered a paragraph.

  This is a [*paragraph].

  [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]

with a [para ...] template:

  [para [custom_bold Now it is]]

We can even avoid this for the common standard templates like [* ...].

This could simplify a lot the logic of the wiki processor (and its
interaction with the template system) at the cost of changing the
behavior of what I think are corner cases.

> The crucial point is that the template processor should be
> 100% regular and free from these quirks.

I totally agree with this.

Best regards
Matias