微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

sphinx可以链接到位于.rst文档上方一个路径中的文档吗?

如何解决sphinx可以链接到位于.rst文档上方一个路径中的文档吗?

我正在尝试使用Sphinx的基础知识来记录一个小项目。但是我无法让他找到上面目录中的文件

项目结构如下:

/ Users / machine / workspace / project1

├── BDRespostas.py
├── constantes.py
├── docs
│   ├── conf.py
│   ├── index.rst
│   └── make.bat
├── estatisticas.py
├── migrate_postgre_sqlite.py
├── preProcessamentoTextual.py
└──

而且我尝试了几种方法来配置index.rst,但没有成功:

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

   :ref:'estatisticas.py'
   ../BDRespostas.py
   '/Users/machine/workspace/project1/constantes.py'

我还结合了几次尝试,将sys.path.insert()添加到项目目录中。如果您已经成功地进行了引用并可以对我有所帮助,我将非常感谢。

解决方法

如上所述,toctree用于包含文档(.rst文件),而不是Python源。告诉我们您想要实现什么。

为了不掩盖它-toctree只能包含当前文件夹或子文件夹中的文档。即你不能

.. toctree::
   
   ../one.rst
   ../two/three.rst

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。