任意のラベルを作成せずにsphinx restructuredtextの見出しに内部リンクを張る方法は？

Question

私は多くの見出しと小見出しを持つ文書を持っています。さらに本文には、見出しの1つにリンクしたいと思っています。 :ref:ラベルの冗長性なしでこれを行うにはどうすればよいですか？内容はちょうど良いヘッダーを拾うようだ。私はこのようなことを望んでいた：`#polled-data-retrieval`_。

Answer 1

reStructuredTextはimplicit hyperlink targetsをサポートしています。

セクションのタイトル、脚注、および引用は自動的にハイパーリンクのターゲット（タイトルテキストや脚注/引用ラベルは、ハイパーリンク名として使用されている）を生成： reStructuredText quick referenceから。したがって、次のテキストが（reStructuredTextのクイックリファレンス、スペルミスとすべてから持ち上げ）

：

Titles are targets, too 
======================= 
Implict references, like `Titles are targets, too`_. 

は、次のようなHTMLを生成します。

<strong><a name="title">Titles are targets, too</a></strong> 

<p>Implict references, like <a href="#title">Titles are targets, too</a>.</p> 

Answer 2

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

autosection extensionは、あなたが本当の相互参照して、これを簡単に行うことができます。

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


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

が、その後、後で...

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


A link- :ref:`Internal Headline` 

この拡張は、ビルトインされているので、あなたが必要とするすべてはconf.py

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

あなたは注意する必要が唯一のものを編集することです今では、内部の見出しを文書コレクション全体に複製することはできません。 （それだけの価値。）