车东[Blog^2]

从TWiki.org下载最新稳定版本：
Wiki20040902.tar.gz那个版本有安全漏洞，我最近下载到的是 TWiki20040904.tar.gz

将twiki解压缩后移动到/home/apache/twiki目录下：将目录下的文件设置为apache服务可以读写, 比如apache实用nobody 用户运行, 那么twiki目录下也要设置为nobody读写.

目录下的列表分布:

bin <== scripts
data <== data: the all meta: structure data and un-structure data
index.html <== default page
lib <== support libary
license.txt <== License
pub <== the public data
pub-htaccess.txt <== pub
readme.txt <== README
robots.txt <== robots.txt: crawler scripts
root-htaccess.txt <== example of root .htaccess file
subdir-htaccess.txt <== example of .htaccess file in sub directory
templates <== default templates
TWikiDocumentation.html <== TWiki documents
TWikiHistory.html <== TWiki history
UpgradeTwiki <== Upgrade scripts

debug.txt <== debug log _default <== default templates wiki page log200501.txt <== monthly logs log200503.txt <== monthly logs log200504.txt <== monthly logs log200505.txt <== monthly logs Main <== package Main(default) mime.types <== apache configure Sandbox <== package Sandbox(testing / trail) Trash <== package Trash bin TWiki <== package Twiki: admin porpose warning.txt <== warning log

WebHome.txt WebHome.txt,v

编辑时还会有临时：锁定文件
WebHome.lock

如果不改动模板：

chmod a-w templates
chmod g-w templates

Apache的配置修改:

ScriptAlias /twiki/bin/ "/home/apache/chedong.com/twiki/bin/"
Alias /twiki/ "/home/apache/chedong.com/twiki/"
<Directory "/home/apache/chedong.com/twiki/bin">
Options +ExecCGI
SetHandler cgi-script
Allow from all
</Directory>
<Directory "/home/apache/chedong.com/twiki/pub">
Options FollowSymLinks +Includes
AllowOverride None
Allow from all
</Directory>
<Directory "/home/apache/chedong.com/twiki/data">
deny from all
</Directory>
<Directory "/home/apache/chedong.com/twiki/templates">
deny from all
</Directory>

修改TWiki.cfg 到相应的目录和配置下：大部分是缺省路径修改

diff TWiki.cfg /home/apache/chedong.com/twiki/lib/TWiki.cfg
62c62
< $defaultUrlHost = "http://your.domain.com";
---
> $defaultUrlHost = "http://www.chedong.com";
72c72
< $pubDir = "/home/httpd/twiki/pub";
---
> $pubDir = "/home/apache/chedong.com/twiki/pub";
74c74
< $templateDir = "/home/httpd/twiki/templates";
---
> $templateDir = "/home/apache/chedong.com/twiki/templates";
76c76
< $dataDir = "/home/httpd/twiki/data";
---
> $dataDir = "/home/apache/chedong.com/twiki/data";
227c227 以下部分是为了将字符集设置为UTF-8（缺省是英文en_US.ISO-8859-1）
< $useLocale = 0;
---
> $useLocale = 1;
244c244
< $siteLocale = "en_US.ISO-8859-1";
---
> $siteLocale = "zh_CN.UTF-8";

修改：bin/setlib.cfg 虽然缺省不改也能运行，但是很多plugins可能没有那么智能，最好改成绝对路径
diff ../bin/setlib.cfg /home/apache/twiki/bin/setlib.cfg
40c40
< $twikiLibPath = '/home/apache/twiki/lib';
---
> $twikiLibPath = '../lib';

如何设置twiki编辑/上传文件需要认证?

首先设置用户名和密码:
在data目录下缺省有一个 .htpasswd文件,缺省里面只有TWikiGuest一个账号, 密码是guest(是加密的) 要注册的新用户的密码也是在这里

TWiki本身有2种级别的新用户注册机制:
一种是公开注册: 可以直接获得初始化密码;
一种是内部注册: 不可以设置初始化密码, 注册完成后需要将通知邮件转发给后台管理员,然后请管理员在后台手工在.htpasswd文件中加入相应账号的名称和密码;

具体选择那种注册模式, 就看网站的性质了，在注册之前,最好在bin/view/TWiki/TWikiPreferences中将管理员的邮件设置好(目前这个页面是TWikiGuest也能修改的) 同时还可以设置好的还有WIKILOGOIMG 等信息
Set WIKIWEBMASTER = chedong AT chedong.com

如何启用认证和设置对那些操作启用认证:

认证的启用需要设置.htaccess文件, twiki在程序目录下缺省有一个文件: /bin/.htaccess.txt 重命名成 .htaccess 将其中的!FILE_path_to_TWiki!和!URL_path_to_TWiki! 替换成twiki的后台物理路径和网站路径设置就好了,如果修改完成后没有启作用, 可能是httpd.conf配置文件中设置了 AllowOverride None
改称 AllowOverride All .htaccess就启用了.

这样设置后: 用户设置访问edit/attach等写入操作时候会需要经过data/.htpasswd中的用户名

设置了认证启用后: 再设置认证用户之间的分组和管理关系
先设置谁能进入TWikiAdminGroup组
Main/TWikiAdminGroup
这个页面缺省是任何人都可以编辑的

设置好Set GROUP = UserAndy UserBob 这样的配置后
再将当前页面的 Set ALLOWTOPICCHANGE = TWikiAdminGroup 前面的#注释去掉, UserAndy就被设置为管理员了,而且管理员文件也只有管理员组可以修改, 如果改坏了, 就只能让系统管理员改 Main/TWikiAdminGroup.txt 源文件了.

更多参考文档： 来自文德
如何安装TWiki
TWiki 使用入门
TWiki语法