Sphinx中自定义指令的未知目标名称

时间:2018-09-05 12:57:20

标签: python-sphinx docutils

我创建了Sphinx扩展,提供了自定义指令。 run方法返回一个target节点和一个section节点,其中包含一些用于自定义指令的文本。

我现在想引用此自定义指令,但是在生成期间,我仅收到来自Sphinx的Unknown target name错误消息。

示例:

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

.. mydirective:: ABC-123

   Some Text goes here.

HTML中mydirective的结果部分具有ID abc-123。该参考试图引用一些已生成的不存在的ID。

如果我将引用写为

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

生成的HTML可以正确导航。

是否可以使用上面的简单引用形式?如果是,怎么办?

谢谢。

0 个答案:

没有答案