Pek*_*ica 3 python google-app-engine python-sphinx
关于我去年关于文档的问题,我现在想要开始并尝试基于Python的Sphinx来整理我一直在研究的PHP CMS的开发人员文档.
我想在我的工作站上本地设置Python,而不是从一开始就在公共可访问的Web服务器上运行它.我有权访问LAMP堆栈上的所有Web托管包,我不愿意购买基于Python的托管.我对Google App Engine非常感兴趣,他们提供的免费配额将为我做一百次,即使没有,他们的定价看起来也很合理.
现在我对Python一无所知 - 让Sphinx工作将是我第一次接触它 - 而且时间很短.据我所知,App Engine提供的平台和python库与标准Python库非常兼容,但不完全相同.
所以我的问题是:
Sphinx可以在App Engine上运行吗？
在App Engine上安装Sphinx就像我在普通的Python安装上安装它一样简单吗？或者,App Engine的环境是否需要调整我在当前Python级别上无法在合理时间内执行的源代码？
我应该首先在本地服务器和"普通"Python堆栈上安装Sphinx吗？
有没有人知道任何有用的操作方法,教程或其他资源？
您根本不需要在GAE上安装Sphinx.
您可以使用Sphinx创建静态HTML,CSS和JS的目录.完成此步骤后,您只需上传Sphinx的输出 - 完整.
Sphinx(HTML,CSS和JS)的输出只需从一个地方提供.您将文档从创建它的位置上传到GAE作为静态文件并提供它们.完成.
Sphinx完全没有"在Web服务器上安装"的方面.Sphinx不是一个Web应用程序; 它不会在您的Web服务器上运行.您可以在开发中简单地运行它以将文档发布到HTML,LaTeX或其他任何内容.一旦创建了静态HTML文件,就不再需要Sphinx的任何部分了.
Sphinx可以在App Engine上运行吗？
我想它可以,但你永远不需要.
在App Engine上安装Sphinx就像......一样简单
没关系,因为你没有在那里安装它.您将其安装在工作站上并在工作站上使用它.
我应该首先在本地服务器和"普通"Python堆栈上安装Sphinx吗？
不要将其安装在服务器上.将其安装在您的工作站上.
有没有人知道任何有用的操作方法,教程或其他资源？
如果用"this"表示"在Web服务器上安装",那么回答是"否".一个不会将其安装在Web服务器上.因此,没有"在Web服务器上安装"的操作方法,教程或资源.
如果用"this"表示"用Sphinx创建文档",那么答案就是" http://sphinx.pocoo.org有什么问题？他们缺少什么？
我希望Sphinx的"引擎"将输入(由reST文件组成)转换为HTML/CSS/JS,可以从任何地方访问,以使我(和可能的其他贡献者)独立于特定的工作站.
Sphinx就像一个编译器.每个人都在自己的工作站上有自己的副本.他们下载文档源,进行更改,提交源更改并上载生成的文档.
从同一个地方提供生成的文档.
正确.下载源代码,进行更改,重新生成文档并提交更改后,您上传生成的文档,以便从一个地方(仅一个地方)提供服务.
Sphinx是一个编译器.它不是"网络引擎".它是一个简单的编译器,只需将您的文档编译为HTML,就可以提供它.