python-sphinx - 在无服务器模型中使用 sphinx

Question

我目前正在使用 sphinx 从 bitbucket 存储库中的 ReStructuredText 文件自动生成我的文档站点。

这当然都是内部托管/托管的，但我一直在考虑是否可以将其切换为更无服务器的模型，使用 FaaS 生成站点，然后使用基于云的站点托管来进行实际托管（例如 S3静态网站托管）。

我想知道是否可以以编程方式使用 sphinx（例如在 AWS Lambda 或 Azure 函数中）？

谢谢，约翰

Answer 1

您可以直接使用对象sphinx-build生成输出，而不是从命令行执行。sphinx.application.Sphinx

一个基本的例子：

import os
from sphinx.application import Sphinx

# Main arguments 
srcdir = "/path/to/source"
confdir = srcdir
builddir = os.path.join(srcdir, "_build")
doctreedir = os.path.join(builddir, "doctrees")
builder = "html"

# Create the Sphinx application object
app = Sphinx(srcdir, confdir, builddir, doctreedir, builder)

# Run the build
app.build()