-- hd [DateTime(2004-08-05T22:38:15Z)] TableOfContents

PyBlosxom

一直在考虑使用一个Blog系统加强woodpecker的社区，最终选定了pyblosxom。pyblosxom到现在还没有加入到FreeBSD的ports中来，我将它的安装记录下来，希望对将来使用它的人有一个参考。

这里我们讲述的安装模式为多人使用的模式，因为我们需要为woodpecker社区中的参与者们每一个人开放一个空间。对于一个用户的安装方法会更简单，请参考pyblosxom的INSTALL。

本文所说明的为pyblosxom 1.0版本的安装信息，其它版本主参考相应版本的INSTALL文件。

使用需求

• 一个Web服务器（可以使用FreeBSD支持的非常好的Apache）
• python 2.1以上的版本
• 一个文本编译器（pyblosxom现在还需要使用一个文本编辑器来加入文章）

系统安装

1. 解开pyblosxom的压缩包到一个临时目录
2. 将用户su为root
3. 在临目录中运行“python setup.py install”以安装pyblosxom代码库到python中。
4. 将config.py和pyblosxom.cgi文件复制到cgi-bin目录下
5. 修改config.py中相关的设置

# 你的blog的名字
py['blog_title'] = "Woodpacker Blog"
# 你的blog在RSS中的说明
py['blog_description'] = "Woodpacker Blog"
# 作者的名字和邮件地址
py['blog_author'] = "HD hdcola at gmail.com"
# blog的默认语言
py['blog_language'] = "zh"
# blog的字符编码
py['blog_encoding'] = "utf-8"
# blog存储数据的目录
py['datadir'] = "/data1/www/blog.woodpecker/blog"
# blog系统存储日志的目录
py['logdir'] = "/data1/www/blog.woodpecker/log"

1. 运行一下pyblosxom.cgi，看一下输出，是否有错误
2. 在操作系统下使用文字编辑器建立一个文本文件到py['datadir']指向的目录下。我建立的文件名叫hello.txt内容为：

%<-------------------------------------------
First Post 
<p> 
   This is the first post in my blog. 
</p> 
%<-------------------------------------------

这用使用浏览器访问cgi-bin/pyblosxom.cgi试试。就可以看到你有一个blog在系统中出现了。

安装插件

Comments

1. 复制contrib/plugins/comments/plugins/comments.py到你的plugins目录下。在config.py文件中的load_plugins属性中加入comments。

2. 如果你需要安装trackbacks（可选），将contrib/plugins/comments/plugins/trackback.py}}复制到你的plugins目录下。在{{{config.py文件中的load_plugins属性中加入trackbacks。

3. 如果你需要安装pingbacks（可选），复制contrib/plugins/comments/plugins/xmlrpc_pingback.py到你的plugins目录下。你一定要确认你已经定义了py["base_url"]属性。xmlrpc_pingback.py需要使用到Mark Pilgrin的rssfinder（http://diveintomark.org/projects/feed_finder/feedfinder.py）和rssparser（freebsd ports里在textproc/py-feedparser中）模块（它们都可以在http://diveintomark.org/projects/找到源头）。不要忘记在}文件中的load_plugins属性中加入xmlrpc_pingback。注：这步行不通，代码还有问题。

4. 如果需要支持CommentAPI时，复制contrib/plugins/comments/plugins/commentAPI.py到你的plugins目录下。