1
0
mirror of https://github.com/django/django.git synced 2025-10-24 06:06:09 +00:00

Fixed #17686, refs #17816 -- Added "Files" section to Unicode topic.

Thanks Fako Berkers for help with the patch.
This commit is contained in:
Florian Demmer
2015-11-07 15:35:07 +01:00
committed by Tim Graham
parent 1c5f4e86bc
commit 25b912abbe
3 changed files with 55 additions and 21 deletions

View File

@@ -358,6 +358,36 @@ A couple of tips to remember when writing your own template tags and filters:
translation objects into strings. It's easier to work solely with Unicode
strings at that point.
.. _unicode-files:
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.
Filesystem support for UTF-8 file names varies and might depend on the
environment. Check your current configuration in an interactive Python shell by
running::
import sys
sys.getfilesystemencoding()
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.
In your development environment, you might need to add a setting to your
``~.bashrc`` analogous to:::
export LANG="en_US.UTF-8"
Email
=====