python-sphinx - Sphinx napoleon を使用して、他のバージョンの標準ライブラリへの型リンクを作成する

Question

Sphinx と Napoleon と autodoc 拡張機能を使用して Google スタイルのドキュメント文字列を解析する Python プロジェクトを文書化しています。Google スタイルでは引数の型を指定する必要があるため、Sphinx は標準ライブラリ内の標準型のドキュメントへのリンクを自動的に作成します。Intersphinx ただし、デフォルトでは 2.7 バージョンのドキュメントにリンクしていますが、私は 3.x バージョンにリンクしたいと考えています。この動作を制御するにはどうすればよいですか?

Answer 1

Python ライブラリのリンク方法は、intersphinx 拡張機能によって制御されます。設定

intersphinx_mapping = {'python': ('https://docs.python.org/3.4', None)}

でconf.py、リンクは Python 3 標準ライブラリにリンクする必要があります。

intersphinx の使用方法の詳細については、 intersphinx のドキュメントを参照してください。