修改 pelican 3.1 使之支持中文文件夹作为分类目录

    前提：

    windows + pelican 3.1 + python 2.6
    并且 pelican 配置文件中设置了 USE_FOLDER_AS_CATEGORY = True（默认为 True，只要不设置为 False 即可）

    默认情况下，pelican 不支持中文文件夹作为分类目录：

    d:\myblog>pelican content -o output -s pelicanconf.py -D
...

CRITICAL: 'utf8' codec can't decode byte 0xd3 in position 2: invalid continuation byte
Traceback (most recent call last):
  File "C:\Python26\Scripts\pelican-script.py", line 9, in <module>
    load_entry_point('pelican==3.1', 'console_scripts', 'pelican')()
  File "C:\Python26\lib\site-packages\pelican\__init__.py", line 319, in main
    pelican.run()
  File "C:\Python26\lib\site-packages\pelican\__init__.py", line 152, in run
    p.generate_context()
  File "C:\Python26\lib\site-packages\pelican\generators.py", line 337, in generate_context
    .decode('utf-8')
  File "C:\Python26\lib\encodings\utf_8.py", line 16, in decode
    return codecs.utf_8_decode(input, errors, True)
UnicodeDecodeError: 'utf8' codec can't decode byte 0xd3 in position 2: invalid continuation byte

    从错误信息中我们可以看到 pelican 对文件夹名称默认按 utf8 编码进行解码，而在 windows 下文件（夹）名称默认是按 gbk 进行编码的，所以就出现了编码错误。

    下面我们来修复这个错误。

    编辑文件 C:\Python26\lib\site-packages\pelican\generators.py 进行以下两步操作即可：

    1. 首先导入 sys 模块：import sys
    2. 然后编辑第 338 行左右的
      category = os.path.basename(os.path.dirname(f))\
           .decode('utf-8')

      为

      category = os.path.basename(os.path.dirname(f))\
           .decode(sys.stdin.encoding)

      此处的修改是为了让程序使用系统默认的输入编码（简体中文版 Windows 下默认是 gbk）进行解码。

    进行相关修改后，再次执行 pelican content -o output -s pelicanconf.py -D 生成 html 文件，执行过程一切顺利。

    但也有一个不完美的地方：

    虽然在浏览器中这个不会是乱码，但看起来还是有点不爽。 下面我们要将它变成中文拼音，这样就不会乱码了。

    继续编辑 generators.py 文件：

    1. 导入相关模块：from pelican.utils import slugify 。 这个模块的作用是将非 ASCII 字符转换为 ASCII 字符，比如，将 中国 转换为 zhong-guo 。
    2. 将 199 行左右的
      for cat, arts in self.categories:
    arts.sort(key=attrgetter('date'), reverse=True)

      改为

      for cat, arts in self.categories:
    cat = slugify(cat)
    arts.sort(key=attrgetter('date'), reverse=True)

    修改后的效果：

    Comments