diff options
| author | Nicolas Lœuillet <nicolas@loeuillet.org> | 2014-02-21 15:57:10 +0100 |
|---|---|---|
| committer | Nicolas Lœuillet <nicolas@loeuillet.org> | 2014-02-21 15:57:10 +0100 |
| commit | 99679d06884120c57f43b44e55e03595f1f87bed (patch) | |
| tree | a3f2a1aa1afdaeca1386d0c6e8a75344fd2241fb /inc/3rdparty/htmlpurifier/HTMLPurifier/ConfigSchema/schema/AutoFormat.RemoveEmpty.txt | |
| parent | 655214ab30ee84884dc408488b85586f36263fcb (diff) | |
| parent | d3b47e94705e17b3ba3529cbb1dc6efe69c5d2b7 (diff) | |
| download | wallabag-99679d06884120c57f43b44e55e03595f1f87bed.tar.gz wallabag-99679d06884120c57f43b44e55e03595f1f87bed.tar.zst wallabag-99679d06884120c57f43b44e55e03595f1f87bed.zip | |
Merge pull request #481 from wallabag/dev1.5.2
1.5.2
Diffstat (limited to 'inc/3rdparty/htmlpurifier/HTMLPurifier/ConfigSchema/schema/AutoFormat.RemoveEmpty.txt')
| -rw-r--r-- | inc/3rdparty/htmlpurifier/HTMLPurifier/ConfigSchema/schema/AutoFormat.RemoveEmpty.txt | 46 |
1 files changed, 46 insertions, 0 deletions
diff --git a/inc/3rdparty/htmlpurifier/HTMLPurifier/ConfigSchema/schema/AutoFormat.RemoveEmpty.txt b/inc/3rdparty/htmlpurifier/HTMLPurifier/ConfigSchema/schema/AutoFormat.RemoveEmpty.txt new file mode 100644 index 00000000..6b5a7a5c --- /dev/null +++ b/inc/3rdparty/htmlpurifier/HTMLPurifier/ConfigSchema/schema/AutoFormat.RemoveEmpty.txt | |||
| @@ -0,0 +1,46 @@ | |||
| 1 | AutoFormat.RemoveEmpty | ||
| 2 | TYPE: bool | ||
| 3 | VERSION: 3.2.0 | ||
| 4 | DEFAULT: false | ||
| 5 | --DESCRIPTION-- | ||
| 6 | <p> | ||
| 7 | When enabled, HTML Purifier will attempt to remove empty elements that | ||
| 8 | contribute no semantic information to the document. The following types | ||
| 9 | of nodes will be removed: | ||
| 10 | </p> | ||
| 11 | <ul><li> | ||
| 12 | Tags with no attributes and no content, and that are not empty | ||
| 13 | elements (remove <code><a></a></code> but not | ||
| 14 | <code><br /></code>), and | ||
| 15 | </li> | ||
| 16 | <li> | ||
| 17 | Tags with no content, except for:<ul> | ||
| 18 | <li>The <code>colgroup</code> element, or</li> | ||
| 19 | <li> | ||
| 20 | Elements with the <code>id</code> or <code>name</code> attribute, | ||
| 21 | when those attributes are permitted on those elements. | ||
| 22 | </li> | ||
| 23 | </ul></li> | ||
| 24 | </ul> | ||
| 25 | <p> | ||
| 26 | Please be very careful when using this functionality; while it may not | ||
| 27 | seem that empty elements contain useful information, they can alter the | ||
| 28 | layout of a document given appropriate styling. This directive is most | ||
| 29 | useful when you are processing machine-generated HTML, please avoid using | ||
| 30 | it on regular user HTML. | ||
| 31 | </p> | ||
| 32 | <p> | ||
| 33 | Elements that contain only whitespace will be treated as empty. Non-breaking | ||
| 34 | spaces, however, do not count as whitespace. See | ||
| 35 | %AutoFormat.RemoveEmpty.RemoveNbsp for alternate behavior. | ||
| 36 | </p> | ||
| 37 | <p> | ||
| 38 | This algorithm is not perfect; you may still notice some empty tags, | ||
| 39 | particularly if a node had elements, but those elements were later removed | ||
| 40 | because they were not permitted in that context, or tags that, after | ||
| 41 | being auto-closed by another tag, where empty. This is for safety reasons | ||
| 42 | to prevent clever code from breaking validation. The general rule of thumb: | ||
| 43 | if a tag looked empty on the way in, it will get removed; if HTML Purifier | ||
| 44 | made it empty, it will stay. | ||
| 45 | </p> | ||
| 46 | --# vim: et sw=4 sts=4 | ||