sphinx.ext.autosectionlabel – 参照にこのタイトルを利用できます

バージョン 1.4 で追加.

この拡張は、セクションへの参照をそのタイトルを用いて行えるようにするものです。これは参照のロール(ref)に作用します。

例えば:

A Plain Title
-------------

This is the text of the section.

It refers to the section title, see :ref:`A Plain Title`.

内部では、この拡張は各セクションに対してラベルを生成しています。ドキュメント全体で同じセクション名が使われている場合は、いずれのセクションともターゲットとして利用されます。