如何向自定义 Sphinx/JupyterBook 扩展添加枚举

Question

我正在为 Sphinx/JupyterBook 编写一个名为

examplenum

的指令的简单扩展，它将添加一个以“Example”开头的新标题，然后自动将正确的部分和示例编号添加到标题的末尾。例如，如果它是第 4.6 节中的第二个

examplenum

，那么指令将在文档中插入标题“Example 4.6.2”。

我对 Sphinx 指令 非常 陌生。我能够弄清楚如何添加标题并增加示例的编号，但我无法弄清楚如何包含节号。这是我的运行功能：

    def run(self):
        env = self.env
        example_id = env.new_serialno('examplenum') + 1
        example_sect = nodes.section()
        example_sect['ids'] = "Example"
        label = "Example {number}".format(number = example_id)
        example_sect += nodes.title(text=label)
        return [example_sect]

任何帮助将不胜感激。