Jump to content

Extensión:Babel

From mediawiki.org
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 lanzamiento: 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 Master mantiene la compatibilidad con versiones anteriores.
MediaWiki >= 1.43.0
Cambios de la base de datos
Composer mediawiki/babel
Tablas babel
Licencia GNU Licencia Pública general 2.0 o posterior
Descarga Incluído en Language Extension Bundle
Ejemplo Translatewiki.net
  • $wgBabelMainCategory
  • $wgBabelAutoCreate
  • $wgBabelDefaultLevel
  • $wgBabelCategorizeNamespaces
  • $wgBabelUseUserLanguage
  • $wgBabelCentralDb
  • $wgBabelCategoryNames
  • $wgBabelUseCommunityConfiguration
  • $wgBabelAllowOverride
Descargas trimestrales 85 (Ranked 63rd)
Wikis públicos que lo utilizan 2,416 (Ranked 192nd)
Traduce la extensión Babel si está disponible en translatewiki.net
Asuntos Tareas abiertas · Reportar un bug

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 extrae los archivos en un directorio denominado «Babel» dentro de la carpeta extensions/.
    Developers and code contributors should install the extension from Git instead, using: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.
  • Yes 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. Puede cambiar el estilo como desee anulándolos en el MediaWiki:Common.css de la página.
  • Si se encuentra la extensión de 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 de MediaWiki y los valores predeterminados en inglés.

Uso

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

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

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

xx-0
si no entiende el idioma en absoluto.
xx-1
Capacidad básica: suficiente para comprender material escrito o preguntas sencillas en este idioma.
xx-2
Habilidad intermedia—suficiente para editar o discutir.
xx-3
Nivel avanzado—aunque puede 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 un idioma todos los días y lo dominan a fondo, incluidos coloquialismos y modismos.

Para incluir cualquier otra plantilla, simplemente agregue el nombre de la plantilla, por ejemplo, agregue User CSS si desea incluir Template:User CSS. Se puede agregar un prefijo o sufijo a los nombres de las plantillas (por ejemplo, <código>Usuario</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, por ejemplo, {{#babel: plain=1 | babelcode1 | babelcode2 | ... }}. Esto facilita el uso de babel con otras cajas de usuario.

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

Tenga en cuenta que sólo se permite uno de los parámetros anteriores. 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.

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',
];
utilizará 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, a la que se agregan todos los usuarios de ese idioma. Establecer en falso para deshabilitar; el formato predeterminado es "Categoría:Fr". Acepta el mismo formato que $wgBabelCategoryNames arriba. 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), estará en 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 para agregar solo 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
Permitir o no que las categorías de Babel se anulen en wiki usando MediaWiki:Babel-category-override
$wgBabelAutoCreate
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]