Sphinx 文档在本地有效，但在阅读文档时无效

Question

我开始为我的 lil' python/django 项目编写文档。

发生这种情况：

Running Sphinx v1.2
loading translations [en]... done
building [readthedocs]: targets for 18 source files that are out of date
updating environment: 18 added, 0 changed, 0 removed
reading sources... [  5%] administrator-guide/customizing
reading sources... [ 11%] administrator-guide/index
reading sources... [ 16%] developer-guide/index
reading sources... [ 22%] index
reading sources... [ 27%] modules/booking
Sphinx Standard Error
Sphinx error:
'ascii' codec can't decode byte 0xef in position 475: ordinal not in range(128)

我明白，这是一个编码问题。

但是：我所有的文件都是用 UTF-8 编码的。并且它可以在本地（Windows）工作。

这是我的modules/booking.rst。还有in this directory are my booking-module-files。

非常感谢任何帮助！

Answer 1

如PEP 0263 所述，将其添加到源文件的顶部可确保它与 utf-8 编码一起正常工作。

#!/usr/bin/env python
# -*- coding: utf-8 -*-

当我在源文件的字符串文字中有一些日文字符时，我个人遇到了这个问题。