Extensión:Babel

This page is a translated version of the page Extension:Babel and the translation is 100% complete.
Manual de extensiones de MediaWiki
Babel
Estado de la versión: estable
Implementación Función del analizador
Descripción Agrega una función de analizador para informar a otros usuarios sobre el dominio del idioma y clasificar a los usuarios de los mismos niveles e idiomas.
Autor(es) Robert Leverington (RobertLdiscusión)
Última versión Actualizaciones continuas
Política de compatibilidad La rama maestra mantiene la retrocompatibilidad.
MediaWiki >= 1.43.0
Cambios en la base de datos
Composer mediawiki/babel
Tablas babel
Licencia Licencia Pública General de GNU 2.0 o posterior
Descargar Incluido en el paquete de extensión de idioma
Ejemplo Translatewiki.net
  • $wgBabelMainCategory
  • $wgBabelAutoCreate
  • $wgBabelDefaultLevel
  • $wgBabelCategorizeNamespaces
  • $wgBabelUseUserLanguage
  • $wgBabelCentralDb
  • $wgBabelCategoryNames
  • $wgBabelUseCommunityConfiguration
  • $wgBabelAllowOverride
Descargas trimestrales 26 (Ranked 57th)
Wikis públicos que lo utilizan 2,416 (Ranked 192nd)
Traduce la extensión Babel si está disponible en translatewiki.net
Incidentes Tareas abiertas · Reportar un error

La extensión Babel agrega una función analizadora para reemplazar el antiguo sistema Babel que dependía completamente de plantillas. Si se especifica un parámetro de idioma no reconocido, verá si hay una plantilla existente con el nombre y la incluirá.

En los proyectos de Wikimedia, el sustantivo Babel (en referencia a la Torre de Babel) se refiere a los textos en las páginas de los usuarios que ayudan a la comunicación multilingüe al facilitar el contacto con alguien. que habla un idioma determinado. La idea se originó en Wikimedia Commons y también se ha implementado en muchas otras wikis.

Instalación

  • Descarga y mueve la carpeta Babel extraída a tu directorio extensions/.
    Los desarrolladores y contribuidores de código deberían instalar la extensión desde Git en su lugar, usando:
    cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Babel
    
  • Añade el siguiente código en la parte final de tu archivo LocalSettings.php :
    wfLoadExtension( 'Babel' );
    
  • Ejecuta la secuencia de actualización, que creará automáticamente las tablas de la base de datos que necesita esta extensión.
  • Configurar según sea necesario.
  •   Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.
  • El CSS se encuentra en el archivo $parh. Puedes cambiar el estilo como desees anulándolos en la página MediaWiki:Common.css.
  • Si se encuentra la extensión CLDR , los nombres de los idiomas se toman de ahí (donde las traducciones no están disponibles); de lo contrario, se utilizan los nombres de los idiomas integrados en MediaWiki y los valores predeterminados en inglés.

Uso

La sintaxis para la función analizadora #babel es la siguiente:

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

Agrega uno de los siguientes códigos para cada idioma que hables o comprendas, separados por |, donde xx es el código de idioma en MediaWiki, código ISO 639-1 o ISO 639-3 para el idioma. El uso general de cada nivel de código es el siguiente:

xx-0
Si no entiendes el idioma en absoluto.
xx-1
Capacidad básica: suficiente para comprender material escrito o preguntas sencillas en este idioma.
xx-2
Capacidad intermedia: suficiente para editar o las discusiones.
xx-3
Nivel avanzado: aunque puedes escribir en este idioma sin problemas, pueden ocurrir algunos pequeños errores.
xx-4
Nivel "casi nativo": aunque no es tu primer idioma desde que naciste, tu habilidad es similar a la de un hablante nativo.
xx-5
Capacidad profesional.
xx o xx-N
Hablantes nativos que usan el idioma todos los días y lo dominan a fondo, incluyendo coloquialismos y modismos.

Para incluir cualquier otra plantilla, agrega el nombre de la plantilla, p.ej., agrega User CSS si quieres incluir Template:User CSS. Se puede agregar un prefijo o sufijo a los nombres de las plantillas (p.ej., <código>User</código> al principio) según la configuración local. Esto se puede usar para restringir la selección y reducir la longitud de los parámetros; por ejemplo, CSS podría incluir Template:User CSS si se configura de esa manera.

Parámetros

Para eliminar el encabezado y el pie de página, usa plain=1 como primer parámetro, p.ej., {{#babel: plain=1 | babelcode1 | babelcode2 | ... }}. Esto facilita el uso de Babel con otras cajas de usuario.

Para ocultar categorías, usa el parámetro nocat=1 como el primer parámetro, p.ej., {{#babel: nocat=1 | babelcode1 | babelcode2 | ... }}.

Tenga en cuenta que sólo se permite uno de los parámetros anteriores. Por el momento, no es posible utilizar ambos parámetros; por ejemplo, {{#babel: nocat=1 | plain=1 | babelcode1 | babelcode2 | ... }} no funcionará.

Categorización

Si la categorización está habilitada, la extensión crea categorías utilizando el bot Babel AutoCreate con el texto especificado en MediaWiki:babel-autocreate-text-levels y MediaWiki:babel-autocreate-text-main. Con la configuración básica, las categorías que crea el bot no están categorizadas, y para solucionar esto, se recomienda hacer lo siguiente:

  1. Crea una plantilla {{Babel category }} que generará categorías.
  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}}
    

Esto le permitirá categorizar categorías automáticamente y, si algo sucede, podrá reemplazar simultáneamente la categorización y el texto en todas las categorías.

Configuración

Parámetros de configuración

Babel tiene varios parámetros de configuración que se pueden modificar en LocalSettings.php .

$wgBabelLanguageCodesCdb
(cadena) la ruta del archivo de la base de datos del código de idioma, el valor predeterminado debería ser suficiente.
$wgBabelLanguageNamesCdb
(cadena) la ruta del archivo de la base de datos del nombre del idioma, el valor predeterminado debería ser suficiente.
$wgBabelCategoryNames
(matriz de cadena o booleana, indexada por las cadenas "1", "2", ... "5", "N") donde cada entrada es el nombre de una categoría para el nivel de habilidad indicado por su índice, los posibles elementos variables son : %code% (código de idioma), %wikiname% (el nombre del idioma en el idioma del contenido de la wiki) y %nativename% (el nombre del idioma en su idioma). Para deshabilitar la adición de una categoría para un nivel particular, establezca el valor correspondiente en falso.
Por ejemplo:
$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',
];
Se utilizarán categorías como "Category:User en-0" y "Category:User fr-N". El valor predeterminado es solo "Category:Fr-N" y así sucesivamente.
$wgBabelMainCategory
(cadena) Nombre de la categoría principal (sin nivel) para cada idioma al que se agregan todos los usuarios de ese idioma. Establezca en falso para deshabilitar; el formato predeterminado es "Categoría:Fr". Acepta el mismo formato que $wgBabelCategoryNames anterior. Ejemplo:
$wgBabelMainCategory = 'User %code%';
$wgBabelDefaultLevel
(cadena) Nivel de habilidad predeterminado para usar cuando no se especifica ninguno, debe ser un índice de $wgBabelCategoryNames, que es una de las cadenas "1", "2", ... "5", "N". El valor predeterminado es "N".
$wgBabelUseUserLanguage
(booleano) Si se utiliza el idioma de la interfaz de usuario para el mensaje de encabezado y pie de página. Si es falso (predeterminado), se utilizará el idioma del contenido de la página. Esto se debe a que el uso del idioma de la interfaz de usuario puede fragmentar la memoria caché del analizador.
$wgBabelCategorizeNamespaces
Matriz de espacios de nombres a los que solo se les agregará categorización automática. Por ejemplo, si $wgBabelCategorizeNamespaces = [ NS_USER ];, entonces Babel sólo añadirá categorías a las páginas en el espacio de nombres del usuario. El valor predeterminado es nulo, lo que significa categorizar todos los espacios de nombres.
$wgBabelCategoryOverride
Si se debe permitir o no que las categorías de Babel se anulen en la wiki usando MediaWiki:Babel-category-override
$wgBabelAutoCreate
Si se debe permitir o no la creación automática de las categorías.

Mensajes de sistema

También se pueden realizar varias personalizaciones utilizando mensajes de espacio de nombres de MediaWiki.

MediaWiki:babel-template "Template:Usuario $1"
El formato de los nombres de las plantillas cuando se incluye una.
MediaWiki:babel-portal ""
El formato del destino del enlace del código de idioma. Configurar la cadena vacía para no vincular el código de idioma.
MediaWiki:Babel-autocreate-user "Babel AutoCreate"
Nombre de usuario que se utilizará para la creación automática de categorías relacionadas con Babel
MediaWiki:babel-autocreate-text-levels "Los usuarios de esta categoría indican que tienen un nivel de dominio $1 del idioma $2."
Texto para insertar en categorías creadas automáticamente para diferentes niveles de idioma. Debe cambiar esto si desea que se clasifiquen automáticamente en la categoría principal del idioma respectivo ($wgBabelMainCategory).
MediaWiki:babel-autocreate-text-main "Los usuarios en esta categoría indican su conocimiento del idioma $1."
Texto para insertar en categorías creadas automáticamente para categorías sin nivel. Debe cambiar esto si desea que se clasifiquen automáticamente en una categoría principal para todos los idiomas.
MediaWiki:babel "Información de idiomas del usuario"
El encabezado de la caja de babel. Establecer a - para no mostrar un encabezado.
MediaWiki:babel-url "Project:Babel"
El nombre de la página donde se puede encontrar información sobre la extensión de babel. Establecer a - para no mostrar ningún enlace en el encabezado.
MediaWiki:Babel-footer "Usuarios por idioma"
El pie de página de la caja de babel. Establecer a - para no mostrar un encabezado.
MediaWiki:babel-footer-url " :Category:Babel - Usuarios por idioma"
La página a vincular en el pie de página del cuadro de babel
MediaWiki:Babel-category-override "$1"
Anula cualquier categoría de Babel generada automáticamente. Parámetros:
$1 = la categoría que se generaría normalmente.
$2 = código de idioma
$3 = el nivel de Babel.
Las categorías anuladas con este método no se crearán automáticamente para reducir el riesgo de vandalismo o ediciones erróneas en esa página.

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]