Неизвестное имя цели для пользовательской директивы в Sphinx - PullRequest
0 голосов
/ 05 сентября 2018

Я создал расширение для Sphinx, которое предоставляет пользовательскую директиву. Метод run возвращает узел target и узел section с некоторым текстом для пользовательской директивы.

Теперь я хотел бы сослаться на эту пользовательскую директиву, но во время генерации я получаю только Unknown target name сообщений об ошибках от Sphinx.

Пример:

This is some text with a reference to `ABC-123`_.

.. mydirective:: ABC-123

   Some Text goes here.

Полученный раздел в HTML для mydirective имеет идентификатор abc-123. Ссылка пытается ссылаться на некоторый сгенерированный, несуществующий идентификатор.

Если я напишу ссылку как

 `ABC-123 <#abc-123>`_

сгенерированный HTML может быть правильно перемещен.

Можно ли использовать простую форму ссылки выше? Если да, то как?

Заранее спасибо.

...