Open main menu

Extension:Babel

This page is a translated version of the page Extension:Babel and the translation is 29% complete.
Other languages:
Deutsch • ‎English • ‎Lëtzebuergesch • ‎Sassaresu • ‎Scots • ‎asturianu • ‎dansk • ‎español • ‎français • ‎italiano • ‎lietuvių • ‎magyar • ‎polski • ‎português • ‎português do Brasil • ‎sicilianu • ‎български • ‎русский • ‎हिन्दी • ‎中文 • ‎日本語 • ‎ꯃꯤꯇꯩ ꯂꯣꯟ • ‎조선말 • ‎한국어
MediaWiki 拡張機能マニュアル
OOjs UI icon advanced.svg
Babel
リリースの状態: 安定
Babel-extension-screenshot.png
実装 パーサー拡張機能
説明 利用者の言語の理解度について他の利用者に知らせ、言語別・習熟度別にカテゴリ分けする、パーサー関数を追加する。
作者 Robert Leverington (RobertLtalk)
最新バージョン Continuous updates
MediaWiki 1.30+
データベースの変更 はい
Composer mediawiki/babel
テーブル babel
ライセンス GNU 一般公衆利用許諾書 2.0 以降
ダウンロード 言語拡張機能バンドルに含まれます
Translatewiki.net
  • $wgBabelCategorizeNamespaces
  • $wgBabelCategoryNames
  • $wgBabelMainCategory
  • $wgBabelDefaultLevel
  • $wgBabelUseUserLanguage
  • $wgBabelUseDatabase
  • $wgBabelCentralDb
  • $wgBabelCentralApi
translatewiki.net で翻訳を利用できる場合は、Babel 拡張機能の翻訳にご協力ください
使用状況とバージョン マトリクスを確認してください。
問題点 未解決のタスク · バグを報告

The Babel extension adds a parser function to replace the old Babel system that completely relied on templates. If an unrecognized language parameter is specified, it will see if there is an existing template with the name and include that.

On Wikimedia projects, the noun Babel (in reference to the Tower of Babel) refers to the texts on user pages aiding multilingual communication by making it easier to contact someone who speaks a certain language. The idea originated on the Wikimedia Commons and has also been implemented on many other wikis.

ダウンロード

拡張機能は、Git から直接取得できる場合があります [?]:

  • コードを参照
  • 一部の拡張機能には安定版リリースのタグがあります。
    • タグを参照
    • タグを選択します
    • 「スナップショット」をクリックします
  • 各ブランチは過去の MediaWiki リリースと関連付けられています。 最新のアルファ バージョンを含む「master」ブランチもあります (MediaWiki のアルファ バージョンが必要な場合用)。

スナップショットを展開して、MediaWiki インストレーション内の extensions/Babel/ ディレクトリに配置します。

git に馴染みがあり、かつサーバーにシェルでアクセスできる場合は、拡張機能を以下のようにして取得することもできます:

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

インストール

  • ダウンロードして、ファイルを extensions/ フォルダー内の Babel という名前のディレクトリ内に配置します。

MediaWiki 1.25 以前を稼働させている利用者へ:

上記の手順では、wfLoadExtension() を使用してこの拡張機能をインストールする新しい方法を記載しています。 この拡張機能をこれらの過去のバージョン (MediaWiki 1.25 以前) にインストールする必要がある場合は、wfLoadExtension( 'Babel' ); の代わりに以下を使用する必要があります:

require_once "$IP/extensions/Babel/Babel.php";
  • The CSS is located in the file resources/ext.babel.css. You can change the style as desired by overriding them in the page MediaWiki:Common.css.
  • If the CLDR extension is found language names are taken from that (where translations are unavailable), otherwise built in MediaWiki language names and English defaults are used.

使用法

パーサー関数 #babel の構文は以下の通りです:

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

Add one of the following codes for each language you speak or understand, separated by |, where xx is the MediaWiki language code, ISO 639-1 code, or ISO 639-3 code for the language. The general usage of each code level is as follows:

xx-0
If you don't understand the language at all.
xx-1
Basic ability - enough to understand written material or simple questions in this language.
xx-2
Intermediate ability - enough for editing or discussions.
xx-3
Advanced level - though you can write in this language with no problem, some small errors might occur.
xx-4
"Near-native" level - although it's not your first language from birth, your ability is something like that of a native speaker.
xx-5
Professional proficiency.
xx or xx-N
Native speakers who use a language every day and have a thorough grasp of it, including colloquialisms and idioms.

To include any other template, simply add the name of the template, e.g. add User from London if you want to include Template:User from London. A prefix or suffix may be added to template names (e.g. User at the beginning) depending on the local configuration, this can be used to restrict the selection and reduce the length of parameters; for example from London could include Template:User from London if configured in such a way.

To remove the header and footer, use plain=1 as the first parameter, e.g. {{#babel: plain=1 | babelcode1 | babelcode2 | ... }}. This makes it easier to use babel with other userboxes.

設定の構成

Configuration parameters

Babel has six configuration parameters which can be modified in LocalSettings.php .

$wgBabelLanguageCodesCdb 
(string) the path of the language code database file, the default should suffice.
$wgBabelLanguageNamesCdb 
(string) the path of the language name database file, the default should suffice.
$wgBabelCategoryNames 
(array of string or boolean, indexed by the strings "1", "2", … "5", "N") where each entry is the name of a category for the skill level indicated by its index, possible variable elements are: %code% (language code), %wikiname% (the name of the language in the wiki's content language), and %nativename% (the name of the language in its language). To disable adding a category for a particular level, set the corresponding value to 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',
];
will use categories like "Category:User en-0" and "Category:User fr-N". The default is just "Category:Fr-N" and so on.
$wgBabelMainCategory 
(string) Name of the main (non-level) category for each language, to which all users of that language are added. Set to false to disable; defaults to format "Category:Fr". It accepts the same format as $wgBabelCategoryNames above. Example:
$wgBabelMainCategory = 'User %code%';
$wgBabelDefaultLevel 
(string) Default ability level to use when none is specified, should be an index from $wgBabelCategoryNames, that is one of the strings "1", "2", … "5", "N". Default is "N".
$wgBabelUseUserLanguage 
(boolean) Whether to use the user interface language for the header and footer message. If false (default), it will be in the page content language. This is because using the user interface language may fragment the parser cache.

System messages

Several customizations can also be made using MediaWiki namespace messages.

MediaWiki:babel-template "Template:利用者 $1"
テンプレートを参照読み込みする際のテンプレート名の書式
MediaWiki:babel-portal "⧼babel-portal⧽"
The format of the target of the link from the language code.
MediaWiki:Babel-autocreate-user "バベル自動作成係"
バベルに関連するカテゴリの自動作成に使用する利用者名
MediaWiki:babel-autocreate-text-levels "このカテゴリに属している利用者は$2についてレベル $1 の能力を有しています。"
Text to insert into auto-created categories for different language levels. You have to change this if you want them to be auto-categorized in the main category of the respective language ($wgBabelMainCategory).
MediaWiki:babel-autocreate-text-main "このカテゴリに属している利用者は、自身の$1の言語能力について、表明しています。"
Text to insert into auto-created categories for non-level categories. You have to change this if you want them to be auto-categorized in a parent category for all languages.
MediaWiki:babel "バベル利用者情報"
バベル ボックスのヘッダー
MediaWiki:babel-url "Project:バベル"
The pagename where information on the babel extension can be found
MediaWiki:Babel-footer "言語別の利用者"
バベル ボックスのフッター
MediaWiki:babel-footer-url " :カテゴリ:バベル - 言語別の利用者"
The page to link to in the footer of the babel box

API

meta=babel (bab)

(main | query | babel)

Get information about what languages the user knows

Parameter:
babuser

User to get information about

This parameter is required.
Type: user name
Example:
Get the Babel information for user Example
api.php?action=query&meta=babel&babuser=Example [open in sandbox]