Comportamiento similar a una miniatura utilizando el atributo de destino de la directiva de imagen

Question

Uso Sphinx para generar algunos documentos. Tengo un documento reStructuredText y me gustaría poner una imagen en él. El caso es que la imagen debe poder hacer clic para que, después de que un usuario haga clic en la imagen, se muestre esta imagen a tamaño completo. Yo uso la directiva imagen y su opción de destino así:

.. image:: /images/some_image.png 
    :alt: Image descripion 
    :align: center 
    :target: `big_some_image`_ 

.. _big_some_image: /images/some_image.png 

El problema es que en la página representada consigo:

<a href="/images/some_image.png"><img src="../../../_images/some_image.png"></a> 

Así que no es correcto src de la directiva de la imagen, sino una incorrecta href atributo del hipervínculo.

Preguntas:

• ¿Hay alguna manera de generar vínculos en la forma en que lo hace la Directiva de imagen? Me refiero en relación con el documento.

• ¿Hay alguna otra forma (incorporada) de tener un comportamiento de "miniatura -> clic -> imagen grande"?

Answer 1

Cuando se utiliza la directiva image desde el interior de la esfinge, esfinge hace un manejo especial para encontrar el archivo de imagen y copiarla en su proyecto (como el directorio de _images), y luego representa el HTML para que apunte a ese lugar .

Pero la opción target simplemente toma una URL como parámetro. No sabe nada acerca de su proyecto Sphinx, ni cómo se presentan sus imágenes, y no intenta adivinar.

Si desea que apunte a una versión más grande del mismo archivo, es probable que necesite hacer algunos pasos manuales (como quizás copiar el archivo a una ubicación específica), o tal vez proporcionar una URL relativa a la gran archivo, en lugar de la URL absoluta que tiene en su ejemplo.

Si quiere ir por un camino completamente diferente, también puede intentar sobrescribir y modificar las plantillas HTML para que su proyecto agregue algo de JavaScript para obtener el efecto de hacer clic en una imagen más grande que desee.

Answer 2

Basta con utilizar la opción de escala:

.. image:: large_image.png 
    :scale: 20% 

Cuando se hace clic en la imagen escalada, la imagen se carga completo en su propia ventana. Así que esto no aumenta el tamaño de la imagen en la página, pero de todos modos sería complicado.

Answer 3

Parece que hay una extensión de Sphinx que hace esto ahora, y bastante bien en eso, sphinxcontrib-fancybox 0.3.2. Instalar con pip, añadirlo a sus extensiones en conf.py, y el uso de la directiva fancybox:

.. fancybox:: images/image.png 

Answer 4

enlaces relativos parecen funcionar. Para la configuración de documentos Mapserver, si una imagen se coloca en el directorio images, un vínculo relativo como en el siguiente código funciona en mi compilación local.Aquí hay un ejemplo usando figura (el guión bajo ("_") antes de "imágenes" en el objetivo enlace es necesario):

.. figure:: ../../images/carto-elements.png 
    :height: 400 
    :width: 600 
    :align: center 
    :target: ../../_images/symcon-overlay.png