[tt-rss.git] / lib / htmlpurifier / library / HTMLPurifier / ConfigSchema / schema / AutoFormat.AutoParagraph.txt

AutoFormat.AutoParagraph
TYPE: bool
VERSION: 2.0.1
DEFAULT: false
--DESCRIPTION--

<p>
  This directive turns on auto-paragraphing, where double newlines are
  converted in to paragraphs whenever possible. Auto-paragraphing:
</p>
<ul>
  <li>Always applies to inline elements or text in the root node,</li>
  <li>Applies to inline elements or text with double newlines in nodes
      that allow paragraph tags,</li>
  <li>Applies to double newlines in paragraph tags</li>
</ul>
<p>
  <code>p</code> tags must be allowed for this directive to take effect.
  We do not use <code>br</code> tags for paragraphing, as that is
  semantically incorrect.
</p>
<p>
  To prevent auto-paragraphing as a content-producer, refrain from using
  double-newlines except to specify a new paragraph or in contexts where
  it has special meaning (whitespace usually has no meaning except in
  tags like <code>pre</code>, so this should not be difficult.) To prevent
  the paragraphing of inline text adjacent to block elements, wrap them
  in <code>div</code> tags (the behavior is slightly different outside of
  the root node.)
</p>
--# vim: et sw=4 sts=4
Commit	Line	Data
010efc9b AD	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