Sfenks'de bir başlık ile iç içe bir bağlantı nasıl yapılır?

Question

Birçok başlığa ve alt başlığa sahip bir belgem var. Daha sonra yazıya geri başlıklardan birine bağlamak istiyorum. Bunu :ref: etiketlerinin fazlalığı olmadan nasıl yapabilirim? İçeriğin başlıkları iyi görünüyor. Böyle bir şey için umuyordum: `#polled-data-retrieval`_.

Answer 1

reStructuredText, implicit hyperlink targets'u destekler. reStructuredText quick reference Gönderen:

Bölüm başlıkları, dipnotlar ve otomatik köprü hedefleri oluşturmaz alıntılar (başlık metni veya dipnot/atıf etiket köprü adı olarak kullanılır).

Yani (reStructuredText hızlı başvuru, yazım hataları ve tüm kaldırdı) şu metin:

<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

Yeni, daha iyi cevap:

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

aşağıdakine benzer HTML üretir 2016 için!

autosection extension, gerçek çapraz referanslarla bunu kolayca yapmanızı sağlar.

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


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

sonra, sonra ...

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


A link- :ref:`Internal Headline` 

Bu eklenti yerleşik, böylece tüm ihtiyacınız conf.py

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

dikkatli olmak zorunda tek şey düzenlemektir Şu anda, doküman koleksiyonundaki dahili başlıkları kopyalayamıyorsunuz. (Buna değer.)