特别说明:请不要使用Windows自带的记事本改程序!Mediawiki使用utf-8格式保存程序,记事本会在文件开始多出三个字节,而这会导致网站运行出错。推荐使用EmEditor进行编辑(另存为utf-8,不要unicode标记)。
Mediawiki安装完成之后生成的LocalSettings.php文件是整个网站的配置文件,根据你的实
用范围可能会有些必要的设置:
1.开放图形上传功能
首先需要到LocalSettings.php里面搜索upload字串。找到下列内容进行修改;然后将网站的images目录权限设为允许写入即可。如果服务器上安装了ImageMagick库,可再取消$wgUseImageMagick行的注释。
【版本1.4.X】取消第3行和第6行的注释(即行首的#号)
To enable image uploads, make sure the ‘images’ directory
is writable, then uncomment this:
$wgDisableUploads = false;
$wgUseImageResize = true;
$wgUseImageMagick = true;
$wgImageMagickConvertCommand = “/usr/bin/convert”;
【版本1.5.X】取消这一行的行首#号
$wgEnableUploads = true;
2.管理员权限设定
以下修改中,很多过程需要管理员的权限。因此请以管理员帐号登录。如需他人帮忙,则要将其也提升为管理员:
以站长或行政管理员(bureaucrat)身份进入Special:MakeSysop页面(在特殊页面最下方),输入用户名并按下方按钮即可。
该页面上有行政管理员的选项,请慎重考虑而不要随意勾选。
3.标签及其他系统提示、链接的修改
进入Special:Allmessages页面(在特殊页面中可以找到,一般翻译为“系统界面”,本站则修改为“界面定制”标题)
在这个页面上,左侧是该信息所在的网址,中间是系统初始设置,右侧是当前设置。搜索页面,找到要修改的字符串,点左侧相应的链接。
编辑该页面,保存。
注意:⒈修改这些页面需要有管理员权限;
⒉修改效果可能需要过一会儿才能显现,这是服务器的页面缓存问题。
对于多语种版本,对应有多套本地化信息,需要分别修改。这需要到个人的参数设置页面中调整界面语言、中文字体选项,然后重复上述过程。
4.更改页面左上角的网站图标
默认设置(monobook风格)下,在skins/common/images/目录中有wiki.png的图片文件,替换为自己的图片即可。
5.多个繁简体中文标签的删减
安装时选用"中文-zh"方式时,网站页面上方会有多个台湾、香港、新加坡等多个标签。修改下面的系统设置可以减少标签到“不转换”、“简体”、“繁体”三个:
Mediawiki:variantname-zh-hk:设为disable可取消香港繁体标签
Mediawiki:variantname-zh-sg:设为disable可取消新加坡繁体标签
6.左侧工具条的定制
增加工具条选项、显示友情链接等内容,需要对工具栏进行定制
在搜索栏中输入: Mediawiki:Sidebar 然后编辑
7.打开外部图片引用功能
Mediawiki 1.6及之前版本中,在wiki文本中书写外部图片链接可以直接显示图片。
出于安全性考虑,Mediawiki 1.7之后将这个设置的默认值调整为关闭状态。需要本功能的应自行打开,在localsettings.php增加下面一行即可:
$wgAllowExternalImages = true;
允许从外部网址上传图片
从Mediawiki 1.8开始,新增了以网址形式将外部图片上传到wiki的功能。本功能默认关闭,打开方法为在localsettings.php增加下面一行:
$wgAllowCopyUploads = true;
8.默认时区更改
Mediawiki默认使用服务器的时区设置,所以用户签名、最近更新、网页更新等时间信息经常会出现“(UTC)”(国际平均时间),这与本地时间不同,带来了一定的不便。
在LocalSettings.php倒数第三行加入以下代码:
$wgLocaltimezone = “Asia/Shanghai”;
putenv(“TZ=$wgLocaltimezone”);
$wgLocalTZoffset = date(“Z”) / 60;
这样可以让Mediawiki使用北京时间显示
9. 隐藏MediaWiki的首页标题
MediaWiki的每个页面都有一个大大的标题,首页也是这样,通常该标题为“MainPage”或“首页”,首页的标题既影响美观,又占用空间。那么 如何将该标题隐去呢?MediaWiki没有内建的选项来隐去此标题,但可以通过JavaScript或CSS来隐去此标题。完整的信息可以参见这里:
http://www.mediawiki.org/wiki/Manual:FAQ#How_do_I_hide_the_main_page_title.3F
这里只介绍对于MediaWiki 1.9及其以上版本通过CSS隐去首页标题的方法。如果使用的是默认的Monobook皮肤,可以通过修改“skins/monobook/main.css”文件来隐去首页标题。在该文件任意位置另起一行加入:
body.page-Main_Page h1.firstHeading { display:none; }
注意如果MediaWiki使用简体中文语言文件,则上面代码应该为:
body.page-首页 h1.firstHeading { display:none; }
当然,如果使用繁体,则应该是:
body.page-首頁 h1.firstHeading { display:none; }
反正和你的首页标题对应就行了。
10. 在Mediawiki中搜索3字单词
在MySQL中建立全文索引时,默认只对4个字符以上(包括)的字符串建立索引,也就是说当要在使用MySQL作为数据库引擎的MediaWiki网站中检索三字词时,是得不到结果的,比如试图搜索web。若要对四个字符以下单词建立索引,需要修改MySQL的一个参数:ft_min_word_len,其默认值是4。修改该参数后重启MySQL并重建MediaWiki的索引:
REPAIR TABLE searchindex QUICK;
如果使用的数据库是MySQL 3.x 版本,除了修改以上参数外,还需要在MediaWiki的LocalSettings.php中设定$wgDBminWordLen参数,如果是4.x以上版本,则可以忽略此参数:
$wgDBminWordLen = 3;
11.更多的本地化定制
如果不是对个性化要求较高可以跳过这块。
DefaultSettings与LocalSettings
调用顺序
在mediawiki系统中,将首先调用本文件进行通用的初始设置,然后再调用LocalSettings.php进行变量修改(以适应不同站点的需要)。
修改方式
对于需要修改的设置,请对LocalSettings.php进行设定/修改,而不是直接修改DefaultSettings.php。这样做的好处是以后升级mediawiki系统时,可以方便地进行文件替换。
LocalSettings.php的定制:
基础设置
$IP变量存放着安装wiki站点的本地路径。注意不要在最后添加反斜线。DefaultSettings.php的读取路径会受到这个变量的影响。
$wgSitename变量存放wiki网站的名称(utf-8格式)。这个名称在系统中被多次引用。
$wgNoFollowLinks确定是否使用nofollow特性。该特性打开时,搜索引擎将不会对wiki文本中的外部链接进行追踪检索,从而降低spamer的效果及兴趣。
$wgScriptPath是访问系统主要脚本的URL路径前缀。当使用Apache路径改写功能时需要修改这个变量。
$wgScript是Mediawiki的主要脚本名称,当前为index.php。不要轻易改动它。
$wgRedirectScript指定Mediawiki处理redirect操作时的URL路径。不要轻易改动它。
$wgArticlePath是访问Mediawiki页面时使用的路径。如需使用Apache的rewrite规则来创建美观简短的URL,应将此变量进行合理设置。
$wgArticlePath影响内部文本中的自动链接,设置错误时会导致点击内部链接时跑飞;但在浏览器中输入通用模式路径(index?tilte=…方式)时仍能正常访问页面。