无法从不同的文件添加 RST 参考

Question

在 RST 文档文件中，执行 :ref 命令后，我无法生成指向目标部分的链接。

这是编辑后的文件： https://github.com/rahulchhabra07/pcl/blob/master/doc/tutorials/content/narf_keypoint_extraction.rst

这是目标文件：https://github.com/rahulchhabra07/pcl/edit/master/doc/tutorials/content/range_image_visualization.rst

请告诉我，如何确保链接适用于标签。

Answer 1

我认为问题在于范围图像可视化文件未包含在项目中；它没有在索引文件中列出。所以当 sphinx 寻找目标标签时，它并没有找到。如果您不希望目标在 toc 中，您可以将其包含在它自己的 toc 中并隐藏它：

.. toctree::
  :hidden:

  filename