MediaWiki系统的安装、配置和修改方法
系统安装
前提是你已经部署好了apache+php+mysql环境,如不会请网上搜索。windows下推荐使用xampp,一步安装到位。
从MediaWiki官网上下载最新版的MediaWiki,将软件压缩包上传到服务器后解压到系统安装目录,windows下可使用winrar、winzip、7zip等软件进行解压,linux下可使用以下命令进行解压。解压完毕后用浏览器访问一下MediaWiki所在目录会提示安装,按步骤安装即可,不细述。
tar -xvzf mediawiki-1.16.0.tar.gz -C /path/to/wiki/dir/
安装完成后移动config文件夹中的配置文件LocalSettings.php到系统根目录。
系统配置和修改
1. 主题/皮肤设置
皮肤预览:使用管理员账户登陆后,在My preferences 设置》Appearance 外观 》Skin 皮肤中预览皮肤效果,此处保存的话只有在管理员账户登陆时才有效,非全局设定。
增加新皮肤:上传皮肤文件到skins文件夹下,即可使用上述方法预览新皮肤。
修改系统默认皮肤:修改配置文件中的$wgDefaultSkin = 'monobook';一行,如希望使用Vector皮肤,则改为$wgDefaultSkin = 'vector';
注:Vector皮肤为维基百科和MediaWiki官网的默认皮肤。
2. 优化皮肤:增加Vector皮肤左侧导航菜单的折叠效果、采用WikiEditor编辑器
效果如维基百科和MediaWiki官网的左侧导航菜单和编辑界面的多功能编辑工具条。
效果是使用UsabilityInitiative扩展做出来的。从扩展页面上下载该插件,上传并解压到系统的extensions目录下。
之后修改MediaWiki配置文件,增加以下几行代码:
// UsabilityInitiative/Vector require_once("$IP/extensions/UsabilityInitiative/Vector/Vector.php"); $wgVectorModules['editwarning']['global'] = false; // Don't enable EditWarning globally $wgVectorModules['editwarning']['user'] = true; // Allow users to enable EditWarning in their preferences $wgVectorUseSimpleSearch = true; // Need this as well for SimpleSearch $wgDefaultSkin = 'vector'; // If you want to change the default skin for new users $wgVectorUseIconWatch = true; //Enable star icon to add/remove page from watchlist // UsabilityInitiative/WikiEditor require_once("$IP/extensions/UsabilityInitiative/WikiEditor/WikiEditor.php"); $wgDefaultUserOptions['usebetatoolbar-cgd'] = 1; // Default user preference to use toolbar dialogs $wgWikiEditorModules['toolbar']['global'] = true; // Enable the WikiEditor toolbar for everyone $wgWikiEditorModules['toolbar']['user'] = false; // Don't allow users to turn the WikiEditor toolbar on/off individually
注:UsabilityInitiative扩展目前只支持MediaWiki 1.16版,从1.17版本后该扩展已分拆为新的插件。
3. LOGO修改
最简单的,直接替换/skins/common/images/wiki.png文件,当然,你也可以通过设定$wgLogo来设定logo文件位置。
4. 上传文件设定
修改 LocalSettings,$wgEnableUploads就是控制上传的参数,true允许,false不允许,默认应该是允许的。您还需要将 images目录加上可写入的权限,要不然用户无法上传。通过$wgFileExtensions = array('','','')设定允许上传的文件类型,$wgFileBlacklist = array('','','')设定不允许上传的文件类型。
5. 修改为/wiki/式网址
修改LocalSettings.php
$wgArticlePath = "/wiki/$1";
再修改httpd.conf(apache配置文件)
Alias /wiki /filesystem/path/to/you/site/index.php Alias /index.php /filesystem/path/to/you/site/index.php
备注:网上还有很多修改为/wiki/式网址的方法,我都测试过,发现除了使用apache别名功能外,还就就是利用.htaccess编写rewrite rule了。具体的,大家可以google下。
6. 使用者权限修改
$wgGroupPermissions['*' ]['createaccount'] = false; $wgGroupPermissions['*' ]['read'] = true; $wgGroupPermissions['*' ]['edit'] = false; $wgGroupPermissions['*' ]['createpage'] = false; $wgGroupPermissions['*' ]['createtalk'] = true;
7. 设定/取消Sysop(管理员)权限
到Special:Userrights页面,输入用户名,在列表中选择"sysop"权限即可;再次选定并确认则取消管理员权限。注意仅有"Bureaucrat"(行政管理员)权限的帐号才能进行以上设定。
8. 以新窗口打开外部链接
- 打开 "includes/Linker.php"
- 找到 "function getExternalLinkAttributes"
- 在下面一段代码之後
$r = ($class != '') ? " class='$class'" : " class='external'";
增加以下代码:
$r .= " target=\"_blank\"";
这样就能让所有的外部链接以新窗口形式打开了。
由于MediaWiki的页面缓冲机制,可能造成这个修改的效果不能迅速完全反映出来。
9. 清除页面缓冲
- 在普通页面的网址后面添加“&action=purge”参数可以更新服务器缓冲数据,这可能需要几分钟之后才能见到效果。
- 在LocalSettings.php中设置$wgCacheEpoch全局变量,强制现有缓冲过期(参见DefaultSettings.php)
10. 提示信息修改
比较常用的提示信息有以下几个:
- MediaWiki:Mainpage 首页,可修改为首页将使用的文章标题
- MediaWiki:pagetitle (浏览器上方)网页标题,可改为“$1 - 站名”,其中$1代表文章名称
- MediaWiki:Privacy (页脚)隐私政策,可改为相应文章标题(如“隐私政策”)或“-”禁止显示本项。
- MediaWiki:Aboutpage (页脚)关于本站
- MediaWiki:Disclaimers (页脚)免责申明,可改为相应文章标题(如“本站免责声明”)或“-”禁止显示本项。
- MediaWiki:Sidebar (测栏)导航栏 格式:URL|标题
11. 修改左侧导航条
当需要在mediawiki左侧导航条的内容时,请在搜索栏中输入“mediawiki:sidebar”,然后进行编辑(需要以站长或管理员身份登录)。
mediawiki:sidebar的原始信息如下:
* navigation
** mainpage|mainpage
** portal-url|portal
** currentevents-url|currentevents
** recentchanges-url|recentchanges
** randompage-url|randompage
** helppage|help
** sitesupport-url|sitesupport
第一行(一个前导*)表示导航栏的名称,其提示文本在“mediawiki:navigation”页面中修改,也可以直接输入文字信息(文字不能与内部mediawiki参数页面重名)。
后续行(两个前导*)表示实际导航栏的内容,其格式为“链接网址|显示文本”。其中,链接网址有三种类型:
- 直接输入http网址,例如直接输入“http://www.allwiki.com/bbs”
- 文章页面标题,例如输入“天下维客”代表站内文章“[[天下维客]]”的网址
mediawiki
名字空间的参数页,例如输入“mainpage”代表文字信息参数页面“[[mediawiki:mainpage]]”的网址。此类字串还有
helppage、portal-url等,请到special:allmessages里面查看更多的此类字串。
12. 系统界面提示信息修改
Special:Allmessages是一个称为“系统界面”的特殊页面,可以在搜索框中输入“Special:Allmessages”来直接访问。也可以访问特殊页面下的系统界面.
当发现mediawiki中的提示信息为英文时,请进入该页面,搜索找到相应信息,然后点击表格左栏中链接进行修改。
MediaWiki的大部分界面信息存放在Special:Allmessages里面,包括界面的文字、链接、气泡提示、热键等。只有极少量的内容放在localsettings.php中。
请注意:必须以站长或者管理员身份登录后才能修改界面信息!
13. 繁简共存版本的界面修改
对于安装时选用zh语种进行繁简并存的系统,对于同一条提示信息应同时修改6个版本:
- mediawiki:xxx
- mediawiki:xxx/zh
- mediawiki:xxx/zh-cn
- mediawiki:xxx/zh-tw
- mediawiki:xxx/zh-hk
- mediawiki:xxx/zh-sg
如有修改不到的话,则使用相应语种浏览器的用户(或用户在参数设置页面里选择不同语言时),会看到未修改的提示信息。
这就是为什么安装时不推荐zh语种进行繁简共存的原因。
14. 查看MediaWiki版本
在Special pages 特殊页面里找到Version页面,或者直接通过网址打开Special:Version页面。
在Special:Version特殊页面可以看到MediaWiki版本、PHP版本、Apache版本和所安装的扩展的版本。
15. 短网址隐藏网址中的index.php
使用诸如/wiki/Main_Page这样的网址作为连接地址,就如同维基百科网址的网址连接一样。
(1) LocalSettings.php作如下修改:
$wgScriptPath = "/w"; # 系统真实可访问到的路径 $wgArticlePath = "/wiki/$1"; # 虚拟路径,必须与 $wgScriptPath 不同 $wgUsePathInfo = true; # 启用 pretty URLs
(2) Apache的配置文件httpd.conf增加如下配置:
Alias /wiki /var/www/w/index.php
以后配置后一项为文件系统的绝对路径。修改完成后使用命令 /usr/local/sbin/apachectl restart 重启Apache
更多关于短网址的配置参见Manual:Short URL
更多系统配置相关的请参见LocalSettings.php的使用
参考文章:http://wasabi.javaeye.com/blog/309176
还没有人抢沙发呢~