Sphinxで引用符がカギ括弧として表示されてしまう

Question

Sphinx v1.6.2 with Python 2.7 を使っています。

日本語のドキュメントを作成する場合は conf.py で "language = 'ja'" を
指定するものだと思っていますが、この状態だと出力された html の表示上、
シングルクォートとダブルクォートがそれぞれ"『" と "「" になってしまう
ケースがあるようです。

ちなみに、ドキュメントの中身は最初から日本語で翻訳ものではないので、
gettext は使いません。

このようなケースでは、 "language = 'ja'" をしないほうがよいのでしょうか。
また指定しない場合、gettext が無効になる以外に何か副作用があるようでしたら、
それについてもご教示いただけるとありがたいです。

ちなみに実験結果です。イマイチ法則性がわかりません。。。

$ env|grep LANG
LANG=ja_JP.UTF-8

【原文】

• I can't wait.
• ' はシングルクォート、 " はダブルクォートです。
• 16 は X'10' 、17 は X '11' 、18 は X'12' 、19 は X '13' です。
• X'5A' / X '5B' / X '5C'

【language = 'ja' なし】

I can’t wait.
‘ はシングルクォート、 ” はダブルクォートです。
16 は X‘10’ 、17 は X ‘11’ 、18 は X‘12’ 、19 は X ‘13’ です。
X‘5A’ / X ‘5B’ / X ‘5C’

【language = 'ja' あり】

I can’t wait.
『 はシングルクォート、 」 はダブルクォートです。
16 は X’10』 、17 は X 『11』 、18 は X’12』 、19 は X 『13』 です。
X’5A』 / X 『5B』 / X 『5C』

希望する表示結果は、ほぼ「language = 'ja' なし」の状態です。ちなみに
これもよく見るとシングルクォートがすべて全角になっているのですが、これは
そういうものかもしれないとは思っています。

関連しそうな設定項目を以下に示します：
extensions = ['sphinx.ext.autodoc', 'sphinx.ext.githubpages', 'sphinxcontrib.phpdomain']
pygments_style = 'sphinx'
html_theme = 'sphinx_rtd_theme'
html_theme_path = ["sphinx_rtd_theme", ]

Answer 1

これはSphinxというよりもDocutilsのSmart Quotesという機能です。

http://docutils.sourceforge.net/docs/user/smartquotes.html

\\でエスケープしてください。

Sphinxで一括でDisableにすることも出来ます。

http://www.sphinx-doc.org/en/stable/config.html#confval-html_use_smartypants

Sphinx1.6以降ではdocutils.confに設定を書くことが推奨されています。

Comments

[hotta]

$ cat docutils.conf
[parsers]
smart_quotes: false

を追加することで、language=ja でも問題ないことを確認しました。
ありがとうございました。