[1.9.x] Fixed #17686, refs #17816 -- Added "Files" section to Unicode topic.

Thanks Fako Berkers for help with the patch.

Backport of 25b912abbe31fa440e702b5273c18cf74e2d6e0b from master

1 files changed, 14 insertions, 21 deletions

diff --git a/docs/howto/deployment/wsgi/modwsgi.txt b/docs/howto/deployment/wsgi/modwsgi.txt
index 689effba17..90ca1c0527 100644
--- a/docs/howto/deployment/wsgi/modwsgi.txt
+++ b/docs/howto/deployment/wsgi/modwsgi.txt
@@ -74,6 +74,20 @@ should put in this file, and what else you can add to it.
     or by :ref:`using mod_wsgi daemon mode<daemon-mode>` and ensuring that each
     site runs in its own daemon process.
 
+.. admonition:: Fixing ``UnicodeEncodeError`` for file uploads
+
+    If you get a ``UnicodeEncodeError`` when uploading files with file names
+    that contain non-ASCII characters, make sure Apache is configured to accept
+    non-ASCII file names::
+
+        export LANG='en_US.UTF-8'
+        export LC_ALL='en_US.UTF-8'
+
+    A common location to put this configuration is ``/etc/apache2/envvars``.
+
+    See the :ref:`unicode-files` section of the Unicode reference guide for
+    details.
+
 Using a virtualenv
 ==================
 
@@ -222,24 +236,3 @@ Authenticating against Django's user database from Apache
 Django provides a handler to allow Apache to authenticate users directly
 against Django's authentication backends. See the :doc:`mod_wsgi authentication
 documentation </howto/deployment/wsgi/apache-auth>`.
-
-If you get a UnicodeEncodeError
-===============================
-
-If you're taking advantage of the internationalization features of Django (see
-:doc:`/topics/i18n/index`) and you intend to allow users to upload files, you must
-ensure that the environment used to start Apache is configured to accept
-non-ASCII file names. If your environment is not correctly configured, you
-will trigger ``UnicodeEncodeError`` exceptions when calling functions like
-the ones in :mod:`os.path` on filenames that contain non-ASCII characters.
-
-To avoid these problems, the environment used to start Apache should contain
-settings analogous to the following::
-
-    export LANG='en_US.UTF-8'
-    export LC_ALL='en_US.UTF-8'
-
-Consult the documentation for your operating system for the appropriate syntax
-and location to put these configuration items; ``/etc/apache2/envvars`` is a
-common location on Unix platforms. Once you have added these statements
-to your environment, restart Apache.