diff options
| author | Tim Graham <timograham@gmail.com> | 2016-05-14 19:06:31 -0400 |
|---|---|---|
| committer | Tim Graham <timograham@gmail.com> | 2016-05-14 19:06:31 -0400 |
| commit | e475e849703d937e158e75e7a6d9cb99090857f6 (patch) | |
| tree | b067aefddcb92ec4a0d926948ea1a423bdf8ee1b /docs/ref/utils.txt | |
| parent | 5238af325729c4a3068f7e8e18edc9928972fab3 (diff) | |
Refs #26021 -- Used hanging indentation in some doc examples.
Diffstat (limited to 'docs/ref/utils.txt')
| -rw-r--r-- | docs/ref/utils.txt | 22 |
1 files changed, 14 insertions, 8 deletions
diff --git a/docs/ref/utils.txt b/docs/ref/utils.txt index eadd036cb6..f95ff1017f 100644 --- a/docs/ref/utils.txt +++ b/docs/ref/utils.txt @@ -317,7 +317,7 @@ Sample usage:: >>> feed.add_item( ... title="Hello", ... link="http://www.holovaty.com/test/", - ... description="Testing." + ... description="Testing.", ... ) >>> with open('test.rss', 'w') as fp: ... feed.write(fp, 'utf-8') @@ -629,15 +629,19 @@ escaping HTML. So, instead of writing:: - mark_safe("%s <b>%s</b> %s" % (some_html, - escape(some_text), - escape(some_other_text), - )) + mark_safe("%s <b>%s</b> %s" % ( + some_html, + escape(some_text), + escape(some_other_text), + )) You should instead use:: format_html("{} <b>{}</b> {}", - mark_safe(some_html), some_text, some_other_text) + mark_safe(some_html), + some_text, + some_other_text, + ) This has the advantage that you don't need to apply :func:`escape` to each argument and risk a bug and an XSS vulnerability if you forget one. @@ -658,8 +662,10 @@ escaping HTML. ``args_generator`` should be an iterator that returns the sequence of ``args`` that will be passed to :func:`format_html`. For example:: - format_html_join('\n', "<li>{} {}</li>", ((u.first_name, u.last_name) - for u in users)) + format_html_join( + '\n', "<li>{} {}</li>", + ((u.first_name, u.last_name) for u in users) + ) .. function:: strip_tags(value) |
