Amaury / SkrivMarkup

Interpreter of the Skriv Markup Language.
GNU Lesser General Public License v2.1
25 stars 3 forks source link

Difference between inline and block extensions? #23

Open bohwaz opened 11 years ago

bohwaz commented 11 years ago

I find that the two different syntaxes for inline and block extensions is too complicated.

Why can't we have the same syntax for both? Example:

<<lipsum|2>>

<<translate|french|english
manger
>>

I also find it rather disturbing that "inline" extensions (like lipsum) can generate block content. eg. lipsum generates paragraphs. If an extension is "inline" shouldn't it only generate inline content?

If the syntax difference between inline and block extensions was to be removed it would be easier to understand, because either it's inline and the extension tag doesn't have any content except for parameters, either it's block and it has content over multiple lines.

I also just noticed that in the repository the lipsum extension is a block one, but is shown as an inline one on the syntax documentation page...

Amaury commented 11 years ago

You're right, the documentation is confusing. In fact, the real specification of lipsum extension is on its proposal page, where it's defined as a block one. I should change the documentation to reflect that. And yes, inline extensions must generate inline HTML tags only.