XEP-0393: simplify block parsing

This commit is contained in:
Sam Whited 2018-02-15 15:22:28 -06:00
parent 60df13b76d
commit 15faf862c6
1 changed files with 19 additions and 9 deletions

View File

@ -25,6 +25,17 @@
<supersededby/> <supersededby/>
<shortname>styling</shortname> <shortname>styling</shortname>
&sam; &sam;
<revision>
<version>0.1.3</version>
<date>2018-02-14</date>
<initials>ssw</initials>
<remark>
<p>
Reorder block and span sections, simplify block parsing, and update the
definition of a span.
</p>
</remark>
</revision>
<revision> <revision>
<version>0.1.2</version> <version>0.1.2</version>
<date>2018-01-13</date> <date>2018-01-13</date>
@ -209,18 +220,18 @@
</p> </p>
<section3 topic='Plain' anchor='line-block'> <section3 topic='Plain' anchor='line-block'>
<p> <p>
Groups of lines that are not part of any other block are considered a Individual lines of text that are not inside of a preformatted text
"plain" block, as are individual lines of text that are not inside of a block are considered a "plain" block.
preformatted text block.
Plain blocks are not bound by styling directives and do not imply Plain blocks are not bound by styling directives and do not imply
formatting themselves, but they may contain spans which imply formatting themselves, but they may contain spans which imply
formatting. formatting.
Plain blocks may not contain child blocks.
</p> </p>
<example caption='Plain block text'><![CDATA[ <example caption='Plain block text'><![CDATA[
<body> <body>
((There are four blocks in this body marked by parens,) (There are three blocks in this body marked by parens,)
(but there is no *formatting) (but there is no *formatting)
(as spans* may not escape blocks.)) (as spans* may not escape blocks.)
</body> </body>
]]></example> ]]></example>
</section3> </section3>
@ -229,8 +240,7 @@
A preformatted text block is started by a line beginning with "```" A preformatted text block is started by a line beginning with "```"
(U+0060 GRAVE ACCENT), and ended by a line containing only three grave (U+0060 GRAVE ACCENT), and ended by a line containing only three grave
accents or the end of the parent block (whichever comes first). accents or the end of the parent block (whichever comes first).
Preformatted text blocks cannot contain child blocks and other styling Preformatted text blocks cannot contain child blocks or spans.
MUST NOT be rendered inside the block.
Text inside a preformatted block SHOULD be displayed in a monospace font. Text inside a preformatted block SHOULD be displayed in a monospace font.
</p> </p>
<example caption='Preformatted block text'><![CDATA[ <example caption='Preformatted block text'><![CDATA[
@ -247,8 +257,8 @@
&gt; ``` &gt; ```
&gt; (println &quot;Hello, world!&quot;) &gt; (println &quot;Hello, world!&quot;)
The entire blockquote is a preformatted text block, but this line is The entire blockquote is a preformatted text block, but this line
plaintext! is plaintext!
</body> </body>
]]></example> ]]></example>
</section3> </section3>