Modèle:Lang-Documentation - Historique des versions

- Hermes - : corr ortho

2018-01-15T18:17:21Z

corr ortho

- Hermes - : ajout {{Sommaire à gauche}} + cat

2012-11-16T13:00:46Z

ajout {{Sommaire à gauche}} + cat

- Hermes - : ajout modèles lang ékopédia et Base ékopédia

2012-03-21T14:31:54Z

ajout modèles lang ékopédia et Base ékopédia

- Hermes - : créate

2012-03-21T14:24:33Z

créate

Nouvelle page

{{Wikipedia|Modèle:Lang/Documentation}}
 
<noinclude>{{documentation modèle vue directement}}</noinclude>

Le modèle "Lang" sur les wikis (Wikipédia, Ekopédia, etc ) 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, 3.1.2 Language of Parts}}'']</ref> pour lesquels cela n’a pas de caractère obligatoire. Le ''{{lang|en|WWC Working group}}'' 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, Language of Parts:Understanding SC 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 par défaut ===

: <code><nowiki>{{Lang|</nowiki>''code-langue''|''texte''}}</code>
: <code><nowiki>{{Lang|</nowiki>''direction-langue''|''code-langue''|''texte''}}</code>

=== Syntaxe explicite ===

: <code><nowiki>{{Lang|</nowiki>''code-langue''|texte=''texte''}}</code>
: <code><nowiki>{{Lang|</nowiki>''code-langue''|dir=''direction-langue''|texte=''texte''|trans=''trans''}}</code>
: Cette syntaxe est reconnue uniquement par l’utilisation explicite et alors obligatoire du paramètre '''nommé''' : <code>texte=</code>''texte''

=== Paramètres ===

* ''code-langue'' : obligatoire, doit être un [[code de langue IETF]] (voir [[#Codes de langue|plus loin]])
* ''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 syntaxe explicite (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''
* <code><nowiki>{{lang|de|texte=Die {{II}}. Republik}}</nowiki></code> {{lang|de|texte=Die {{II}}. Republik}}
* <code><nowiki>{{lang|ar|dir=rtl|texte=العربية...}}</nowiki></code> {{lang|ar|dir=rtl|texte=العربية...}}
* <code><nowiki>{{lang|de|Die ewige Wiederkehr des Gleichen}}</nowiki></code> {{lang|de|Die ewige Wiederkehr des Gleichen}}
* <code><nowiki>{{lang|es|¿Qué tal güey?}}</nowiki></code> {{lang|es|¿Qué tal güey?}}
* <code><nowiki>{{lang|rtl|ar|العربية...}}</nowiki></code> {{lang|rtl|ar|العربية...}}
* <code><nowiki>{{lang|el|texte=ἡμέρα|trans=êméra}}</nowiki></code> {{lang|el|texte=ἡμέρα|trans=êméra}}
* <code><nowiki>{{lang|ja|texte=クレヨンしんちゃん|trans=Crayon Shin-chan}}</nowiki></code> {{lang|ja|texte=クレヨンしんちゃん|trans=Crayon Shin-chan}}

== Italiques ==

Les italiques se mettent à l’extérieur.

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>

== Codes de langue ==
{{article détaillé|Code de langue IETF}}

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

Certaines erreurs courantes sont automatiquement détectées et signalées dans la [[:catégorie:Page avec code de langue invalide]].

Voici quelques codes courants :

{|class="sortable wikitable"
|-
!scope="col"| Langue
!scope="col"| Code
!scope="col"| Notes
|-
| allemand || '''de''' ||
|-
| alsacien || '''gsw''' || (alémanique, également suisse allemand)
|-
| anglais || '''en''' ||
|-
| arabe || '''ar''' || dir='''rtl''' ; écriture avec l’alphabet perso-arabe ; écriture pointée possible pour marquer les voyelles dans les textes traditionnels
|-
| arménien || '''hy''' || [[alphabet arménien|é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''' || écriture avec l’alphasyllabaire bengali
|-
| breton || '''br''' ||
|-
| bulgare || '''bg''' ||
|-
| catalan || '''ca''' ||
|-
| chinois simplifié || '''zh-Hans''' || sinogrammes dans leur variante graphiques simplifiée, orthographe parfois différente
|-
| chinois traditionnel || '''zh-Hant''' || sinogrammes 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''' ||
|-
|[[français de Belgique]] || '''fr-BE''' ||
|-
|[[français de France]] || '''fr-FR''' ||
|-
|[[français de Suisse]] || '''fr-CH''' ||
|-
|[[français québécois]] || '''fr-CA''' ||
|-
|[[ancien français]] || fro || de 842 à 1400 environ
|-
|[[moyen français]] ||frm || de 1400 environ à 1600 environ
|-
| finnois || '''fi''' ||
|-
| grec ancien <ref>IANA, [http://www.iana.org/assignments/language-subtag-registry www.iana.org/assignments/language-subtag-registry].</ref> || '''grc''' || orthographe traditionnelle : polytonique (avec esprits, iota souscrits…) et anciennes lettres supplémentaires <ref>IANA, [http://www.iana.org/assignments/language-subtag-registry www.iana.org/assignments/language-subtag-registry].</ref>
|-
| grec moderne <ref>IANA, [http://www.iana.org/assignments/language-subtag-registry www.iana.org/assignments/language-subtag-registry].</ref> || '''el''' || formes distinctes (médiale et finale) pour le sigma minuscule <ref>IANA, [http://www.iana.org/assignments/language-subtag-registry www.iana.org/assignments/language-subtag-registry].</ref>
|-
| 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 traditionnelles ''kanji''
|-
| khmer || '''km''' || écriture avec l’alphasyllabaire khmer (cambodgien)
|-
| 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
|-
| laotien || '''lo''' || écriture avec l’alphasyllabaire laotien
|-
| luxembourgeois || '''lb''' ||
|-
| macédonien || '''mk''' || écriture avec l’alphabet cyrillique
|-
| néerlandais || '''nl''' ||
|-
| occitan ; provençal || '''oc''' ||
|-
| ourdou || '''ur''' || dir='''rtl''' ; écriture avec l’alphabet perso-arabe ; écriture pointée possible pour marquer les voyelles dans les textes traditionnels
|-
| persan ; farsi || '''fa''' || dir='''rtl''' ; écriture avec l’alphabet perso-arabe ; écriture pointée possible pour marquer les voyelles dans les textes traditionnels
|-
| phénicien || '''phn''' || dir='''rtl'''
|-
| polonais || '''pl''' ||
|-
| portugais standard || '''pt''' ||
|-
| portugais brésilien || '''pt-BR''' ||
|-
| russe || '''ru''' ||
|-
| serbe || '''sr''' || écriture avec l’alphabet latin ou l’alphabet cyrillique
|-
| suédois || '''sv''' ||
|-
| thaï || '''th''' || écriture avec l’alphasyllabaire thaï
|-
| tibétain || '''bo''' || écriture avec l’alphasyllabaire tibétain
|-
| 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 <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-eko}} Modèle pour Accès aux 7 versions linguistiques d'Ekopédia
* {{m|Lang:isl}} Ce modèle est destinée à l'indication d'un mot, d'un passage ou d'une référence en islandais.

<includeonly>

[[Catégorie:Modèle pour les langues|*]]


[[ab:Шаблон:Lang]]
[[ace:Templat:Lang]]
[[af:Sjabloon:Lang]]
[[als:Vorlage:Lang]]
[[am:መለጠፊያ:Lang]]
[[an:Plantilla:Lang]]
[[ang:Bysen:Lang]]
[[ar:قالب:Lang]]
[[ast:Plantía:Lang]]
[[av:Шаблон:Lang]]
[[ay:Plantilla:Lang]]
[[az:Şablon:Dillər]]
[[bar:Vorlage:Lang]]
[[be-x-old:Шаблён:Мова]]
[[bg:Шаблон:lang]]

[[ca:Plantilla:Lang]]
[[cr:Template:Lang]]
[[cs:Šablona:Jazyk]]
[[cv:Шаблон:Lang]]
[[da:Skabelon:Lang]]
[[de:Vorlage:Lang]]
[[en:Template:Lang]]
[[eo:Ŝablono:Lang]]
[[es:Plantilla:Lang]]
[[et:Mall:Keel]]
[[fa:الگو:Lang]]
[[gl:Modelo:Lang]]
[[gu:ઢાંચો:Lang]]
[[hi:साँचा:Lang]]
[[hsb:Předłoha:Lang]]

[[hu:Sablon:Lang]]
[[ia:Patrono:Lang]]
[[id:Templat:Lang]]
[[it:Template:Lang]]
[[ja:Template:Lang]]
[[ka:თარგი:Lang]]
[[ko:틀:Lang]]
[[ksh:Schablon:Lang]]
[[lbe:Шаблон:Lang]]
[[lv:Veidne:Lang]]
[[mk:Шаблон:Lang]]
[[ms:Templat:Lang]]
[[new:Template:Lang]]
[[nl:Sjabloon:Lang]]
[[no:Mal:Lang]]

[[pt:Predefinição:Lang]]
[[qu:Plantilla:Lang]]
[[ro:Format:Lang]]
[[ru:Шаблон:Lang]]
[[simple:Template:Lang]]
[[sk:Šablóna:Lang]]
[[sl:Predloga:Jezik]]
[[sq:Stampa:Lang]]
[[sr:Шаблон:Јез]]
[[sv:Mall:Lang]]
[[tl:Suleras:Lang]]
[[tr:Şablon:Diller]]
[[uk:Шаблон:Lang]]
[[vi:Tiêu bản:Lang]]
[[xal:Зура:Lang]]
[[zh:Template:Lang]]
[[zh-min-nan:Template:Lang]]
[[zh-yue:Template:話]]
[[zu:Template:Lang]]

</includeonly><noinclude>[[Catégorie:Modèle d'indication de langue|*]]</noinclude>

@@ Ligne 212 : / Ligne 212 : @@
 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 ==

@@ Ligne 1 : / Ligne 1 : @@
 <br />
-{{Wikipedia|Modèle:Lang/Documentation}}
+<noinclude>{{documentation modèle vue directement}}</noinclude>
 <br />
 Le modèle "Lang" sur les wikis (Wikipédia, Ekopédia, etc ) 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, 3.1.2 Language of Parts}}'']</ref> pour lesquels cela n’a pas de caractère obligatoire. Le ''{{lang|en|WWC Working group}}'' 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, Language of Parts:Understanding SC 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>.
+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, 3.1.2 Language of Parts}}'']</ref> pour lesquels cela n’a pas de caractère obligatoire. Le ''{{lang|en|WWC Working group}}'' 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, Language of Parts:Understanding SC 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>.<br />
 == Syntaxe ==
@@ Ligne 16 : / Ligne 22 : @@
 : <code><nowiki>{{Lang|</nowiki>''code-langue''|''texte''}}</code>
 : <code><nowiki>{{Lang|</nowiki>''direction-langue''|''code-langue''|''texte''}}</code>
+<br />
 === Syntaxe explicite ===
@@ Ligne 204 : / Ligne 212 : @@
 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-eko}} Modèle pour Accès aux 7 versions linguistiques d'Ekopédia (voir ci-dessous);
-* {{m|Lang-eko-BASE}} Modèle pour Accès aux 7 versions linguistiques d'Ekopédia BASE d'Images (voir ci-dessous);
+* '''[[Unicode]]'''
-* {{m|Lang:isl}} Ce modèle est destinée à l'indication d'un mot, d'un passage ou d'une référence en islandais.
+* {{m|Lang-eko}} Modèle pour Accès aux 7 versions linguistiques d''''Ekopédia Encyclopédie''' ''(voir ci-dessous)''
 <br />
-{{Lang-eko}}
+----
-{{Lang-eko-BASE}}
+----
 <includeonly>
 <br />
@@ Ligne 288 : / Ligne 305 : @@
 [[zu:Template:Lang]]
-</includeonly><noinclude>[[Catégorie:Modèle d'indication de langue|*]]</noinclude>
+</includeonly><noinclude>[[Catégorie:Informatique]][[Catégorie:Modèle d'indication de langue|*]]</noinclude>