追加.この拡張機能は他のプロジェクトのオブジェクトのドキュメントに対して、自動リンクを生成できるようになります。設定されたドキュメント集の中を探索しにいくようになります。いう参照があった場合には、そのドキュメントの詳細な場所を知らなくても、Pythonの標準ライブラリのドキュメントの、ZipFileクラスに対してリンクが張られます。「新しい」フォーマット(後述)を使用する場合、リンクターゲット名に特定のプリフィックスを付けることで、強制的に外部ドキュメントを探索しにいくように設定できます。いうリンクがあれば、もし"python"という名前のドキュメントセットが設定されていたとすると、その中の"comparisons"というラベルを探索しに行きます。この仕組みの背後では、次のようなことが行われています。いうファイルがあります。このファイルの中にはオブジェクト名と、HTMLのルートからの相対URLのマッピング情報が含まれます。いう設定値を使って、そのマッピングファイルの場所を指定できます。このマッピング情報は、リンクが解決されていないオブジェクトの参照から、外部のドキュメントのリンクを張るために使用されます。デフォルトの設定では、マッピングファイルはドキュメントと同じ位置にあるとみなされます。マッピングファイルの場所は個別に指定できます。インターネットのアクセスができない環境でビルドできるようにする場合などです。追加すると、リンクを有効にするための設定値が追加されます。intersphinx_mapping¶この設定値には、このドキュメントからリンクさせる他のプロジェクトの場所と名前を設定します。相対的なローカルパスがキーに設定された場合には、ビルドドキュメントに対して相対的な場所であるとみなされます。値側に相対パスが設定された場合には、ソースディレクトリからの相対パスになります。設定しておくと、プロキシーを経由してアクセスを行います。1.0以前で使用されていました。これは現在でも使用できます。この設定値はURI同士(値は場合によってはNone)をマッピングする辞書になります。キーは外部のSphinxのドキュメントのベースのURIを設定します。ローカルのパス、もしくはHTTPのURIが使用できます。値はインベントリファイル(.inv)がある場所を設定します。UIと同じ場所にあるとみなされます)、もしくはローカルのパス、HTTPのURIのどれかになります。いうタプルを値に持つ辞書のマッピングです。外部のSphinxのドキュメントを表すベースのURIで、ローカルファイルパスもしくはHTTPのURIを指定できます。インベントリファイル(.inv)がある場所を設定します。これに設定できるのは、None(ベースURIと同じ場所にあるとみなされます)、もしくはローカルのパス、HTTPのURIのどれかになります。ユニークな識別子は、クロスリファレンスのターゲットのプリフィックスとして使用されます。そのため、ターゲットの要素がintersphinxによって設定されたことが明確になります。いう項目があれば、この"comparisons"というラベルは"python"のドキュメントセットの中にあるドキュメントに対してリンクが作成されます。以下のページに対するリンクを作成します。ダウンロードされたインベントリ情報はキャッシュされるので、もしもPythonのドキュメントに新しいオブジェクトが追加された場合には、自分でアップデートする必要があります。以下のページに対するリンクを作成します。Pythonのドキュメントに新しいオブジェクトが追加された場合には、自分でアップデートする必要があります。追加.各インベントリへの代替ファイルを指定できます。次の例に示すように、1つは、二番目のインベントリタプル項目に対してもタプルを与えることができます。(次の)タプルを反復処理で読みこみます。この記法の基本ユースケースはプライマリインベントリのサーバーダウン時用のミラーサイトを指定することです。'python-inv.txt'))}intersphinx_cache_limit¶リモートのインベントリーをキャッシュする最長の日数を設定します。デフォルトは5で、5日間という意味になります。マイナスの値を設定すると、インベントリーのキャッシュの日数による制限がなくなります。intersphinx_timeout¶タイムアウトの秒数を設定します。タイムアウトしません。注釈タイムアウト時間は、通信時間全体の時間ではなく、サーバーが応答を返し始めるまでの時間です。指定した秒数位内に応答を開始しない場合、例外が発生します。これは、文書プロジェクトでSphinx間リンクが破損している主要因を探る際に有用です。