MediaWiki系统的安装、配置和修改方法（转载）

前提是你已经部署好了apache+php+mysql环境，如不会请网上搜索。windows下推荐使用xampp，一步安装到位。

从MediaWiki官网上下载最新版的MediaWiki，将软件压缩包上传到服务器后解压到系统安装目录，windows下可使用winrar、winzip、7zip等软件进行解压，linux下可使用以下命令进行解压。解压完毕后用浏览器访问一下MediaWiki所在目录会提示安装，按步骤安装即可，不细述。

1
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配置文件，增加以下几行代码：

01
02
03
04
05
06
07
08
09
10
11
12
13
// 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

1
$wgArticlePath = "/wiki/$1";

再修改httpd.conf（apache配置文件）

1
2
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. 使用者权限修改

1
2
3
4
5
$wgGroupPermissions['*' ]['createaccount'] = false;
$wgGroupPermissions['*' ]['read'] = true;
$wgGroupPermissions['*' ]['edit'] = false;
$wgGroupPermissions['*' ]['createpage'] = false;
$wgGroupPermissions['*' ]['createtalk'] = true;

7. 设定/取消Sysop（管理员）权限

到Special:Userrights页面，输入用户名，在列表中选择”sysop”权限即可；再次选定并确认则取消管理员权限。注意仅有”Bureaucrat”（行政管理员）权限的帐号才能进行以上设定。

8. 以新窗口打开外部链接

  1. 打开 “includes/Linker.php”
  2. 找到 “function getExternalLinkAttributes”
  3. 在下面一段代码之後
1
$r = ($class != '') ? " class='$class'" : " class='external'";

增加以下代码：

1
$r .= " target=\"_blank\"";

这样就能让所有的外部链接以新窗口形式打开了。

由于MediaWiki的页面缓冲机制，可能造成这个修改的效果不能迅速完全反映出来。

9. 清除页面缓冲

  1. 在普通页面的网址后面添加“&action=purge”参数可以更新服务器缓冲数据，这可能需要几分钟之后才能见到效果。
  2. 在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作如下修改：

1
2
3
$wgScriptPath = "/w";   # 系统真实可访问到的路径
$wgArticlePath = "/wiki/$1";  # 虚拟路径，必须与 $wgScriptPath 不同
$wgUsePathInfo = true;        # 启用 pretty URLs

(2) Apache的配置文件httpd.conf增加如下配置：

1
Alias /wiki /var/www/w/index.php

以后配置后一项为文件系统的绝对路径。修改完成后使用命令 /usr/local/sbin/apachectl restart 重启Apache

  1. 暂无评论

  1. 暂无 Trackback

return top