From 7ade336ab7068d736c4be5fee62c507be95ab3c2 Mon Sep 17 00:00:00 2001 From: ines Date: Tue, 5 Dec 2017 13:17:55 +0100 Subject: [PATCH] Add "Unknown locale" issue to troubleshooting guide (see #1684, #1641, #1517) --- website/usage/_install/_troubleshooting.jade | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/website/usage/_install/_troubleshooting.jade b/website/usage/_install/_troubleshooting.jade index 8326901ce..c846ff957 100644 --- a/website/usage/_install/_troubleshooting.jade +++ b/website/usage/_install/_troubleshooting.jade @@ -55,6 +55,24 @@ p | the latest version of pip. To see which version you have installed, | run #[code pip --version]. ++h(3, "unknown-locale") Unknown locale: UTF-8 + ++code(false, "text"). + ValueError: unknown locale: UTF-8 + +p + | This error can sometimes occur on OSX and is likely related to a + | still unresolved #[+a("https://bugs.python.org/issue18378") Python bug]. + | However, it's easy to fix: just add the following to your + | #[code ~/.bash_profile] or #[code ~/.zshrc] and then run + | #[code source ~/.bash_profile] or #[code source ~/.zshrc]. + | Make sure to add #[strong both lines] for #[code LC_ALL] and + | #[code LANG]. + ++code(false, "bash"). + export LC_ALL=en_US.UTF-8 + export LANG=en_US.UTF-8 + +h(3, "import-error") Import error +code(false, "text").