添加comments插件

-- limodou [2004-09-03 19:51:01]

1. 添加comments插件

comments包含一系列的插件,有:comments, traceback, xmlrpc_pingback, commentAPI等插件,这要主里讲述了comments, traceback, xmlrpc_pingback的安装

1.1. 说明

这里所有的目录都是按我写的pyBlosxom的安装及配置一文而来:

  • blog起始目录: /var/www/html/limodou
  • blog记录存放目录: py['datadir']='/var/www/html/limodou'
  • plugins存放目录:py['plugin_dirs']=['/var/www/html/limodou/plugins']
    • 请注意在config.py中检查这个变量是否设置正确
  • comments/traceback/xmlrpc_pingback都要用到PyXML模板,因此需要下载并安装PyXML

1.2. 安装

参考文档见:安装Comments

  • 安装PyXML请看它的README说明。简单地说要执行两步:
    • python setup.py build
    • python setup.py install
  • 准备,所有要用的东西已经在PyBlosxom的共享目录下的(我的是/usr/local/share/pyblosxom-1.0.0/contrib/)的plugins/comments/目录下了。它有两个目录,一个是plugins,存放有:comments, traceback,, xmlrpc_pingback, commentAPI这四个插件。另一个是flavour,存放comments的模板样式。

  • 拷贝plugins目录下的所有东西到你的blog目录下的plugins目录中(我的是/var/www/html/limodou/plugins)
  • 将flavour目录下的所有东西拷贝到你的blog记录存放目录(我的是/var/www/html/limodou/entries)

1.3. 配置config.py

进入你的blog目录 (/var/www/html/limodou),编辑 config.py

  • 正确配置py['plugin_dirs'] (我的是/var/www/html/limodou/plugins)
  • 对于comments的配置,需要增加:
    • py['comment_dir']变量 (我的是/var/www/html/limodou/comments)请注意一定要给它足够的权限,我反正是给了个777 py[['comment_ext']用于设置注释文件的后缀 (我设为cmt)

py['comment_dir']='/var/www/html/limodou/comments'
py['comment_ext']='cmt'

  • 生成注释时会在comment_dir目录下生成与catelog一样的目录。如entries目录下有一个python的分类,则对python下的文档进行注释时,会在comments目录下生成一个python目录,然后将信息存放其中。 在py['load_plugins']中增加'comments' 同时还有三个变量是用于当别人写了评论时,自动发信的,因为我机器上没有smtp,因此没有配。举例为:

py['comment_smtp_server'] = "localhost"
py['comment_smtp_from']   = "[email protected]"
py['comment_smtp_to']     = "[email protected]"
  • 对于traceback的配置就是在py['load_plugins']中增加'traceback'就可以了
  • 对于xmlrpc_pingback说是要还要安装RSS Feed的处理,不过我没试了。不过在安装时这个程序报错了,需要修改:

4   from Pyblosxom.Request import Request
  • 改为

4   from Pyblosxom.pyblosxom import Request
  • 就可以了。

1.4. 测试plugin

每个plugin都可以进行自测。只要运行你的blog目录下的pyblosxom.cgi程序就行了。看看有没有报错。

1.5. 定制Flavour

你可以修改与comment相关的样式(Flavour),都是以comment开头的,使它们满足你的要求。(我没有改:)

1.6. 注意

在config.py文件中的py['base_url']一定要正确(如果你去掉了本行前面的注释的话)。我刚开始这项不对,就报找不到文件,后来干脆去掉,就正常了。

2. 讨论