Я могу визуализировать мои файлы Readme.md в Sphinx, используя рекомендацию. Но когда я пытаюсь вставить несколько файлов Readme в дерево .rst файла, только к первому можно получить доступ по ссылке на документацию.
Kick! KVM
=========
Source Code: https://bitbucket-eng-rtp1.cisco.com/bitbucket/projects/KICK/repos/kickdb/browse/kick/kvm
ReadMe
------
.. toctree::
:maxdepth: 2
./README.md
Tests ReadMe
------------
.. toctree::
:maxdepth: 2
./tests/README.md
KVM Module Code
---------------
.. automodule:: kick.kvm.actions
:members:
:undoc-members:
Я вижу оба файла Readme в структуре папок, но ссылки не работают при попытке получить к ним доступ с визуализированной html-страницы.
Вот изображение структуры папок.
Любая помощь приветствуется, спасибо!
Вот ошибка, которая появляется в сборке Sphinx:
/workspace/kick_device2/kick/kvm/kvm.rst:16: ПРЕДУПРЕЖДЕНИЕ: toctree содержит ссылку на документ kick / kvm / tests / README, у которого нет заголовка: ссылка не будет создана