Edición de «Módulo:Lang/doc»

{{Lua|Arguments|No globals|Unicode data|Yesno}}

Este módulo pretende generar el marcado html correcto para textos que no estén en español y se usen en la Wikipedia. Tiene el propósito secundario de facilitar el correcto renderizado de textos en otros idiomas. El módulo agrupa el procesado de las plantillas {{ep|Lang}}, <code><nowiki>{{</nowiki>[[:Categoría:Wikipedia:Plantillas de lenguas de país|lang-xx]]<nowiki>}}</nowiki></code> y {{ep|Transl}} en un único módulo que utilice un conjunto de datos consolidado. También comprueba los posibles errores para asegurarse de que el html se renderiza correctamente para los navegadores y lectores de pantalla.

Otras plantillas que dependen de esta para el soporte de idiomas son:
* {{ep|Cirílico}}
* {{ep|Nombre original}}

'''AVISO:''' Si vas a hacer cambios en este módulo, ponlos antes en la [[Módulo:Lang/zona de pruebas|zona de pruebas]] y [[#Casos de prueba|ejecuta los tests]] para comprobar que todo va bien.

==Conjunto de datos==
El conjunto de datos especificado en [[Módulo:Lang/data]] y sus módulos de datos incluidos:
* language tag-and-name data
** [[Módulo:Lang/data/iana languages]] – del [https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry archivo language-subtag-registry] del IANA 
** [[Módulo:Lang/data/iana languages translation]] – traducción del anterior, se prioriza frente al otro manteniéndose el original en caso de no existir traducción.
* language script data
** [[Módulo:Lang/data/iana scripts]] – del archivo language-subtag-registry del IANA (traducido)
* language region data
** [[Módulo:Lang/data/iana regions]] – del archivo language-subtag-registry del IANA (traducido) 
* language variant data
** [[Módulo:Lang/data/iana variants]] – del archivo language-subtag-registry del IANA
* suppressed-script data
** [[Módulo:Lang/data/iana suppressed scripts]] – del archivo language-subtag-registry del IANA 

Módulos de datos suplementarios:
* datos no estándares o sobrescritos
** [[Módulo:Lang/ISO 639 synonyms]] – mapea códigos de tres caracteres del ISO 639-2, -2T, -3 a códigos de dos caracteres ISO 639-1 – de [https://www.loc.gov/standards/iso639-2/php/English_list.php Codes for the Representation of Names of Languages]
** [[Módulo:Lang/tag from name]] – datos invertidos de etiqueta-nombre para que el nombre del idioma actúe como clave

=== Actualización ===
Para actualizar los datos se deben seguir los siguientes pasos:
* [[Módulo:Lang/data/iana languages]]: copiar el <code>iana_languages.lua</code> generado.
* [[Módulo:Lang/data/iana languages translation]]: copiar el <code>iana_languages_translation.lua</code> generado.
* [[Módulo:Lang/data/iana scripts]]: copiar el <code>iana_scripts.lua</code> generado.
* [[Módulo:Lang/data]] - override: copiar el <code>override.lua</code> generado.
* [[Módulo:Lang/data]] - articles: copiar el <code>articles.lua</code> generado.
Para generar los archivos mencionados se puede utilizar el código que se encuentra en [https://github.com/josecurioso/wikipedia-lang-generator este repositorio] junto con las instrucciones.

== Casos de prueba==
* [[Módulo:Lang/tests]] ([[Módulo discusión:Lang/tests|ejecutar]])
* category_from_tag()
** [[Módulo:Lang/tests/ISO 639-1 category from tag]] ([[Módulo discusión:Lang/tests/ISO 639-1 category from tag|ejecutar]])
** [[Módulo:Lang/tests/ISO 639-3-1 category from tag]] (A–G) ([[Módulo discusión:Lang/tests/ISO 639-3-1 category from tag|ejecutar]])
** [[Módulo:Lang/tests/ISO 639-3-2 category from tag]] (H–M) ([[Módulo discusión:Lang/tests/ISO 639-3-2 category from tag|ejecutar]])
** [[Módulo:Lang/tests/ISO 639-3-3 category from tag]] (N–S) ([[Módulo discusión:Lang/tests/ISO 639-3-3 category from tag|ejecutar]])
** [[Módulo:Lang/tests/ISO 639-3-4 category from tag]] (T–Z) ([[Módulo discusión:Lang/tests/ISO 639-3-4 category from tag|ejecutar]])
** [[Módulo:Lang/tests/ISO 639 sobrescritos y en desuso category from tag]] ([[Módulo discusión:Lang/tests/ISO 639 sobrescritos y en desuso category from tag|ejecutar]])
* name_from_tag()
** [[Módulo:Lang/tests/ISO 639-1 name from tag]] ([[Módulo discusión:Lang/tests/ISO 639-1 name from tag|ejecutar]])
** [[Módulo:Lang/tests/ISO 639-3-1 name from tag]] (A–I) ([[Módulo discusión:Lang/tests/ISO 639-3-1 name from tag|ejecutar]])
** [[Módulo:Lang/tests/ISO 639-3-2 name from tag]] (J–P) ([[Módulo discusión:Lang/tests/ISO 639-3-2 name from tag|ejecutar]])
** [[Módulo:Lang/tests/ISO 639-3-3 name from tag]] (Q–Z) ([[Módulo discusión:Lang/tests/ISO 639-3-3 name from tag|ejecutar]])
** [[Módulo:Lang/tests/ISO 639 sobrescritos y en desuso name from tag]] ([[Módulo discusión:Lang/tests/ISO 639 sobrescritos y en desuso name from tag|ejecutar]])
* tag_from_name()
** [[Módulo:Lang/tests/ISO 639-1 tag from name]] ([[Módulo discusión:Lang/tests/ISO 639-1 tag from name|ejecutar]])
** [[Módulo:Lang/tests/ISO 639-3-1 tag from name]] (A–I) ([[Módulo discusión:Lang/tests/ISO 639-3-1 tag from name|ejecutar]])
** [[Módulo:Lang/tests/ISO 639-3-2 tag from name]] (J–P) ([[Módulo discusión:Lang/tests/ISO 639-3-2 tag from name|ejecutar]])
** [[Módulo:Lang/tests/ISO 639-3-3 tag from name]] (Q–Z) ([[Módulo discusión:Lang/tests/ISO 639-3-3 tag from name|ejecutar]])
** [[Módulo:Lang/tests/ISO 639 sobrescritos y en desuso tag from name]] ([[Módulo discusión:Lang/tests/ISO 639 sobrescritos y en desuso tag from name|ejecutar]])

==Categorías de seguimiento==
* {{Enlace de categoría con conteo|Wikipedia:Errores de Lang y lang-xx}}
* {{Enlace de categoría con conteo|Wikipedia:Errores de Transl}}
* {{Enlace de categoría con conteo|Wikipedia:Lang y lang-xx con códigos promovidos a ISO 639-1}}
* {{Enlace de categoría con conteo|Wikipedia:Lang y lang-xx con códigos ISO 639 obsoletos}}

<includeonly>
<!-- Coloca las categorías del módulo a continuación y los interwikis en Wikidata -->
</includeonly>