Sphinx readthedocs安装目录的布局与在我自己的计算机上安装的布局不同如何使它们相同?

问题描述

例如,当我在计算机上运行Sphinx时,它将进行安装

developers / integration.rst进入developers / integration.html

但是在readthedocs上它将安装在

developers / integration / index.html

这会使在任何原始命令中使用相对链接失败。

有没有一种方法可以强制我的机器安装使用与readthedocs相同的目录结构?还是其他解决方案?

解决方法

这基本上就是Standalone HTML BuilderDirectory HTML Builder之间的区别。您可以使用文档读取配置文件的sphinx-builder选项来更改构建器,或者通过使用-b指定构建器来在命令行上更改构建选项。