diff options
Diffstat (limited to 'vendor/twig/twig/doc/tags/spaceless.rst')
-rw-r--r-- | vendor/twig/twig/doc/tags/spaceless.rst | 37 |
1 files changed, 0 insertions, 37 deletions
diff --git a/vendor/twig/twig/doc/tags/spaceless.rst b/vendor/twig/twig/doc/tags/spaceless.rst deleted file mode 100644 index 12e77b25..00000000 --- a/vendor/twig/twig/doc/tags/spaceless.rst +++ /dev/null | |||
@@ -1,37 +0,0 @@ | |||
1 | ``spaceless`` | ||
2 | ============= | ||
3 | |||
4 | Use the ``spaceless`` tag to remove whitespace *between HTML tags*, not | ||
5 | whitespace within HTML tags or whitespace in plain text: | ||
6 | |||
7 | .. code-block:: jinja | ||
8 | |||
9 | {% spaceless %} | ||
10 | <div> | ||
11 | <strong>foo</strong> | ||
12 | </div> | ||
13 | {% endspaceless %} | ||
14 | |||
15 | {# output will be <div><strong>foo</strong></div> #} | ||
16 | |||
17 | This tag is not meant to "optimize" the size of the generated HTML content but | ||
18 | merely to avoid extra whitespace between HTML tags to avoid browser rendering | ||
19 | quirks under some circumstances. | ||
20 | |||
21 | .. tip:: | ||
22 | |||
23 | If you want to optimize the size of the generated HTML content, gzip | ||
24 | compress the output instead. | ||
25 | |||
26 | .. tip:: | ||
27 | |||
28 | If you want to create a tag that actually removes all extra whitespace in | ||
29 | an HTML string, be warned that this is not as easy as it seems to be | ||
30 | (think of ``textarea`` or ``pre`` tags for instance). Using a third-party | ||
31 | library like Tidy is probably a better idea. | ||
32 | |||
33 | .. tip:: | ||
34 | |||
35 | For more information on whitespace control, read the | ||
36 | :doc:`dedicated<../templates>` section of the documentation and learn how | ||
37 | you can also use the whitespace control modifier on your tags. | ||