Jump to content

Extension:巴別

本頁使用了標題或全文手工轉換
From mediawiki.org
This page is a translated version of the page Extension:Babel and the translation is 97% complete.
MediaWiki扩展手册
Babel
发行状态: 稳定版
实现 解析器函数
描述
添加解析器函数以通知其他用戶語言熟練程度並對具有相同級別和語言的用戶進行分類。
作者 Robert Leverington (RobertL留言)
最新版本 持续更新
兼容性政策 master分支维持向后兼容。
MediaWiki >= 1.41.0
数据库更改
Composer mediawiki/babel
babel
许可协议 GNU通用公眾授權條款2.0或更新版本
下載 包含在语言扩展包中
示例 Translatewiki.net
  • $wgBabelMainCategory
  • $wgBabelAutoCreate
  • $wgBabelDefaultLevel
  • $wgBabelCategorizeNamespaces
  • $wgBabelUseUserLanguage
  • $wgBabelCentralDb
  • $wgBabelCategoryNames
  • $wgBabelUseCommunityConfiguration
  • $wgBabelAllowOverride
季度下載量 66 (Ranked 71st)
正在使用的公开wiki数 2,416 (Ranked 192nd)
前往translatewiki.net翻譯Babel扩展
問題 开启的任务 · 报告错误

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

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

安裝

  • 下载文件,并将解压后的Babel文件夹移动到extensions/目录中。
    开发者和代码贡献人员应从Git安装扩展,输入:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Babel
  • 将下列代码放置在您的LocalSettings.php 的底部:
    wfLoadExtension( 'Babel' );
    
  • 运行更新脚本,它将自动创建此扩展必须依赖的数据库表。
  • 按需求配置。
  • Yes 完成 – 在您的wiki上导航至Special:Version,以验证已成功安装扩展。
  • CSS位于文件resources/ext.babel.css中。可以通过在MediaWiki:Common.css页中重写样式,將它们改变成你想要的。
  • 如果找到了CLDR 扩展,语言名称将取自该扩展(在翻译不可用的情况下),否则将使用内置的MediaWiki语言名称和英语默认值。

用法

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

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

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

xx-0:如果您对此种语言一窍不通。
xx-1:初级水平——您对此种语言的文章或簡單会话略懂一二。
xx-2:中等水平——足以进行编辑或讨论。
xx-3:高等水平——尽管你可以毫无问题地用这种语言写作,但仍難免有些小錯。
xx-4:近母语水平——虽然此种语言不是你的母语,但你基本可以达到母语者的水平。
xx-5:专业水平。
xxxx-N:您是这种语言的母语用户,您天生就可以使用该语言的俗话和/或俚语。

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

Parameters

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

To hide categories, use the nocat=1 parameter as the first parameter, e.g., {{#babel: nocat=1 | babelcode1 | babelcode2 | ... }}.

Please note that only one of the parameters above is allowed. At the moment, it is not possible to use both parameters; for example, {{#babel: nocat=1 | plain=1 | babelcode1 | babelcode2 | ... }} will not work.

Categorization

If categorization is enabled, the extension creates categories using the Babel AutoCreate bot with the text specified in MediaWiki:babel-autocreate-text-levels and MediaWiki:babel-autocreate-text-main. With basic settings, the categories that the bot creates are not categorized, and to fix this, it is recommended to do the following:

  1. Create a template {{Babel category }} that will generate categories.
  2. Replacing text on MediaWiki:babel-autocreate-text-levels with
    {{Babel category|level=$1|language=$2|ISO=$3}}
    
  3. Replacing text on MediaWiki:babel-autocreate-text-main with
    {{Babel category|language=$1|ISO=$2}}
    

This will allow you to categorize categories automatically, and if something happens, you can simultaneously replace the categorization and text in all categories.

配置

配置参数

语文有六个可以在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
只对其添加自动分类的命名空间数组。 例如,如果配置 $wgBabelCategorizeNamespaces = [ NS_USER ];,那么 Babel 将只向用户命名空间中的页面添加分类。 默认为null,这意味着对所有命名空间进行分类。
$wgBabelCategoryOverride
是否允许在wiki上用MediaWiki:Babel-category-override覆盖Babel类别
$wgBabelAutoCreate
是否自动创建分类页。

系统消息

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

MediaWiki:babel-template "Template:User $1"
当包含一个模板时,模板名称的格式。
MediaWiki:babel-portal ""
来自语言代码的链接目标的格式。 设置为空字符串以不链接语言代码。
MediaWiki:Babel-autocreate-user "Babel AutoCreate"
用于自动创建Babel相关类别的用户名
MediaWiki:babel-autocreate-text-levels "此分类中的用户表示他们具有$2的$1级能力。"
用于插入不同语言级别的自动创建的类别中的文本。如果你想让它们自动归入各自语言的主要类别($wgBabelMainCategory),你必须改变这个。
MediaWiki:babel-autocreate-text-main "此分类中的用户能理解$1。"
在自动创建的类别中插入非级别类别的文本。如果你想让它们在所有语言的父类中自动归类,你必须改变这个。
MediaWiki:babel "用户巴别信息"
babel框的页顶 设置为 - 将不显示标题。
MediaWiki:babel-url "Project:巴别"
可以找到有关Babel扩展信息的页面名称 设置为 - 可在标题中不显示任何链接。
MediaWiki:Babel-footer "用户(按语言)"
babel框的页脚。 设置为 - 将不显示页脚。
MediaWiki:babel-footer-url " :Category:巴别-用户(按语言)"
在巴别框的页脚中链接到的页面
MediaWiki:Babel-category-override "$1"
覆盖任何自动生成的Babel类别。 参数:
$1 = 正常生成的分类。
$2 = 语言代码
$3 = babel 级别。
使用这种方法覆盖的任何类别将不会被自动创建,以减少对该页面的破坏或错误编辑的风险。

API

meta=babel (bab)

(main | query | babel)

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, Temporary user, 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]