Conserver le code en ligne à l'intérieur des références dans Sphinx

Question

Dans Sphinx, si j'ai le titre suivant de la déclaration:

.. _somestuff:

``this is code``, this is not!
==============================

Il rend, comme ceci:

    this is code, ce n'est pas!

Ce qui est bon, mais, si j'utilise la référence, de l'e.g:

Have a look at :ref:`somestuff`

Il perd la mise en forme du code et rend comme:

Jetez un oeil à ce qui est code, ce n'est pas!

au lieu de:

Jetez un oeil à l' this is code, ce n'est pas!

---

Est-il possible de conserver la mise en forme du code de la référence? Et comment pourrais-je aller à ce sujet?

Answer 1

Si vous avez un coup d'oeil à l' :ref: de la documentation dans son site web officiel à propos des balises inline:

:ref:

À l'appui de la croix-référencement des emplacements arbitraires dans tout document, le standard reste étiquettes sont utilisées. Pour que cela fonctionne noms d'étiquette doit être unique tout au long de l'ensemble de la documentation ...

Je pense (comme @Kevin Corne) c'est pas possible en ce moment, parce que c'est seulement utilisée pour créer des liens (sans d'abord mise en forme) avec d'autres sections de votre projet. Alors si vous écrivez quelque chose comme ceci:

.. _somestuff:

``this is code``, this is not!
==============================

.. _another_somestuff:

this is another code!
========================

Si j'en lien avec ces articles:

Have a look at :ref:`somestuff`
Have a look at :ref:`another_somestuff`
Have a look at :ref:`this link <somestuff>`

Le résultat est:

---

Jetez un oeil à ce qui est code, ce n'est pas!

Jetez un oeil à ce qui est un autre code!

Jetez un oeil à ce lien

---

Le style est le même dans chacun d'eux .

Remarque: l'italique/gras les mots symbolisent les liens