使用位于 Filr（微焦点）的项目构建 sphinx 文档时出现问题

Question

当我的项目位于我的桌面或其他地方时，我可以使用 sphinx 正常构建我的文档。

但是，我在 Filr（微焦点）中备份了所有文件。这就是我们在工作中使用的。最近将我的项目移至此备份系统后，我注意到 sphinx 无法再构建它。我必须在其他地方进行测试，并且它有效。 当然，我已经仔细检查了路径和文件名，但似乎没有任何作用。

供您参考，我也可以离线访问 Filr，因为它会自动同步。

这是我得到的基本错误。似乎源文件就在那里找不到：

cd "C:\Users\antdu953\Filr\My Files\WAVE ENERGY\RESEARCH\MODELLING\xModel\docs"
make html

输出：

Application error:
Cannot find source directory (C:\Users\antdu953\Filr\My Files\WAVE ENERGY\RESEARCH\MODELLING\xModel\docs\source)

可能出了什么问题？

Answer 1

一种可能的解决方案是合并所有源目录作为初步构建步骤，并在单独的文件夹中执行 sphinx-build。 rsync 可用于有效同步源目录和构建目录中的文件。

另一个解决方案是在构建时设置环境变量以指定要构建的产品。

您还可以尝试相应地设置Python的模块搜索路径sys.path，以便Sphinx可以找到它们。