One of my first contribute to newest, but quite promising e-commerce engine Sylius.org powered by a Symfony2 php framework  is a help to improve documentation for one of bundle from Sylius package. I should note Sylius positioned as e-commerce full-circle engine, for doc’s maintain it use a rst (reStructuredText) format for files, which host at readthedocs.org

Sphinx – python documentation generator

So back to the problem which I met when tried to build Sylius doc’s  on local machine (with latest Mac OS X). I’ve fresh installed sphinx and after run:

sphinx-quickstart /or/  shpinx-build doc_source_folder hml

got a weird error.

Like (put here chunk of full error):

$ sphinx-quickstart 
  Traceback (most recent call last):
  File "/usr/local/bin/sphinx-quickstart", line 8, in 
    load_entry_point('Sphinx==1.1.3', 'console_scripts', 'sphinx-quickstart')()
  File "/System/Library/Frameworks/Python.framework/Versions/2.7/Extras/lib/python/pkg_resources.py", line 318, in load_entry_point
    return get_distribution(dist).load_entry_point(group, name)

WTF??!!

Thanks God,  google and stackoverflow answer there http://stackoverflow.com/questions/10921430/fresh-installation-of-sphinx-quickstart-fails

Retype solution here:

Add the following line to your ~/.bach_profle or ~/.zshrc

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

Then restart terminal.app, or just run:

source $HOME/.bash_profile