Mediawiki的本地化

wangsisi

LocalSettings.php的本地化定制

安装MediaWiki之后，生成的LocalSettings.php文件中自动记录了部分本地配置信息。多数mediawiki的参数设置改变，需要手动修改该文件。

Image:Allwiki notice.png对这个文件所做的手动修改需要记录一下，以便日后升级时重建这些设置。 Image:Allwiki notice.png为安全起见，请留意设置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=...方式）时仍能正常访问页面。
    在windows环境下安装mediawiki时，首页空白、首页计数错误问题可能与此变量设置有关。建议调试时改为通用模式，以检验是否是这个引起的问题。

典型设置如下：

"$wgScript/$1"     用/分隔符传递文章名称（默认）
"$wgScript?title=$1"     用参数传递文章名称（通用模式）。
"mypath/$1"     客户化路径。使用Apache的rewrite功能将"mypath"转换为合适路径

    * $wgStylePath指向Mediawiki中样式表(CSS)的存放路径。

    $wgStyleDirectory应指向同一位置，但这里是本地文件路径，用来使用内部脚本访问文件系统。

    * $wgLogo变量指定网站图标存放的相对URL路径（图标在默认模板下显示于网站首页左上角）。你可以修改这个变量，指向上传到网站空间的其他图片（也可不做修改，而直接替换/skins/common/images/wiki.png文件）。

    * $wgUploadPath指定存放上载文件的目录URL路径，$wgUploadDirectory指向对应本地文件系统路径。

    $wgUploadDirectory（略）

    * $wgEmergencyContact：收取网站异常消息的邮件帐号，主要是收取内部错误报告。应设为站长的联系邮箱。

    * $wgPasswordSender：当用户忘记密码需要查时，系统可从这个邮件地址发出密码提醒邮件。这个邮件地址请选用用户可以回复的邮件地址。

MediaWiki使用MySQL数据库存储页面、修改、用户信息等大量内容。

* $wgDBserver 运行MySQL数据库的宿主服务器名称。请根据实际情形进行设定，一般情况下服务商会使用"localhost"。

    $wgDBname 指定MediaWiki使用的数据库名称。
    $wgDBuser和$wgDBpassword：访问数据库时使用的用户登录名及密码。
    $wgDBprefix MediaWiki使用数据表的前缀，以便区分于公用同一MySQL数据库的其他程序。

    * $wgCapitalLinks：MediaWiki默认禁止使用小写字母开头的文章名称，如有需要可将其值改为false。（鉴于其他未确定的原因，不推荐这样做）

高级设置
直接SQL查询

    * $wgAllowSysopQueries：如果设为true，则可以通过Special:Asksql页面进行SQL查询操作。 这非常不安全，如果你希望管理员可以进行只读的的SQL操作，则需要定义一个权限受限的MySQL用户。

        * $wgDBsqluser和$wgDBsqlpassword中包含使用上述特征时用到的用户登录名称和密码。

    * 请参考 http://www.mysql.com/doc/en/GRANT.html" 了解MySQL系统中如何进行设定活动（英文）。

图片上传

    * $wgDisableUploads：默认为true，禁止通过浏览器界面上传文件。如需上传图片，请改为false，同时（通过FTP工具等方式）将上传目录设置为允许网络写入。(1.5.x之后,该选项变为$wgEnableUploads：先把前面的#去掉；和旧版本相反true是允许上传，false是禁止通过浏览器界面上传文件.)

    $wgUseImageResize：如果需要支持运行中改变图片大小（例如thumbnail缩略图功能），请设为true。
    $wgUseImageMagick：如果ImageMagick软件运行正常，请将本变量设为true。
    同时，请确认$wgImageMagickConvertCommand变量指向服务器运行convert命令的正确位置。

LaTeX行内公式

为处理LaTeX的数学公式，需要安装LaTeX、GhostView、GhostScript，以及Texvc。

正确安装上述软件之后，需要相应的修改配置文件。请删除$wgUseTeX=true前面的#号，并确认$wgMathPath、$wgMathDirectory和$wgTmpDirectory设置正确（如无意外，一般无需改动）。

支持InterWiki特性

MediaWiki已经内建了InterWiki支持，但需要配置在wiki内部链接中使用的前缀字串。这个前缀字串一般与$wgSitename相同，但可以通过$wgLocalInterwiki变量进行单独配置。

用户界面的语种

    * $wgLanguageCode：MediaWiki允许用户用多种语言进行本地化，替代掉默认的英文界面。安装时已经设定了本变量，一般无需再次改动。以下是中文地区常用的选项，更多语种参见language code。

        * 'en' => 标准英文界面

    * 'zh' => 繁简体共存的中文设置，包含zh-cn/zh-tw/zh-hk/zh-sg四个版本
    * 'zh-cn' => '中文(简体)'
    * 'zh-tw' => '中文(繁體)'
    * 'zh-hk' => '中文(繁體)'
    * 'zh-sg' => '中文(新加坡)'

用户界面通用模板

    * $wgDefaultSkin：用于改变系统默认的界面模板。美观起见可是用系统初始设置的monobook，速度起见建议换用cologneblue。

以下内容尚未得到本文贡献者的充分了解 </pre>

文件缓存

参见元维基的File cache条目。
* $wgUseLatin1
    * $wgProxyKey

站点版权设定

本节内容尚未得到完善的检验，以下为实验性的操作方法：

可以再LocalSettings.php中增加如下内容：

$wgRightsPage = "YourWiki:Copyright"; $wgRightsText = "copyright YourWiki"; </pre>

编辑[[MediaWiki:Copyright">MediaWiki:Copyright</a>页面以提供合适的信息，使用"$1|MediaWiki:Copyright]]页面以提供合适的信息，使用"$1"参数指向本地化的版权页面链接。

接下来的变量，可有可无。主要是网站最下方的显示本网站的协议，文本解释和图标

$wgRightsUrl = "http://www.gnu.org/copyleft/fdl.html""; $wgRightsText = "GNU Free Documentation License 1.2"; $wgRightsIcon = "${wgStylePath}/common/images/gnu-fdl.png"; </pre>

定制名字空间

参见元维基的Custom namespaces页面。

参见： [" rel="nofollow|http://meta.wikimedia.org/wiki/LocalSettings.php] 元维基的LocalSettings介绍（英文）

添加自己的名称空间。
* 在includes/Defines.php中设定名称空间常量
    * 整数100以前为wiki保留使用.
    * 奇数为talk
    * 如:define('NS_REQUIREMENT', 100); define('NS_REQUIREMENT_TALK', 101);

    * 在includes/DefaultSetting.php中,把定义的常量添加到$wgExtraNamespace数组中.
    * 这是一个关联数组
    * key为常量,value为字符串
    * 如$wgExtraNamespaces = array( NS_REQUIREMENT => "Requirement", NS_REQUIREMENT_TALK => "Ruquirement_Talk",);

DefaultSettings.php介绍
禁止讨论

改成如下代码，在1.6.5版本通过测试：

1. 
   
2. $wgGroupPermissions = array();
   
3. // Implicit group for all visitors
   
4. $wgGroupPermissions['*'    ]['createaccount']   = true;
   
5. $wgGroupPermissions['*'    ]['read']            = true;
   
6. $wgGroupPermissions['*'    ]['edit']            = true;
   
7. $wgGroupPermissions['*'    ]['createpage']      = true;
   
8. $wgGroupPermissions['*'    ]['createtalk']      = false;
   
9. // Implicit group for all logged-in accounts
   
10. $wgGroupPermissions['user' ]['move']            = true;
    
11. $wgGroupPermissions['user' ]['read']            = true;
    
12. $wgGroupPermissions['user' ]['edit']            = true;
    
13. $wgGroupPermissions['user' ]['createpage']      = true;
    
14. $wgGroupPermissions['user' ]['createtalk']      = false;
    
15. $wgGroupPermissions['user' ]['upload']          = true;
    
16. $wgGroupPermissions['user' ]['reupload']        = true;
    
17. $wgGroupPermissions['user' ]['reupload-shared'] = true;
    
18. $wgGroupPermissions['user' ]['minoredit']       = true;
    
19. $wgAllowExternalImages = true;
    

复制代码