“安装MW：初始化配置”的版本间差异

2022年8月22日 (一) 08:28的版本

配置文件

MediaWiki 的配置文件有两处：

1、DefaultSettings.php：系统默认的配置文件，位于“./includes/DefaultSettings.php”；

2、LocalSettings.php：用户设置的配置文件，位于“./LocalSettings.php”；

以下都在 LocalSettings.php 中进行增加、覆盖、设置相应配置。

修改默认 Logo 与 Favicon

可以使用“Axialis IconWorkshop”制作图标（Favicon）。

设置：

## The URL path to the logo.  Make sure you change this from the default,
## or else you'll overwrite your logo when you upgrade!
# $wgLogo = "$wgResourceBasePath/resources/assets/wiki.png";
# $wgLogos = [ '1x' => "$wgResourceBasePath/resources/assets/wiki.png" ];
$wgLogo = "$wgResourceBasePath/resources/assets/wikioe.png";
$wgFavicon = "$wgResourceBasePath/resources/assets/wikioe.ico";

去除底部的“Powered by”图标

设置：

unset($wgFooterIcons['poweredby']);

修改皮肤

MediaWiki 的皮肤位于“./skins”中，可在网络下载并上传至服务器中（注意：修改皮肤文件读写权限及所有者）。

$wgDefaultSkin 用于加载皮肤，$wgDefaultSkin 用于设置皮肤。

设置：

## Default skin: you can change the default skin. Use the internal symbolic
## names, ie 'vector', 'monobook', 'timeless':
$wgDefaultSkin = "vector";

# Enabled skins.
# The following skins were automatically enabled:
wfLoadSkin( 'MinervaNeue' );
wfLoadSkin( 'MonoBook' );
wfLoadSkin( 'Timeless' );
wfLoadSkin( 'Vector' );

上传文件配置

LocalSettings中，$wgEnableUploads = true;;
MediaWiki中允许上传文件类型限制配置（默认支持：'png','gif', 'jpg', 'jpeg', 'webp'），可参阅 DefaultSettings.php 中 $wgFileExtensions 的值，如：

$wgFileExtensions = [ 'png', 'gif', 'jpg', 'jpeg', 'webp' ];

而不允许的文件类型在参数$wgFileBlacklist中设定，如：

$wgFileBlacklist = [
	:# HTML may contain cookie-stealing JavaScript and web bugs
	'html', 'htm', 'js', 'jsb', 'mhtml', 'mht', 'xhtml', 'xht',
	# PHP scripts may execute arbitrary code on the server
	'php', 'phtml', 'php3', 'php4', 'php5', 'phps', 'phar',
	# Other types that may be interpreted by some servers
	'shtml', 'jhtml', 'pl', 'py', 'cgi',
	# May contain harmful executables for Windows victims
	'exe', 'scr', 'dll', 'msi', 'vbs', 'bat', 'com', 'pif', 'cmd', 'vxd', 'cpl' ];

登录后通过导航栏或特殊页面中的上传文件链接上传文件。用[[File:文件名]]在页面中引用文件，如果引入的是图片文件，还可以指定图片宽度([[File:Example.jpg|200px]])，加入图片说明([[File:Example.jpg|图片1]])，设置方框效果([[File:Filename.jpg|thumb]])。

清除页面缓存

DefaultSettings.php 中,找到参数$wgCacheEpoch，将参数值置为当前时间，可以取消全部已经缓存的页面（包括客户端和服务器端）。

/**
 * Set this to current time to invalidate all prior cached pages. Affects both
 * client-side and server-side caching.
 * You can get the current date on your server by using the command:
 * @verbatim
 *   date +%Y%m%d%H%M%S
 * @endverbatim
 */
$wgCacheEpoch = '20030516000000';

其他配置

修改导航栏

通过wiki地址 index.php?title=MediaWiki（ MediaWiki:Sidebar ）,或者在搜索栏中输入“mediawiki:sidebar”，进入页面后点击编辑即可。

导航栏格式如下：

*导航栏名称一
**链接一地址|链接一名称
**链接二地址|链接二名称

*导航栏名称二
**链接一地址|链接一名称
**链接二地址|链接二名称

用户组

MediaWiki中有3个用户组：机器人/管理员/行政员，每个用户组的具体权限可通过”特殊页面” -> “用户组权限”查看；
通过首页中”创建用户”注册的用户默认不属于任何用户组；
从属于行政员用户组的用户，可通过”特殊页面” -> “用户权限管理”给其他用户分配用户组。

问题

站点路径的问题：

站点目录结构的不同，则配置文件的 $wgScriptPath 配置不同，网站的访问路径不同：

如果站点目录为 "/www/wwwroot/wiki.eijux.com/wiki"：
LocalSettings.PHP的配置为：$wgScriptPath = ""；

网站的访问路径为：http://wiki.eijux.com/index.php?title=%E9%A6%96%E9%A1%B5
如果站点目录为 "/www/wwwroot/wiki.eijux.com/wiki"：
LocalSettings.PHP的配置为：$wgScriptPath = "/wiki"；

网站的访问路径为：http://wiki.eijux.com/wiki/index.php?title=%E9%A6%96%E9%A1%B5

@@ 第2行： / 第2行： @@
-== 配置 ==
+== 配置文件 ==
-MediaWiki的配置文件有两处：
+ MediaWiki 的配置文件有两处：
-# '''/www/wwwroot/xxx.com/includes/DefaultSettings.php''' ： 系统默认的配置文件；
-# '''/www/wwwroot/xxx.com/LocalSettings.php''' ： 用户设置的配置文件；
+、<span style="color: blue; font-size: 150%">'''DefaultSettings.php'''</span>：系统默认的配置文件，位于“<span style="color: green">'''./includes/DefaultSettings.php'''</span>”；
-主要在LocalSettings.php中进行设置和覆盖相应配置，对DefaultSettings.php只是做较少的修改<br/>
+、<span style="color: blue; font-size: 150%">'''LocalSettings.php'''</span>：用户设置的配置文件，位于“<span style="color: green">'''./LocalSettings.php'''</span>”；
-=== 修改默认logo与icon ===
+以下都在 '''LocalSettings.php''' 中进行增加、覆盖、设置相应配置。
-LocalSettings.php中，'''''$wgLogo = "$wgResourceBasePath/resources/assets/wiki.png"'''''。<br/>
-更改logo的方法有两种，
+=== 修改默认 Logo 与 Favicon ===
-# 替换“./resources/assets/wiki.png”为同名图片(不建议，因为更新系统时会覆盖该默认图片)；
+ 可以使用“<span style="color: green; font-size: 120%">'''Axialis IconWorkshop'''</span>”制作图标（Favicon）。
-# 另行制定其他路径下的自定义图片，如“$wgLogo = "$wgResourceBasePath/images/logo.jpg"”。
-<pre>
+设置：
+: <syntaxhighlight lang="PHP" highlight="">
 ## The URL path to the logo.  Make sure you change this from the default,
 ## or else you'll overwrite your logo when you upgrade!
 # $wgLogo = "$wgResourceBasePath/resources/assets/wiki.png";
 # $wgLogos = [ '1x' => "$wgResourceBasePath/resources/assets/wiki.png" ];
-</pre>
-在'''LocalSettings.php'''中配置网站'''Logo'''和站点'''icon'''：
-<syntaxhighlight lang="php">
 $wgLogo = "$wgResourceBasePath/resources/assets/wikioe.png";
 $wgFavicon = "$wgResourceBasePath/resources/assets/wikioe.ico";
 </syntaxhighlight>
-* 用“Axialis IconWorkshop”制作图标相当nice【2020/10/07 16:43:15】
-=== 去除底部的power by图标 ===
+=== 去除底部的“Powered by”图标 ===
-LocalSettings.php中，加入 '''''unset($wgFooterIcons['poweredby']);'''''。
+设置：
+: <syntaxhighlight lang="PHP" highlight="">
+unset($wgFooterIcons['poweredby']);
+</syntaxhighlight>
 === 修改皮肤 ===
-LocalSettings.php中，'''''$wgDefaultSkin = "vector";'''''。<br/>
+ MediaWiki 的皮肤位于“./skins”中，可在网络下载并上传至服务器中（注意：修改皮肤文件读写权限及所有者）。
-MediaWiki的皮肤位于“./skins”中，可在网络下载并上传至服务器中（并修改皮肤文件读写权限及所有者），并在LocalSettings.php中加载皮肤（如'''''wfLoadSkin( 'Vector' );'''''）。
-<pre>
+ <span style="color: blue">'''$wgDefaultSkin'''</span> 用于加载皮肤，<span style="color: blue">'''$wgDefaultSkin'''</span> 用于设置皮肤。
+设置：
+: <syntaxhighlight lang="PHP" highlight="">
 ## Default skin: you can change the default skin. Use the internal symbolic
 ## names, ie 'vector', 'monobook', 'timeless':
@@ 第39行： / 第43行： @@
 # Enabled skins.
 # The following skins were automatically enabled:
+wfLoadSkin( 'MinervaNeue' );
 wfLoadSkin( 'MonoBook' );
 wfLoadSkin( 'Timeless' );
 wfLoadSkin( 'Vector' );
-</pre>
+</syntaxhighlight>
+=== 上传文件配置 ===
-=== 上传文件设定 ===
 LocalSettings中，'''''$wgEnableUploads = true;''''';<br/>
-MediaWiki中允许上传文件类型限制配置（默认支持'png','gif', 'jpg', 'jpeg', 'webp'），可参阅DefaultSettings.php中'''''$wgFileExtensions'''''的值，如：
+MediaWiki中允许上传文件类型限制配置（默认支持：'png','gif', 'jpg', 'jpeg', 'webp'），可参阅 DefaultSettings.php 中 '''''$wgFileExtensions''''' 的值，如：
 <pre>$wgFileExtensions = [ 'png', 'gif', 'jpg', 'jpeg', 'webp' ];</pre>
 而不允许的文件类型在参数'''''$wgFileBlacklist'''''中设定，如：
@@ 第62行： / 第71行： @@
 登录后通过导航栏或特殊页面中的上传文件链接上传文件。用'''''<nowiki>[[File:文件名]]</nowiki>'''''在页面中引用文件，如果引入的是图片文件，还可以指定图片宽度('''''<nowiki>[[File:Example.jpg|200px]]</nowiki>''''')，加入图片说明('''''<nowiki>[[File:Example.jpg|图片1]]</nowiki>''''')，设置方框效果('''''<nowiki>[[File:Filename.jpg|thumb]]</nowiki>''''')。<br/>
+=== 清除页面缓存 ===
+DefaultSettings.php 中,找到参数'''''$wgCacheEpoch'''''，将参数值置为当前时间，可以取消全部已经缓存的页面（包括客户端和服务器端）。
+<pre>
+/**
+ * Set this to current time to invalidate all prior cached pages. Affects both
+ * client-side and server-side caching.
+ * You can get the current date on your server by using the command:
+ * @verbatim
+ *   date +%Y%m%d%H%M%S
+ * @endverbatim
+ */
+$wgCacheEpoch = '20030516000000';
+</pre>
+== 其他配置 ==
 === 修改导航栏 ===
 通过wiki地址 ''index.php?title=MediaWiki''（ [http://wiki.eijux.com/index.php?title=MediaWiki:Sidebar MediaWiki:Sidebar] ）,或者在搜索栏中输入“mediawiki:sidebar”，进入页面后点击编辑即可。<br/>
@@ 第80行： / 第104行： @@
 通过首页中”创建用户”注册的用户默认不属于任何用户组；<br/>
 从属于行政员用户组的用户，可通过”特殊页面” -> “用户权限管理”给其他用户分配用户组。
-=== 清除页面缓存 ===
-DefaultSettings.php中,找到参数'''''$wgCacheEpoch'''''，将参数值置为当前时间，可以取消全部已经缓存的页面(包括客户端和服务器端)。
-<pre>
-/**
- * Set this to current time to invalidate all prior cached pages. Affects both
- * client-side and server-side caching.
- * You can get the current date on your server by using the command:
- * @verbatim
- *   date +%Y%m%d%H%M%S
- * @endverbatim
- */
-$wgCacheEpoch = '20030516000000';
-</pre>