使用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.txtSphinx再次正常呈现的文件.

预处理器还weblog/index.txt使用最新的10个条目创建根.和weblog/atom.xml(硬编码)rss feed的输出目录.

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

Answer 2

截至目前(2012年2月),有不同的资源可以做你想要的:

基于sphinx的博客引擎:http://tinkerer.me/

Reinout Van Rees的博客:https://github.com/reinout/reinout.vanrees.org

feed contrib扩展:https://bitbucket.org/birkenfeld/sphinx-contrib/src/tip/feed/README

Answer 3

本周"Python模块"的作者Doug hellmann使用Sphinx完成了他的网站.

http://www.doughellmann.com/PyMOTW/

他有几个帖子涵盖了狮身人面像主题,可能会帮助你:

http://blog.doughellmann.com

Answer 4

如果你需要在reStructuredText中写,你应该尝试Pelican.

Pelican是一个静态站点生成器,用Python编写.您将能够直接在reStructuredText或Markdown中编写博客条目.

Answer 5

值得一提的是,在sphinx-contrib扩展中有一个sphinx的RSS扩展,称为sphinxcontrib.feed 它以及许多其他有趣的Sphinx事件http://bitbucket.org/birkenfeld/sphinx-contrib/

(免责声明:我写了Feed扩展.)

Answer 6

查看Sphinx的ABlog

我正在使用它自己创建一个博客.

当我在饲料中喂食时,我偶然发现了它.我搜索了一下,发现它很有趣.它还有Disqus集成,可以生成Atom提要(不太确定目前是什么,我是网络新手)

我还没有弄清楚如何部署我的测试博客,当我发现一些东西时会更新.