Автоматическая нумерация/подписи к изображениям Sphinx?

Question

Есть ли способ автоматически генерировать подпись к изображению/рисунку с помощью sphinx?

В настоящее время у меня есть файлы rest-sphinx, которые я конвертирую в html и (latex)pdf с помощью sphinx.

Мне нужен простой способ для пользователей ссылаться на определенное изображение в полученных файлах html/pdf.Например, если пользователь ссылается на документацию в электронном письме: «В «Изображении 65» написано XXX, но у меня это не работает».

Я пробовал использовать фигура где кажется, что вы можете добавить подпись к изображению, но ее нужно добавить вручную.(И у меня почему-то проблемы с его работой с заменой).

Есть ли метод rest-sphinx, который я упускаю из виду, который позволит достичь этого?Или есть ли способ изменить/отредактировать существующие шаблоны Sphinx, чтобы добавить эту возможность?

Answer 1

Sphinx использует reStructuredText по шаблону Джинджа.Однако, согласно документации Sphinx, вы есть другие варианты шаблонов.

Вы должны уметь использовать Jinja структуры управления в специальном шаблоне для достижения желаемого эффекта.