Extension:巴別

MediaWiki扩展手册

Babel 发行状态： 穩定版
实现	解析器函数
描述	添加解析器函数以通知其他用戶語言熟練程度並對具有相同級別和語言的用戶進行分類。
作者	Robert Leverington (RobertL讨论)
最新版本	Continuous updates
兼容性政策	master分支维持向后兼容。
MediaWiki	1.36+
数据库更改	是
Composer	mediawiki/babel
表	babel
许可协议	GNU通用公眾授權條款2.0或更新版本
下載	包括于语言扩展捆绑中 下載扩展 Git [?]: 下载Git master 浏览存储库 (Phabricator · GitHub) 提交历史 repository contributors (GitHub) 代码复核
示例	Translatewiki.net
參數 $wgBabelMainCategory $wgBabelCategorizeNamespaces $wgBabelDefaultLevel $wgBabelCentralDb $wgBabelAutoCreate $wgBabelCategoryNames $wgBabelAllowOverride $wgBabelUseUserLanguage
使用的函数钩 LinksUpdate LoadExtensionSchemaUpdates ParserFirstCallInit UserGetReservedNames
季度下載量	109 (Ranked 76th)
正在使用的公开wiki数	2,416 (Ranked 192nd)
前往translatewiki.net翻譯Babel扩展
問題	开启的任务 · 报告错误

Babel扩展添加解析器函数以替換掉完全依賴模板的“舊”语文系統。如果指定了某個無法識別的語言參數，則它將查看是否存在具有該名稱的現有模板然後將它包括進來。

在维基媒体项目中，名词Babel（巴別）（參考自巴別塔）指的是用户页面上的文本，它帮助人们更容易地与说某种语言的人联系，从而帮助多语言交流。 这个想法起源于維基媒體共享資源，并已在许多其他wiki上实现。

下載

此扩展可直接从Git检索到 ^[?]:

• 浏览代码
• 部分扩展有稳定版本标签。
  • 浏览标签
  • 选择标签
  • 点击“快照”
• 每个分支与过去的MediaWiki发布版本相关联。 这里也有一个“主线”分支，包含最新alpha版本（可能需要MediaWiki的alpha版本）。
  • 浏览分支
  • 选择一个分支名称
  • 点击“继续”

提取快照，并将它放置在您的MediaWiki安装副本的extensions/Babel/目录中。

如果您对git熟悉，并且拥有您服务器的shell访问权，您也可以通过以下方法获得扩展：

cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Babel.git

安裝

• 下载文件，并将其放置在您extensions/文件夹中的Babel目录内。
• 将下列代码放置在您的LocalSettings.php 的底部：

  wfLoadExtension( 'Babel' );
  

• 运行更新脚本，它将自动创建此扩展必须依赖的数据库表。
• 根据需要配置。
•  完成 – 在您的wiki上导航至Special:Version，以验证已成功安装扩展。

• CSS位于文件resources/ext.babel.css中。可以通过在MediaWiki:Common.css页中重写样式，將它们改变成你想要的。
• 如果找到了拓展:CLDR 扩展，语言名称将取自该扩展（在翻译不可用的情况下），否则将使用内置的MediaWiki语言名称和英语默认值。

用法

#babel解析器函数的语法如下:

 {{#babel: babelcode1 | babelcode2 | ... }}

为您所说或理解的每种语言添加以下代码之一，以|分隔，其中xx是该语言的MediaWiki语言代码、ISO 639-1或ISO 639-3代码。 每个代码级别的一般用法如下:

xx-0：如果您对此种语言一窍不通。

xx-1：初级水平——您对此种语言的文章或簡單会话略懂一二。

xx-2：中等水平——足以进行编辑或讨论。

xx-3：高等水平——尽管你可以毫无问题地用这种语言写作，但仍難免有些小錯。

xx-4：近母语水平——虽然此种语言不是你的母语，但你基本可以达到母语者的水平。

xx-5：专业水平。

xx或xx-N：您是这种语言的母语用户，您天生就可以使用该语言的俗话和/或俚语。

要包含任何其他的模板，只需添加该模板的名称，例如，如果要包含Template:User CSS，请User CSS。 根据本地配置，可以将前缀或后缀添加到模板名称（例如，User）中。这可用于限制选择和缩短参数的长度；例如，CSS可以包括Template:User CSS，如果以这种方式配置的话。

要删除页眉和页脚，请使用plain=1作为第一个参数，例如{{#babel: plain=1 | babelcode1 | babelcode2 | ... }}。 这使得更容易与其他用户框一起使用语文。

配置

配置參數

语文有六个可以在LocalSettings.php 中修改的配置参数。

$wgBabelLanguageCodesCdb

（字符串）语言代码数据库文件的路径，默认值应该足够了。

$wgBabelLanguageNamesCdb

（字符串）语言代码数据库文件的路径，默认值应该足够了。

$wgBabelCategoryNames

（字符串或布尔数组，以字符串"1"、"2"、... "5"、"N "为索引），其中每个条目是其索引所表示的技能水平的类别名称，可能的变量元素是：%code%（语言代码），%wikiname%（维基内容语言中的语言名称），%nativename%（其语言中的语言名称）。要禁止为某一级别添加类别，请将相应的值设置为false。

例如：

$wgBabelCategoryNames = [
	'0' => 'User %code%-0',
	'1' => 'User %code%-1',
	'2' => 'User %code%-2',
	'3' => 'User %code%-3',
	'4' => 'User %code%-4',
	'5' => 'User %code%-5',
	'N' => 'User %code%-N',
];

将使用"Category:User en-0"和"Category:User fr-N"等分类。默认值是"Category:Fr-N"，依此类推。

$wgBabelMainCategory

（字符串）每种语言的主要（非级别）分类的名称，该语言的所有用户都被添加到该分类中。设置为false表示禁用；默认格式为 "Category:Fr"。它接受的格式与上面的$wgBabelCategoryNames相同。例如：

$wgBabelMainCategory = 'User %code%';

$wgBabelDefaultLevel

（字符串）当没有指定任何的能力之时，使用的默认能力级别，应该是一个从$wgBabelCategoryNames开始的索引，是"1","2", ... "5","N"中的一个字符串。默认为"N"。

$wgBabelUseUserLanguage

（布尔值）是否使用用户界面语言来表达页眉和页脚信息。如果是false（默认），将使用页面内容语言。这是因为使用用户界面语言可能会使解析器缓存碎片化。

$wgBabelCategorizeNamespaces

只对其添加自动分类的命名空间数组。 For example, if $wgBabelCategorizeNamespaces = [ NS_USER ];, then Babel will only add categories to pages in the user namespace. 默认为null，这意味着对所有命名空间进行分类。

$wgBabelCategoryOverride

是否允许在wiki上用MediaWiki:Babel-category-override覆盖Babel类别

$wgBabelAutoCreate

是否自动创建分类页。

系统消息

还可以使用MediaWiki命名空间自定义一些系统消息。

MediaWiki:babel-template "Template:User $1"

当包含一个模板时，模板名称的格式。

MediaWiki:babel-portal ""

来自语言代码的链接目标的格式。 Set to the empty string to not link the language code.

MediaWiki:Babel-autocreate-user "Babel AutoCreate"

用于自动创建Babel相关类别的用户名

MediaWiki:babel-autocreate-text-levels "此分类中的用户表示他们具有$2的$1级能力。"

用于插入不同语言级别的自动创建的类别中的文本。如果你想让它们自动归入各自语言的主要类别（$wgBabelMainCategory），你必须改变这个。

MediaWiki:babel-autocreate-text-main "此分类中的用户能理解$1。"

在自动创建的类别中插入非级别类别的文本。如果你想让它们在所有语言的父类中自动归类，你必须改变这个。

MediaWiki:babel "用户巴别信息"

babel框的页顶 Set to - to not display a header.

MediaWiki:babel-url "Project:巴别"

可以找到有关Babel扩展信息的页面名称 Set to - to display no link in the header.

MediaWiki:Babel-footer "用户（按语言）"

babel框的页脚。 Set to - to not display a footer.

MediaWiki:babel-footer-url " :Category:巴别-用户（按语言）"

在巴别框的页脚中链接到的页面

MediaWiki:Babel-category-override "$1"

覆盖任何自动生成的Babel类别。 参数：
$1 = the category that would be generated normally.
$2 = the language code
$3 is the babel level.
使用这种方法覆盖的任何类别将不会被自动创建，以减少对该页面的破坏或错误编辑的风险。

meta=babel (bab)

(main | query | babel)

• This module requires read rights.
• Source: Babel
• License: GPL-2.0-or-later

Get information about what languages the user knows

Specific parameter:

Other general parameters are available.

babuser

User to get information about

This parameter is required.

Type: user, by any of username, IP, IP range and interwiki name (e.g. "prefix>ExampleName")

Example:

Get the Babel information for user Example

api.php?action=query&meta=babel&babuser=Example [open in sandbox]