Sphinx自动化图片编号/标题？

Question

有没有办法用sphinx自动生成图片或图表的标题呢？

我现在有一些rest-sphinx文件，正在用sphinx把它们转换成html和（latex）pdf格式。

我希望用户能方便地在生成的html/pdf文件中引用特定的图片。比如，如果用户在邮件中提到文档时，可以说“在‘图片65’中说XXX，但这对我没用”。

我试过使用figure，这个功能似乎可以给图片加标题，但需要手动添加。（而且我不知道为什么在替换时总是出问题）。

有没有我忽略的rest-sphinx方法可以实现这个功能？或者，有没有办法修改sphinx现有的模板来添加这个功能？

Answer 1

Sphinx使用一种叫做reStructuredText的格式，这种格式是通过Jinja来进行模板化的。不过，根据Sphinx的说明，你还有其他的模板选项。

你可以在自定义模板中使用Jinja的控制结构，这样就能实现你想要的效果。