境界之轮回第三季24:TWiki主要是干嘛的

0 前言:关于TWiki

--------------------------------------------------------------------------------
关于Wiki，大家肯定听说了不少，TWiki只是Wiki的一种实现形式。不过在众多的wiki版本中，TWiki声名远扬，按照twiki.org的解释是，一个灵活、强大、简单的企业级共同协作平台。目前著名的网络公司Yahoo内部的平台就是使用的TWiki, 另外Motorola 和SAP 等国际大公司都在使用TWiki，这也是我为什么选择TWiki的原因。
TWiki的文档很多，也很细致，不过刚开始看还有些不习惯，文档中所以的WikiName都加上了链接，有时候经常点来点去就不知道自己点到哪里去了。目前关于TWiki的中文文档是少之又少，关于TWiki安装文档，更是凤毛麟角。当然安装TWiki并不是什么难事，不过，许多事情都是说起来容易，做起来难......

1 安装流程

--------------------------------------------------------------------------------

下载TWiki . TWiki的官方网站是twiki.org，其下载页面是:Download the Package,目前的版本是2004年9月分release的。下载其安装包：TWiki20040902.tar.gz
配置setlib.cfg . 解开压缩包后，在twiki/bin目录下，你会发现setlib.cfg文件，里面唯一需要修改的是:$twikiLibPath ，把他改成twiki/lib的绝对路径。如:$twikiLibPath=/home/winter/twiki/lib 。
配置TWiki.cfg .这是最重要的配置，主要包括：
$defaultUrlHost. 缺省的主机url路径。用url的形式赋值，如：$scriptUrlPath="http://www.stlchina.org";
$scriptUrlPath . 脚本所在的url路径。相对于$defaultUrlHost的，因此只要写后一部分就行了。如$scriptUrlPath = "/twiki/bin";
$dispScriptUrlPath . 脚本的实际显示路径。默认都会是: $dispScriptUrlPath = $scriptUrlPath;
$dispViewPath . 用于显示网页脚本的url路径，相对于$dispScriptUrlPath, 缺省是$dispViewPath = "/view" 不用修改。
$pubUrlPath . 用来保存附件的url路径。默认是$pubUrlPath = "/twiki/pub";
$pubDir 用来保存附件的绝对路径。 注意，这个路径需要是twiki/pub所在本机的绝对路径。如$pubDir = "/home/winter/twiki/pub" .如果使用的是虚拟主机，这个路径就很麻烦了。参看关于虚拟主机
$templateDir 用来保存模板的绝对路径。同上，需要本机的绝对路径。如：$templateDir ="/home/winter/twiki/templates";
$dataDir .保存数据的目录。需要绝对路径。如：$dataDir = "/home/wende/twiki/data";
选择你的存储模式 . TWiki使用的是文本数据库，TWiki会保存所有的变化。了解unix和linux的朋友都知道diff命令，还有类似的ci co rcs等命令。TWiki就是使用这些命令来实现其不同的版本管理。如果你能控制你的网站服务器，例如，你有root权限。你可以设置$ storeTopicImpl = "RcsWrap"; 但是，如果你是虚拟主机用户，你还是选择$storeTopicImpl = "RcsLite";后者会100%使用perl来完成所有的文档存储和版本管理功能。如果你选择后者，你最好把所有在twiki/bin目录下的文件增加一个后缀名，然后在你的TWiki.cfg文件中设置：$scriptSuffix = ".pl";
测试你的配置 . 使用bin目录下的testenv脚本来测试你的环境。如果你发现有红色的warning，那就是还有一些问题。不过不要紧，一切都可以解决。如果是路径问题，你可以查查实际的路径是否确实存在。如果你是使用虚拟主机用户，那么只要你选择了RcsLite方式，这些路径问题的warning，你基本可以忽略。

2 设置用户访问权限.

--------------------------------------------------------------------------------
Wiki本来是讲究自由、协作和信任。因此在安装后，任何人都有权限访问、修改所有的文章。但是在网络上，为了安全起见，还是希望有用户认证。可以按照以下步骤实施:

把twiki/bin目录下的.htaccess.txt改名为.htaccess .了解apache配置的人肯定知道这是干什么:)
设置
AuthUserFile /home/winter/twiki/data/.htpasswd
AuthName 'twiki'
AuthType Basic

其中AuthUserFile 是twiki/data/.htpasswd的绝对路径。
出错页面设置:
ErrorDocument 401 http://www.stlchina.org/twiki/bin/oops.pl/TWiki/TWikiRegistration?template=oopsauth

这时需要把注册页面换成带输入密码的注册页面: 在twiki/data/TWiki/下有TWikiRegistration.txt和TWikiRegistrationPub.txt, 用后者把前者覆盖(cp TWikiRegistrationPub.txt TWikiRegistration.txt)
你现在测试每个页面的'Edit'，你会发现需要输入用户名和密码。如果你按照这个方式改了，发现还不行的话，那就是服务器的设置有一些问题。我在安装的时候就遇到了这样的问题(51.net的G型服务，开始少装了几个安全认证的包)

3 TWiki中文显示设置

--------------------------------------------------------------------------------
Wiki默认是不支持中文的，其编码为:en_US.ISO-8858-1 ,如果你用Edit编辑了某个页面，在其中输入了中文，然后提交，显示一切正常。但是你再次点'Edit'的时候，你会发现中文部分变成了乱码 #98A3 #E2F3 等。要让TWiki显示中文，操作如下：
TWiki.cfg 文件中，设置： $useLocale =1 (默认是 0)
$siteLocale = "cn_CN.GB2312"; 这样Twiki就会支持GB2312。
重新打开一个页面，看看页面源码，应该在meta里面有：content="text/html; charset=gb2312"
4 在虚拟主机(Web hosting)上安装TWiki的注意事项

--------------------------------------------------------------------------------
对于虚拟主机用户来说，安装TWiki确实是很麻烦的事情。一般只有ftp权限，所有的操作都需要本地修改，然后上传，经过测试，再修改，再上传。对于ftp链接，本来就不是很稳定，使其操作就更加麻烦。
对于虚拟主机用户来说，需要解决以下问题：

得到public所在主机的绝对路径。我是用的是虎翼网的G 型服务，按照他们网站和业务员的解释说，我的ftp的public目录就是在机器的/home/username/public目录。经过我测试，并非如此，而是这样:/home/user/ap1/username/public_html .当然不同的用户路径模式有可能不一样。但是如果你是使用的虚拟主机，你需要得到绝对路径。我当时是使用PHP测试得到的。
选择$storeTopicImpl = "RcsLite"来存储文章和进行版本管理。因为虚拟主机用户一般都很难知道ci co diff等命令的实际路径，如果选择RcsWrap方式，可能会在网页存储的时候遇到到一个明显的错误:
During save of file TestTopic1? an error was found by the version control system.
Please notify your TWiki administrator. /usr/bin/ci -q -l -m'none' -t-none -w'guest'
/home/n/a/naturemagic/public_html/data/Test/TestTopic1.txt 2>&1 1>/dev/null /usr/bin/ci:
permission denied

Go back in your browser and save your changes locally.

选择$scriptSuffix = ".pl";默认是$scriptSuffix = ""; 这样可以避免一些在目录设置上的问题，所有都依赖于perl。另外需要把twiki/bin目录下所有的脚本文件都改名成.pl的后缀。如testenv 改为testenv.pl
在twiki/bin目录下的.htaccess文件中，也需要把相应的改成pl后缀.如：
<Files "viewauth">
require valid-user
</Files>
改成:
<Files "viewauth.pl">
require valid-user
</Files>

5 其他参考
顺利的安装会有同样的顺利，而失败的安装却各有各的原因。如果你仍然有问题，选择下列途径：
首先选择参考TWiki安装向导，
对于中文TWiki的安装,当然要参考如何安装TWiki(中文TWiki的安装).
对于英文比较好的朋友，可以直接到TWiki.org官方网站上去。
还有CheDong的TWiki的安装备忘, 竹笋炒肉的TWIKI手记

--------------------------------------------------------------------------------