реструктурировать текстовую ссылку на другой якорь меню первого файла - PullRequest
1 голос
/ 01 марта 2020

С этой структурой:

$ 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 Ответ

2 голосов
/ 01 марта 2020

Роль :doc: можно использовать для ссылки на другой документ, но она не поддерживает ссылки на указанное c местоположение в документе.

Вместо этого используйте :ref: роль для связи с целью, определенной меткой. Можно автоматически создавать ярлыки с расширением sphinx.ext.autosectionlabel.

См. Также https://github.com/sphinx-doc/sphinx/issues/6766.

...