ConfigSchema/schema/AutoFormat.AutoParagraph.txt

0001 AutoFormat.AutoParagraph
0002 TYPE: bool
0003 VERSION: 2.0.1
0004 DEFAULT: false
0005 --DESCRIPTION--
0006
0007 <p>
0008   This directive turns on auto-paragraphing, where double newlines are
0009   converted in to paragraphs whenever possible. Auto-paragraphing:
0010 </p>
0011 <ul>
0012   <li>Always applies to inline elements or text in the root node,</li>
0013   <li>Applies to inline elements or text with double newlines in nodes
0014       that allow paragraph tags,</li>
0015   <li>Applies to double newlines in paragraph tags</li>
0016 </ul>
0017 <p>
0018   <code>p</code> tags must be allowed for this directive to take effect.
0019   We do not use <code>br</code> tags for paragraphing, as that is
0020   semantically incorrect.
0021 </p>
0022 <p>
0023   To prevent auto-paragraphing as a content-producer, refrain from using
0024   double-newlines except to specify a new paragraph or in contexts where
0025   it has special meaning (whitespace usually has no meaning except in
0026   tags like <code>pre</code>, so this should not be difficult.) To prevent
0027   the paragraphing of inline text adjacent to block elements, wrap them
0028   in <code>div</code> tags (the behavior is slightly different outside of
0029   the root node.)
0030 </p>
0031 --# vim: et sw=4 sts=4