WordPress 中文文档

From WordPress Chinese

DefaultSettings.php是MediaWiki系统中存放默认设置的文件，位于/includes目录中。

DefaultSettings与LocalSettings

调用顺序

在mediawiki系统中，将首先调用本文件进行通用的初始设置，然后再调用LocalSettings.php进行变量修改（以适应不同站点的需要）。

修改方式

对于需要修改的设置，请对LocalSettings.php进行设定/修改，而不是直接修改DefaultSettings.php。这样做的好处是以后升级mediawiki系统时，可以方便地进行文件替换。

DefaultSettings中的内容

通过对DefaultSettings.php的阅读，我们可以了解大量的系统设置信息，而这其中很多内容是目前缺乏详细中文介绍的。

以下是DefaultSettings.php中包含的部分设置介绍：（无版本说明时均指适用于mediawiki 1.8.x以上版本）

性能相关设置

$wgUseDatabaseMessages

使用数据库存储界面提示信息，默认为使用。本项特性可以方便界面信息的修改，见specail:allmessages页面，但是将明显增大数据库的开销，导致页面加载速度增加25-60%；memcached功能才可以有效减轻本项带来的开销。然而，关闭时会造成界面信息修改的极大不便，不建议关闭它。（欢迎补充资料）

$wgShowIPinHeader

在网页上显示匿名用户的IP。默认打开，即显示IP

$wgUseFileCache

对匿名用户访问的页面进行静态页面存储，须关闭$wgShowIPinHeader。本项可降低数据库压力，（欢迎补充资料）

$wgMiserMode

关闭部分对数据库负载很大的特性，包括短页面等？实际影响不明。（欢迎补充资料）。默认未关闭这些操作。

$wgDisableQueryPages

对查询功能的控制。如果$wgMiser=true则禁止所有查询，否则只禁止一部分。

$wgDisableCounters、$wgDisableTextSearch、$wgDisableSearchContext

禁用计数器、文本搜索、全文搜索。默认未关闭上述功能。

$wgHitcounterUpdateFreq

页面访问计数器的更新频率，可用于减小服务器压力？（欢迎补充资料）默认为1，即每次访问都更新。

系统安全相关

$wgGroupPermissions、$wgRestrictionTypes、$wgAutoConfirmAge等

用户权限设置，参见mediawiki的用户权限

$wgSpamRegex = false;

用于识别spam信息的正则表达式，参见Mediawiki下对垃圾网址的处理方法。

$wgRestrictionTypes = array( 'edit', 'move' );

页面保护包含的操作类型

$wgRestrictionLevels = array( , 'autoconfirmed', 'sysop' );

设定Special:Protect页面中可被选择的permission keys集合。如果$wgAutoConfirmAge = 0，选择'autoconfirm'将允许所有注册用户操作。

$wgAutoConfirmAge = 0;

用户注册帐号之后，需要经过XX秒才能被系统认为获得'autoconfirm'群组身份。

$wgRateLimits = array(...

修改频度控制，[[Mediawiki 1.8">mediawiki 1.8</a>版本尚处于试验期。<font color="#FF8000|mediawiki 1.8]]版本尚处于试验期。（欢迎补充资料）

$wgRateLimitLog = null;

过分频繁修改的记录

$wgRateLimitsExcludedGroups = array( 'sysop', 'bureaucrat' );

不受编辑频度限制的群组

$wgAllowSpecialInclusion = true;

允许包含特殊页面，例如

$wgReservedUsernames = array( 'MediaWiki default', 'Conversion script' );

禁止被注册和使用的用户名，可用于系统保留特定用户名。注意：使用时对大小写敏感，即AAA和Aaa是不同的用户，保留用户名时应留意。（同时，系统默认对首字母进行大写，allwiki会转换为Allwiki再进行注册）

$wgUseRCPatrol = true;

是否允许在最近更新中对恶意破坏进行审核标记

$wgAntivirus、$wgAntivirusSetup、$wgAntivirusRequired等

对于上传文件的病毒扫描设置。默认没有扫描操作。

搜索相关设置

$wgGoToEdit = false;

在搜索文章名称时，若文章不存在则直接转到编辑页面。默认未使用。

$wgDisableInternalSearch = false;

禁止内部基于MySQL的搜索，以便采用外部的搜索扩展

$wgSearchForwardUrl = null;

将内部搜索信息转换为外部搜索链接，例如使用Google来辅助搜索功能：

$wgSearchForwardUrl = 'http://www.google.com/search?q=$1' . '&domains=http://example.com' . '&sitesearch=http://example.com' . '&ie=utf-8&oe=utf-8';</pre>

$wgNoFollowLinks = true;

对外部链接增加nofollow参数，以使搜索引擎不能继续沿该链接搜索下去，从而避免spam的干扰。参见nofollow说明。

$wgNoFollowNsExceptions = array();

禁用nofollow的名字空间。这可能用于网站系统中被保护的系统页面。

$wgNamespaceRobotPolicies = array();

不同名字空间下对robot的策略设定，例如

$wgNamespaceRobotPolicies = http://www.php.net/array">( NS_TALK => 'noindex' );</pre>

上传、图片相关设置

具体使用请参见mediawiki的图像功能，这里仅列出变量名称

$wgEnableUploads = false;

$wgUseImageResize = false;

$wgMaxUploadSize

上传文件的最大体积限制，默认为100M。此设置还受服务器环境限制？（欢迎补充资料）

该参数还受到了 php.ini 中 upload_max_filesize 的参数影响。（我本机是wamp，php.ini位于 安装目录\Apache2\bin下）

$wgHashedSharedUploadDirectory

上传文件是否采用Hash目录方式（images/a/aa/filename）存放。默认采用Hash方式，这样有助于网站安全，避免恶意使用者猜测到文件的具体存放位置。如希望只存在images目录下，本选项应设为false。

$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg' );

$wgFileBlacklist

$wgUploadSizeWarning = 150 * 1024;

上传文件的大小超过此值时会产生警告

$wgAllowCopyUploads = false;

是否允许指定外部网站图片URL网址来上传文件。默认关闭。

$wgImageLimits = array (...

图像描述页中使用的图片大小，归一化大小可以节省磁盘占用？（欢迎补充资料）

$wgThumbLimits = array(...

限定图像缩略图的宽度，以节省磁盘占用。

$wgCategoryMagicGallery = true;

在分类页面中以画廊形式展示该分类下的图片页面，而不是采用文章链接形式展示

$wgCategoryPagingLimit = 200;

分类页面中每页最多展示的项数

$wgDjvuToXML、$wgDjvuRenderer、$wgDjvuPostProcessor等

Djvu图像格式支持。目前应用很少，一般可不理会。

$wgThumbnailScriptPath = false;

$wgSharedThumbnailScriptPath = false;

$wgUseImageMagick = false;

$wgImageMagickConvertCommand = '/usr/bin/convert';

$wgCustomConvertCommand = false;

$wgSVGConverters = array(...

$wgSVGConverter = 'ImageMagick';

$wgSVGConverterPath = ;

$wgSVGMaxSize = 1024;

$wgMaxImageArea = 1.25e7;

$wgGenerateThumbnailOnParse = true;

名字空间相关

$wgNamespacesWithSubpages

允许建立子页面的名字空间

$wgNamespacesToBeSearchedDefault

进行检索时默认包含的名字空间

$wgExtraNamespaces = NULL;

扩充名字空间，举例如下：

$wgExtraNamespaces = http://www.php.net/array">(100 => "Sport", 101 => "Sport_Talk", 102 => "System", 103 => "System_Talk" );</pre>

注意：一旦设定又取消扩充的名字空间，则该名字空间下建立的文章将无法继续被访问。但对名字空间进行改名则没问题，仅仅是采用新的名字空间来访问相应文章而已。

用户自定义的名字空间应从100开始，避免与系统内定的名字空间冲突。正文页面使用偶数，讨论页使用奇数。

$wgSitename = 'MediaWiki';

站点名称。本项在LocalSettings.php中被重新定义。

$wgMetaNamespace = false;

project namespace的名称。若保持false状态，将使用 $wgSitename 来代替。

$wgMetaNamespaceTalk = false;

project talk namespace的名称。若保持false状态，则将使用由project namespace衍生出来的名称。本设定仅在少量特殊语种中因为语法原因而进行修改，否则一般无需调整。

页面提示相关

$wgSiteNotice

每个页面中都会显示的提示信息，指定字串将出现于文章标题上方。

$wgMaxCredits = 0;

文章贡献者的提示数量。修改为非零数值N后就在文章底部显示N个贡献者信息。

【版权相关内容】

$wgRightsPage

$wgRightsUrl

$wgRightsText

$wgRightsIcon

$wgCopyrightIcon

【界面js/CSS定制相关】

$wgAllowUserJs = false;

$wgAllowUserCss = false;

$wgUseSiteJs = true;

$wgUseSiteCss = true;

$wgAllowPageInfo = false;

对页面进行action=info操作，可以显示如下信息。由于开销比较大，默认关闭此特性。

• Number of watchers: 0
• Number of edits (article): 4
• Number of distinct authors (article): 2

</pre>

$wgSiteSupportPage

网站捐助页面的标题。在使用数据库信息时，应通过mediawiki:sitesupport-url项来修改。

$wgUseCategoryBrowser

一个处于测试期的分类功能，可以在分类信息内显示更多的层级关联信息。默认关闭。

$wgExtraSubtitle

作用不明。（欢迎补充资料）

文章编辑相关

$wgCapitalLinks = true;

文章名称若为英文字母，则自动转换为大写。

$wgLegalTitleChars

文章标题中的允许字符。标题中禁止出现“[]{}|#”符号，“%?+”是否正常起作用则随服务器环境设置而有所不同。

$wgMaxNameChars

用户名的最大字节数

$wgMaxArticleSize

文章最长KB数。默认为2048KB。

$wgUserHtml = true;

允许在wiki文本中使用部分比较安全的html代码。参见mediawiki允许的html代码。

$wgRawHtml = false;

允许使用所有html代码。这会导致很大的潜在危险，因为可能有人利用此特性发布恶意代码或对网站进行攻击。默认不开放全部html代码的权限。

$wgUseTidy = false;

使用Tidy对用于输入的html代码进行语法检查/修正。若使用此特性时还要对DefaultSettings.php中更多相关变量进行设置。

$wgMaxTocLevel = 999;

目录中的最大缩进层数

$wgExternalDiffEngine = false;

是否使用外部的版本比较工具

$wgUseETag

Template:?作用不明

杂类设置

$wgDefaultUserOptions

用户默认参数设置，包括编辑区大小设定、最近更新的范围等

$wgLocaltimezone = null;

$wgLocalTZoffset = null;

时间信息设定，参见mediawiki的时区设置。

$wgUseTrackbacks = false;

是否打开trackback功能。如果打开，则会在左侧工具栏中出现Trackback链接，具体作用不详。（欢迎补充资料）

$wgUseExternalEditor = true;

启用外部文本编辑器。参见 [" rel="nofollow|http://meta.wikimedia.org/wiki/Help:External_editors]

$wgSortSpecialPages = true;

Special:Specialpages里面是否对特殊页面进行排序

$wgDisableLangConversion = false;

是否禁止语言变种转换，例如繁体中文/简体中文的转换。

Cache/Squid、Cookie/Session、Interwiki、Debug/Profiling/Log、Proxy防范、系统内存/文件大小、编码相关设置

复杂功能，介绍从略

路径信息、电子邮件信息、数据库帐号信息

这些内容在LocalSettings.php中被重新设定，此处介绍从略。

多wiki站点、Interwiki相关设置

$wgUseSharedUploads、wgSharedDB等

多wiki站点共享上传文件、共享数据库等的设置

$wgUploadNavigationUrl = false;

指定外部图像服务器进行上传的网址，例如维基百科使用如下设置上传到公用资源服务器：

$wgUploadNavigationUrl = '[" rel="nofollow|http://commons.wikimedia.org/wiki/Special:Upload']; </pre>

$wgRepositoryBaseUrl="[" rel="nofollow">http://commons.wikimedia.org/wiki/Image</a>:|http://commons.wikimedia.org/wiki/Image]

";

指定资源服务器的Base URL，作用不明。（欢迎补充资料）

$wgInterwikiMagic = true;

Treat language links as magic connectors, not inline links

$wgHideInterlanguageLinks = false;

侧栏中是否隐藏跨语言链接

Ajax相关设置

$wgUseAjax = false;

是否使用[[Ajax">Ajax</a>特性，<font color="#FF8000|Ajax]]特性，具体作用不详。（欢迎补充资料）

$wgAjaxSearch = false;

是否打开搜索条的自动建议提示功能，具体作用不详。（欢迎补充资料）

$wgAllowDisplayTitle = false ;

是否允许DISPLAYTITLE在显示中改变文章标题，具体作用不详。（欢迎补充资料）

参考资料

• mediawiki的系统设置
• LocalSettings.php
• mediawiki的系统界面