我创建了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可以正确导航。
是否可以使用上面的简单引用形式?如果是,怎么办?
谢谢。