Bienvenue sur le wiki de Nuit debout, nous sommes le 3056 mars.
Modification de Modèle:Langue/Documentation
Attention : Vous n’êtes pas connecté. Votre adresse IP sera visible de tout le monde si vous faites des modifications. Si vous vous connectez ou créez un compte, vos modifications seront attribuées à votre nom d’utilisateur, entre autres avantages.
Cette modification va être défaite. Veuillez vérifier les modifications ci-dessous, puis publier si c’est bien ce que vous voulez faire.
Version actuelle | Votre texte | ||
Ligne 1 : | Ligne 1 : | ||
− | {{Sous-page de documentation}} {{Protection|nombre= | + | {{Sous-page de documentation}} {{Protection|nombre=290000}} {{Modèle utilisant les modules Lua|Module:Langue}} {{Raccourci de modèle|lang}} |
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. | 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 | + | '''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}} ''{{ | + | 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 == | ||
Ligne 13 : | Ligne 13 : | ||
'''Syntaxe simplifiée :''' | '''Syntaxe simplifiée :''' | ||
− | |||
* <code><nowiki>{{Langue|</nowiki>''code de langue''|''texte''<nowiki>}}</nowiki></code> | * <code><nowiki>{{Langue|</nowiki>''code de langue''|''texte''<nowiki>}}</nowiki></code> | ||
* <code><nowiki>{{Langue|</nowiki>''code de langue''|''texte''|trans=''trans''|dir=''direction-langue''<nowiki>}}</nowiki></code> | * <code><nowiki>{{Langue|</nowiki>''code de langue''|''texte''|trans=''trans''|dir=''direction-langue''<nowiki>}}</nowiki></code> | ||
− | La syntaxe simplifiée est déconseillée car elle n'affiche pas le texte si celui-ci contient un signe « = » | + | La syntaxe simplifiée est déconseillée car elle n'affiche pas le texte si celui-ci contient un signe « = » |
=== Paramètres === | === Paramètres === | ||
− | |||
<templatedata> | <templatedata> | ||
{ | { | ||
Ligne 53 : | Ligne 51 : | ||
== Exemples == | == 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 />{{lang|de|texte=Die {{II}}. Republik}} | |
− | + | * <code><nowiki>{{langue|ar|texte=العربية...|dir=rtl}}</nowiki></code> <br />{{lang|ar|texte=العربية...}} | |
− | * <code><nowiki>{{ | + | * <code><nowiki>{{langue|allemand|Die ewige Wiederkehr des Gleichen}}</nowiki></code> <br />{{lang|de|Die ewige Wiederkehr des Gleichen}} |
− | * <code><nowiki>{{ | + | * <code><nowiki>{{langue|es|¿Qué tal güey?}}</nowiki></code> <br />{{lang|es|¿Qué tal güey?}} |
− | * <code><nowiki>{{ | + | * <code><nowiki>{{lang|arabe|العربية...|dir=rtl}}</nowiki></code> <br />{{lang|ar|العربية...|dir=rtl}} |
− | * <code><nowiki>{{ | + | * <code><nowiki>{{lang|el|texte=ἡμέρα|trans=êméra}}</nowiki></code> <br />{{lang|el|texte=ἡμέρα|trans=êméra}} |
− | * <code><nowiki>{{ | + | * <code><nowiki>{{lang|ja|クレヨンしんちゃん|trans=Crayon Shin-chan}}</nowiki></code> <br />{{lang|ja|クレヨンしんちゃん|trans=Crayon Shin-chan}} |
− | * <code><nowiki>{{ | + | |
− | * <code><nowiki>{{ | + | |
== Liens internes == | == Liens internes == | ||
− | + | Le code à privilégier est celui-ci : <code><nowiki>''[[The New York Times|{{lang|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 == | == Italiques == | ||
− | + | Les italiques se mettent à l’extérieur. Voir [[Wikipédia:Atelier_accessibilité/Bonnes_pratiques#Changements_de_langue|Les bonnes pratiques d'accessibilité]]. | |
− | Les italiques se mettent à l’extérieur. Voir [[Wikipédia:Atelier_accessibilité/Bonnes_pratiques#Changements_de_langue| | + | |
'''Exemple''' : | '''Exemple''' : | ||
− | <code><nowiki>Les Directives pour l’Accessibilité du Contenu Web (''{{ | + | <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> | </code> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== Codes de langue == | == Codes de langue == | ||
Ligne 101 : | Ligne 76 : | ||
=== Codes principaux === | === Codes principaux === | ||
− | |||
{|class="sortable wikitable" | {|class="sortable wikitable" | ||
|- | |- | ||
Ligne 112 : | Ligne 86 : | ||
| anglais || '''en''' || | | anglais || '''en''' || | ||
|- | |- | ||
− | | arabe || '''ar''' || écriture avec l’alphabet perso-arabe | + | | arabe || '''ar''' || écriture avec l’alphabet perso-arabe. |
|- | |- | ||
| catalan || '''ca''' || | | catalan || '''ca''' || | ||
Ligne 129 : | Ligne 103 : | ||
|} | |} | ||
− | La liste complète des codes | + | La liste complète des codes accepté par le modèle : |
− | + | {{boite déroulante|titre= code de langue|contenu= | |
− | {{ | + | |
{{Colonnes|taille=18|1= | {{Colonnes|taille=18|1= | ||
{{#invoke:Langue|listeAliasCode}} | {{#invoke:Langue|listeAliasCode}} | ||
Ligne 137 : | Ligne 110 : | ||
}} | }} | ||
− | Si le code de langue dont vous avez besoin manque, demander sur le [[P:MD|projet modèle]]. Les codes de langue compatibles sont ceux qui suivent la | + | Si le code de langue dont vous avez besoin manque, demander sur le [[P:MD|projet modèle]]. Les codes de langue compatibles sont ceux qui suivent la recommandation {{nobr|BCP 47}} de l’[[Internet Engineering Task Force|IETF]]. La liste des composants utilisables issus notamment des normes {{nobr|[[ISO 639]]}}, {{nobr|[[ISO 15924]]}}, [[ISO 3166-1]], M.49 est publiée à l’adresse suivante : ''http://www.iana.org/assignments/language-subtag-registry''. Pour une rechercher un code de langue [http://people.w3.org/rishida/utils/subtags/ ce site] (en anglais) est recommandé. |
Certaines erreurs courantes sont automatiquement détectées et signalées dans la [[:catégorie:Page avec code de langue invalide]]. | Certaines erreurs courantes sont automatiquement détectées et signalées dans la [[:catégorie:Page avec code de langue invalide]]. | ||
− | === | + | === système d'écriture === |
− | + | La plupart de langues ont un système d’écriture par défaut. Lorsque la langue est écrite avec un autre système d’écriture, il est utile de le préciser, le modèle ou le navigateur pourra alors adapter le sens d'écriture ou la police utilisée. Ce code à quatre lettres suit le code langue principal, séparet par un tiret (-). | |
− | La plupart | + | |
− | + | ||
− | + | ||
− | + | Par exemple l'arabe (<code>ar</code>) est considéré comme écrit avec des caractère arabe, de droite à gauche. Si le texte est une translitération de l'arabe en alphabet latin, écrit de gauche à droite il faut utiliser le code de langue <code>ar-Latn</code>. | |
− | + | Exemple de code système d’écriture : | |
− | * | + | * latin : <code>Latn</code>, |
− | * | + | * arabe : <code>Arab</code>, |
− | * | + | * cyrillique : <code>Cyrl</code> |
− | * | + | * grec : <code>Grek</code>, |
− | * | + | * hébreux : <code>Hebr</code>, |
− | * | + | * sinogrammes traditionnels : <code>Hant</code>, |
− | + | * sinogrammes simplifiés : <code>Hans</code>, | |
− | * | + | * [[Tifinagh]] :<code>Tfng</code>. |
− | + | ||
− | * [[ | + | |
− | Pour la liste complète et pour tester si un code est valide, voir [http:// | + | Pour la liste complète et pour tester si un code est valide, voir [http://people.w3.org/rishida/utils/subtags/ ce site] (en anglais ; dans la boite de dialogue ''List'', sélectionner ''Regions'' et cliquer sur ''List'') |
=== Variété géographique === | === Variété géographique === | ||
+ | Pour prendre en compte les variété géographique, un code pays [[ISO 3166-1]] à deux lettres peut-être ajouté, séparé par un tiret (-). | ||
− | + | '''Exemple''' : <code>fr-CA</code> pour le français québecois. | |
− | '' | + | Pour les dialectes d'une régions n'ayant pas de code de langue propre, il faut utiliser le code de langue le plus proche. |
− | + | '''Exemple''' : <code>oc</code> pour le gascon et le provençal, qui sont des dialectes de l'occitan (ou langue d’oc). | |
− | |||
== Changer l’apparence d’une langue == | == 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 | + | 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 ; | /* personnalisation de l’écriture latine étendue, pour la langue : vietnamien ; | ||
Ligne 185 : | Ligne 153 : | ||
/* personnalisation de l’écriture cyrillique, pour les langues : russe, bulgare, serbe, macédonien, mongol moderne... */ | /* 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 | + | :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 ; | /* personnalisation de l’écriture arabe, pour les langues : arabe, persan, ourdou ; | ||
taille augmentée mais interlignage par défaut conservé */ | taille augmentée mais interlignage par défaut conservé */ | ||
− | :lang(ar), :lang(fa), :lang(ur) {font-family: Segoe UI, Tahoma; font-size: 1.25em | + | :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ï ; | /* personnalisation de l’écriture thaïe, pour la langue : thaï ; | ||
taille réduite mais interlignage par défaut augmenté */ | 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 | + | :lang(th) {font-family: Segoe UI, Tahoma, FreeSans; font-size:0.87em; line-height:1.4} |
− | Note : Si un | + | 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…). | + | 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 == | == Notes et références == | ||
Ligne 207 : | Ligne 175 : | ||
* {{m|Code langue}} | * {{m|Code langue}} | ||
* {{m|Langue du titre}} | * {{m|Langue du titre}} | ||
− | |||
− | |||
<includeonly> | <includeonly> | ||
[[Catégorie:Modèle pour les langues|*]] | [[Catégorie:Modèle pour les langues|*]] | ||
</includeonly> | </includeonly> |