Modèle:Lang/Documentation
Ce modèle a pour but d’indiquer la langue d’un texte, notamment pour les synthétiseurs vocaux et l’indexation correcte des inclusions de mots en langues différentes par les moteurs de recherche. Il permet aussi la personnalisation de la présentation des textes, en permettant aux utilisateurs de paramétrer les polices de caractères permettant d’afficher correctement chaque écriture.
Syntaxe
- Ancienne syntaxe :
{{Lang|code-langue|texte}}{{Lang|direction-langue|code-langue|texte}}
- Syntaxe améliorée (préférable car non ambigüe) :
{{Lang|code-langue|texte=texte}}{{Lang|code-langue|dir=direction-langue|texte=texte|trans=trans}}- Cette syntaxe est reconnue uniquement par l’utilisation explicite et alors obligatoire du paramètre nommé : texte=texte
- Paramètres :
- code-langue : obligatoire, code de langue du type RFC 4646 (voir plus bas)
- direction-langue : facultatif, direction de la langue, rtl (droite à gauche) ou ltr (gauche à droite), utile pour l'imbrication de textes dans des langues de directions différentes
- texte : obligatoire, texte en langue étrangère
- trans : facultatif, translittération du texte précédent (attention, ce n’est pas une traduction, mais une conversion lettre à lettre la plus proche possible de l’orthographe originale)
- Note :
- Si le contenu du texte en paramètre (ou sa mise en forme) peut contenir un signe '=', il est recommandé d’utiliser la nouvelle syntaxe (et donc de nommer ce paramètre explicitement, ainsi que le paramètre optionnel de direction).
- Exemples :
- Les effets sont a priori non visibles à l’écran (la police utilisée dépend du logiciel configuré par l’utilisateur), sauf ceux concernant la position (à droite ou à gauche) des ponctuations en début ou fin de textes écrits de droite à gauche
- {{lang|de|texte=Die {{II}}. Republik}}
- Die Modèle:II. Republik
- {{lang|ar|dir=rtl|texte=العربية...}}
- العربية...
- {{lang|de|Die ewige Wiederkehr des Gleichen}}
- Die ewige Wiederkehr des Gleichen
- {{lang|es|¿Qué tal güey?}}
- ¿Qué tal güey?
- {{lang|rtl|ar|العربية...}}
- العربية...
- {{lang|el|texte=ἡμερα|trans=êméra}}
- ἡμερα (êméra)
- {{lang|ja|texte=クレヨンしんちゃん|trans=Crayon Shin-chan}}
- クレヨンしんちゃん (Crayon Shin-chan)
Codes de langue
La liste des codes compatibles RFC 4646 se trouve à l’adresse suivante : http://www.iana.org/assignments/language-subtag-registry
Elle correspond à une extension de ISO 639, complété par les codes d’écritures ISO 15924, puis les codes de pays/régions ISO 3166. Voici quelques rappels de codes courants :
| Langue | Code | Notes |
|---|---|---|
| allemand | de | |
| alsacien | als | code utilisé aussi sur les projets Wikimedia pour l’alémanique (suisse allemand) |
| anglais | en | |
| arabe | ar | dir=rtl ; écriture pointée possible pour marquer les voyelles dans les textes traditionnels |
| arménien | hy | écriture arménienne |
| azéri | az | normalement en écriture latine moderne ; variante de l’alphabet latin : attention à la conversion majuscule/minuscule des i (qui sont distingués avec ou sans le point) |
| basque | eu | |
| bengali | bn | |
| breton | br | |
| bulgare | bg | |
| catalan | ca | |
| chinois simplifié | zh-Hans | sinogrammes han yue dans leur variante graphiques simplifiée, orthographe parfois différente |
| chinois traditionnel | zh-Hant | sinogrammes han yue dans leur variante graphique traditionnelle, orthographe parfois différente |
| coréen | ko | alphasyllabaire hangul, et quelques sinogrammes dans leur variante graphique traditionnelle hanzi |
| corse | co | |
| croate | hr | |
| danois | da | |
| espagnol | es | |
| français | fr | |
| finnois | fi | |
| grec ancien | grc | orthographe traditionnelle : polytonique (avec esprits, iota souscrits…) et anciennes lettres supplémentaires |
| grec moderne | el | orthographe simplifiée : monotonique (la plupart des diacritiques supprimés), mais formes distinctes (médiale et finale) pour le sigma minuscule |
| hébreu | he | dir=rtl ; deux orthographes possibles : pointée (traditionnelle) ou simplifiée (la majorité des diacritiques absents de l’utilisation moderne usuelle) |
| hindi | hi | écriture avec l’abugida devanagari |
| indonésien | id | |
| italien | it | |
| japonais | ja | alphasyllabaires hiragana, katakana et sinogrammes dans leurs variantes graphiques traditonnelles kanji |
| latin | la | alphabet de base normalement réduit (sans j, u, w, y) mais diacritiques possibles (usage principalement didactique) pour différencier les voyelles brèves ou longues |
| luxembourgeois | lu | |
| macédonien | mk | |
| néerlandais | nl | |
| occitan ; provençal | oc | |
| ourdou | ur | dir=rtl |
| persan ; farsi | fa | dir=rtl |
| polonais | pl | |
| portugais standard | pt | |
| portugais brésilien | pt-BR | |
| russe | ru | |
| serbe | sr | |
| suédois | sv | |
| thaï | th | |
| turc | tr | variante de l’alphabet latin : attention à la conversion majuscule/minuscule des i (qui sont distingués avec ou sans le point) |
| vietnamien | vi | alphabet latin étendu (voyelles diacritées et avec accents de ton) |
Changer l’apparence d’une langue
Afin de changer le style des caractères d’une langue en particulier, on peut se servir de la syntaxe CSS dédiée :lang(code-langue) dans son monobook.css. Exemples :
/* personnalisation de l’écriture latine étendue, pour la langue : vietnamien ;
ou pour l’API */
:lang(vi) {font-family: Segoe UI, Tahoma, Verdana, FreeSans, sans-serif}
/* personnalisation de l’écriture grecque, pour les langues : grec moderne (monotonique), grec ancien (polytonique) */
:lang(el), :lang(grc) {font-family: Athena, Segoe UI, Lucida Sans Unicode, Arial Unicode MS, Tahoma, FreeSans, sans-serif}
/* personnalisation de l’écriture cyrillique, pour les langues : russe, bulgare, serbe, macédonien, mongol moderne... */
:lang(ru), :lang(bg), :lang(sr), :lang(mk), :lang(mn) {font-family: Segoe UI, Tahoma, sans-serif}
/* personnalisation de l’écriture arabe, pour les langues : arabe, persan, urdu ;
taille augmentée mais interlignage par défaut conservé */
:lang(ar), :lang(fa), :lang(ur) {font-family: Segoe UI, Tahoma; font-size:1.25em}
/* personnalisation de l’écriture thaïe, pour la langue : thaï ;
taille réduite mais interlignage par défaut augmenté */
:lang(th) {font-family: Segoe UI, Tahoma, FreeSans; font-size:0.87em; line-height:1.4}
Attention aussi aux personnalisations de tailles de police dans votre feuille de style personnelle Monobook : elles peuvent éventuellement s’imbriquer et créer des tailles agrandies ou réduites plusieurs fois si les attributs "lang" sont utilisés ailleurs que sur les inclusions faites par ce modèle et modifient la mise en page des blocs (paragraphes, tableaux…). Il vaut mieux personnaliser la taille par défaut dans le seul élément "body" pour l’appliquer en une seule fois à toute la page, ou utiliser les fonctions d’agrandissement de texte ou de zoom de page intégrées dans votre navigateur.
Il vaut mieux ne pas personnaliser la direction du texte en fonction de l’écriture dans la feuille de style personnelle, car cela dépend de la présentation des pages, et certaines inclusions de textes peuvent avoir besoin de changer la direction par défaut. Ce modèle permet de préciser cette direction (rtl ou ltr) dans les articles, là où c’est nécessaire dans les pages.
