python-sphinx - 別のページの小見出しまたはアンカーへの相互参照の追加

Question

reST/Sphinx ページの相互参照を、同じドキュメント セット内の別のページのサブヘッダーまたはアンカーに挿入する方法は?

Answer 1

2016年の新しい、より良い答え！

autosection拡張機能を使用すると、これを簡単に行うことができます。

=============
Some Document
=============


Internal Headline
=================

じゃあ後で...

===============
Some Other Doc
===============


A link-  :ref:`Internal Headline`

この拡張機能は組み込みなので、必要なのは編集するだけですconf.py

extensions = [
    .
    . other
    . extensions
    . already
    . listed
    .
    'sphinx.ext.autosectionlabel',
]

注意しなければならない唯一のことは、ドキュメント コレクション全体で内部見出しを複製できないことです。（価値がある。）