Estensione:Babel

Manuale sulle Estensioni MediaWiki

Babel Stato della release: stabile
Implementazione	Parser function
Descrizione	Aggiunge una funzione parser per informare gli altri utenti riguardo le competenze linguistiche e categorizzare gli utenti con gli stessi livelli e lingue.
Autore(i)	Robert Leverington (RobertLdiscussione)
Versione	Aggiornamenti continui
Politica di compatibilità	Master maintains backward compatibility.
MediaWiki	>= 1.41.0
Modifiche al Database	Sì
Composer	mediawiki/babel
Tabelle	babel
Licenza	GNU General Public License 2.0 or later
Scaricare	Included in Language Extension Bundle Download extension Git [?]: Download Git master browse repository (Phabricator · GitHub) commit history repository contributors (GitHub) code review
Esempio	Translatewiki.net
Parametri $wgBabelMainCategory $wgBabelAutoCreate $wgBabelDefaultLevel $wgBabelCategorizeNamespaces $wgBabelUseUserLanguage $wgBabelCentralDb $wgBabelCategoryNames $wgBabelUseCommunityConfiguration $wgBabelAllowOverride
Hook usati CommunityConfigurationProvider_initList LinksUpdate LoadExtensionSchemaUpdates ParserFirstCallInit UserGetReservedNames
Quarterly downloads	71 (Ranked 72nd)
Public wikis using	2,416 (Ranked 192nd)
Traduci l'estensione Babel se è disponibile su translatewiki.net
Problemi	Compiti aperti · Riportare un bug

L'estensione Babel aggiunge una funzione parser che sostituisce il vecchio sistema dei Babel completamente basato sui template. Nel caso in cui venisse specificata una lingua non riconosciuta come parametro, verrà mostrato il template con lo stesso nome qualora esistesse.

Sui progetti Wikimedia, il nome Babel (dal mito della Torre di Babele) fa riferimento alla tabella, presente sulle pagine Utente, che mirano a una comunicazione multilingue rendendo più facile contattare qualcuno che conosca una data lingua. L'idea è nata su Wikimedia Commons ed è stata poi implementata su molti altri progetti wiki.

Installazione

• Download and move the extracted Babel folder to your extensions/ directory.
  Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Babel
• Aggiungi il seguente codice al tuo $LocalSettings (preferibilmente alla fine):

  wfLoadExtension( 'Babel' );
  

• Esegui lo script di aggiornamento, che creerà automaticamente nel database le tavole necessarie a questa estensione.
• Configurare come richiesto.
•  Done – Naviga in Special:Version nella tua wiki per verificare che l'estensione sia stata installata correttamente.

• Il CSS si trova nel file resources/ext.babel.css. Si può cambiare lo stile a proprio piacimento disabilitandoli sulla pagina MediaWiki:Common.css.
• Se viene trovata l'estensione CLDR , i nomi delle lingue vengono presi da quella (dove le traduzioni non sono disponibili), altrimenti vengono utilizzati i nomi delle lingue incorporati in MediaWiki e le impostazioni predefinite in inglese.

Uso

La sintassi per la funzione parser #babel è la seguente:

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

Aggiungi uno dei seguenti codici per ogni lingua che parli o capisci, separato da |, dove xx è il codice per la lingua MediaWiki codice lingua, o ISO 639-1 o ISO 639-3. L'uso generale per ogni livello di codice è il seguente:

xx-0

se non comprendi per niente la lingua.

xx-1

Abilità di base - abbastanza per capire materiale scritto o domande semplici in questa lingua.

xx-2

abilità intermedia - sufficiente per la modifica o discussioni.

xx-3

Livello avanzato - anche se riesci a scrivere in questa lingua senza alcun problema, potrebbero verificarsi alcuni piccoli errori.

xx-4

Livello "simil-nativo" - anche se non è la tua lingua madre, la tua capacità è simile a quella di un madrelingua.

xx-5

Conoscenza professionale.

xx o xx-N

Madrelingua che utilizzano un linguaggio di ogni giorno e hanno una conoscenza approfondita di esso, comprese le espressioni colloquiali e i modi di dire.

Per includere qualsiasi altro modello, aggiungi semplicemente il nome del modello, ad esempio aggiungi User CSS se desideri includere Template:User CSS. È possibile aggiungere un prefisso o un suffisso ai nomi dei modelli (ad esempio Utente all'inizio) a seconda della configurazione locale. Questo può essere utilizzato per limitare la selezione e ridurre la lunghezza dei parametri; ad esempio CSS potrebbe includere Template:User CSS se configurato in questo modo.

Parameters

Per rimuovere l'intestazione e il piè di pagina, utilizza plain=1 come primo parametro, ad esempio {{#babel: plain=1 | babelcode1 | babelcode2 | ... }}. Questo rende più facile l'utilizzo di babel con altre caselle utente.

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.

Configurazione

Parametri di configurazione

Babel ha diversi parametri di configurazione che possono essere modificati in LocalSettings.php .

$wgBabelLanguageCodesCdb

(stringa) il percorso del file del database del codice della lingua, il valore predefinito dovrebbe essere sufficiente.

$wgBabelLanguageNamesCdb

(stringa) il percorso del file del database del codice della lingua; il valore predefinito dovrebbe essere sufficiente.

$wgBabelCategoryNames

(array di stringhe o booleani, indicizzati dalle stringhe "1", "2", … "5", "N") dove ogni voce è il nome di una categoria per il livello di competenza indicato dal suo indice, i possibili elementi variabili sono : %code% (codice della lingua), %wikiname% (il nome della lingua nel contenuto di lingue di wiki) e %nativename% (il nome della lingua nella sua propria lingua). Per disabilitare l'aggiunta di una categoria per un particolare livello, imposta il valore corrispondente su false.

Per esempio:

$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',
];

Userà categorie come "Category:User en-0" e "Category:User fr-N". L'impostazione predefinita è solo "Category:Fr-N" e così via.

$wgBabelMainCategory

(stringa) Nome della categoria principale (non di livello) per ciascuna lingua, alla quale vengono aggiunti tutti gli utenti di quella lingua. Impostato su false per disabilitare; il formato predefinito è "Categoria:Fr". Accetta lo stesso formato di $wgBabelCategoryNames sopra. Esempio:

$wgBabelMainCategory = 'User %code%';

$wgBabelDefaultLevel

(stringa) Il livello di abilità predefinito da utilizzare quando non è specificato nessuno, dovrebbe essere un indice da $wgBabelCategoryNames, ovvero una delle stringhe "1", "2", … "5", "N". L'impostazione predefinita è "N".

$wgBabelUseUserLanguage

(booleano) Indica se utilizzare la lingua dell'interfaccia utente per il messaggio di intestazione e piè di pagina. Se è false (impostazione predefinita), sarà nella lingua del contenuto della pagina. Questo perché l'utilizzo della lingua dell'interfaccia utente può frammentare la cache del parser.

$wgBabelCategorizeNamespaces

Matrice di spazi dei nomi a cui aggiungere solo la categorizzazione automatica. Ad esempio, se $wgBabelCategorizeNamespaces = [ NS_USER ];, Babel aggiungerà solo le categorie alle pagine nello spazio dei nomi utente. Il valore predefinito è null, il che significa categorizzare tutti gli spazi dei nomi.

$wgBabelCategoryOverride

Se consentire l'override delle categorie Babel sul wiki utilizzando MediaWiki:Babel-category-override

$wgBabelAutoCreate

Se creare automaticamente le categorie.

Messaggi di sistema

Diverse personalizzazioni possono anche essere effettuate usando i messaggi nel namespace MediaWiki.

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

Il formato dei nomi dei modelli quando ne viene incluso uno.

MediaWiki:babel-portal ""

Il formato della destinazione del collegamento dal codice della lingua. Impostare su una stringa vuota per non collegare il codice della lingua.

MediaWiki:Babel-autocreate-user "Babel AutoCreate"

Nome utente da usare per la creazione automatica delle categorie Babel

MediaWiki:babel-autocreate-text-levels "Gli utenti in questa categoria indicano che riescono a comunicare in $2 con un livello di conoscenza $1."

Testo da inserire in categorie create automaticamente per diversi livelli linguistici. Devi cambiarlo se vuoi che vengano categorizzati automaticamente nella categoria principale della rispettiva lingua ($wgBabelMainCategory).

MediaWiki:babel-autocreate-text-main "Gli utenti in questa categoria indicano il loro livello di conoscenza in $1."

Testo da inserire nelle categorie create automaticamente per le categorie non di livello. Devi cambiarlo se vuoi che vengano categorizzati automaticamente in una categoria principale per tutte le lingue.

MediaWiki:babel "Babel utente"

L'intestazione del box babel Impostare su - per non visualizzare un'intestazione.

MediaWiki:babel-url "Project:Babel"

The page name where information on the babel extension can be found. Impostare su - per non visualizzare alcun collegamento nell'intestazione.

MediaWiki:Babel-footer "Utenti per lingua"

Il piè di pagina del box babel. Impostare su - per non visualizzare un piè di pagina.

MediaWiki:babel-footer-url " :Category:Utenti per lingua"

La pagina a cui collegarsi nel piè di pagina del riquadro babel

MediaWiki:Babel-category-override "$1"

Sostituisce qualsiasi categoria Babel generata automaticamente. Parametri
$1 = la categoria che verrebbe generata normalmente.
$2 = il codice della lingua
$3 = il livello di babel.
Qualsiasi categoria sovrascritta utilizzando questo metodo non verrà creata automaticamente per ridurre il rischio di atti vandalici o modifiche errate a quella pagina.

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