Issue tracker: #MediaWiki-extensions-UniversalLanguageSelector

Extension:UniversalLanguageSelector/ca

From Linux Web Expert

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
MediaWiki extensions manual
File:OOjs UI icon advanced-invert.svg
UniversalLanguageSelector
Release status: stable
File:ULS-Display-Settings.png
Implementation User interface, Skin , Beta Feature
Description Eina que permet als usuaris seleccionar un idioma i configurar el seu suport d'una manera fàcil.
Author(s) Equip Wikimedia Language
Compatibility policy Master maintains backward compatibility.
MediaWiki
Composer mediawiki/universal-language-selector
License
Download
<translate> Download extension</translate>
<translate> Git</translate> [?]:
Inclosa en Language Extension Bundle
No és compatible amb Internet Explorer 8 o inferior.
Quarterly downloads Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin').
Public wikis using Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin').
Translate the UniversalLanguageSelector extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

El Selector d'idiomes universal és una eina que permet als usuaris seleccionar un idioma i configurar el seu suport d'una manera fàcil. Quan s'usa, també incorpora la funcionalitat de les extensions WebFonts i Narayam (les quals han quedat en desús en favor del Selector d'idiomes universal). Vegeu Selector d'idiomes universal per a informació a fons i addicional.

Ús

L'objectiu principal és permetre als usuaris seleccionar un idioma i configurar el seu suport d'una manera fàcil.

L'extensió proporciona les següents característiques:

  1. Un sistema flexible i fàcil de seleccionar un idioma en un gran conjunt d'idiomes.
    1. La selecció es pot basar en la navegació segons la regió geogràfica.
    2. La cerca es pot basar en el codi de llenguatge ISO, el nom de l'idioma escrit en la interfície de l'usuari actual o en el seu propi guió(autònim)
    3. Cerca directa de l'idioma o pels noms dels idiomes utilitzant qualsevol script
    4. Autocompletat dels noms dels idiomes
    5. Correcció automàtica d'errors d'ortografia en les cadenes de cerca
    6. Suggeriments d'idiomes basat en la geolocalització IP
    7. Selecció d'idiomes basat en el sistema operatiu i en el navegador de l'usuari
  2. Mètodes d'entrada
    Consulteu Help:Extension:UniversalLanguageSelector/Input methods per obtenir instruccions completes.
    1. Una col·lecció de mètodes d'entrada fàcilment seleccionables, fàcilment disponible en tots els camps editables
    2. Proporciona un gran conjunt de mètodes d'entrada per a la gran varietat d'idiomes
    3. Preferències de mètode d'entrada per idioma
  3. Tipus de lletra del web
    1. Una gran col·lecció de fonts per triar per a cada idioma que s'utilitzarà com a tipus de lletra incorporat de la pàgina
    2. Preferències del tipus de lletra per idioma
File:ULS-GeoIP.png
Selector d'idiomes universal amb suggeriment d'idioma geoip per a un usuari de l'Índia
File:ULS-Display-Settings.png
La configuració de l'idioma permet a un usuari registrat canviar la interfície d'usuari a la de la seva llengua materna quan accedeix, per exemple, a la Wikipedia en anglès.
File:ULS-Font-Settings-new.png
Un usuari bengalí és capaç de llegir el contingut de la Viquipèdia en bengalí tot i la manca de tipus de lletra en l'ordinador. Els tipus de lletra web es proporcionen automàticament per alfabets no llatins ja que hi han tipus de lletra de codi obert disponibles. L'usuari pot decidir utilitzar els seves tipus de lletra del sistema en funció de cada idioma.
File:ULS-Input-Settings.png
Un parlant hindi sense un teclat hindi configura mètodes d'entrada de caràcters perquè pugui escriure en el seu idioma.
File:ULS-Input-Search.png
En la recerca, un usuari pot canviar entre l'anglès i l'hindi.

Afegint fonts

Supporting more languages is only a matter of including the proper fonts in the code. However, please note that we will add support only for freely licensed fonts, for example fonts licensed under GNU GPL, SIL OFL, etc. An example directory of such free fonts is Google Fonts [1] (not yet fully examined/exploited by the authors of this extension); see also the Open Font Library.

First of all, you need to find or produce such a free font (this is the most important part and you have to do it yourself); then, it has to be converted to the required formats, which are eot, ttf, woff; finally, you can file a request in Phabricator for the font to be added to the extension.

#Preparing webfonts below explains how to convert the fonts: basic knowledge about GNU/Linux based operating system is required; if you have difficulty in doing this, you can skip this step and ask someone else to do it for you on the same Phabricator request (of course this will slow down the process).

Preparing webfonts

Creating .woff:

Use https://github.com/bramstein/sfnt2woff-zopfli to generate woff from ttf file. This will produce a compressed woff file.

Creating .woff2:

Use https://github.com/google/woff2 to generate woff2 from ttf. This will produce a compressed woff2 file. Modern browsers support this format.

Create a font.ini file. Here's an example: 

[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

An asterisk (*) after a language code means that this font will be the default font for that language. If you just want the option to use this font for that language, don't use the asterisk.

After creating the files, do the following:

  1. Create a directory for the font under data/fontrepo/fonts.
  1. Put the ttf, woff, eot and font.ini files in that directory and add them to the source repository (git add).
  1. Go to the scripts/ directory and run php compile-font-repo.php.
  1. Commit the changes to the repository (git commit -a) and submit them according to the Git workflow.

Adding support for a new key mapping (input method)

Follow the instructions on the jquery.ime github wiki, but file requests in the Wikimedia-extensions-UniversalLanguageSelector Phabricator product.

Instal·lació

  • <translate> [[<tvar name=2>Special:ExtensionDistributor/UniversalLanguageSelector/ca</tvar>|Download]] and move the extracted <tvar name=name>UniversalLanguageSelector/ca</tvar> folder to your <tvar name=ext>extensions/</tvar> directory.</translate>
    <translate> Developers and code contributors should install the extension [[<tvar name=git>Special:MyLanguage/Download from Git</tvar>|from Git]] instead, using:</translate>cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/UniversalLanguageSelector%2Fca
  • <translate> Add the following code at the bottom of your <tvar name=1>LocalSettings.php </tvar> file:</translate> 
    wfLoadExtension( 'UniversalLanguageSelector/ca' );
  • File:OOjs UI icon check-constructive.svg <translate> Done</translate> – <translate> Navigate to <tvar name=special>Special:Version</tvar> on your wiki to verify that the extension is successfully installed.</translate>


<translate> Vagrant installation:</translate>

  • <translate> If using <tvar name=vagrant>Vagrant </tvar>, install with <tvar name=code>vagrant roles enable uls --provision</tvar></translate>

Actualització de LanguageNameIndex

Per realitzar una recerca d'idiomes, buscant per un autònims, les dades de l'idioma necessiten ser omplertes. El Selector d'idiomes universal ve amb un índex de noms d'idiomes pre-omplerts (data/langnames.ser). En cas que vulgueu actualitzar-les, instal·leu Extension:CLDR i actualitzeu les dades amb la següent ordre. 

php UniversalLanguageSelector/data/LanguageNameIndexer.php

i verifiqueu que el fitxer langnames.ser s'ha generat en la carpeta UniversalLanguageSelector/data/.

Configuració

The following variables are created automatically during initialization and can be used from JavaScript using mw.config.get( NAME ):

  • wgULSLanguages - an associative array where the keys are language codes and the values are language names in English.
  • wgULSAcceptLanguageList - an array of language codes from the user's Accept-Language value. These are the languages selected in the user's browser preferences.

For serving fonts, you might want to add the following MIME types to your webserver if not already there. This guide might help. 

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

The following variables can also be configured:

  • $wgULSGeoService - ULS can use geolocation services to suggest languages based on the country the user is visiting from. Setting this to false will prevent builtin geolocation from being used. You can provide your own geolocation by setting window. Geo to object which has key 'country_code' or 'country'. If set to true, it will query Wikimedia's geoip service. The service should return jsonp that uses the supplied callback parameter. Defaults to http://freegeoip.net/json/ (warning: this website has shut down its API) and expects the same format.
  • $wgULSEnable - Enable language selection, compact language links, input methods and webfonts for everyone, unless the behavior is overridden by the configuration variables below. Even if false the classes and resource loader modules are registered for the use of other extensions. Language changing via cookie or setlang query parameter is not possible.
  • $wgULSAnonCanChangeLanguage - Allow anonymous users to change language with cookie and setlang query param. Do not use if you are caching anonymous page views without taking cookies into account. Does not have any effect if either of $wgULSEnable or $wgULSEnableAnon is set to false.
  • $wgULSIMEEnabled - Disable the input methods feature for all users by default. Can still be enabled manually by the user.
  • $wgULSPosition - The location and the form of the language selection trigger. The possible values are: personal: as a link near the username or the log in link in the personal toolbar (default). interlanguage: as an icon near the header of the list of interlanguage links in the sidebar.
  • $wgULSNoImeSelectors - Array of jQuery selectors of elements on which IME must not be enabled. eg: [ '#wpCaptchaWord' ];
  • $wgULSLanguageDetection - Whether to automatically detect the user's language from the Accept-Language header.

Position of ULS trigger

  • $wgULSPosition - The location and the form of the language selection trigger. The possible values are: personal: as a link near the username or the log in link in the personal toolbar (default). interlanguage: as an icon near the header of the list of interlanguage links in the sidebar.

It is also possible to have ULS trigger anywhere in the screen. An element with uls-settings-trigger 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):

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:

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

  • 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 font/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ó de les pàgines

UniversalLanguageSelector is one of the dependencies of the Extensió: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.

Alternate ways to load fonts

By specifying font-family

Inside the wiki text <span style="font-family:'YourFontName';">YourText</span>, 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 <span lang="my">YourText</span>, 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.

Exemple:

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

gives the text rendered in Cuneiform using Akkadian font

𒄖𒉈𒅁𒌨𒅎

Vegeu també

Retrieved from "https://www.linuxwebexpert.com/wiki/index.php?title=Extension:UniversalLanguageSelector/ca&oldid=18277"