Extension:Selector Idioma Universal

This page is a translated version of the page Extension:UniversalLanguageSelector and the translation is 98% complete.
Outdated translations are marked like this.
Manual de extensiones de MediaWiki
UniversalLanguageSelector
Estado de lanzamiento: estable
Implementación Interfaz de usuario, Piel , Funcionalidades en beta
Descripción Herramienta que permite a los usuarios seleccionar un idioma y configurar su soporte de una manera fácil.
Autor(es) Equipo de idioma de Wikimedia
Última versión 2024-01-22
Política de compatibilidad Master mantiene la compatibilidad con versiones anteriores.
MediaWiki >= 1.40.0
Composer mediawiki/universal-language-selector
Licencia
Descarga Incluido en el paquete de extensión de idioma
  • $wgULSWebfontsEnabled
  • $wgULSGeoService
  • $wgULSLanguageDetection
  • $wgULSAnonCanChangeLanguage
  • $wgULSEnable
  • $wgULSImeSelectors
  • $wgULSIMEEnabled
  • $wgULSNoWebfontsSelectors
  • $wgULSFontRepositoryBasePath
  • $wgULSCompactLanguageLinksBetaFeature
  • $wgULSNoImeSelectors
  • $wgULSPosition
No es compatible con Internet Explorer 8 o anterior.
Descargas trimestrales 181 (Ranked 38th)
Wikis públicos que lo utilizan 1,237 (Ranked 214th)
Traduce la extensión UniversalLanguageSelector si está disponible en translatewiki.net
Asuntos Tareas abiertas · Reportar un bug

El Selector de Idioma Universal es una herramienta que permite a los usuarios seleccionar un idioma y configurar su soporte de una manera fácil. Donde se utilice, también envía la funcionalidad de las extensiones WebFonts y Narayam (las cuales han quedado en desuso en favor del Selector de Idioma Universal). Consulte Selector de Idioma Universal para obtener información adicional y de antecedentes.

Uso

El objetivo principal es permitir a los usuarios seleccionar un idioma y configurar su asistencia de una manera fácil.

La extensión provee las siguientes funcionalidades:

  1. Forma flexible y fácil de seleccionar un idioma de un gran conjunto de idiomas.
    1. La selección puede basarse en la búsqueda y navegación basada en la región geográfica.
    2. La búsqueda puede basarse en el código de idioma ISO, el nombre del idioma escrito en el idioma actual de la interfaz del usuario o en su propio script (autónimo)
    3. Búsqueda de idioma cruzado - busca nombres de idiomas usando cualquier script
    4. Autocompletado de nombres de idiomas
    5. Corrección automática de los errores de ortografía en las cadenas de búsqueda
    6. Sugerencias de idiomas basadas en Geo IP
    7. Selección del idioma basada en el idioma del navegador/SO de los usuarios
  2. Métodos de entrada
    Consulta Help:Extension:UniversalLanguageSelector/Input methods para obtener instrucciones completas.
    1. Una colección de métodos de entrada fácilmente seleccionable, disponible en cada campo editable
    2. Proporciona un gran conjunto de métodos de entrada para una amplia gama de idiomas
    3. Preferencias del método de entrada por idioma
  3. Tipografías web
    1. Una gran colección de tipografías a elegir en cada idioma para usar como tipografía incrustada en la página
    2. Preferencias de tipografía por idioma
 
Selector de idioma universal con sugerencia de idioma basada en geoip para un usuario de España
 
La configuración de idioma permite que un usuario registrado que acceda a Wikipedia en inglés cambie la interfaz de usuario a su idioma nativo.
 
Un usuario bengalí puede leer contenido de la Wikipedia bengalí a pesar de la falta de fuentes en su computadora. Las fuentes web se proporcionan automáticamente para las secuencias de comandos no latinas para las que está disponible una fuente de código abierto. El usuario puede decidir usar sus fuentes del sistema por idioma.
 
Un hablante hindi sin un teclado hindi configura los métodos de entrada para que pueda escribir en su idioma.
 
Cuándo buscando un usuario puede cambiar entre inglés e hindi.

Añadiendo fuentes

Soportar más idiomas es solo cuestión de incluir las fuentes adecuadas en el código. Sin embargo, tenga en cuenta que añadiremos compatibilidad solo para fuentes con licencia libre, por ejemplo, fuentes bajo licencia GNU GPL, SIL OFL, etc. Un directorio de ejemplo de tales fuentes gratuitas es Google Fonts [1] (aún no completamente examinado/explotado por los autores de esta extensión); consulte también Open Font Library.

En primer lugar, necesita encontrar o producir una fuente gratuita (esta es la parte más importante y debe hacerla usted mismo); luego, debe convertirla a los formatos requeridos, que son eot, ttf, woff; finalmente, puede presentar una solicitud en Phabricator para la fuente que se añadirá a la extensión.

#Preparando webfonts a continuación explica cómo convertir las fuentes: se requiere conocimiento básico sobre un sistema operativo basado en GNU/Linux; si tiene dificultades para hacerlo, puede omitir este paso y pedirle a otra persona que lo haga por usted en la misma solicitud de Phabricator (por supuesto, esto ralentizará el proceso).

Preparando webfonts

Creating .woff:

Utilice https://github.com/bramstein/sfnt2woff-zopfli para generar woff a partir de un archivo ttf. Esto producirá un archivo woff comprimido.

Creando .woff2:

Utilice https://github.com/google/woff2 para generar woff2 desde ttf. Esto producirá un archivo woff2 comprimido. Los navegadores modernos admiten este formato.

Cree un archivo font.ini. Aquí hay un ejemplo:

[AbyssinicaSIL]
languages=am*, ti*
version=1.200
license=OFL 1.1
licensefile=OFL.txt
url=http://scripts.sil.org/AbyssinicaSIL
ttf=AbyssinicaSIL.ttf
woff=AbyssinicaSIL.woff
woff2=AbyssinicaSIL.woff2
bold=AbyssinicaSIL Bold

[AbyssinicaSIL Bold]
ttf=AbyssinicaSIL-Bold.ttf
woff=AbyssinicaSIL-Bold.woff
woff2=AbyssinicaSIL-Bold.woff2

Un asterisco (*) después de un código de idioma significa que esa fuente será la fuente predeterminada para ese idioma. Si solo desea la opción de utilizar esa fuente para ese idioma, no use el asterisco.

Después de crear los archivos, haga lo siguiente:

  1. Cree un directorio para la fuente en data/fontrepo/fonts.
  2. Coloque los archivos ttf, woff, eot y font.ini en ese directorio y añadalos al repositorio fuente (git add).
  3. Vaya a scripts/ y ejecute php compile-font-repo.php.
  4. Confirme los cambios en el repositorio (git commit -a ) y envíelos de acuerdo con el Git workflow.

Añadiendo soporte para un nuevo mapeo de teclas (método de entrada)

Siga el instructions on the jquery.ime github wiki, pero solicite archivos en el producto Phabricator Wikimedia-extensions-UniversalLanguageSelector.

Instalación

  • Descarga y extrae los archivos en un directorio denominado «UniversalLanguageSelector» 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/UniversalLanguageSelector
  • Añade el siguiente código en la parte final de tu archivo LocalSettings.php :
    wfLoadExtension( 'UniversalLanguageSelector' );
    
  •   Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.


Instalación Vagrant:

  • Si se utiliza Vagrant , instala con vagrant roles enable uls --provision

Actualizando LanguageNameIndex

Para realizar la búsqueda en varios idiomas, buscando en autonyms, los datos de idioma deben completarse. ULS viene con un índice de nombre de idioma precompuesto (data/langnames.ser). En caso de que quiera actualizarlo, instale Extension:CLDR y actualice los datos con el siguiente comando.

php UniversalLanguageSelector/data/LanguageNameIndexer.php

y verifique que el archivo langnames.ser se genere en ULS/data/folder.

Configuración

Las siguientes variables se crean automáticamente durante la inicialización y se pueden utilizar desde JavaScript usando mw.config.get( NAME ):

  • wgULSLanguages​ - una matriz asociativa donde las claves son códigos de idioma y los valores son nombres de idioma en inglés.
  • wgULSAcceptLanguageList - una matriz de códigos de idioma del valor de Accept-Language del usuario. Estos son los idiomas seleccionados en las preferencias del navegador del usuario.

wgULSLanguages - una matriz asociativa donde las claves son códigos de idioma y los valores son nombres de idiomas en inglés. wgULSAcceptLanguageList - una matriz de códigos de idioma del valor Accept-Language del usuario. Estos son los idiomas seleccionados en las preferencias del navegador del usuario.

Para servir fuentes, es posible que desee añadir los siguientes tipos de mime a su servidor web si aún no están allí. Esta guía podría ayudar.

font/woff .woff
application/vnd.ms-fontobject .eot
application/x-font-ttf .ttf

Las siguientes variables también se pueden configurar:

  • $wgULSGeoService - ULS puede usar los servicios de geolocalización para sugerir idiomas según el país desde el que el usuario está visitando. Si se establece esto en falso evitará que se use la geolocalización integrada. Puede proporcionar su propia geolocalización configurando window.Geo al objeto que tiene la clave 'country_code' o 'country'. Si se establece en verdadero, consultará el servicio geoip de Wikimedia. El servicio debe devolver jsonp que usa el parámetro de devolución de llamada proporcionado. El valor predeterminado es http://freegeoip.net/json/ y espera el mismo formato. Si se establece en false, no se utilizará la geolocalización integrada. Puedes proporcionar tu propia geolocalización configurando ventana. Geo al objeto que tiene la clave 'country_code' o 'country'. Si se establece en true, consultará el servicio geoip de Wikimedia. El servicio debe devolver jsonp que utiliza el parámetro de devolución de llamada suministrado. Por defecto es http://freegeoip.net/json/ (aviso: este sitio web ha cerrado su API) y espera el mismo formato.
  • $wgULSEnable - Habilita la selección del idioma, enlaces de idiomas compactos, métodos de entrada y webfonts para todos, a menos que las variables de configuración a continuación anulen el comportamiento. Incluso si es falso, las clases y los módulos del cargador de recursos están registrados para el uso de otras extensiones. El cambio de idioma a través de cookie o parámetro de consulta setlang no es posible.
  • $wgULSAnonCanChangeLanguage - Permite a los usuarios anónimos cambiar el idioma con cookie y setlang query param. No utilizar si está almacenando en caché vistas de página anónimas sin tener en cuenta las cookies. No tiene ningún efecto si cualquiera de $wgULSEnable o $wgULSEnableAnon se establecen en falso.
  • $wgULSIMEEnabled - Desactiva la función de métodos de entrada para todos los usuarios de forma predeterminada. Todavía puede ser habilitado manualmente por el usuario.
  • $wgULSPosition - La ubicación y la forma del disparador de selección de idioma. Los valores posibles son: personal: como un enlace cerca del nombre de usuario o el enlace de inicio de sesión en la barra de herramientas personal (predeterminado). interlanguage: como un icono cerca del encabezado de la lista de enlaces interlingüísticos en la barra lateral.
  • $wgULSNoImeSelectors - Matriz de selectores jQuery de elementos en los cuales IME no debe estar habilitado. ej: array( '#wpCaptchaWord' );
  • $wgULSLanguageDetection - Si se detecta automáticamente el idioma del usuario a partir de la cabecera Accept-Language.

Posición del disparador ULS

  • $wgULSPosition - La ubicación y la forma del disparador de selección de idioma. Los valores posibles son: personal: como un enlace cerca del nombre de usuario o el enlace de inicio de sesión en la barra de herramientas personal (predeterminado). interlanguage: como un icono cerca del encabezado de la lista de enlaces interlingüísticos en la barra lateral.

También es posible hacer que ULS se dispare en cualquier parte de la pantalla. Un elemento con uls-settings-trigger actuará como un disparador ULS.

Anulación de fuentes predeterminadas

ULS tiene un repositorio de fuentes grande para servir como webfonts. A veces hay varias fuentes para un idioma y hay una fuente predeterminada para cada idioma/script. El orden de las fuentes o de la fuente predeterminada se puede anular de la siguiente manera utilizando scripts globales (MediaWiki:Common.js) o scripts personales (Special:MyPage/common.js):

Configuración de la caché

Para garantizar que los archivos de fuentes web estén en caché en las máquinas de los clientes, los tipos de archivos de fuentes se deben agregar a la configuración del servidor web. En Apache2 esto consiste en:

  • Añadir extensiones de archivos de fuentes a la expresión regular FileTimes en FilesMatch para el directorio correspondiente, por ejemplo:
  • Añadir extensiones de archivos de fuentes a la regex FileTimes en FilesMatch para el directorio relevante, ejemplo:

<FilesMatch "\.(gif|jpe?g|png|css|js|woff|svg|eot|ttf)$">

  • Añadir valores de ExpiresByType a los tipos MIME relevantes, de forma similar a los tipos MIME de imágenes.
    • Tenga en cuenta que no hay un tipo MIME estándar para TTF. application/x-font-ttf se utiliza por Wikimedia.
  • Añadir los tipos MIME:
    • Tenga en cuenta que no existe un tipo MIME estándar para TTF. application/x-font-ttf se utiliza para Wikimedia.
  • Añadir los tipos MIME:
AddType font/woff .woff
AddType application/vnd.ms-fontobject .eot
AddType application/x-font-ttf .ttf

Para un ejemplo completo, consulte la actualización de configuración de caché realizada para el clúster de Wikimedia.

Traducción de página

UniversalLanguageSelector es una de las dependencias de la Extensión de Extensión:Traducir , que lo utiliza para varias funciones de selección de idioma. Uno de ellos es el sistema MyLanguage para enlaces, que depende del idioma de la interfaz del usuario, pero se pueden configurar más: ver función de traducción de página.

Utilización de Webfonts

El usuario puede elegir webfonts para un idioma desde Configuración de idioma -> Configuración de pantalla. Por defecto, se aplicará a la wiki la primera fuente de ese menú. El usuario puede cambiar la fuente y se recordará en todas las páginas. Opcionalmente, el usuario puede desactivar la incrustación de fuentes seleccionando la fuente del sistema.

Si la fuente está disponible en el sistema local del usuario, la fuente no se descargará del servidor mediawiki. Se tomará del ordenador del usuario. De lo contrario, la fuente se descargará del servidor sólo una vez, es decir, cuando el usuario seleccione la fuente por primera vez. La próxima vez en adelante, la fuente se tomará de la caché local.

Formas alternativas de cargar fuentes

Especificando font-family

Dentro del texto wiki <span style="font-family:'YourFontName';">YourText</span>, la extensión webfonts comprobará si la fuente está disponible en la extensión y, en caso afirmativo, la descargará en el cliente. De este modo, el lector no tendrá ninguna dificultad para leer el texto aunque la fuente especificada no esté disponible en su ordenador.

Especificando el idioma

Dentro del texto wiki <span lang="mi">TuTexto</span>, la extensión webfonts comprobará si hay alguna fuente disponible para el idioma dado con la extensión y, en caso afirmativo, la descargará en el cliente. De este modo, el lector no tendrá ninguna dificultad para leer el texto aunque la fuente especificada no esté disponible en su ordenador. Si hay varias fuentes para el idioma, se utilizará la fuente por defecto. Si no se prefiere la fuente por defecto, utilice el método font-family para especificar la fuente. Si la etiqueta tiene definiciones tanto de lang como de font-family, font-family tiene preferencia.

Ejemplo:

<span lang=sux>𒄖𒉈𒅁𒌨𒅎</span>

ofrece el texto en cuneiforme con fuente acadia

𒄖𒉈𒅁𒌨𒅎

Véase también