Warning: file_get_contents(/data/phpspider/zhask/data//catemap/2/github/3.json): failed to open stream: No such file or directory in /data/phpspider/zhask/libs/function.php on line 167

Warning: Invalid argument supplied for foreach() in /data/phpspider/zhask/libs/tag.function.php on line 1116

Notice: Undefined index: in /data/phpspider/zhask/libs/function.php on line 180

Warning: array_chunk() expects parameter 1 to be array, null given in /data/phpspider/zhask/libs/function.php on line 181
Github 如何在ReadTheDocs的一个项目中设置多个Sphinx文档?_Github_Python Sphinx_Read The Docs - Fatal编程技术网

Github 如何在ReadTheDocs的一个项目中设置多个Sphinx文档?

Github 如何在ReadTheDocs的一个项目中设置多个Sphinx文档?,github,python-sphinx,read-the-docs,Github,Python Sphinx,Read The Docs,我想使用ReadTheDocs托管我的Sphinx文档。该项目位于github上。我可以很好地连接到它 我的特殊性在于,该项目包含两个Sphinx文档(例如程序员手册和用户手册)。ReadTheDocs似乎同时检测(有两个conf.py)和构建这两个文件。然而,在显示它们时,它只显示其中一个的html,据我所知,第一个是按字母顺序显示的 因此,我的问题是: 如果两者都已建成,您如何才能看到另一个 是否有办法使用“子项目”指定每个conf.py的路径,从而为每个文档/手册提供清晰的URL?这将是理

我想使用ReadTheDocs托管我的Sphinx文档。该项目位于github上。我可以很好地连接到它

我的特殊性在于,该项目包含两个Sphinx文档(例如程序员手册和用户手册)。ReadTheDocs似乎同时检测(有两个conf.py)和构建这两个文件。然而,在显示它们时,它只显示其中一个的html,据我所知,第一个是按字母顺序显示的

因此,我的问题是:

  • 如果两者都已建成,您如何才能看到另一个

  • 是否有办法使用“子项目”指定每个conf.py的路径,从而为每个文档/手册提供清晰的URL?这将是理想的解决方案

  • 你一定要遵守规则

    通常您需要一个索引(在
    conf.py
    中称为
    master\u doc

    然后必须在目录树、包含或链接等中引用每个文件


    看看github(即:的)上的示例。

    我知道索引文件和目录树等。我在每本手册中都使用它们。我不是说要将多个.rst文件链接到一个手册中,而是说多个手册,每个手册都有自己的conf.py和目录结构,每个手册都使用sphinx quickstart在自己的目录中启动。它们是独立的手册,恰好位于同一个存储库中。对不起,我根本就没有这样理解。嗯,我唯一一次远程执行类似于您的设置的操作是在根目录下使用一个main conf.py来配置所有手册,这些手册位于子目录中。。。我很想了解将出现在本文中的解决方案。