Description

cocoatomo

opened on Oct 5, 2017

Issue body actions

(shimizukawa 氏による報告)

https://docs.python.org/ja/3/library/functions.html#print のドキュメントで、引用符が鉤括弧に置き換えられてしまっている。

http://docs.python.jp/3/library/functions.html#print では、この現象は起きていない。

これは docutils の smart quotes によるもの。

Activity

1. cocoatomo

   self-assigned this

   on Oct 5, 2017
2. methane commented on Oct 6, 2017

   

   methane

   on Oct 6, 2017

   Contributor

   More actions

   これどこで直すのが良いんでしょうね。
   docutils か sphinx か。
3. methane commented on Oct 6, 2017

   

   methane

   on Oct 6, 2017

   Contributor

   More actions

   docutils の設定を直してもらうにしても、これ、 Sphinx の設定ファイルからは設定できなくて、
   docutils.conf を修正してもらう必要がある？？？
4. cocoatomo commented on Oct 6, 2017

   

   cocoatomo

   on Oct 6, 2017

   ContributorAuthor

   More actions

   (https://pythonjp.slack.com/archives/C3QH8PTAS/p1507191806000103 より転載)

   sphinx project rootに docutils.conf を置いて内容を以下のように書けばOK

   [restructuredtext parser]
   smart_quotes:no
   

   see: http://docutils.sourceforge.net/docs/user/config.html#smart-quotes
5. cocoatomo commented on Oct 10, 2017

   

   cocoatomo

   on Oct 10, 2017

   ContributorAuthor

   More actions

   1.6.3 以降で以下の変更が行われており, docutils.conf を置いて対応する必要は無いとのこと.

   sphinx-doc/sphinx#3875

   https://pythonjp.slack.com/archives/C3QH8PTAS/p1507265612000072
   「Sphinx側で、シグネチャのクォート文字が変換されないように修正してたんだった」
6. shimizukawa commented on Oct 10, 2017

   

   shimizukawa

   on Oct 10, 2017

   More actions

   @methane はい。docutils.confを書き換える（なければ新規に作る）必要があります。

   とりあえず、sphinx-1.6.3でSphinx側で直してあるので、sphinx-1.6.3以降にバージョンあげれば、docutils.confには手を付けなくて大丈夫。
7. JulienPalard commented on Oct 11, 2017

   

   JulienPalard

   on Oct 11, 2017

   More actions

   Fixed by upgrading sphinx to the latest version.

   Reacted by cocoatomo
8. cocoatomo commented on Oct 11, 2017

   

   cocoatomo

   on Oct 11, 2017

   ContributorAuthor

   More actions

   @JulienPalard Thanks for your fix.

   ref. python/docsbuild-scripts#33
9. cocoatomo

   closed this as completedon Oct 11, 2017

Issue actions