Sphinx文档在本地工作，但不是在阅读文档

Question

我开始为我的文件写我的文档＆＃39; 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编码的。它在本地工作（窗口）。

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

非常感谢任何帮助！

Answer 1

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

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

当我在源文件中的字符串文字中有一些日文字符时，我个人碰到了这个障碍。