昨日の記事で、どの拡張も HTML に変換した時に他のページにリンクできないという体たらくなので、 Sphinx においけるリンクの解決方法をまとめておく。 解決方法: domain#resolve_xref() を使う 以上。 見出しで言い切ったのでこれ以上ネタも無いのだが、コードを使って補足しておく。 Sphinx のベースになっている docutils では、単体のファイルしか扱わないため ラベルを意味する reftarget ノードとリンク(参照)を表す reference ノードのふたつで用が足りていて、 リンクの解決はドキュメントの先頭から travrese() をして、該当のラベルを見つけるだけでよかった。 しかし、Sphinx では複数のファイルを組み合わせて文書を構築するため、 ファイル A からファイル B へリンクすることもある。 だが、ファイル A にあるリンクを解