|
Revision 21, 1.1 kB
(checked in by admin, 18 years ago)
|
|
|
| Line | |
|---|
| 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> |
|---|