Pelican 3.3 pelican-quickstart error “ValueError:

问题:

When I was trying to use pelican3.3, I typed the commend \"pelican-quickstart\", some errors showed up.

These are the errors:

(PelicanEnv)59-127-113-90:myblog Richo$ pelican-quickstart
Traceback (most recent call last):
  File \"/Users/Richo/Dropbox/Github/PelicanEnv/bin/pelican-quickstart\", line 9, in <module>
    load_entry_point(\'pelican==3.3\', \'console_scripts\', \'pelican-quickstart\')()
  File \"/Users/Richo/Dropbox/Github/PelicanEnv/lib/python2.7/site-packages/pkg_resources.py\", line 378, in load_entry_point
    return get_distribution(dist).load_entry_point(group, name)
  File \"/Users/Richo/Dropbox/Github/PelicanEnv/lib/python2.7/site-packages/pkg_resources.py\", line 2566, in load_entry_point
    return ep.load()
  File \"/Users/Richo/Dropbox/Github/PelicanEnv/lib/python2.7/site-packages/pkg_resources.py\", line 2260, in load
    entry = __import__(self.module_name, globals(),globals(), [\'__name__\'])
  File \"/Users/Richo/Dropbox/Github/PelicanEnv/lib/python2.7/site-packages/pelican/__init__.py\", line 16, in <module>
    from pelican.generators import (ArticlesGenerator, PagesGenerator,
  File \"/Users/Richo/Dropbox/Github/PelicanEnv/lib/python2.7/site-packages/pelican/generators.py\", line 20, in <module>
    from pelican.readers import Readers
  File \"/Users/Richo/Dropbox/Github/PelicanEnv/lib/python2.7/site-packages/pelican/readers.py\", line 11, in <module>
    import docutils.core
  File \"/Users/Richo/Dropbox/Github/PelicanEnv/lib/python2.7/site-packages/docutils/core.py\", line 20, in <module>
    from docutils import frontend, io, utils, readers, writers
  File \"/Users/Richo/Dropbox/Github/PelicanEnv/lib/python2.7/site-packages/docutils/frontend.py\", line 41, in <module>
    import docutils.utils
  File \"/Users/Richo/Dropbox/Github/PelicanEnv/lib/python2.7/site-packages/docutils/utils/__init__.py\", line 20, in <module>
    import docutils.io
  File \"/Users/Richo/Dropbox/Github/PelicanEnv/lib/python2.7/site-packages/docutils/io.py\", line 18, in <module>
    from docutils.utils.error_reporting import locale_encoding, ErrorString, ErrorOutput
  File \"/Users/Richo/Dropbox/Github/PelicanEnv/lib/python2.7/site-packages/docutils/utils/error_reporting.py\", line 47, in <module>
    locale_encoding = locale.getlocale()[1] or locale.getdefaultlocale()[1]
  File \"/Users/Richo/Dropbox/Github/PelicanEnv/lib/python2.7/locale.py\", line 513, in getdefaultlocale
    return _parse_localename(localename)
  File \"/Users/Richo/Dropbox/Github/PelicanEnv/lib/python2.7/locale.py\", line 445, in _parse_localename
    raise ValueError, \'unknown locale: %s\' % localename
ValueError: unknown locale: UTF-8

My OS is OS X Mavericks.

回答1:

You could try a solution posted here or here. Basically, add some lines to your ~/.bash_profile:

export LC_ALL=en_US.UTF-8
export LANG=en_US.UTF-8

There is an outstanding bug report related to this issue. It appears that Python makes some assumptions about the format of locale names that aren\'t universally valid. Explicitly setting these environment vars is basically just a workaround for that bug.

[Edit:] As @asmeurer correctly points out, the above fix assumes English and the U.S. You should really pick your preferred locale from the list given by locale -a (generally one that ends in UTF-8).

回答2:

Gerrat\'s answer works, and I believe we should mention that if you use somthing like zsh, you should add lines to ~/.zshrc instead of ~/.bash_profile or ~/.bash_rc

回答3:

Upstairs answers were quick great! But I believe people lazy like me want to change the global environment in case never change again while change to another Login user. So we need to change the file like:

sudo vi /etc/profile or sudo vi /etc/bashrc

And then add the two line in the following files

export LC_ALL=\"en_US.UTF-8\"
export LANG=\"en_US.UTF-8\"

Remember do not miss one of them, it doesn\'t work for me just $LANG or $LC_ALL. After that run the command to active the environment.

sudo source /etc/profile 
sudo source /etc/bashrc
source ~/.bash_profile 
source ~/.zshrc

Again, lazy people like me can finish in one line command.

echo -e \"export LC_ALL=en_US.UTF-8\\nexport LANG=en_US.UTF-8\" >> ~/.bash_profile && source ~/.bash_profile

回答4:

I\'m reposting my answer from this question here, since that it was marked as a duplicate of this one, and the accepted answer on this question is wrong in many ways.

This is a bug in the OS X Terminal app that only shows up in certain locales (country/language combinations). Open Terminal in /Applications/Utilities and uncheck the box “Set locale environment variables on startup”.

This will set your LANG environment variable to be empty. This may cause terminal use to incorrect settings for your locale. The locale command in the Terminal will tell you what settings are used. To use the correct language, add a line to your bash profile (typically ~/.profile)

export LANG=your-lang

Replace your-lang with the correct locale specifier for your language. The command locale -a will show you all the specifiers. For example, the language code for US English is en_US.UTF-8. The locale affects what translations are used when they are available, and also how dates, currencies, and decimals are formatted.

Note, this image and content were taken from http://conda.pydata.org/docs/troubleshooting.html#unknown-locale (I\'m also the original author of that page).

回答5:

For some reason I also needed:

export LC_CTYPE=en_US.UTF-8