- android - 多次调用 OnPrimaryClipChangedListener
- android - 无法更新 RecyclerView 中的 TextView 字段
- android.database.CursorIndexOutOfBoundsException : Index 0 requested, 光标大小为 0
- android - 使用 AppCompat 时,我们是否需要明确指定其 UI 组件(Spinner、EditText)颜色
跟进我的 last year's question关于文档,我现在想开始尝试基于 Python 的 Sphinx用于整理我一直在使用的 PHP CMS 的开发人员文档。
我不想在我的工作站上本地设置 Python,而是希望从一开始就在可公开访问的 Web 服务器上运行它。我有权访问的所有网络托管包都在 LAMP 堆栈上运行,我不愿意购买基于 Python 的托管。我对 Google App Engine 很感兴趣,他们提供的免费配额对我来说是一百倍,即使不是,他们的定价看起来也很合理。
现在我对 Python 的了解为零——让 Sphinx 工作将是我第一次接触它——而且时间很少。据我所知,App Engine 提供的平台和 Python 库与标准 Python 库非常兼容,但完全相同。
所以我的问题是:
Sphinx 能否在 App Engine 上运行?
在 App Engine 上安装 Sphinx 是否像在普通 Python 安装之上安装一样简单?或者 App Engine 的环境是否需要调整源代码,而我目前的 Python 水平无法在合理的时间内执行?
我是否应该先在本地服务器上安装 Sphinx 和“普通”Python 堆栈?
有人知道这方面的任何有用的操作方法、教程或其他资源吗?
最佳答案
您根本不需要在 GAE 上安装 Sphinx。
您使用 Sphinx 创建静态 HTML、CSS 和 JS 的目录。完成此步骤后,您只需上传 Sphinx 的完整输出。
Sphinx 的输出(HTML、CSS 和 JS)只是从一个地方提供。您将文档从创建它的地方上传到 GAE 作为静态文件并提供给它们。完成。
Sphinx 根本没有“安装在 Web 服务器上”这一方面。 Sphinx 不是 Web 应用程序;它不在您的网络服务器上运行。您在开发中短暂运行它以将文档发布为 HTML、LaTeX 或其他格式。一旦您创建了静态 HTML 文件,您就不再需要任何地方的 Sphinx 的任何部分。
Can Sphinx run on App Engine at all?
我想它可以,但你永远不需要。
Is installing Sphinx on the App Engine as straightforward as...
没关系,因为你不会把它安装在那里。您将它安装在您的工作站上并在您的工作站上使用它。
Should I be installing Sphinx on a local server and a "normal" Python stack instead first?
不要将其安装在服务器上。在您的工作站上安装它。
Does anybody know any helpful How-to's, tutorials or other resources for this?
如果“这个”是指“在网络服务器上安装”,那么答案是“否”。人们不会将其安装在 Web 服务器上。因此,没有关于“在 Web 服务器上安装”的操作方法、教程或资源。
如果“这个”是指“使用 Sphinx 创建文档”,那么答案是“https://www.sphinx-doc.org 有什么问题?它们缺少什么?
I would like Sphinx's "engine" that turns the input (consisting of reST files) into HTML/CSS/JS to be accessible from anywhere to make me (and possible other contributors) independent from a specific workstation.
Sphinx 就像一个编译器。每个人的工作站上都有自己的副本。他们下载文档源、进行更改、提交源更改并上传生成的文档。
serve the generated documentation from the same place.
正确。下载源代码、进行更改、重新生成文档并提交更改后,您上传生成的文档,以便从一个且仅一个位置提供服务。
Sphinx 是一个编译器。它不是“网络引擎”。这是一个简单的编译器,可以将您的文档编译成 HTML,以便提供。
关于python - 在 App Engine 上安装 Sphinx - 可能吗?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/2522255/
这很可能是我的语法错误,因为我对在 C++ 中使用多个文件和结构(特别是将结构传递给函数)还很陌生。这是三个文件: 主要.cpp: #include #include #include #inc
我有 TypeScript NestJS 项目。 我需要验证传入的 DTO 到我的 API。它可以被描述为“创建项目”,其中我们有建筑类型(房屋、公寓、花园),并根据该类型我们需要定义: 房屋:楼层包
是否可以从可用于泛型参数的可能类型集中排除特定类型?如果是如何。 例如 Foo() : where T != bool 将意味着除了类型 bool 之外的任何类型。 编辑 为什么? 以下代码是我尝试强
我的 WebGL 体积光线转换应用程序即将完成。但是我发现了一个问题。我必须通过 2D 纹理模拟 3D 纹理。这不是问题。我正在用小切片创建一个巨大的纹理。巨大纹理的尺寸约为 4096x4096 像素
我正在处理的网页上显示了一个返回顶部按钮。当您向下滚动时,有时单击它时,它会跳到顶部,然后跳回您在页面上的位置,然后像预期的那样平滑滚动到顶部。请记住,它并不总是这样做。这只是一个滞后或故障问题还是我
我对此还很陌生,所以请耐心等待。 我有一个类,它具有三个属性:几个整数和一个用户定义对象的集合。 public class Response { public int num1 { get;
我正在制作一款平台游戏,让玩家每 30 毫秒跳跃一次,并向上添加少量的力。我想我应该使用多线程,因为我之前已经做过一些,而且看起来很简单。无论如何,我尝试了这个: public void jump()
是否可以从可能的类型集中排除特定类型,这些类型可以在泛型参数中使用?如果是这样的话。 例如 Foo() : where T != bool 表示除 bool 类型之外的任何类型。 编辑 为什么? 以下
我正在尝试在单个查询中实现内部和外部联接,我不确定我的做法是正确还是错误,因为我不太擅长查询。 就这样吧。 我有以下表格。 hrs_residentials hrs_residential_utili
关于 my website ,有一段代码可以向页面添加几个元素。这段代码不是我可以编辑的东西,而且我对它放置这些元素的位置不满意,因为它弄乱了我的一些布局。所以我想出了一个小的 jQuery 来将它们
一位客户希望我创建一个数据集,如下所示。我不知道这是否可能或合乎逻辑。 我有表parent: id name ------- ------- 1 parent1 2
这可能吗?google 好像没有这方面的资料.. 这样,如果用户在另一个网站上播放视频或歌曲,我的音量就会自动减小 最佳答案 不,这是不可能的。 如果可能的话,它必须是特定于浏览器的,但我不认为这种情
所以我正在尝试制作响应式页面。问题是为什么它归结为移动数据需要位于列表中。 我会用一些示例代码来解释 所以这可能是桌面上的输出 option1
当您将鼠标悬停在a 元素 上时,是否可以删除url? 这就是我的意思: 最佳答案 一种选择是使用一些 JavaScript。 删除 href=来自 的属性标签,取而代之的是 onclick=...
我已经考虑了几个小时,但我无法取得太大进展。它是这样的: You have an array of size n and q queries. Each query is of the form (l
我一直在尝试编写一个脚本来强化 android。我没有成功! 我正在通过模拟器运行一个 AVD,并且已经用我加载的 android shell 和 bash shell 试过了。正如您将在下面看到的那
Private Sub Workbook_Open() Dim WBname As String WBname = ThisWorkbook.name If Not InStr(WBname, "te
Spark 2.0.0-预览版 我们有一个应用程序使用了相当大的广播变量。我们在大型 EC2 实例上运行它,因此部署处于客户端模式。广播变量是一个巨大的 Map[String, Array[Strin
我正在尝试从此link中提取摘要。但是,我无法仅提取摘要的内容。到目前为止,这是我完成的工作: url <- "http://www.scielo.br/scielo.php?script=sci_a
我的主页中有一个iframe。 iframe页面中有一个modalpopup。因此,当显示modalpopup时,modalpopup的父级是iframe主体和主页父级主体。因此,覆盖层仅覆盖ifra
我是一名优秀的程序员,十分优秀!