Python sphinx 如何链接Sphinx文档集中的页面

我在谷歌上搜索了很多遍后都找不到答案

我第一次尝试sphinx，但我看不到如何在sphinx文档中包含指向其他页面的链接。似乎

：doc

指令应该可以做到这一点，但它不起作用

例如，假设我有一棵非常简单的树：

./index.rst
./files/CPPFiles.rst
./files/PythonFiles.rst

第一个是，

index.rst

，并且有一个TOC，它希望在“自由”文本中链接到这些子文件之一，因此my index.rst包含以下内容：

My Docs
=======

This is a Python module but powered by a C++ back end. 
Unless you're planning on extending this module you only need
to read :doc:`the Python docs<files/PythonFiles>`.


.. toctree::
   :maxdepth: 2
   :caption: Contents:

   files/PythonFiles
   files/CPPFiles

---

在这两种情况下，

：doc:

中的文本按预期显示，但不是链接。

空白在重构文本中具有意义

:doc:`the Python docs<files/PythonFiles>`.

：doc:`Python文档`。

应该是：

:doc:`the Python docs <files/PythonFiles>`.

：doc:`Python文档`。

:doc:`the Python docs <files/PythonFiles>`.