Pelican 3.3 Pelican-Quickstart Error: "ValueError: Unknown Locale: UTF-8"

Ao tentar usar o pelican3.3, erros como o seguinte pode ocorrer ao invocar o comando "pelican-quickstart":

ValueError: unknown locale: UTF-8

Causa

Este erro é causado por uma discrepância entre as suposições feitas pelo Python e as configurações de localidade do seu sistema operacional. Python espera que o nome da localidade siga um formato específico, o que nem sempre é o caso.

Solução

1. Definir variáveis ​​de ambiente de localidade

Você pode definir manualmente as variáveis ​​de ambiente de localidade em seu ~/.bash_profile para solucionar este problema:

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

2. Escolha um local válido

Observe que a correção acima assume o inglês e os Estados Unidos como o local preferido. Você deve escolher um local apropriado na lista fornecida por locale -a. Geralmente, selecione um que termine em UTF-8.

3. Relatório de bug

Um relatório de bug aberto destaca esse problema, indicando que o Python faz suposições incorretas sobre o formato dos nomes de localidade. Definir as variáveis ​​de ambiente é uma solução alternativa para esse problema.