如何安装TWiki(最新版本中文TWiki 4.0安装)
作者:Winter
1 前言:关于TWiki
关于Wiki，大家肯定听说了不少，TWiki只是Wiki的一种实现形式。不过在众多的wiki版本中，
TWiki声名远扬，按照twiki.org的解释是，一个灵活、强大、简单的企业级共同协作平台。目前著名的网络公司
Yahoo内部的平台就是使用的TWiki, 另外Motorola 和SAP 等国际大公司都在使用TWiki，这也是我为什么选择TWiki的原因。
TWiki的文档很多，也很细致，不过刚开始看还有些不习惯，文档中所以的WikiName都加上了链接，有时候经常点来点去就不知道自己点到哪里去了。目前关于TWiki的中文文档是少之又少，关于TWiki安装文档，更是凤毛麟角。当然安装TWiki并不是什么难事，不过，许多事情都是说起来容易，做起来难......
也许是因为Twiki自己是一个新生产品，因此也有一些不完善的地方，特别是版本升级的时候会有一些不兼容的地方。本文的第一版是在2005年年中写的，一年之后，twiki升级到4了。安装也变得有些不同，在我升级过程中，记录了一些注意事项，供大家参考。不过还是建议大家查看TWiki网站上的文档，那是相当的丰富。如果是安装旧的版本，查看这儿的链接http://www.stlchina.org/twiki/bin/view.pl/Main/InstallWiki?rev=7
2 安装流程
- 下载TWiki . TWiki的官方网站是twiki.org，其下载页面是:twiki download,目前的版本是Twiki4.04。下载其安装包：TWiki-4.0.4.tgz, 或者TWiki-4.0.4.zip。解开压缩包以后，你会发现在目录中有一个文件INSTALL.html文件，其中详细告诉你如何操作。
- 配置LocalSite.cfg . 在twiki/bin目录下，你会发现LocalSite.cfg.txt文件，里面唯一需要修改的是:$twikiLibPath ，把他改成twiki/lib的绝对路径。如:$twikiLibPath=/home/winter/twiki/lib 。
- 配置config twiki4比以前的配置简单多了，以前你会发现有很多变量需要你去定义，而且需要你修改后上传。现在你可以通过web页面进行配置。那个文件在你的twiki/bin/configure. 在你开始安装，或者以后进行插件(plugin)的管理，都会是通过这个页面进行。第一次安装，你只需要设置:"General path settings"部分。看看我的配置:http://www.stlchina.org/twiki/bin/configure.pl。里面的配置很简单，因此，不用多讲......
3 设置用户访问权限.
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型服务，开始少装了几个安全认证的包)
不过我在升级的时候遇到一个问题，以前的用户名和密码通过弹出式对话框，总是告诉我密码无效。后来我发现twiki4提供了一个用户登陆页面：http://www.stlchina.org/twiki/bin/login.pl. 这样也可以实现类似如BBS的用户登陆。在STL中文站上面就提供这样的链接, 看看左侧。
如果还是遇到无法编辑的页面，你可以看看 TWikiAccessControl , 里面列出了所有的twiki权限，管理员可以自己设置。真正的设置页面在这里：http://www.stlchina.org/twiki/bin/view.pl/TWiki/SitePermissions
4 TWiki的有用的技巧设置
- 用户登陆 。前面已经说了，可以通过两种方式。
- 个性化 . 全网站的一些链接、图标等个性化设置都在: TWikiPreferences 。 你可以设置你的网页背景颜色、个性图标、网站logo等。
- 插件管理 你可以在twiki的官方网站上找到一些有用的插件，这里是twiki4中测试用过的插件列表。下载以后，按照使用步骤安装到你的twiki目录，然后通过 twiki/bin/configure 进行配置。
- robots.txt 对于twiki来说，每个网页是动态生成，对于服务器来说有很大负载，特别是在搜索引擎的spider进行抓取网页的时候。spider会跟踪每个链接，包括edit, rdiff,attach,save.......等等操作，而且这些十分消耗服务器资源，对于用户来说没有任何用处，还常常导致一些不必要的流量。因此需要设置robots.txt，告诉spider哪些网页你不要抓取。在twiki安装时就有一个默认的robots.txt, 在twiki根目录下，你把它copy到你的网站域名的根目录下即可。查看STL中文站的robots.txt: http://www.stlchina.org/robots.txt. 此操作可以让你的网站负载降低到以前的20%.
- 反恶意抓取 . 个人和一些不道德的公司，经常会对你的网站进行流氓抓取(即短时间内频繁抓取你的每个链接, 而且不顾robots协议), 这样也会导致你的服务器负载过大。这时你需要一个插件：TWiki.BlackListPlugin. 我安装两周，过滤了15个恶意IP.
- 中文标题 这是一个很有意思的工作，TWiki默认的标题格式是：'Topic Name < Web Name < TWki Name', 如果你使用的是英文，估计还好一点，你可以是你们Topic Name包含有意义的词。但是你的文章内容是中文，这种方式对于搜索引擎很不友好。因此如何让标题显示成中文，这需要一些技巧。我采用的方式是：
- 在TWiki.TWikiPreferences设置一个全局变量: $MYTITLE. 变量的设置方法查看：TWiki变量设置方法
- 修改twiki/templates中的page.pattern.tmpl 在< title>中加入 %MYTITLE％ - ％TOPIC％
- 然后在每个页面设置自己的Title. 设置格式也需要注意，3个空格+ Set + MYTITLE = 你想要的网页标题。看看本文设置的是：
- Set MYTITLE = 如何安装TWiki(最新版本中文TWiki安装 TWiki4.0)
5 其他参考
顺利的安装会有同样的顺利，而失败的安装却各有各的原因。如果你仍然有问题，选择下列途径：
- 首先选择参考TWiki安装向导，
- 对于中文TWiki的安装,当然要参考如何安装TWiki(中文TWiki的安装).
- 对于英文比较好的朋友，可以直接到TWiki.org官方网站上去。
- 对于twiki4的安装，还有种玉堂的文章：http://gztw.com/2006/03/twiki.html。里面记录了很多详细信息。
- 还有CheDong的TWiki的安装备忘, 竹笋炒肉的TWIKI手记