documentation - online - Retener el código en línea dentro de las referencias en Sphinx
generador de codigos qr personalizados (1)
Si echa un vistazo a :ref: documentación en su sitio web oficial sobre marcas en línea:
:árbitro:
Para admitir referencias cruzadas a ubicaciones arbitrarias en cualquier documento, se utilizan las etiquetas reST estándar. Para que esto funcione, los nombres de las etiquetas deben ser únicos en toda la documentación ...
Creo que (como @Kevin Horn) no es posible en este momento, porque solo se usa para crear enlaces (sin el primer formato) con otras secciones en su proyecto. Entonces, si escribes algo como esto:
.. _somestuff:
``this is code``, this is not!
==============================
.. _another_somestuff:
this is another code!
========================
Si me enlace con estas secciones:
Have a look at :ref:`somestuff`
Have a look at :ref:`another_somestuff`
Have a look at :ref:`this link <somestuff>`
El resultado es:
Eche un vistazo a esto es código, ¡esto no es así!
¡Echa un vistazo a este es otro código!
Eche un vistazo a este enlace
El estilo es el mismo en todos ellos.
Nota : las palabras en cursiva / negrita simbolizan enlaces
En Sphinx, si tengo la siguiente declaración de rumbo:
.. _somestuff:
``this is code``, this is not!
==============================
Se renderiza así:
this is code , ¡esto no es!
Lo cual es bueno, pero, si uso la referencia, por ejemplo:
Have a look at :ref:`somestuff`
Pierde el formato del código y lo renderiza como:
Eche un vistazo a esto es código, ¡esto no es así!
en lugar de:
Eche un vistazo a this is code , ¡esto no es así!
¿Es posible mantener el formato del código en la referencia? ¿Y cómo lo haré?