include/HTMLPurifier/standalone/HTMLPurifier/ConfigSchema/schema/AutoFormat.AutoParagraph.txt

   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