有没有办法禁用Sphinx标题/部分的自动锚点?

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

我有一个用例,我不希望 Sphinx 自动为我的部分生成锚点,因为我有多个具有相同标题的部分。

Title
-----

sample text

Title
-----

more sample text

使用默认的 Sphinx 项目配置,这将导致锚点和引用发生冲突,我现在不希望出现这种情况。是否有特定的配置/构建选项来禁用部分的锚点生成?

python-sphinx restructuredtext
1个回答
0
投票

不幸的是,没有配置选项可以抑制这些隐式超链接目标的生成。

但是,您可以通过提供“显式”超链接目标来防止冲突,例如,

.. _title:

Title
-----

sample text

Title
-----

Sample text referencing the first title_.

(使用普通 Docutils 进行测试,使用 Sphinx 的里程可能会有所不同。)

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