我有一个用例,我不希望 Sphinx 自动为我的部分生成锚点,因为我有多个具有相同标题的部分。
Title
-----
sample text
Title
-----
more sample text
使用默认的 Sphinx 项目配置,这将导致锚点和引用发生冲突,我现在不希望出现这种情况。是否有特定的配置/构建选项来禁用部分的锚点生成?
不幸的是,没有配置选项可以抑制这些隐式超链接目标的生成。
但是,您可以通过提供“显式”超链接目标来防止冲突,例如,
.. _title:
Title
-----
sample text
Title
-----
Sample text referencing the first title_.
(使用普通 Docutils 进行测试,使用 Sphinx 的里程可能会有所不同。)