allwiki首页  
天下维客 你可以修改的网络知识库
首页最近更改优秀条目专题展示电脑科技词典软件学习网络知识电脑安全明星时尚天下百科
 

Localsettings.php

天下维客,你可以修改的网络知识库

(重定向自Mediawiki的本地化)
Jump to: navigation, search
mediawiki简明设置教程 提示信息修改 清空页面缓冲 修改网站LOGO 图像功能使用 修改左侧导航条
LocalSettings.php修改 贡献者列表 时间显示设置 增加Google广告 改用/wiki/式网址 增加友情链接侧栏
LocalSettings.php DefaultSettings.php 系统界面 搜索结果中新建页面 新窗口打开外部链接 总目录


下文是本地化过程的细节描述,建议首先参考更简明的mediawiki建站综述页面,缺少所需定制细节再来阅读本文。提问或交流请到mediawiki建站的讨论页



目录

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影响内部文本中的自动链接,设置错误时会导致点击内部链接时跑飞;但在浏览器中输入通用模式路径(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中包含使用上述特征时用到的用户登录名称和密码。


图片上传

  • $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版本通过测试:



$wgGroupPermissions = array();
// Implicit group for all visitors
$wgGroupPermissions['*'    ]['createaccount']   = true;
$wgGroupPermissions['*'    ]['read']            = true;
$wgGroupPermissions['*'    ]['edit']            = true;
$wgGroupPermissions['*'    ]['createpage']      = true;
$wgGroupPermissions['*'    ]['createtalk']      = false;
// Implicit group for all logged-in accounts
$wgGroupPermissions['user' ]['move']            = true;
$wgGroupPermissions['user' ]['read']            = true;
$wgGroupPermissions['user' ]['edit']            = true;
$wgGroupPermissions['user' ]['createpage']      = true;
$wgGroupPermissions['user' ]['createtalk']      = false;
$wgGroupPermissions['user' ]['upload']          = true;
$wgGroupPermissions['user' ]['reupload']        = true;
$wgGroupPermissions['user' ]['reupload-shared'] = true;
$wgGroupPermissions['user' ]['minoredit']       = true;
$wgAllowExternalImages = true;

</pre>

Personal tools
工具