Numerazione / didascalie automatiche delle immagini di Sphinx?

Question

C'è un modo per generare automaticamente una didascalia di immagine / figura usando la sfinge?

Al momento ho file rest-sphinx che sto convertendo in html e (latex) pdf usando sphinx.

Vorrei un modo semplice per gli utenti di fare riferimento a un'immagine specifica nei file html / pdf risultanti. Ad esempio, se un utente fa riferimento alla documentazione in un'email, "nell'immagine 65" indica XXX, ma questo non funziona per me "

Ho provato a utilizzare figure dove appare per consentire di applicare una didascalia a un'immagine, ma questa deve essere aggiunta manualmente. (E ho problemi a farlo funzionare con la sostituzione per qualche motivo).

Esiste un metodo di sfinge di riposo che sto trascurando per raggiungere questo obiettivo? Oppure, c'è un modo per modificare / modificare i modelli esistenti di sfinge per aggiungere questa capacità?

Answer 1

Sphinx consuma reStructuredText come riportato da Jinja . Tuttavia, secondo la documentazione di Sphinx, hai altre opzioni di template .

Dovresti essere in grado di usare le strutture di controllo di Jinja in un modello personalizzato per ottenere l'effetto che stai cercando.