Загадочная ошибка Sphinx: «Несоответствие анонимной гиперссылки».

Я использую Sphinx 2.2.2 для отладки документа Sphinx с большим новым исходным файлом, содержащим множество перекрестных ссылок. Я получаю это сообщение:

      Warning, treated as error:
C:\Users\...\<filename>.rst::Anonymous hyperlink mismatch: 15 references but 0 targets.
See "backrefs" attribute for IDs.
ERROR: Error while building Main - External manual !

Я примерно знаю, что это значит: 15 анонимных перекрестных ссылок указывают на неопределенные цели (или, возможно, все указывают на одну неопределенную цель). Но как мне их найти?

В нем говорится, что я должен видеть атрибут «backrefs» для «идентификаторов», что, предположительно, поможет мне найти ссылки на проблемы. Но я не знаю, что такое атрибут «backrefs», или что это за атрибут, или как получить к нему доступ, или что такое «идентификаторы» и что с ними делать, когда я их найду.

Я искал в Интернете ссылки на «обратные ссылки», но не нашел ничего подходящего и понятного. Кто-нибудь может помочь?

0 ответов

Другие вопросы по тегам