[Summary view] [Print] [Text view]

   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