restructuredtext 链接到其他 rst 文件菜单锚点答案

【问题标题】：restructuredtext link to other rst file menu anchorrestructuredtext 链接到其他 rst 文件菜单锚点
【发布时间】：2020-06-14 00:33:28
【问题描述】：

采用这种结构：

$ tree
.
├── Editors.rst
└── Tool_vim.rst

我想从 Editor.rst 文件链接到 Tool_vim.rst 文件。

我明白了：

Follow install from :doc:`Tool_linux_install`

但是在 Tool_linux_install.rst 我有一个带有 .. contents:: 和部分的菜单，但我没有成功链接到 vim 章节：

Follow install from :doc:`Tool_linux_install#vim`

但是编译的时候报错：

Tool_vim.rst:423: WARNING: unknown document: Tool_linux_install#vim

【问题讨论】：

【解决方案1】：

:doc: 角色可用于链接到另一个文档，但它不支持链接到文档中的特定位置。

改为使用:ref: 角色链接到由标签定义的目标。可以使用sphinx.ext.autosectionlabel 扩展名自动生成标签。

【讨论】：