如何在Shinx中创建可引用的标签节点

问题描述

我正在用Shinx创建自定义指令。 此指令列出了所有可能的对象(每个对象都在单独的部分中)。

现在，我希望文档的其他部分(文件)可以引用这些对象。

我想做一些非常简单的事情，比如：

class MyDirective(Directive):
    def run(self, obj):
        id1 = 'object-unique-id1'
        id2 = 'object-unique-id2'
        label = nodes.label('abc1', refid=id1)
        section = nodes.section(ids=[id2])
        section += nodes.title(text='abc')
        section += label
        return [section]

但它不允许我通过：ref：object-unique-id1、：ref：object-unique-id2或：ref：abc引用此部分。

所以我的问题是：如何创建可以引用的节点？

---

解决方案

在节前添加目标似乎有效。类似于：

class MyDirective(Directive):
    def run(self, obj):
        titleTxt = 'abc'
        lineno = self.state_machine.abs_line_number()
        target = nodes.target()
        section = nodes.section()

        # titleTxt appears to need to be same as the section's title text
        self.state.add_target(titleTxt, '', target, lineno) 
        section += nodes.title(titleTxt, '')

        return [target, section]

注意对self.state.add_target的调用。

在构建稍后的某个地方，目标会被魔术般地创建，并且应该能够用

引用您的部分

:ref:`abc`

项目中的任何位置。