TWiki安装和使用心得

 

 

TWiki是一个开源（GPL）的wiki程序。软件定位为“灵活、强大、易于使用的企业协作平台”，运行于Perl环境。拥有编程技能的人可以使用变量创建动态页面，譬如内容表格，或者嵌入式搜索结果的页面。默认内置所见即所得编辑器，完善的用户权限系统，不需要任何数据库，完全基于文件目录的格式化引擎。

TWiki部署起来稍微有点复杂，下面是我在Ubuntu上部署TWiki的一些心得。

1. 环境准备

$ sudo apt-get install apache2 perl cron grep rcs patch php5
$ sudo apt-get install libapache2-mod-php5 libcgi-session-perl libdigest-sha1-perl libhtml-parser-perl

 

2. 下载

$ wget http://downloads.sourceforge.net/project/twiki/TWiki%20for%20all%20Platforms/TWiki-5.0.1/TWiki-5.0.1.tgz?r=&ts=1293085896&use_mirror=nchc
$ sudo tar -xvzf TWiki-5.0.1.tgz
$ sudo cp -a twiki /var/www/
$ sudo chown -R www-data:www-data /var/www/twiki

 

3. 配置

$ sudo cp /var/www/twiki/bin/LocalLib.cfg.txt /var/www/twiki/bin/LocalLib.cfg

 

修改LocalLib.cfg中的$twikiLibPath为：

$twikiLibPath = “/var/www/twiki/lib”

 

生成twiki.conf文件：http://twiki.org/cgi-bin/view/TWiki/ApacheConfigGenerator，并复制到/var/www/twiki/twiki.conf
修改/etc/apache2/httpd.conf，加入一行：

include "/var/www/twiki/twiki.conf"

(或者复制一份/var/www/twiki/twiki_httpd_conf.txt为twiki.conf，然后修改里面的路径相关的设置)

修改twiki.conf文件中的

<FilesMatch "^(configure)$"> 节点，设置允许访问configure页面的来路IP或者用户名。

Allow from 127.0.0.1 192.168.1.100
Require user CoderZh

 

重启apache2

$ sudo /etc/init.d/apache2 restart

 

访问：http://<ipaddress>/twiki/bin/configure 可进入配置页面，配置完成后进入主页。

 

使用技巧

1. 中文支持

TWiki默认是iso8859-1编码，不支持中文编辑， 界面也是全英文。让TWiki支持中文，首先，确保服务器的locale安装有zh_CN.UTF-8。

$ sudo locale-gen zh_CN
$ sudo locale-gen zh_CN.UTF-8
$ sudo dpkg-reconfigure locales

 

然后在configure里配置如下：

{UserInterfaceInternationalisation} √
{Languages}{'zh-cn'}{Enabled} √
{DisplayTimeValues} servertime
{UseLocale} √
{Site}{Locale} zh_CN.UTF-8
{Site}{LocaleRegexes} √
{Site}{CharSet} UTF-8
{Site}{Lang} zh
{Site}{FullLang} zh-cn
{PluralToSingular} √

2. 发邮件

TWiki支持自动发送验证邮件，用于用户注册和找回密码。要支持发邮件，首先在服务器上安装sendmail：

$ sudo apt-get install sendmail

 

然后，在configure页面设置邮件相关项目，以下两项留空。

 

{SMTP}{MAILHOST} 留空
{SMTP}{SENDERHOST} 留空

 

3. 批量添加用户

进入页面：http://<ipaddress>/twiki/bin/view/TWiki/BulkRegistration ，里面有详细说明。

 

4. 页面设置

WebPreferences和TopicPreferences页面，可对Web或Topic进行设置，比如权限等等。详细的有哪些设置项，可参考：

http://<ipaddress>/twiki/bin/view/TWiki/TWikiPreferences

比如，要设置管理员才能修改的权限，之需要在Wiki内容或者当前Topic的设置页面，添加如下语句：

   Set ALLOWTOPICCHANGE = TWikiAdminGroup

注意格式为：[3个空格]Set[空格]xxx[空格]=[空格]xxx

 

更多其他的内容，就靠自己去发现和总结了。 有任何问题，也欢迎和我交流。