AutoFormat.AutoParagraph.txt 1.1 KB

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