pyblosxom 1.5.3

什么是Pyblosxom

Pyblosxom是一个轻量级的博客系统。它最初是Blosxom的Python克隆，但后来发展成为一个具有Blosxom风格的独立博客系统。

Pyblosxom关注三个方面

简单性

Pyblosxom 将所有数据存储在文件系统中，以纯文本文件形式存在。这使得您可以使用任何文本编辑器来创建、更新和操作条目。您还可以使用现有的文本操作工具、版本控制、脚本、grep 等来管理您的博客。

Pyblosxom 可以作为 CGI 脚本、WSGI 组件运行，或者您可以使用它将您的网站静态编译成 HTML/XML 文件。

您的流程就是您的流程。

可扩展性

Pyblosxom 具有插件框架，使您能够扩展和增强 Pyblosxom 的默认行为。插件是用 Python 编写的。我们在网站上的插件注册表中维护了一个插件列表。

编写插件并不困难。我们很乐意帮助您编写插件。

社区

目前有数百名 Pyblosxom 用户，他们的需求各不相同。Pyblosxom 在各种操作系统和各种环境中使用。我们拥有标准的开源项目设施：邮件列表、IRC 频道、wiki 等。

Pyblosxom 是为了让您可以使用现有的文本操作工具而构建的，无需从头开始构建整个生态。

Pyblosxom 可以作为

• 一个“静态渲染器”来编译您的博客

• 一个 CGI 脚本

• 一个 WSGI 应用程序

您可以在网站上了解更多关于 Pyblosxom 的信息。

您可能不想使用 Pyblosxom 的原因

Pyblosxom 是一个小型的开源项目，虽然有一个社区，但相对较小。Pyblosxom 的功能很强大，但它是一个利基博客系统。

Pyblosxom 是一个 基于文件 的博客系统。每个博客条目都是一个单独的文件，存储在您的文件系统上的目录层次结构中。默认情况下，层次结构是一个分类树，这意味着每个博客条目都属于一个单一的分类。默认情况下，使用 mtimes 作为博客条目的时间戳。有一些插件可以改变这种行为，但需要额外的配置才能使用。

有许多其他的博客系统。如果很明显 Pyblosxom 不适合您，不要强迫使用它——使用其他东西。

Pyblosxom 概述

条目、分类、存储

• Pyblosxom 将所有内容都存储在文件系统上的文件中——没有数据库。

• 每个博客条目都是一个文件。

• 博客条目文件存储在您的 datadir 中的目录层次结构中。

• 您的 datadir 中的每个子目录都对应于您的博客的一个分类。

主题

• Pyblosxom 中的主题称为 flavours。

• flavour 是一组 模板。

• flavours 存储在一个名为 flavourdir 的目录中。

• Pyblosxom 随附了几个 flavours：html、rss20 和 atom。

• 网站维护了一个由像您这样的人贡献的 flavours 的 flavour registry。

• 有关风味和模板的更多信息，请参阅手册中的“风味和模板”章节（如果查看源代码，则为 docs/flavours_and_templates.rst）。

插件

• Pyblosxom 具有插件系统。

• 插件是用 Python 编写的。

• 插件使用 plugin_dirs 和 load_plugins 配置变量加载。

• 网站维护了一个由像您这样的人提交的插件的插件注册表。

• 有关使用插件的更多信息，请参阅手册中的“插件”（如果查看源代码，则为 docs/plugins.rst）。

• 有关编写插件的更多信息，请参阅“编写插件”（如果查看源代码，则为 docs/dev_writing_plugins.rst）。

项目详情、联系方式以及获取帮助的地方

有关邮件列表、IRC、源代码、问题跟踪器以及其他所有信息的详细信息，请参阅网站。

要求

• Python 2.5 或更高版本——不支持 Python 3 或更高版本

• (可选) 用于构建文档的 Sphinx

• (可选) 根据您安装的插件，还有其他一些东西

如何安装 Pyblosxom

如果您是第一次安装，请务必阅读手册中的《安装 Pyblosxom》部分（查看源码时请参考 INSTALL）。

如果您是从旧版本升级 Pyblosxom，请阅读手册中的《升级 Pyblosxom》部分（查看源码时请参考 UPGRADE），以及《新版本更新》部分（查看源码时请参考 WHATSNEW），其中包含了本版本的新功能和您需要更改博客的地方。

如何查找全面文档

源代码压缩包中包含一个 docs/ 目录，其中包含该版本 Pyblosxom 的手册。

最最新版本和过往版本的 Pyblosom 手册可以在网站上找到。

如何加入社区

Pyblosxom 是由像您这样的人编写的。如果您在使用 Pyblosxom，请为社区做出贡献，无论是报告一个错误、修复某个问题、添加一个新的功能、撰写关于 Pyblosxom 的博客、告诉您的朋友、编写一个插件，还是在 IRC 上与我们交流。

关于我们在哪里交流等详细信息可以在网站上找到。

如何报告错误、提交补丁、解决问题

如果您在使用 Pyblosxom 时遇到问题，请报告它！

报告错误有几种不同的方式，但所有错误最终都应该进入我们的问题跟踪系统。

1. 在 irc.freenode.net 上的 #pyblosxom 频道上告知某人。

2. 向 pyblosxom-users 或 pyblosxom-devel 邮件列表发送邮件。详细信息请参阅网站。

3. 在问题跟踪系统中撰写错误报告。详细信息请参阅网站。

如果您能够修复错误，那将非常有帮助！请在错误报告中附加一个补丁文件，或者将其作为附件发送到 pyblosxom-devel 邮件列表。

在发送补丁时，了解错误的详细情况以及您是如何修复它的，以及是否还有悬而未决的问题，将非常有帮助。

如何运行单元测试

测试是用 Python 的 unittest 模块编写的，不需要任何额外的测试框架。

要运行测试，请执行以下操作：

python setup.py test

这将构建 Pyblosxom，然后运行测试。

如果您想将测试添加到测试套件中，请这样做，并给我们发送补丁！