python - 使用 Sphinx 编写个人网站和博客

Question

Sphinx是一个 Python 库，可以从一组 ReST 中生成漂亮的文档。格式化的文本文件。

我想知道是否有人编写了 Sphinx 插件来使其生成个人网站和博客。

特别是对于博客，需要一种方法来自动按时间顺序列出帖子并生成 RSS 提要。需要编写一个 Sphinx 插件来生成这种特殊的页面/xml。

以前有人试过吗？

Answer 1

我已经在 http://reinout.vanrees.org/weblog 完成了.关键技巧是添加预处理器步骤。我的博客条目位于 weblog/yyyy/mm/dd/ 文件夹结构中。

脚本遍历该文件夹结构，在每个目录中创建 index.txt 文件，列出子项。然后，正常的 Sphinx 进程会渲染那些 index.txt 文件。

我为标签添加了一个自定义的 Sphinx 处理器。因此，在我的博客条目顶部某处的“.. tags::python, buildout”会生成标签。预处理器再次收集这些条目并写出一个 weblog/tags/TAGNAME.txt 文件，Sphinx 再次正常呈现该文件。

预处理器还使用最新的 10 个条目创建根 weblog/index.txt。还有一个 weblog/atom.xml 在(硬编码)RSS 提要的输出目录中。

所以:你需要一些自定义的东西，但它几乎是纯文本，所以对我来说这是一个很好的练习。您还可以编写一些帮助脚本来简化生活，例如将文本文件从某处复制到今天的博客目录(包括创建丢失的目录和“svn add”)。