在Sphinx中引用自定义图形类型

Question

如果我尝试引用自定义图形类

class MyFigure(
    sphinx.util.docutils.SphinxDirective, 
    docutils.parsers.rst.directives.images.Figure
):
    pass

def setup(app):
    app.add_role('fig', MyFigure)

然后像这样使用它

.. fig:: foo.png
    :name: myfig


Look at :ref:`myfig`.

任何引用都将失败，并带有>>

WARNING: undefined label: myfig
如何解决此问题？

如果我尝试引用自定义图形类类MyFigure（sphinx.util.docutils.SphinxDirective，docutils.parsers.rst.directives.images.Figure）：通过def setup（app）：app.add_role（'...

Answer 1

docutils.parsers.rst.directives.images.Figure是不适合自定义的类，因为它不处理name属性。请使用Sphinx的修补版本sphinx.directives.patches.Figure。