重新构造到其他rst文件菜单锚的文本链接

Question

使用此结构：

$ 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

Answer 1

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

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

另请参阅https://github.com/sphinx-doc/sphinx/issues/6766.