使用自动切片标签时引用本地标题

问题描述 投票:0回答:1

启用了autosectionlabel和autosectionlabel_prefix_document后,如何使用sphinx引用本地文档中的小节标题。我的文档有详细的嵌套文件夹安排,并希望用代表本地文件的内容替换长路径。 #,或本地文件名不起作用

示例

Heading 1
---------

subheading
^^^^^^^^^^

:ref:`/full/path/relative_to_config_file:subheading` works 
python-sphinx
1个回答
0
投票

我完全不清楚autosectionlabel的文档。我认为您可以在没有绝对参考的情况下做您想做的事情:

autosectionlabel

或者也许:

Heading 1
---------

subheading
^^^^^^^^^^

:ref:`relative/to/config/file:subheading`

否则,您将必须使用任意:ref:`relative-to-config-file:subheading`

如果将标签直接放在节标题之前,则可以使用:ref:cross-references对其进行引用。例如:

label-name
© www.soinside.com 2019 - 2024. All rights reserved.