diff --git a/django/template/defaultfilters.py b/django/template/defaultfilters.py index 3e35e67bd0..16a3d4d6e9 100644 --- a/django/template/defaultfilters.py +++ b/django/template/defaultfilters.py @@ -228,9 +228,9 @@ def make_list(value): @stringfilter def slugify(value): """ - Converts to lowercase, removes non-word characters (alphanumerics and - underscores) and converts spaces to hyphens. Also strips leading and - trailing whitespace. + Converts to ASCII. Converts spaces to hyphens. Removes characters that + aren't alphanumerics, underscores, or hyphens. Converts to lowercase. + Also strips leading and trailing whitespace. """ return _slugify(value) diff --git a/django/utils/text.py b/django/utils/text.py index b2645e8697..37bcd3150e 100644 --- a/django/utils/text.py +++ b/django/utils/text.py @@ -438,9 +438,9 @@ unescape_string_literal = allow_lazy(unescape_string_literal) def slugify(value): """ - Converts to lowercase, removes non-word characters (alphanumerics and - underscores) and converts spaces to hyphens. Also strips leading and - trailing whitespace. + Converts to ASCII. Converts spaces to hyphens. Removes characters that + aren't alphanumerics, underscores, or hyphens. Converts to lowercase. + Also strips leading and trailing whitespace. """ value = force_text(value) value = unicodedata.normalize('NFKD', value).encode('ascii', 'ignore').decode('ascii') diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt index 8e74d1e44a..e9c2e0c391 100644 --- a/docs/ref/templates/builtins.txt +++ b/docs/ref/templates/builtins.txt @@ -2024,9 +2024,9 @@ If ``some_list`` is ``['a', 'b', 'c']``, the output will be ``['a', 'b']``. slugify ^^^^^^^ -Converts to lowercase, removes non-word characters (alphanumerics and -underscores) and converts spaces to hyphens. Also strips leading and trailing -whitespace. +Converts to ASCII. Converts spaces to hyphens. Removes characters that aren't +alphanumerics, underscores, or hyphens. Converts to lowercase. Also strips +leading and trailing whitespace. For example:: diff --git a/docs/ref/utils.txt b/docs/ref/utils.txt index 507f3d6095..4c7368f687 100644 --- a/docs/ref/utils.txt +++ b/docs/ref/utils.txt @@ -842,9 +842,9 @@ appropriate entities. .. function:: slugify - Converts to lowercase, removes non-word characters (alphanumerics and - underscores) and converts spaces to hyphens. Also strips leading and - trailing whitespace. + Converts to ASCII. Converts spaces to hyphens. Removes characters that + aren't alphanumerics, underscores, or hyphens. Converts to lowercase. Also + strips leading and trailing whitespace. For example::