Extensão:Babel
Babel Estado da versão: estável |
|||
---|---|---|---|
![]() |
|||
Implementação | Parser extension | ||
Descrição | Adds a parser function to inform other users about language proficiency and categorize users of the same levels and languages. | ||
Autor(es) | Robert Leverington (RobertLtalk) | ||
Última versão | Continuous updates | ||
MediaWiki | 1.30+ | ||
Alterações à base de dados |
Não | ||
Composer | mediawiki/babel | ||
Licença | GNU General Public License 2.0 or later | ||
Exportação (Download) | Included in Language Extension Bundle | ||
Exemplo | Translatewiki.net | ||
|
|||
|
|||
Traduza a extensão Babel se ela estiver disponível na wiki translatewiki.net | |||
Verifique a matriz de utilização e versões | |||
Problemas | Tarefas em aberto · Reportar um problema |
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.
Contents
Download
The extension can be retrieved directly from Git [?]:
- Browse code
- Some extensions have tags for stable releases.
- Browse tags
- Select the tag
- Click "snapshot"
- Each branch is associated with a past MediaWiki release. There is also a "master" branch containing the latest alpha version (might require an alpha version of MediaWiki).
- Browse branches
- Select a branch name
- Click "Continue"
Extract the snapshot and place it in the extensions/Babel/ directory of your MediaWiki installation.
If you are familiar with git and have shell access to your server, you can also obtain the extension as follows:
cd extensions/
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/Babel.git
Installation
- Exporte e coloque o ficheiro, ou ficheiros, num diretório chamado
Babel
, na sua pastaextensions/
.
- Acrescente o seguinte código ao fundo do ficheiro LocalSettings.php:
wfLoadExtension( 'Babel' );
- Configure as required.
Pronto – Na página especial Special:Version da sua wiki verifique se a extensão foi instalada.
Para utilizadores que tenham o MediaWiki versão 1.25 ou anteriores:
As instruções acima descrevem a nova forma de instalar esta extensão, usando a extensão wfLoadExtension()
Se precisar de instalar esta extensão nestas versões anteriores (MediaWiki 1.25 e anteriores), em vez de wfLoadExtension( 'Babel' );
, use:
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 pageMediaWiki: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.
Uso
Syntax for the #babel
parser function is as follows:
{{#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
orxx-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.
Configuração
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.
- Por exemplo:
$wgBabelCategoryNames = array(
'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:Usuário $1
" - The format of template names when one is being included.
- MediaWiki:babel-portal "
⧼babel-portal⧽
" - The format of the target of the link from the language code.
- MediaWiki:Babel-autocreate-user "
Babel AutoCreate
" - Username to be used for autocreation of Babel related categories
- MediaWiki:babel-autocreate-text-levels "
Os utilizadores nesta categoria indicam que têm um nível de conhecimento $1 na língua $2.
" - 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 "
Os utilizadores nesta categoria indicam que têm conhecimentos da língua $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 "
Informação Babel do utilizador
" - The header of the babel box
- MediaWiki:babel-url "
Project:Babel
" - The pagename where information on the babel extension can be found
- MediaWiki:Babel-footer "
Utilizadores por língua
" - The footer of the babel box
- MediaWiki:babel-footer-url "
:Categoria:Babel - Utilizadores por língua
" - The page to link to in the footer of the babel box
API
meta=babel (bab)
- This module requires read rights.
- Source: Babel
- License: GPL-2.0-or-later
Get information about what languages the user knows
- babuser
User to get information about
- This parameter is required.
- Type: user name
- Get the Babel information for user Example
- api.php?action=query&meta=babel&babuser=Example [open in sandbox]
![]() | This extension is being used on one or more Wikimedia projects. This probably means that the extension is stable and works well enough to be used by such high-traffic websites. Look for this extension's name in Wikimedia's CommonSettings.php and InitialiseSettings.php configuration files to see where it's installed. A full list of the extensions installed on a particular wiki can be seen on the wiki's Special:Version page. |
- Pages using duplicate arguments in template calls
- GPL licensed extensions/pt
- Stable extensions/pt
- Parser extensions/pt
- Extensions supporting Composer/pt
- Extensions in Wikimedia version control/pt
- ParserFirstCallInit extensions/pt
- LinksUpdate extensions/pt
- LoadExtensionSchemaUpdates extensions/pt
- UserGetReservedNames extensions/pt
- All extensions/pt
- Extensions used on Wikimedia/pt
- Localisation extensions/pt