Hacer referencia a figuras con números en Sphinx y reStructuredText

Question

Al escribir RST que se procesará con Sphinx, no puedo obtener la salida de LaTeX de Sphinx para utilizar números de figura al hacer referencia a las figuras. Por ejemplo, este código:

The lemmings are attacking, as can be seen in :ref:`figlem`. 

.. _figlem: 

.. figure:: _static/lemming_invasion.* 

    They're coming! 

se convertirá en esto:

Los lemmings están atacando, como se puede observar en Están viniendo!

/imagen va aquí/

Figura 1.1: Ya vienen!

Pero lo que yo quiero es la forma "estándar" del látex de figuras que hacen referencia, así:

Los lemmings están atacando, como se puede ver en la figura 1.1

Cómo ¿Lo logro? El código que estoy usando actualmente es el recomendado por el manual de Sphinx, pero no produce el resultado que deseo.

Answer 1

La extensión numfig hace exactamente esto. Lo intenté y funcionó para mí.

Answer 2

Creo que hacer referencia a Cifras aún no está implementado en reST, pero aquí está la solución http://article.gmane.org/gmane.text.docutils.user/5623 que te acerca.

Answer 3

Se puede usar código de látex sin procesar, en línea. Para el ejemplo anterior, primero se define una función para el código de látex sin procesar y luego se usa para referirse a la figura con el comando latex \ref{}, y para establecer una etiqueta para la figura con el comando latex \label{}.

lo siguiente debe funcionar:

.. role:: raw-latex(raw) 
    :format: latex 

The lemmings are attacking, as can be seen in :ref:`figlem` 
on figure :raw-latex:`\ref{pic:lem}`. 

.. _figlem: 

.. figure:: _static/lemming_invasion.* 

    They're coming! :raw-latex:`\label{pic:lem}` 

Tenga en cuenta que el comando \label{} aparecerá dentro de la leyenda en el archivo tex, pero todavía es aceptable, al menos por pdflatex. También tenga en cuenta que debe haber al menos un espacio antes de :raw-latex.

Answer 4

Para ampliar la respuesta aceptada, puede configurarla rápidamente de la siguiente manera. Coloque el archivo numfig.py en su directorio source. A continuación, abra conf.py y elimine la línea que dice

sys.path.insert(0, os.path.abspath('.')) 

A continuación, añada a la lista 'numfig'extensions.

para utilizar en su documento rst, primera etiqueta su figura (por ejemplo, fig-main):

.. _fig-main: 

.. figure:: main.png 

    This is the figure caption. 

Por último, se puede hacer referencia a su número de la figura usando la directiva :num:, así:

Refer to the main figure (Figure :num:`fig-main`). 

Answer 5

En las últimas versiones de Sphinx (1.3+), numerar las cifras y hacer referencia a ellas desde el texto se hizo un poco más fácil ya que el soporte ahora está incorporado.

En el texto, se puede hacer algo como:

.. _label: 
.. figure:: images/figure.* 


At :numref:`label` you can see... 

El resultado final debe ser algo así como "En la figura 1.1 se puede ver ...". Esta técnica funciona tanto con la salida HTML predeterminada como con la salida LaTeX.

En su archivo conf.py, asegúrese de establecer la marca numfig = True. También hay opciones de configuración para el formato de texto de las referencias (numfig_format y numfig_secnum_depth).

Referencias:

• http://www.sphinx-doc.org/en/stable/config.html#confval-numfig
• http://www.sphinx-doc.org/en/stable/markup/inline.html#cross-referencing-figures-by-figure-number