Tags:
create new tag
, view all tags

如何安装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 安装流程


  1. 下载TWiki . TWiki的官方网站是twiki.org,其下载页面是:twiki download,目前的版本是Twiki4.04。下载其安装包:TWiki-4.0.4.tgz, 或者TWiki-4.0.4.zip。解开压缩包以后,你会发现在目录中有一个文件INSTALL.html文件,其中详细告诉你如何操作。
  2. 配置LocalSite.cfg . 在twiki/bin目录下,你会发现LocalSite.cfg.txt文件,里面唯一需要修改的是:$twikiLibPath ,把他改成twiki/lib的绝对路径。如:$twikiLibPath=/home/winter/twiki/lib 。
  3. 配置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的有用的技巧设置


  1. 用户登陆 。前面已经说了,可以通过两种方式。
  2. 个性化 . 全网站的一些链接、图标等个性化设置都在: TWikiPreferences 。 你可以设置你的网页背景颜色、个性图标、网站logo等。
  3. 插件管理 你可以在twiki的官方网站上找到一些有用的插件,这里是twiki4中测试用过的插件列表。下载以后,按照使用步骤安装到你的twiki目录,然后通过 twiki/bin/configure 进行配置。
  4. 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%.
  5. 反恶意抓取 . 个人和一些不道德的公司,经常会对你的网站进行流氓抓取(即短时间内频繁抓取你的每个链接, 而且不顾robots协议), 这样也会导致你的服务器负载过大。这时你需要一个插件:TWiki.BlackListPlugin. 我安装两周,过滤了15个恶意IP.
  6. 中文标题 这是一个很有意思的工作,TWiki默认的标题格式是:'Topic Name < Web Name < TWki Name', 如果你使用的是英文,估计还好一点,你可以是你们Topic Name包含有意义的词。但是你的文章内容是中文,这种方式对于搜索引擎很不友好。因此如何让标题显示成中文,这需要一些技巧。我采用的方式是:
    1. TWiki.TWikiPreferences设置一个全局变量: $MYTITLE. 变量的设置方法查看:TWiki变量设置方法
    2. 修改twiki/templates中的page.pattern.tmpl 在< title>中加入 %MYTITLE% - %TOPIC%
    3. 然后在每个页面设置自己的Title. 设置格式也需要注意,3个空格+ Set + MYTITLE = 你想要的网页标题。看看本文设置的是:
  • Set MYTITLE = 如何安装TWiki(最新版本中文TWiki安装 TWiki4.0)
    1. twiki4.2以后的版本中设置和这个不同,需要修改twiki/templates/twiki.tmpl文件,找到设施标题的那一行,把TOPIC,改成MYTITLE就可以了

5 其他参考


顺利的安装会有同样的顺利,而失败的安装却各有各的原因。如果你仍然有问题,选择下列途径:
  1. 首先选择参考TWiki安装向导
  2. 对于中文TWiki的安装,当然要参考如何安装TWiki(中文TWiki的安装).
  3. 对于英文比较好的朋友,可以直接到TWiki.org官方网站上去。
  4. 对于twiki4的安装,还有种玉堂的文章:http://gztw.com/2006/03/twiki.html。里面记录了很多详细信息。
  5. 还有CheDongTWiki的安装备忘, 竹笋炒肉的TWIKI手记
Topic revision: r11 - 2008-12-20 - WinterLb
 
This site is powered by the TWiki collaboration platformCopyright © 2008-2018 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback 京ICP备05049167号