Modification de Modèle:Langue/Documentation

{{Sous-page de documentation}}<includeonly>{{Protection}}</includeonly>

'''{{m|langue}}''' est similaire à {{m|lang}} mais permet d’employer dans certains cas le nom de la langue en toutes lettres.

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.

'''La mention d’un changement de langue est une information essentielle pour l’[[Wikipédia:Atelier accessibilité|accessibilité du contenu]]. Elle est également utile aux outils de traduction automatiques'''.

Les normes internationales d’accessibilité imposent de signaler un changement de langue, excepté {{Citation|pour un nom propre, pour un terme technique, pour un mot dont la langue est indéterminée ou pour un mot ou une expression faisant partie du langage courant}}<ref>[http://www.w3.org/TR/WCAG20/#meaning {{en}} ''{{lang|en|Web Content Accessibility Guidelines (WCAG) 2.0}}'', ''{{lang|en|3.1.2 Language of Parts}}'']</ref> pour lesquels cela n’a pas de caractère obligatoire. Le [http://www.w3.org/WAI/GL groupe de travail sur les directives d'accessibilité du contenu Web] du [http://www.w3.org W3C] souligne que des mots pris individuellement peuvent « faire partie » de la langue qui les accueille ; il n’y a donc pas lieu de signaler dans ces situations un changement de langue ; un critère pour décider de la stratégie à employer dans ces situations peut être de vérifier si « le mot se prononcerait de la même façon dans la langue du texte qui l’entoure (en dehors de simples problèmes d’accent ou d’intonation) »<ref>[http://www.w3.org/TR/2008/NOTE-UNDERSTANDING-WCAG20-20081211/meaning-other-lang-id.html {{en}} ''{{lang|en|Understanding WCAG 2.0}}'', ''{{lang|en|Language of Parts}}'' : ''{{lang|en|Understanding {{abr|SC|Success Criterion}} 3.1.2}}'']. Cette page recommande ainsi de ne pas signaler par un attribut spécifique une utilisation du mot « rendezvous » au sein d’un texte en [[anglais]], ou du mot « podcast » au sein d’un texte en [[français]].</ref>.

== Syntaxe ==

=== Syntaxe ===

* <code><nowiki>{{Lang|</nowiki>''code-langue''|texte=''texte''}}</code>
* <code><nowiki>{{Lang|</nowiki>''code-langue''|dir=''direction-langue''|texte=''texte''|trans=''trans''}}</code>

=== Syntaxe simplifiée ===

* <code><nowiki>{{Lang|</nowiki>''nom-de-langue''|''texte''}}</code>
cette syntaxte est déconseillé car elle n'affiche pas le texte si celui-ci contient un signe « = »

=== Paramètres ===

<templatedata>
{
        "description": "Ce modèle indique 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.",
        "params": {
                "1": {
                        "label": "Nom de langue",
                        "description": "Nom français ou code IETF de la langue du texte inclu",
                        "type": "string",
                        "required": true
                },
                "texte": {
                        "label": "Texte",
                        "description": "Entrez ici le texte en langue étrangère.",
                        "type": "string",
                        "required": true,
                        "aliases": ["2"]
                },
                "trans": {
                        "label": "Translittération",
                        "description": "Translittération du texte. Attention, ce n’est pas une traduction, mais une conversion lettre à lettre la plus proche possible de l’orthographe originale.",
                        "type": "string",
                        "required": false
                },
                "dir": {
                        "label": "Direction",
                        "description": "Direction de la langue : rtl (de droite à gauche) ou ltr (de gauche à droite) ; Sera déterminé automatiquement en fonction de la langue s'il n'est pas précisé.",
                        "type": "string",
                        "required": false
                }
        }
}
</templatedata>

== 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''.

* <code><nowiki>{{langue|de|texte=Die {{II}}. Republik}}</nowiki></code> <br />{{langue|de|texte=Die {{II}}. Republik}}
* <code><nowiki>{{langue|allemand|texte=Die {{II}}. Republik}}</nowiki></code> <br />{{langue|allemand|texte=Die {{II}}. Republik}}
* <code><nowiki>{{lang|arabe|texte=العربية...}}</nowiki></code> <br />{{lang|arabe|texte=العربية...}}
* <code><nowiki>{{lang|es|¿Qué tal güey?}}</nowiki></code> <br />{{lang|es|¿Qué tal güey?}}
* <code><nowiki>{{lang|el|texte=ἡμέρα|trans=êméra}}</nowiki></code> <br />{{lang|el|texte=ἡμέρα|trans=êméra}}
* <code><nowiki>{{lang|japonais|texte=クレヨンしんちゃん|trans=Crayon Shin-chan}}</nowiki></code> <br />{{lang|japonais|texte=クレヨンしんちゃん|trans=Crayon Shin-chan}}

== Liens internes ==
Le code à privilégier est celui-ci : <code><nowiki>''[[The New York Times|{{langue|en|The New York Times}}]]''</nowiki></code>. (Voir [[Discussion_Wikipédia:Atelier_accessibilité/Archives_accessibilité_2010_-_premier_semestre#Mod.C3.A8le:Lang_et_liens_internes|Cette discussion]])

== Italiques ==

Les italiques se mettent à l’extérieur. Voir [[Wikipédia:Atelier_accessibilité/Bonnes_pratiques#Changements_de_langue|Les bonnes pratiques d'accessibilité]].

Exemple :

<code><nowiki>Les Directives pour l’Accessibilité du Contenu Web (''{{lang|en|Web Content Accessibility Guidelines}}'') ont été publiées en 1999 par la ''[[Web Accessibility Initiative|{{lang|en|Web Accessibility Initiative}}]]'' du [[World Wide Web Consortium|W3C]].</nowiki>
</code>

== Nom de langue ==
Les langues les plus courrantes peuvent être renseigné par leur nom. La liste est détaillé dans la documentation du modèle {{m|Code langue}}

Dans tout les cas les codes de langue qui suivent la recommandation BCP 47 de l’IETF sont compatibles.
La liste des composants utilisables est publiée à l’adresse suivante : ''http://www.iana.org/assignments/language-subtag-registry''.

== 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 <code>:lang(''code-langue'')</code> dans son [[Special:Mypage/monobook.css|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, ourdou ;
    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}

Note : Si un navigateur ne supporte pas les sélecteurs CSS normalisés <code>:lang(''xxx'')</code>, il est possible d’utiliser dans une feuille de style personnelle les sélecteurs de classes CSS nommés <code>.lang-''xxx''</code> à la place, mais de façon moins précise (et non normalisée, spécifique à cette implémentation sur Wikipédia).

Attention aussi aux personnalisations de tailles de police dans une feuille de style personnelle Monobook : elles peuvent éventuellement s’imbriquer et créer des tailles agrandies ou réduites plusieurs fois si les attributs « <code>lang</code> » 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 « <code>body</code> » 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 (''<code>rtl</code>'' ou ''<code>ltr</code>'') dans les articles, là où c’est nécessaire dans les pages.

== Notes et références ==
<references />

== Voir aussi ==
* {{m|Lang}}
* {{m|Langue du titre}}
* {{m|Code langue}} pour la liste des noms de langue employables.

<includeonly>
[[Catégorie:Modèle pour les langues|*]]
</includeonly>