Tags:
create new tag
, view all tags

如何安装TWiki(中文TWiki 4.0安装)

作者:Winter

0 前言:关于TWiki


关于Wiki,大家肯定听说了不少,TWiki只是Wiki的一种实现形式。不过在众多的wiki版本中,TWiki声名远扬,按照twiki.org的解释是,一个灵活、强大、简单的企业级共同协作平台。目前著名的网络公司Yahoo内部的平台就是使用的TWiki, 另外Motorola 和SAP 等国际大公司都在使用TWiki,这也是我为什么选择TWiki的原因。

TWiki的文档很多,也很细致,不过刚开始看还有些不习惯,文档中所以的WikiName都加上了链接,有时候经常点来点去就不知道自己点到哪里去了。目前关于TWiki的中文文档是少之又少,关于TWiki安装文档,更是凤毛麟角。当然安装TWiki并不是什么难事,不过,许多事情都是说起来容易,做起来难......

也许是因为Twiki自己是一个新生产品,因此也有一些不完善的地方,特别是版本升级的时候会有一些不兼容的地方。本文的第一版是在2005年年中写的,一年之后,twiki升级到4了。安装也变得有些不同,在我升级过程中,记录了一些注意事项,供大家参考。

1 安装流程


  1. 下载TWiki . TWiki的官方网站是twiki.org,其下载页面是:twiki download,目前的版本是Twiki4.04。下载其安装包:TWiki-4.0.4.tgz, 或者TWiki-4.0.4.zip
  2. 配置setlib.cfg . 解开压缩包后,在twiki/bin目录下,你会发现setlib.cfg文件,里面唯一需要修改的是:$twikiLibPath ,把他改成twiki/lib的绝对路径。如:$twikiLibPath=/home/winter/twiki/lib 。
  3. 配置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";
  4. 选择你的存储模式 . TWiki使用的是文本数据库,TWiki会保存所有的变化。了解unix和linux的朋友都知道diff命令,还有类似的ci co rcs等命令。TWiki就是使用这些命令来实现其不同的版本管理。如果你能控制你的网站服务器,例如,你有root权限。你可以设置$storeTopicImpl = "RcsWrap"; 但是,如果你是虚拟主机用户,你还是选择$storeTopicImpl = "RcsLite";后者会100%使用perl来完成所有的文档存储和版本管理功能。如果你选择后者,你最好把所有在twiki/bin目录下的文件增加一个后缀名,然后在你的TWiki.cfg文件中设置:$scriptSuffix = ".pl";
  5. 测试你的配置 . 使用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 其他参考

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

如何安装TWiki(最新版本中文TWiki安装 TWiki4.0)

    1. twiki4.2以后的版本中设置和这个不同,需要修改twiki/templates/twiki.tmpl文件,找到设施标题的那一行,把TOPIC,改成MYTITLE就可以了


  • Set MYTITLE = 如何安装TWiki(中文TWiki安装)

-- ChinaStl - 18 Jun 2005

Edit | Attach | Print version | History: r11 | r9 < r8 < r7 < r6 | Backlinks | Raw View | Raw edit | More topic actions...
Topic revision: r7 - 2006-07-06 - WinterWen
 
  • Edit
  • Attach
This site is powered by the TWiki collaboration platformCopyright © 2008-2020 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号