浏览代码

Improved docs regarding UTF-8 support with Apache and mod_wsgi.

Nick Frazier 3 年之前
父节点
当前提交
bf4be3711a
共有 2 个文件被更改,包括 12 次插入6 次删除
  1. 9 3
      docs/howto/deployment/wsgi/modwsgi.txt
  2. 3 3
      docs/ref/unicode.txt

+ 9 - 3
docs/howto/deployment/wsgi/modwsgi.txt

@@ -83,15 +83,21 @@ should put in this file, and what else you can add to it.
 
 .. 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::
+    If you get a ``UnicodeEncodeError`` when uploading or writing files with
+    file names or content that contains non-ASCII characters, make sure Apache
+    is configured to support UTF-8 encoding::
 
         export LANG='en_US.UTF-8'
         export LC_ALL='en_US.UTF-8'
 
     A common location to put this configuration is ``/etc/apache2/envvars``.
 
+    Alternatively, if you are :ref:`using mod_wsgi daemon mode<daemon-mode>`
+    you can add ``lang`` and ``locale`` options to the ``WSGIDaemonProcess``
+    directive::
+
+        WSGIDaemonProcess example.com lang='en_US.UTF-8' locale='en_US.UTF-8'
+
     See the :ref:`unicode-files` section of the Unicode reference guide for
     details.
 

+ 3 - 3
docs/ref/unicode.txt

@@ -291,8 +291,8 @@ Files
 If you intend to allow users to upload files, you must ensure that the
 environment used to run Django is configured to work with non-ASCII file names.
 If your environment isn't configured correctly, you'll encounter
-``UnicodeEncodeError`` exceptions when saving files with file names that
-contain non-ASCII characters.
+``UnicodeEncodeError`` exceptions when saving files with file names or content
+that contains non-ASCII characters.
 
 Filesystem support for UTF-8 file names varies and might depend on the
 environment. Check your current configuration in an interactive Python shell by
@@ -306,7 +306,7 @@ This should output "UTF-8".
 The ``LANG`` environment variable is responsible for setting the expected
 encoding on Unix platforms. Consult the documentation for your operating system
 and application server for the appropriate syntax and location to set this
-variable.
+variable. See the :doc:`/howto/deployment/wsgi/modwsgi` for examples.
 
 In your development environment, you might need to add a setting to your
 ``~.bashrc`` analogous to:::