Come creare un collegamento a un'intestazione in testo ristrutturato? - testo ristrutturato

Ho un documento in prova ristrutturata come:

Header 1
========

e da qualche altro punto (potrebbe essere lo stesso "primo" file o uno diverso) voglio creare un collegamento ipertestuale a quell'intestazione. In modo che quando un utente fa clic su di esso, arriva alla pagina con l'intestazione Header 1

Come farlo?

Ho provato a inserire la seguente riga nell'altro documento (secondo questa documentazione):

see :ref:`Header 1`

ma quello che ottengo è il seguente:

see Header 1

senza alcun link ...

Ho anche cercato di seguire questa documentazione:

Cosa ho inserito nel rst il file è il seguente

see `Header 1`_

e quello che vedo è il seguente link:

see `Header 1`_

che non sembra molto bello ...

risposte:

1 per risposta № 1

Il tuo primo link era quasi corretto. Devi aggiungere un'etichetta che precede l'intestazione della sezione, separata da una riga vuota. Vedere Markup incorporato, riferimenti arbitrari a posizioni arbitrarie, utilizzando il :ref: direttiva.

Nel tuo caso:

.. _header-1-label-name:

Header 1
========

Some text

Here is a section reference: :ref:`header-1-label-name`.

Here is a section reference with a title: :ref:`Header 1 with a title <header-1-label-name>`.

---