Windows 10上的py支架: Sphinx模块文档未生成
Windows 10上的py支架: Sphinx模块文档未生成
提问于 2019-05-08 13:08:26
我在Windows10机器上使用py支架(https://pyscaffold.org/ )创建了一个Python项目。
当试图通过命令生成文档时：
python setup.py docs这些文档只为已经包含在docs文件夹中的.rst文件生成，但是没有从Python源代码构建文档。没有报告错误，只是对
Module Reference <api/modules>说明：“警告:文档不包含在包含的文件的任何图库中”。需要注意的是，在api/ .rst子文件夹中不生成任何文件。
回答 1
Stack Overflow用户
回答已采纳
发布于 2019-05-08 13:15:56
狮身人面像文档(在http://howto.nspx.ca/how-to-sphinx.html上)警告说：“在Windows上，斯芬克斯自动构建的活动服务器可能会出现空白项目路径问题。如果该命令出错，请尝试移动项目，以便您完全限定的源路径不包含任何空白。”
实际上，我的项目位于
C:\Users\User\Documents\Visual Studio 2015\经过深入研究，我注意到与源代码相关的.rst文件是在
C:\Users\User\Documents\Visual\api\modules因此，这个问题肯定与项目路径中的空白有关。
将整个项目移动到路径没有空白的文件夹中(例如：
C:\Users\User\Documents\Projects解决了这个问题。
页面原文内容由Stack Overflow提供。腾讯云小微IT领域专用引擎提供翻译支持
原文链接：
https://stackoverflow.com/questions/56041582
复制相关文章
相似问题
腾讯云开发者
