如何在readthedocs Sphinx构建中跳过Python源文件

我如何告诉readthedocs不要加载位于上根文件夹中的任何Python文件

背景：我希望readthedocs为Blender Python插件构建Sphinx文档，该插件托管在github上。我已经在存储库中为Sphinx文件创建了docs文件夹。我可以在本地计算机上（在docs目录下）生成Sphinx文档，但在readthedocs上生成时出错

  File "/home/docs/checkouts/readthedocs.org/user_builds/bvtknodes/envs/latest/lib/python3.7/site-packages/pip/_internal/utils/misc.py", line 20, in <module>
    from pip._vendor import pkg_resources
  File "/home/docs/checkouts/readthedocs.org/user_builds/bvtknodes/envs/latest/lib/python3.7/site-packages/pip/_vendor/pkg_resources/__init__.py", line 41, in <module>
    import inspect
  File "/home/docs/checkouts/readthedocs.org/user_builds/bvtknodes/checkouts/latest/inspect.py", line 1, in <module>
    import bpy
ModuleNotFoundError: No module named 'bpy'

文件“/home/docs/checkout/readthedocs.org/user_builds/bvtknodes/envs/latest/lib/python3.7/site packages/pip/_internal/utils/misc.py”，第20行
从pip.\u供应商导入包装资源
文件“/home/docs/checkout/readthedocs.org/user_builds/bvtknodes/envs/latest/lib/python3.7/site packages/pip/_vendor/pkg_resources/uuu init_uuuuuuuuuuuuuuu.py”，第41行
进口检验
文件“/home/docs/checkout/readthedocs.org/user_builds/bvtknodes/checkout/latest/inspect.py”，第1行，在
进口bpy
ModuleNotFoundError:没有名为“bpy”的模块

此错误的原因是根目录中存在

inspect.py

模块，因此读取加载该模块的Docs安装过程，而不是inspect模块的系统版本。当我将inspect.py重命名为b_inspect.py时，文档构建过程在readthedocs中正确完成。然而，这只是一个解决办法，有更好的解决方案吗

原始错误解释：似乎readthedocs正在尝试检查

\uuu init\uuuuuuy.py

（位于顶级文件夹，无法从那里移动到子文件夹）内容，当无法导入bpy时，构建失败。AFAIK没有办法通过pip安装bpy模块（但我无论如何也不想这么做）。我希望readthedocs忽略所有python文件

language=None

和

docs/conf.py

中的

extensions

列表为空。我还将readthedocs Advanced Settings中的“Python配置文件”设置设置为

docs/conf.py

。谢谢

---

这里是。

没有进一步的信息，无法复制或帮助。请包含一个指向失败构建的链接，以便我们可以查看故障并排除故障。好的，添加了链接。我认为问题在于RTD找不到您的

docs/conf.py

文件。在RTD配置中，转到Admin>Advanced Settings，并为“Python配置文件”输入

docs/conf.py

。作为旁注，如果该设置不起作用，我建议您将源代码放入嵌套文件夹

src/projectname

，以将文档与代码分开。这可能是RTD的问题，但这只是猜测。谢谢，但我已经设置了“Python配置文件”，不幸的是，它不是将代码移动到子文件夹的选项。我想知道如果readthedocs无法导入库，是否有办法阻止它解析

\uuuu init\uuuu.py

？一般来说，将源代码放在项目的根目录中是个坏主意。