restructuredtext链接到其他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::和sections的菜单，但我无法成功地链接到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。