Ссылка на пользовательский тип фигуры в 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.