Est-il possible d'insérer des hyperliens dans un bloc littéral ReST?

Question

Je sais ce genre de défaire le but d'un bloc littéral, mais je me demandais s'il y avait une solution de contournement pour y parvenir. Mon cas d'utilisation est de mettre un hyperlien dans un bloc littéral de pseudo-code, afin de référencer les détails ailleurs dans le document.

Exemple:

Look at this JSON pseudo code 
----------------------------- 

:: 

    { 
    "id": <number>, 
    "name": <string>, 
    "big_property": <see schema of big_object_> 
    } 

And the details of big object 
----------------------------- 

.. _big_object: 

:: 

    { 
    <another_schema> 
    } 

Je souhaite que, dans le premier bloc littéral, big_object_ devient un lien hypertexte.

Answer 1

Vous pouvez utiliser la directive parsed-literal pour cela:

.. parsed-literal:: 

    { 
    "id": <number>, 
    "name": <string>, 
    "big_property": <see schema of big_object_> 
    }