CooCooWakka配置手册
(这是一个测试版本,请大家指出文中缺漏和错误)
CooCooWakka的配置文件为其根目录下的wakka.config.php,它生成于
CooCooWakka的安装程序,并会在升级之时自动更新。
该文件定义了两个数组,$wakkaConfig定义了
CooCooWakka的主要配置参数和$specialwakkapage用于定义多语言支持时特殊页面的显示名称,本文将主要介绍前者的设置。
该文件符合PHP语法,你可以通过各种方式定义数组变量,具体参考:
http://www.php.net/manual/en/language.types.array.php
下面介绍$wakkaConfig中各Key的具体意义。
禁止更改的设定
wakka_version
coo_version
这两个变量用于给升级程序识别当前的
CooCooWakka版本,因此请不要更改它们。
数据库设定
mysql_host
mysql数据库服务器的地址
mysql_database
mysql服务器中存放
CooCooWakka数据的数据库名。
mysql_user
mysql_password
访问mysql服务器的用户名以及其明文密码。
table_prefix
数据库中数据表名字的前缀。
网站环境设定
base_url
CooCooWakka使用它来生成站内的连接,如果你的网站
base_path
CooCooWakka的根URL目录地址,比如本站是"http://www.hsfz.net.cn/coo/wiki/"
rewrite_mod
设置
CooCooWakka所在服务器是否使用了
UrlRewriting功能,具体请看
UrlRewriting.
注意:如果你的服务器没有使用
UrlRewriting,而你又把该选项设置为开启,会导致一些看似非常奇怪的后果,比如无法留言、无法下载文件等等。
action_path
handler_path
分别指定
action?和
handler?的目录,其中存放了
CooCooWakka的两种类型的
插件.你可以移动这两个目录,并相应的设定该变量值,使自己的修改不会在升级时被覆盖。
upload_path
指定上传文件的存放目录,其属性必须设为777。
header_action
footer_action
分别设定生成页眉页脚的
Action?,同样地,你也可以设置他们指向你自己的Action.
default_css
设定
CooCooWakka使用的CSS文件(存放于css目录下)
关于CSS文件的编写,请参考
CooCooCSS.
mime_types
设定mine.types文件的位置,除了使用
CooCooWakka自带的以外,可以把它设为Linux/UNIX用户可以将其设为/etc/mime.types来以使用系统默认文件。
站点基本资料设定
wakka_name
你的
CooCooWakka站点的名字。
root_page
你的站点的首页位置,最好符合
WikiName命名规范。
meta_keywords
页面meta tag中keywords的信息,用于向搜索引擎等提供内容关键字的参考。
请在这里填入一些该
CooCooWakka站点内容的一些关键字。
meta_description
页面meta tag中description的信息,用于向搜索引擎等描述你的站点。
请在这里填入一些对该
CooCooWakka站点的简单介绍。
navigation_links
(未登陆状态)导航条内容设定,使用
CooCooWakka格式语法。
logged_in_navigation_links
(登陆状态)导航条内容设定,使用
CooCooWakka格式语法。
language
语言设定,请在language目录查看所支持的语言。其中:
- 英文:english
- 简体中文
GB:schinese
- 繁体中文BIG5:tchinese
- 简体中文UTF8:schinese-utf
- 繁体中文UTF8:tchinese-utf
charset
字符集设定。
注意:简体中文用户请不要使用gb18030,这样会造成页面储存过程中出现乱码。
SpecialCharsetSupport
可以设定为auto或者off,用于在
索引等Actions中判断是否对不同charset作不同处理。
如果没有特殊情况,请设为auto。
hide_comments
默认下是否隐藏留言版。
管理与维护
admin_users
管理员的用户名列表,使用逗号分割。
请参看:
CooCooACL.
AllowHtmlTags?
允许在Wiki页面中的[HTML]标记内使用哪些html标记,不允许的Tag将不会显示于结果页面。
该功能能防止一些恶意的html代码。(请最好不要允许<script><class>等标记的使用)
AutoAddAnchor?
自动给
WikiPage中的标题添加锚点,设为1开启,0关闭。
开启也许会在某些情况(比如标题有较长句子和较多标点)导致该页面无法通过xhtml合格测试。
其实一般没通过也没什么所谓,因此如没有特殊要求,可以开启该功能。
更多请看
Anchor。
AllowUploadExts?
允许上传的文件类型。(
注意,如果允许上传php等脚本,也许会使你的站点遭受攻击。)
referrers_purge_time
反向连接(referrers)站点列表的过期间,单位是“天”。
CooCooWakka将会自动清理过期的条目。
设置为0表示不过期。
pages_purge_time
历史版本(revisons)的过期时间,单位是“天”。
CooCooWakka会自动清理过期的历史版本。
设置为0表示不过期。
default_write_acl
default_read_acl
default_comment_acl
设置默认权限,详细请看
CooCooACL。
debug
是否进入调试模式。