Esfinge automatizado de la numeración de imágenes / títulos?

Question

¿Hay una manera de generar automáticamente un título de imagen / figura utilizando la esfinge?

Actualmente tengo archivos rest-sphinx que estoy convirtiendo a html y (latex) pdf usando sphinx.

Me gustaría una forma fácil para que los usuarios hagan referencia a una imagen específica en los archivos html / pdf resultantes. Por ejemplo, si un usuario hace referencia a la documentación en un correo electrónico, " En 'Imagen 65' dice XXX, pero esto no funciona para mí " ;.

He intentado usar figure donde aparece para permitirle aplicar un título a una imagen, pero esto debe agregarse manualmente. (Y tengo problemas para hacer que funcione con la sustitución por alguna razón).

¿Hay un método de descanso de la esfinge que estoy pasando por alto y que lograría esto? O, ¿hay alguna manera de modificar / editar las plantillas existentes de la esfinge para agregar esta capacidad?

Answer 1

Sphinx consume reStructuredText según la plantilla de Jinja . Sin embargo, según la documentación de Sphinx, usted tiene otras opciones de plantilla .

Debería poder utilizar estructuras de control en una plantilla personalizada para lograr el efecto que buscas.