在 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

如何解决这个问题？

Answer 1

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