| 1 |
efrain |
1 |
AutoFormat.AutoParagraph
|
|
|
2 |
TYPE: bool
|
|
|
3 |
VERSION: 2.0.1
|
|
|
4 |
DEFAULT: false
|
|
|
5 |
--DESCRIPTION--
|
|
|
6 |
|
|
|
7 |
<p>
|
|
|
8 |
This directive turns on auto-paragraphing, where double newlines are
|
|
|
9 |
converted in to paragraphs whenever possible. Auto-paragraphing:
|
|
|
10 |
</p>
|
|
|
11 |
<ul>
|
|
|
12 |
<li>Always applies to inline elements or text in the root node,</li>
|
|
|
13 |
<li>Applies to inline elements or text with double newlines in nodes
|
|
|
14 |
that allow paragraph tags,</li>
|
|
|
15 |
<li>Applies to double newlines in paragraph tags</li>
|
|
|
16 |
</ul>
|
|
|
17 |
<p>
|
|
|
18 |
<code>p</code> tags must be allowed for this directive to take effect.
|
|
|
19 |
We do not use <code>br</code> tags for paragraphing, as that is
|
|
|
20 |
semantically incorrect.
|
|
|
21 |
</p>
|
|
|
22 |
<p>
|
|
|
23 |
To prevent auto-paragraphing as a content-producer, refrain from using
|
|
|
24 |
double-newlines except to specify a new paragraph or in contexts where
|
|
|
25 |
it has special meaning (whitespace usually has no meaning except in
|
|
|
26 |
tags like <code>pre</code>, so this should not be difficult.) To prevent
|
|
|
27 |
the paragraphing of inline text adjacent to block elements, wrap them
|
|
|
28 |
in <code>div</code> tags (the behavior is slightly different outside of
|
|
|
29 |
the root node.)
|
|
|
30 |
</p>
|
|
|
31 |
--# vim: et sw=4 sts=4
|