定制 UseModWiki,直接修改 wiki.pl 显然不是一个好的主意,因为这将加大 Wiki 升级的难度。UseModWiki 提供了另外的一个配置文件 config
,提供对 UseModWiki 的定制。
将安装包中的 config
文件,拷贝到刚刚创建的数据目录:$DataDir。
bash# cp config /opt/UseModWiki/
编辑 config
文件,进行对 UseModWiki 的定制。
标题文字
$SiteName = "Wiki"; # Name of site (used for titles)
LOGO 图片位置
将安装包中的LOGO图片 wiki.gif 拷贝到 Web服务器合适的目录下,要和 config 文件中的配置一致。确省设置如下:
$LogoUrl = "/wiki.gif"; # URL for site logo ("" for no logo)
Cookie 名称
如果一个站点配置了多个 UseModWiki,每个独立的 UseModWiki 需要配置不同的 Cookie 名称。该 Cookie 主要是保存用户的登录信息等。确省设置如下:
$CookieName = "Wiki"; # Name for this wiki (for multi-wiki sites)
设置字符集
要让页面确省的编码为简体中文,如下配置:
$HttpCharset = "gb2312"; # Charset for pages, like "iso-8859-2"
使用样式表 CSS
使用样式表,定制页面显示:
$StyleSheet = "/inc/css/wiki.css"; # URL for CSS stylesheet (like "/wiki.css")
配置 intermap
可选配置。拷贝压缩包中的配置文件 intermap 至UseModWiki数据目录。intermap 文件记录了常用的 Wiki 链接,可以直接引用。
设置保留时间 KeptPages
$KeepDays = 14; # Days to keep old revisions
确省 $KeptPages 设置为两周(14天),含义为清除14天以前的改动历史。对于更新不频繁的 Wiki 网站,这个值显然要设置的大一些为好。
该配置在进行维护操作(?action=maintain)时被读入,并进行相应的清理过期版本等操作。参见:UseMod 管理。
1.0 版本开始支持文件上传,需要在 config 文件中进行设置
$UploadDir = 'E:/REPOS/UseModWiki/upload'; # Full path (like /foo/www/uploads) for files $UploadUrl = '/upload'; # Full URL (like http://foo.com/uploads) ... $UseUpload = 1; # 1 = allow uploads, 0 = no uploads ... $AllUpload = 1; # 1 = anyone can upload, 0 = only editor/admins
其中的 $UploadDir 为上传文件的物理路径;$UploadUrl 为在网站上映射的目录名;$AllUpload 是允许任何用户都可以上传文件,否则只有具有编辑权限和管理员才能上传文件。
开启邮件通知功能
1.0 版本开始支持邮件通知功能,用户只要在“个性设置”中配置接收邮件通知的邮箱,则在 Wiki 页面修改后,会收到邮件通知。
$EmailNotify = 1; # 1 = use email notices, 0 = no email on changes
开启页面缓存
如果开启了页面缓存,将在数据目录 $DataDir 下建立页面缓存目录 $DataDir/html,该目录下保存最新的页面缓存,不必在每次浏览 Wiki 页面时,靠 cgi 重新生成,提高响应速度。
$UseCache = 1; # 1 = cache HTML pages, 0 = generate every page
但是,发现一个问题,缓存页面中的链接指向的是 cgi脚本的文件名(不带路径),对于配置了可以用多种 URL 访问wiki页面,会出现问题。例如: 可以用 "/cgi-bin/wiki.pl" 和 "/wiki" 访问 wiki,缓存页面中的链接可能是 <a href="wiki.pl?... 也可能是 <a href="wiki?... ,在页面跳转过程中,就会出现去访问根本访问不到的 URL,如 "/cgi-bin/wiki", "/wiki.pl"。解决办法是修改 Wiki 脚本中生成页面链接部分的代码:
my @ScriptPath = split('/', "$ENV{SCRIPT_NAME}"); ... ... #$ScriptName = pop(@ScriptPath); # Name used in links $ScriptName = ""; # Set $ScriptName to blank to generate common links in cached htmls
即简单的将 $ScriptName 设置为空即可。
其他
$NewFS = 1; $ThinLine = 1;
现在已经可以访问我们搭建起来的 Wiki 平台了,用浏览器访问我们建好的 UseModWiki 平台,可以发现界面是英文界面,有什么办法将界面汉化么?
Copyright © 2006 WorldHello 开放文档之源 计划 |