Jak utworzyć link wewnętrzny do nagłówka w sfinksie, przekształcić tekst bez tworzenia dowolnych etykiet?

Question

Mam dokument z wieloma nagłówkami i poddziałami. W dalszej części tekstu chcę powrócić do jednego z nagłówków. Jak mogę to zrobić bez nadmiarowości etykiet :ref:? Treści wydają się dobrze odbierać nagłówki. Miałem nadzieję na coś takiego: `#polled-data-retrieval`_.

Answer 1

reStructuredText obsługuje implicit hyperlink targets. Z reStructuredText quick reference: tytuły

sekcji, przypisów i cytatów automatycznie generują cele hiperłączy (etykieta tytuł tekstu lub przypis/cytat jest używana jako nazwa hiperłącza).

więc następujący tekst (podnoszone z reStructuredText podręczne, błędów ortograficznych i wszystkie):

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

produkuje HTML podobnego do poniższego:

<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

nową, lepszą odpowiedź na 2016!

Dzięki temu można łatwo zrobić to z prawdziwymi odnośnikami.

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


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

potem, potem ...

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


A link- :ref:`Internal Headline` 

To rozszerzenie jest wbudowany, więc wszystko, co potrzebne jest, aby edytować conf.py

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

jedyną rzeczą, którą trzeba uważać z tego, że teraz nie można powielać wewnętrznych nagłówków w zbiorze dokumentów. (Warto.)