Hatta Wiki试用

五点半 — Fri, 20 Mar 2009 08:55:00 GMT

大辉推荐了一个网站www.wikimatrix.org。去看了看虽然一直用Wiki进行一些文档的协作，但那么多Wiki还是第一次哈。于是想找一个用Python开发的wiki(wikimatrix上面有一个Wizard可以帮助您找到想要的)。除了老牌的plone,著名的MoinMoin,还发现了一个叫hatta 的。安装了一下，真还不错。
hatta的实现就一个python文件，功能简单，没有权限管理，没有用户管理，作者认为Wiki就是要欢迎天南地北的兄弟都可以修改。hatta的使用简单，按照语法编辑，然后提交了事。中文化也非常简单，Wiki内容本身就可以输入中文，如果觉得页面也应该是中文的也很简单，改改po文件即可。我觉得如果您对Wiki的需求如下就可以考虑使用：

内部使用。如果部署在外网，好事者乱改一气还是比较麻烦的，特别是放一些不该放的。
需要版本控制的文档协作
要在文档中嵌入程序代码，代码需要高亮
需要在文档中嵌入数学公式。hatta使用latex语法输入公式，生成的公式非常漂亮

五点半 2009-03-20 16:55 发表评论

Quixote笔记

五点半 — Sat, 19 Apr 2008 07:11:00 GMT

又是Python。呵呵。谁叫人家帅呢

Quixote的部署

在Quixote官方白皮书中已经详细描述了Quixote的工作模式。Quixote可以使用Python自代的http_server(主要用于开发调试)和与Apache(或lighttpd)配合使用。
Quixote与Apache配合使用方式如下：

使用CGI，文档中称为egular CGI。被认为效率最低的一种方式，因为每一个请求都会创建一个新的进程。
使用fastCGI，CGI可以运行fastCGI一定是可以应用的。这也是豆瓣采用的方式。在Quixote作者的一个PPT中，他认为fastCGI是buggy的。哦:(也不至于啊。我们正在寻找使用fastCGI的部署经验。
使用mod_python，将python代码嵌入到Apache中。
使用SCGI，这是作者推荐的。使用Apache SCGI module scgi_mod将遵循SCGI协议Apache将请求发送到相应的Socket如localhost:3001。而这个Socket由本地运行的一个 Python程序打开。这个Python程序将处理请求，并返回结果。

SCGI的配置

Quixote的网站上对SCGI的描述：SCGI协议是CGI协议的替代。它是一种应用程序与HTTP服务接口标准。它有些像FastCGI但他的设计更容易实现。

配置SCGI过程如下：

安装各个模块不在话下，debian让程序员有了懒惰的美德：

#aptitude install libapache2-mod-scgi python-scgi python-quixote

Apache的配置，添加配置到apache.conf。（有些教程中加入了SetHandler scgi-handler ，但这个加上就很本不会和3000通信。可能是版本的问题。最好不用。）

      <Location "/qx">
       SCGIServer localost:3000
         SCGIHandler On
      Location>

重启Apache

配置完成。SCGI的好处在于，修改了Python程序，不用重启Apache，只要重启SCGI就可以了。

第一个Quixote程序

一切就绪，我们来一次Quixote的完整之旅。

scgi程序要求有一个服务打开3000端口。启动scgi的程序如下:

1
2 #!/usr/bin/python
3 # -*- coding: utf-8 -*-
4
5 from scgi.quixote_handler import QuixoteHandler, main
6 from quixote import enable_ptl
7 from quixote.publish import Publisher
8 enable_ptl() #启动PTL
9
10 def create_publisher():
11     from ourroot import RootDirectory
12     return Publisher(RootDirectory(), display_exceptions='plain')
13
14 if __name__ == '__main__':
15     from quixote.server import scgi_server
16     scgi_server.run(create_publisher, port=3000, script_name="/qx")
17

程序结构是比较简单的，使用的是scgi_server的run方法。要注意的是run方法中的script_name和前面apache 的配置Location是一样的。程序的关键是导入了ourroot这样一个ptl 。下面是我们的第一个ptl程序。

1
2 # -*- coding: utf-8 -*-
3 """这个是我们第一个例子的根目录
4 """
5 from quixote.directory import Directory
6
7 class RootDirectory(Directory):
8     _q_exports = [""]
9     def _q_index [html] (self):
10         print "debug message from the index page"
11         """
12
13
14

15         第一个例子
16
17
18

第一个例子有中文!

19
20
21         """
22

现在在浏览器中输入http://localhost/qx就可以看到结果了。
除了运行上面的python脚本，也可以采用这样的方式运行scgi:

python /var/lib/python-support/python2.5/quixote/server/scgi_server.py \
--factory=FirstApp.create_publisher \
--script-name=/qx --port=3000

Quixote 中文化的要点

Quixote的中文设置好像很麻烦。其实随着python、Quixote版本的推进，现在这个问题已经很简单了。字符集使用的是utf-8。使用gb2312可能也是可以的。

所有源代码使用utf-8在程序的开始加上# -*- coding: utf-8 -*-
ptl的html模板加上content="text/html charset=UTF-8"
关键:在quixote的安装路径下有__init__.py，将其中的DEFAULT_CHARSET = 'iso-8859-1'改成 'utf-8'
也可以不修改__init__.py，使用Publisher的时候把Publisher扩展一下：

1 class UTF8Publisher(Publisher):
2 quixote.DEFAULT_CHARSET = "utf-8"

五点半 2008-04-19 15:11 发表评论