Extension:UniversalLanguageSelector/es

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.
 * 2) La selección puede basarse en la búsqueda y navegación basada en la región geográfica.
 * 3) 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(autonym)
 * 4) Búsqueda de idioma cruzado - busca nombres de idiomas usando cualquier script
 * 5) Autocompletado de nombres de idiomas
 * 6) Corrección automática de los errores de ortografía en las cadenas de búsqueda
 * 7) Sugerencias de idiomas basadas en Geo IP
 * 8) Selección del idioma basada en el idioma del navegador/SO de los usuarios
 * 9) Métodos de entrada
 * Consulte 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) * Hay una lista obsoleta disponible en Extension:Narayam#Esquemas soportados
 * 4) Preferencias del método de entrada por idioma
 * 5) Webfonts
 * 6) Una gran colección de fuentes a elegir en cada idioma para usar como fuente incrustada en la página
 * 7) * Hay una lista obsoleta disponible en Extension:WebFonts#Idiomas soportados
 * 8) * Puede explorar todas las fuentes incluidas
 * 9) Preferencias de fuente por idioma



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 (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
Sfntly es necesario para crear fuentes web (línea de comando solamente).

Una vez instalado, se pueden utilizar los siguientes comandos.

Creando .woff:

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:

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.
 * 3) Vaya a data/fontrepo/scripts y ejecute.
 * 4) Confirme los cambios en el repositorio  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.

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):
 * - una matriz asociativa donde las claves son códigos de idioma y los valores son nombres de idioma en inglés.
 * - 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.

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.  application/x-font-woff .woff application/vnd.ms-fontobject .eot application/x-font-ttf .ttf Las siguientes variables también se pueden configurar:
 * - 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.
 * - 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.
 * - 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  o $wgULSEnableAnon se establecen en falso.
 * - 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.
 * - La ubicación y la forma del disparador de selección de idioma. Los valores posibles son: : como un enlace cerca del nombre de usuario o el enlace de inicio de sesión en la barra de herramientas personal (predeterminado).  : como un icono cerca del encabezado de la lista de enlaces interlingüísticos en la barra lateral.
 * - Matriz de selectores jQuery de elementos en los cuales IME no debe estar habilitado. ej:

Posición del disparador ULS

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

It is also possible to have ULS trigger anywhere in the screen. An element with  will act as a ULS trigger.

Overriding default fonts
ULS has a large font repository to serve as webfonts. Sometimes there are multiple fonts for a language and there is a default font for each language/script. The order of fonts or default font can be overridden as follows using global scripts (MediaWiki:Common.js) or personal scripts (Special:MyPage/common.js):

Here, languageCode should be a valid language code(eg: en, hi, nl). FontA and FontB are fonts available in font repository. In the above example for languageCode, we set a font available in local computer as default font. ie No default webfont.

Caching configuration
To ensure that the web fonts files are cached on the clients' machines, font file types must be added to the web server configuration. In Apache2 this consists of:
 * Adding font file extensions to the FileTimes regex at FilesMatch for the relevant directory, example:
 * Adding ExpiresByType values to the relevant MIME types, similarly to image MIME types.
 * Note that there's no standard MIME type for TTF. application/x-font-ttf is used for Wikimedia.
 * Adding the MIME types:

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

For a full example see the caching configuration update done for the Wikimedia cluster.

Traducción de página
UniversalLanguageSelector is one of the dependencies of the Translate extension, which uses it for several language selection features. One of it is the MyLanguage system for links, which depends on the interface language of the user, but more can be configured: see Page translation feature.

Using Webfonts
User can choose webfonts for a language from the Language settings -> Display settings. By default, the first font in that menu will be applied to the wiki. A user can change the font and it will be remembered across the pages. Optionally user can disable the font embedding too by selecting system font.

If the font is available in user's local system, font will not be downloaded from the mediawiki server. It will be taken from the user's computer. Otherwise, font will be downloaded from the server only once. ie when the user selects the font first time. Next time onwards, font will be taken from the local cache.

By specifying font-family
Inside the wiki text YourText, webfonts extension will check whether the font is available with the extension, if so it will download it to the client. So the reader will not face any difficulty in reading the text even if the font specified is not available in their computer.

By specifying language
Inside the wiki text YourText, webfonts extension will check whether any font is available for the given language with the extension, if so it will download it to the client. So the reader will not face any difficulty in reading the text even if the font specified is not available in their computer. If there are multiple fonts for the language, the default font will be used. If default font is not preferred, use the font-family approach to specify the font. If the tag has both lang and font-family definitions, font-family get precedence.

Ejemplo:

𒄖𒉈𒅁𒌨𒅎

gives the text rendered in Cuneiform using Akkadian font

𒄖𒉈𒅁𒌨𒅎

Véase también

 * Universal Language Selector
 * Universal Language Selector/Interaction Design Framework
 * Universal Language Selector/Technical Design
 * Technical details of Webfonts feature of Universal Language Selector