Sphinxと別のファイルで数式を参照する

Question

Shinxを使用してコードを文書化しています。いくつかのファイルで私は数式を持っており、それらへの参照を含めることを望みます。非常に同じファイル内にあるので、これは問題ではありません。 :eq:'reference'を使用してください。

ただし、別のファイルから数式への相互参照はどのようにして行いますか？私の場合、Sphinxは参照を見つけることができません。

Answer 1

Sphinx docs hereによると、式の相互参照は現在のところ同じ文書内でしか機能しません。これを変更するためのバグや機能のリクエストを提出することをお勧めします（すでに1つがないと仮定します）。回避策として

、おそらくそうのように、あなたが（「その他」のファイルに）参照する式の直前に参照ラベルを配置することにより、generic cross referencing syntaxを使用することができます。

.. _equation_in_other_file: 

して、何かを使用次のようになります。

「参照」するファイルにあります。

（明示的なリンクのタイトルを提供する必要があります注意してください）

それは非常にエレガントではないのですが、それは仕事を得る必要があります。