El propósito de esta plantilla es indicar que un fragmento de texto pertenece a un idioma en particular distinto del de la página en su conjunto (por defecto, inglés, en esta Wikipedia). Se puede utilizar en línea o alrededor de elementos a nivel de bloque, como <poem>párrafos, listas o divs.
La plantilla pone el texto en cursiva de forma predeterminada (esto se puede suprimir y no se aplica a ciertas escrituras) y puede indicar a los navegadores web que utilicen una fuente más apropiada o a los lectores de pantalla que utilicen un tipo de pronunciación particular, etc. Consulte el § Fundamento para obtener más información.
{{lang|language tag|text}}
La etiqueta de idioma debe constar de un código de idioma ISO-639 . Consulta la lista de códigos ISO 639-1 para ver códigos de dos letras; si no encuentras el idioma que buscas, consulta la lista de códigos ISO 639-3 .
La plantilla también admite etiquetas de idioma IETF con el formato correcto mediante subetiquetas que identifican el alfabeto, la región o la variante del idioma. El código de idioma ISO 639 es una abreviatura de dos o tres letras, en minúscula, del nombre del idioma. El francés, por ejemplo, tiene el código fr:
.svg/1280px-Test_Template_Info-Icon_-_Version_(2).svg.png){kind=icon}
She said: "{{lang|fr|Je suis française.}}"→ Ella dijo: " Je suis française " .Dado que todos los idiomas representados por códigos de dos letras en la norma ISO 639-1 también pueden representarse por sus equivalentes de tres letras en la norma ISO 639-2 y superiores, se recomienda utilizar la etiqueta de idioma más corta posible que describa suficientemente el idioma de destino. [1] Por lo tanto, si bien el francés puede representarse mediante frael código de la norma ISO 639-2, utilice fren su lugar el código ISO 639-1. Asimismo, la información sobre el alfabeto, la región y las variantes debe incluirse solo cuando proporcionen una distinción necesaria. Para obtener una lista actualizada de los códigos de idioma, alfabeto, región y variante disponibles, consulte el registro de subetiquetas de idioma de la IANA .
De forma predeterminada, esta plantilla colocará los artículos en la subcategoría correspondiente de Categoría:Artículos que contienen texto en un idioma distinto del inglés . Para evitar esto (por ejemplo, cuando se utiliza {{lang}} dentro de un enlace wiki o el parámetro de título de una cita), agregue el parámetro |cat=no.
{{lang}}aplica automáticamente el estilo cursiva cuando el texto {{{2}}}está escrito completamente en Latnel alfabeto latino (y sus extensiones), ya sea cuando esa es la codificación predeterminada para el idioma o cuando lo activa un xx-Latncódigo de idioma:
{{lang|fr|Je suis française.}}→ Soy francés.''{{lang|fr|Je suis française.}}''→ Je suis française. – el marcado externo se ignora{{lang|he-Latn|la'az}} ({{lang|he|לעז}})→ la'az ( לעז )''{{lang|he-Latn|la'az}}'' (''{{lang|he|לעז}}'')→ la'az ( לעז ): el marcado externo se ignora alrededor del he-Latntexto, pero pondrá en cursiva incorrectamente el material con caracteres hebreos.Cuando Latnel script no debe estar en cursiva, existen varios enfoques: |italic=no – se muestra {{{2}}}en fuente vertical; el marcado en cursiva alrededor de la plantilla se ignora; el marcado en cursiva dentro de la plantilla genera un mensaje de error:
{{lang|fr|Je suis française.|italic=no}}→ Soy francés.''{{lang|fr|Je suis française.|italic=no}}''→ Soy francés.''{{lang|fr|Je suis ''française''.|italic=no}}''→ [Je suis française .] Error: {{Lang}}: el texto tiene marcado en cursiva ( ayuda ) – marcado en cursiva en conflicto con|italic=no|italic=unset – deshabilita el estilo proporcionado por la plantilla; {{{2}}}su estilo se ajusta según el marcado wiki externo o interno:
{{lang|fr|Je suis française.|italic=unset}}→ Soy francés.''{{lang|fr|Je suis française.|italic=unset}}''→ Soy francés.{{lang|fr|''Je suis'' English.|italic=unset}}→ Yo soy inglés.{{noitalic}} También se puede utilizar:
{{lang|fr|Je suis {{noitalic|English}}.}}→ Yo soy inglés .Existe una versión de esta plantilla, {{ langx }} , que está pensada para utilizarse la primera vez que aparece un idioma en un artículo. Estas plantillas imprimirán el nombre del idioma y, cuando corresponda, pondrán su contenido en cursiva:
A '''kremlin''' ({{langx|ru|кремль}}, 'castle') is a major fortified central complex ...→ Un kremlin ( en ruso : кремль , 'castillo') es un importante complejo central fortificado...Si bien la {{langx}}plantilla genera texto en cursiva para idiomas con escritura basada en el latín, si se requiere texto simple, como para nombres propios, |italic=nose puede utilizar:{{noitalic}}
the border town of Ventimiglia ({{langx|fr|Vintimille}})→ la ciudad fronteriza de Ventimiglia ( en francés : Vintimille )the border town of Ventimiglia ({{langx|fr|italic=no|Vintimille}})→ la ciudad fronteriza de Ventimiglia ( en francés : Vintimille )the border town of Ventimiglia ({{langx|fr|{{noitalic|Vintimille}}}})→ la ciudad fronteriza de Ventimiglia ( en francés : Vintimille )Al formatear texto en un idioma extranjero para que se ajuste a las pautas de estilo, es mejor excluir el marcado de estilo de la plantilla, de modo que cualquier marcado extraño que no sea del idioma extranjero no reciba metadatos incorrectos para ese idioma. Esto incluye: comillas en inglés alrededor de títulos de obras en idiomas que usan otros glifos de caracteres de comillas; cursiva de títulos en idiomas que no usan esa convención; y énfasis que no se encuentra (en un estilo u otro) en el texto extranjero original; entre otros casos. En caso de duda, coloque ese marcado fuera de la plantilla cuando sea posible.
{{lang|cel-x-proto|kal-}}→ * kal-{{lang|cel-x-proto|kal-|proto=no}}→ kal-{{langx|cel-x-proto|kal-}}→ Protocelta : * kal-{{langx|cel-x-proto|kal-|proto=no}}→ Protocelta : kal-{{lang|en|accidently}}→ accidentalmente{{lang|en|accidently|proto=yes}}→ * accidentalmentePara incrustar una cadena de texto de derecha a izquierda (como árabe o hebreo ) dentro del contexto habitual de izquierda a derecha, |rtl=yesse debe agregar para comunicar correctamente la dirección de escritura. Para marcar un párrafo completo de texto de derecha a izquierda, se debe usar {{ rtl-para }} en su lugar.
Cualquiera de estos enfoques envolverá el texto en un contenedor con el dir="rtl"atributo. Para garantizar una representación correcta en navegadores que no son totalmente compatibles con el aislamiento bidireccional de HTML5 , también se agrega una marca de izquierda a derecha al final del texto (consulte el W3C para obtener más detalles).
Tenga en cuenta que no es necesario especificar la dirección del texto al utilizar las plantillas, ya que así lo implica el idioma de la plantilla.{{lang-xx}}
† comparar |italic=invertcon |italic=unset:
{{Lang|de|... ein neues Opernprojekt in Angriff: ''Das Käthchen von Heilbronn'', nach Heinrich von Kleists gleichnamigem Drama.|italic=invert}}{{Lang|de|''... ein neues Opernprojekt in Angriff: ''Das Käthchen von Heilbronn'', nach Heinrich von Kleists gleichnamigem Drama.''|italic=unset}}{{lang}}utiliza la función Lua lang() Module:Lang . Ese módulo también admite todas las {{lang-??}}plantillas que utilizan las funciones Lua lang_xx_inherit()y lang_xx_italic(). El módulo tiene otras funciones que pueden resultar útiles. El parámetro selector de función |fn=le indica a module:lang qué función ejecutar. Las funciones disponibles son:
is_ietf_tag– devuelve truesi la etiqueta de idioma IETF proporcionada es válida; nulo en caso contrario{{lang|fn=is_ietf_tag|nv}}→verdadero←{{lang|fn=is_ietf_tag|xx}}→←is_lang_name– devuelve truesi el nombre del idioma proporcionado es válido; nulo en caso contrario{{lang|fn=is_lang_name|navajo}}→verdadero←{{lang|fn=is_lang_name|xxxxx}}→←lang– la función que representa {{lang}}; se incluye aquí para completar, este uso particular es más o menos inútillang_xx_inherit– la función que representa {{lang-??}}la plantilla donde el texto no está en cursiva; se puede utilizar cuando una {{lang-??}}plantilla, por ejemplo {{lang-aao}}, no existe para un idioma en particular:{{lang|fn=lang_xx_inherit|code=aao|Algerian Saharan Arabic text}}→ Árabe sahariano argelino : texto en árabe sahariano argelinolang_xx_italic– la función que representa {{lang-??}}la plantilla donde el texto está en cursiva; se puede utilizar cuando una {{lang-??}}plantilla, por ejemplo {{lang-svc}}, no existe para un idioma en particular:{{lang|fn=lang_xx_italic|code=svc|Vincentian Creole English text}}→ Inglés criollo vicentino : Texto en inglés criollo vicentinoname_from_tag– devuelve el nombre del idioma asociado con la etiqueta de idioma IETF proporcionada:{{lang|fn=name_from_tag|apa}}→ Lenguajes Apachetag_from_name– devuelve el código de idioma ISO 639 (a veces, etiqueta de idioma IETF) asociado con el nombre de idioma proporcionado:{{lang|fn=tag_from_name|havasupai}}→ yuf-x-havtransl– la función que representa ; se incluye aquí para completar, este uso particular es más o menos inútil{{transl}}{{lang|fn=transl|ar|DIN|al-Ḫawārizmī}}→ al-HawārizmīSi es necesario, se puede añadir un código de escritura ISO 15924 a un código de idioma para indicar el uso de una escritura específica. Por ejemplo, el tayiko ( tg) es un idioma que se puede encontrar escrito en alfabetos árabe ( Arab), latino ( Latn) y cirílico ( Cyrl), por lo que es necesario especificar siempre qué alfabeto se utiliza. En tal caso, teniendo cuidado de preservar la capitalización del código de escritura, podríamos terminar con el siguiente código (las etiquetas de idioma en negrita):
Tajik ({{lang|tg-Arab|rtl=yes|تاجیکی}}, {{lang|tg-Latn|toçikī}}, {{lang|tg-Cyrl|тоҷикӣ}})Sin embargo, muchos idiomas se escriben con tanta frecuencia en un sistema de escritura en particular que no es necesario especificarlo. El ruso, por ejemplo, se escribe casi exclusivamente en cirílico, por lo que no es necesario especificarlo ru-Cyrl, tal como en-Latnno sería necesario en el caso del inglés. El registro de subetiquetas contiene información actualizada sobre qué idiomas tienen códigos de escritura comunes que deberían "suprimirse".
Para marcar un idioma que ha sido transliterado de un alfabeto a otro, añada el código del nuevo alfabeto al código del idioma original. Por lo tanto, si se translitera del cirílico ruso a un alfabeto latino, la etiqueta de idioma en la transliteración sería ru-Latn. Si se conoce el esquema de transliteración y se incluye como una "variante" en el registro de subetiquetas, se puede agregar después de cualquier código de alfabeto y región. Por ejemplo, el chino transliterado a un alfabeto latino utilizando el sistema pinyin sería zh-Latn-pinyin. Para facilitar la transliteración a alfabetos latinos y para solucionar problemas de estilo del navegador con algunas combinaciones de idiomas y alfabetos, se puede utilizar {{ transliteration }} en lugar de {{lang}} :
Moscow ({{lang|ru|Москва}}, {{transliteration|ru|Moskva}})→ Moscú ( Москва , Moskva )Para especificar un esquema de transliteración, como el estándar de transliteración ISO para cirílico , utilice {{transliteration|ru|ISO|Moskva}}.
La plantilla {{lang}} no solo se utiliza para especificar el idioma de palabras extranjeras, sino que también se puede utilizar para especificar un solo símbolo o carácter en una escritura, no relacionado con ningún idioma específico. Muchas veces el carácter o símbolo se utiliza en varios idiomas, pero cuando el artículo se refiere al grafema en sí, se debe utilizar el código de idioma ISO 639‑2und , para "Idioma indeterminado":
The Chinese character {{lang|und-Hani|字}} has 6 strokes.Los caracteres chinos ( también conocidos como caracteres Han ) se han utilizado para escribir chino, japonés, coreano, vietnamita y muchos otros idiomas . En este caso, el carácter no representa un uso específico de ningún idioma en particular. Tenga en cuenta que el código de escritura utilizado es Hani, que especifica los caracteres chinos en general, a diferencia de Hanty Hanspara los caracteres tradicionales o simplificados respectivamente.
Compare el uso de {{ script }} :
The Chinese character {{script|Hani|字}} has 6 strokes.El código mis, para "Varios", para indicar cualquier idioma no incluido en la norma ISO-639.
Cuando sea necesario indicar un idioma específico de una región, se debe agregar un código de país ISO 3166-1 alfa-2 o un código de región UN M49pt a la etiqueta de idioma, teniendo cuidado de preservar la capitalización. Por ejemplo, el portugués ( ) tal como se usa en Brasil ( BR) podría representarse como pt-BR, y el español tal como se usa en América Latina como es-419.
Además, los códigos de idioma, escritura y región pueden aparecer todos en la misma etiqueta. Por ejemplo, el código zh-Hant-TWdebe usarse para texto chino escrito con caracteres Han tradicionales , que contengan palabras o expresiones específicas de Taiwán :
Taiwan ({{lang|zh-Hant-TW|臺灣}}, {{transliteration|zh|Táiwān}})Esta plantilla admite varias etiquetas de idioma IETF de uso privado . Las etiquetas de uso privado contienen el -x-singleton y la plantilla las utiliza para identificar idiomas que son diferentes, por una razón u otra, del idioma base identificado por la etiqueta de idioma ISO 639.
Si la plantilla {{ lang }} se debe combinar con enlaces, uno podría verse tentado a mover la plantilla {{ lang }} dentro del enlace de modo que sólo enmarque la etiqueta de texto del enlace, no los elementos de sintaxis de los enlaces u otros elementos estilísticos de algunos tipos de enlaces. Sin embargo, esto no funciona. La plantilla {{ lang }} tendrá que envolver el enlace completo, independientemente de si es un enlace interno o externo, o un enlace proporcionado a través de una plantilla de enlace interwiki {{ ill }} :
Obras:
{{lang|en|[[Book of hours]]}}→ Libro de horas{{lang|de|[[Book of hours|Stundenbuch]]}}→ Libro de lectura{{lang|he-LA|{{ill|Machsor Lipsiae|de}}}}→ Machsor Lipsiae No funciona:
[[{{lang|en|Book of hours}}]]→ [[ Libro de horas ]] (nunca funciona)[[Book of hours|{{lang|de|Stundenbuch}}]]→ Stundenbuch (no funciona en el espacio de artículos, funciona en charlas y otros tipos de páginas){{ill|Machsor Lipsiae|de|lt={{lang|he-LA|Machsor Lipsiae}}}}→ Machsor Lipsiae (no funciona en el espacio de artículos, funciona en páginas de discusión y otros tipos de páginas)Wikipedia:Manual de estilo/Formato de texto § Los términos extranjeros requieren el uso de {{ lang }} en lugar de la ''cursiva'' manual. Esto es preferible por las siguientes razones:
Los usuarios registrados pueden aplicar estilos CSS personalizados a los artículos colocando declaraciones de estilo en su hoja de estilo de usuario. La hoja de estilo de usuario se puede crear en Special:Mypage/common.css . Para obtener más información, consulte Help:User style . Los siguientes ejemplos deberían funcionar en la mayoría de los navegadores modernos .
Para aplicar una fuente específica a todo el texto marcado como ruso de cualquier escritura o región:
[ lang |= ru ] { font-family : fonteskaya ; } /* o */ : lang ( ru ) { font-family : fonteskaya ; } Para aplicar una fuente específica al texto marcado simplemente como ruso:
[ lang = ru ] { familia-fuente : fonteskaya ; } Para aplicar un color a todo el texto marcado con cualquier idioma:
[ idioma ] { color : verde ; } Si el nombre de una fuente contiene caracteres además de letras latinas básicas o guiones, es una buena idea ponerlo entre comillas, ya que algunos de estos caracteres tienen significados especiales (el caso más común en el que se necesitan comillas es un nombre de fuente de varias palabras con caracteres de espacio). Las comillas también son necesarias para las familias de fuentes que contienen palabras clave de familias genéricas ('inherit', 'serif', 'sans-serif', 'monospace', 'fantasy' y 'cursive'). Consulte el W3C para obtener más detalles.
Puede combinar esto con importaciones de fuentes en su hoja de estilos de usuario, por ejemplo, para mostrar todo el texto en alemán en Fraktur y todo el urdu en Noto Nastaliq Urdu Regular:
@ importar url ( https://fonts.googleapis.com/css?family=UnifrakturMaguntia ) ; @ importar url ( http://fonts.googleapis.com/earlyaccess/notonastaliqurdudraft.css ) ; : lang ( de ) { familia de fuentes : UnifrakturMaguntia ; estilo de fuente : normal ; peso de fuente : normal ; } : lang ( ur ) { font-family : "Noto Nastaliq Urdu Regular" , "Noto Nastaliq Urdu" ; } Entonces el siguiente wikitexto se verá como la imagen de abajo:
Victor jagt zwölf Boxkämpfer quer über den Sylter Deich{{lang|de-Latf|Victor jagt zwölf Boxkämpfer quer über den Sylter Deich}}ٹھنڈ میں، ایک قحط زدہ گاؤں سے گزرتے وقت ایک چڑچڑے، بااثر و فارغ شخص کو بعض جل پری نما اژدہے نظر آئے۔{{lang|ur|ٹھنڈ میں، ایک قحط زدہ گاؤں سے گزرتے وقت ایک چڑچڑے، بااثر و فارغ شخص کو بعض جل پری نما اژدہے نظر آئے۔}}Datos de plantilla para Lang
Indica que un fragmento de texto determinado pertenece a un idioma en particular. Permite que los navegadores presenten y pronuncien correctamente los idiomas extranjeros.
