Wikipedia:Manual de estilo/Glosarios

A continuación se presenta una propuesta de política, directriz o proceso para Wikipedia . La propuesta puede estar todavía en desarrollo, en discusión o en proceso de búsqueda de consenso para su adopción.

Atajos MOS: BRILLO WP:GLOSARIOS

Esta página en pocas palabras: Los artículos de listas de glosarios independientes, así como los glosarios integrados en los artículos, deben tener un formato coherente. El formato de glosario estructurado en plantillas ofrece muchos beneficios.

En Wikipedia, un glosario es un tipo especial de lista . Cada glosario es una lista ordenada alfabéticamente de los términos de un tema, con definiciones. Cada término va seguido de una o más definiciones explicativas (de estilo enciclopédico) . (Por ejemplo, véase Glosario de arquitectura ).

Para explicar la jerga a la amplia audiencia de Wikipedia, cada uno de sus glosarios contiene un vocabulario de trabajo y definiciones de conceptos importantes para un área temática determinada. Un glosario suele incluir términos técnicos, jerga, modismos y metáforas de un campo.

Los glosarios pueden ser artículos independientes o listas integradas en secciones de artículos . Los glosarios independientes suelen tener como título "Glosario de términos temáticos ". Un glosario dentro de un artículo suele comenzar con el encabezado "Glosario".

Cada artículo de Wikipedia con un título en la forma "Glosario de términos temáticos ", o similar, es un glosario, al igual que las secciones de glosario dentro de algunos artículos. Estos son distintos de los esquemas , que se titulan en la forma "Esquema temático " y también pueden incluir definiciones, pero están organizados como una jerarquía y utilizan su propio estilo de formato que no se cubre en esta guía. El formato del glosario, sin embargo, no se limita solo a los glosarios en el sentido tradicional. El marcado de lista de descripción HTML subyacente está destinado a grupos de "términos y definiciones, temas y valores de metadatos, preguntas y respuestas, o cualquier otro grupo de datos de nombre-valor". ^[1]

Los siguientes términos se utilizan de forma coherente a lo largo de esta guía:

glosario

Lista de entradas individuales, cada una de las cuales consta de una palabra o un término más largo con una o más definiciones . Los glosarios están sujetos a las mismas reglas (por ejemplo, Wikipedia:Verificabilidad y Wikipedia:Punto de vista neutral ) que el resto del contenido de Wikipedia.

lista

Artículo de lista independiente o incrustado en un artículo , que consta de entradas en orden alfabético y en uno de los estilos prescritos . A continuación se describen las diferencias entre artículos independientes e incrustados para fines de redacción de glosarios.

entrada

Un concepto discreto que puede nombrarse de forma inequívoca con un término y describirse o abordarse de otro modo con una definición .

término

Un nombre o etiqueta para una entrada , que se distingue de otras entradas. Normalmente, solo hay un término, aunque las variantes ortográficas y similares a veces pueden dar lugar a varios términos por entrada. Como todo lo demás en Wikipedia, la existencia del término debe ser verificable .

definición

Prosa que aborda el término de la entrada de una manera enciclopédicamente descriptiva. Si bien algunas definiciones pueden ser similares a las de un diccionario (por ejemplo, para conceptos simples o entradas para las que aún no se han encontrado suficientes fuentes confiables que brinden más detalles), un glosario completo de tales definiciones no es apropiado en Wikipedia y es probable que se traslade a Wikcionario . A menudo hay dos o más definiciones por término. Las definiciones más largas que un párrafo corto pueden indicar la necesidad de un artículo (o sección de artículo) sobre el tema del término y un enlace a él desde la definición del glosario, en lugar de una definición detallada en el glosario mismo.

estilo

Los tres estilos de formato de glosario entre los que puede elegir son estructurado con plantilla, estilo viñetas y estilo subtítulo. Son mutuamente excluyentes. (Por cierto, este glosario que está leyendo ahora mismo en esta sección de Terminología está estructurado con plantilla).

Hay tres estilos para elegir al crear un glosario: estructurado con plantilla, estilo viñetas, estilo de subtítulo y estilo (obsoleto) de punto y coma y dos puntos.

Existe un conjunto especial de plantillas que se utilizan para dar formato al contenido del glosario. Las plantillas son:

• {{ glosario }} : esta plantilla se utiliza al comienzo de un bloque de entradas de glosario
• {{ term }} : esta plantilla establece el tamaño y el estilo de fuente (negrita) para cada término
• {{ defn }} – esta plantilla proporciona el formato para la prosa de definición del término.
• {{ fin del glosario }} : esta plantilla finaliza el bloque de entradas del glosario

Casi todos los glosarios independientes y la mayoría de los integrados son buenos candidatos para el formato estructurado en plantillas. Así es como luce el formato:

==A–M==Texto introductorio opcional.{{glosario}}{{término |1=término A}}{{defn |1=Definición del término A}}{{término |1=término B}}{{defn |no=1 |1=Primera definición del término B.}}{{defn |no=2 |1=Segunda definición del término B.}}{{fin del glosario}}

Este estilo de formato produce una salida XHTML más limpia y rica desde el motor de software MediaWiki de Wikipedia , y utiliza elementos HTML estándar específicamente diseñados para el marcado de glosarios. Proporciona muchos beneficios y la sintaxis no requiere mucho tiempo para aprenderse. Glosarios que utilizan este estilo:

• Son más accesibles para quienes usan lectores de pantalla , lo cual es importante para Wikipedia.
• Tienen entradas directamente vinculables y otros beneficios editoriales (con una compensación de simplicidad), como la consistencia del código
• Mejorar la riqueza y la usabilidad de las aplicaciones de Wikipedia , y hacer que los glosarios sean más fáciles de analizar y reutilizar de diversas maneras por aplicaciones de terceros.
• Utilice HTML semántico , mejorando la reutilización del contenido de Wikipedia tanto por parte del software como de las personas.
• Se validará como XHTML y HTML correctos, lo que garantiza la más amplia compatibilidad con el navegador (consulte las notas técnicas para saber por qué esto es importante)
• Son XML técnicamente bien formados , otro factor de compatibilidad
• Se puede ampliar de forma coherente, por ejemplo, para incluir metadatos o para diseñar términos y definiciones de forma especial.
• Será más fácil reconfigurarlo si Wikipedia decide cambiar el formato de todo el sitio, como suele ocurrir .

Para producir un glosario estructurado a partir de una plantilla, siga estos sencillos pasos:

1. El glosario en su conjunto (o cada parte, si está dividido en secciones, por ejemplo, "A–M") está rodeado por una plantilla y una etiqueta correspondiente .{{glossary}}{{glossary end}}
2. Cada término se proporciona en su propia línea utilizando la plantilla y se pone en negrita automáticamente.{{term}}
3. A continuación se da una definición en su propia línea utilizando la plantilla, y sigue al término o a una definición anterior.{{defn}}

No convierta términos individuales en encabezados en un glosario estructurado con plantillas, ya que esto generará un resultado confuso . Los términos se podrán vincular sin ser encabezados.

Utilice las plantillas como un conjunto y no mezcle plantillas de glosario con códigos de listas de descripción de wikimarkup ( ;y :estilo) u otros marcados.

Si un glosario consta de sólo unas pocas entradas, con definiciones extensas, considere formatear el artículo como un glosario con estilo de subtítulo, en párrafos regulares.

Los glosarios estructurados con plantillas utilizan un marcado semántico y accesible que cumple con los estándares web , por las razones que se detallan anteriormente. Algunos ejemplos de código, que muestran varias opciones de formato, como podrían aparecer en un artículo de glosario independiente dividido en secciones por letras del alfabeto:

==A–M==Texto introductorio opcional.{{glosario}}{{término |1=término A}}{{defn |no=1 |1=Inicio de la definición del término A.<p>Más sobre la definición del término A.</p>}}{{término |1=término B}}{{defn |no=1 |1=Primera definición del término B.}}{{defn |no=2 |1=Segunda definición del término B.}}{{término |1=término C}}{{defn |1=Definición simple del término C.}}{{término |1=término D}}{{defn |1=Definición del término D, con una...{{quote|Pasaje citado en bloque.}}Más definición del término D.}}{{fin del glosario}}

Como se muestra en el ejemplo, varias definiciones utilizan varias plantillas. Consulte la documentación de las plantillas para conocer las funciones avanzadas de , y .{{defn}}{{term}}{{defn}}{{glossary}}

Con una estructura de plantilla (usando estas plantillas o creadas manualmente con HTML), una definición se comporta, dentro de sus <dd>...</dd>límites, como una prosa y un marcado normales. Se pueden usar varios párrafos con facilidad y se pueden usar libremente citas en bloque, listas anidadas y otras estructuras , a diferencia de los otros estilos. La flexibilidad y el poder de las etiquetas HTML son mucho más ricos que los que ofrecen las funciones de lista desordenada ;o de lista de :descripción y *de marcado wiki, que no funcionan correctamente debido a errores y fallas de MediaWiki.

Se pueden crear varios párrafos, como en la prosa normal, simplemente introduciendo una línea en blanco como se muestra en el ejemplo, o se pueden bloquear explícitamente con <p>…</p>marcado.

Dentro de un , todo el texto y el resto del contenido deben estar dentro de un . El siguiente marcado no es válido en varios lugares, como se indica:{{glossary}}{{defn}}

{{glosario}} {{Principal| Las Hatnotes y otras plantillas no pueden ir aquí, dentro de la lista del glosario pero antes de los términos y definiciones }} {{término|1=término A}} {{defn|1=Definición del término A.}} {{término|1=término B}} {{defn|no=1|1=Primera definición del término B.}} {{defn|no=2|1=Segunda definición del término B.}} {{término|1=término C}} {{defn|1=Definición del término C.}} {{fin del glosario}}[[File:misplaced_image.png|thumb|right|300px|This image cannot be between the term and definition like this.]]<blockquote>Between definitions is no place for a quotation or anything else.</blockquote><p>A paragraph (or whatever) can't be between entire entries, without {{glossary end}} to close the glossary before the content and a new {{glossary}} to open glossary formatting again after that content being interpolated.</p>

Este contenido adicional no va dentro del {{term}}, que es solo para el término y su marcado.

Este es el estilo más simple que se utiliza para los glosarios. Es una aplicación de una lista con viñetas . Ejemplo, con definiciones junto a los términos:

==Glosario==Texto introductorio opcional.*  '''término A'''  – definición. *  '''término B'''  – 1. Primera definición . 2. Segunda definición.

Este estilo sencillo se utiliza a menudo en glosarios integrados. No se deben utilizar listas numeradas (que comiencen con #en lugar de ), ya que implican un orden específico (por ejemplo, jerárquico o cronológico).*

Los glosarios complejos se realizan mejor utilizando un formato estructurado por plantillas.

Los bloques de texto, debidamente marcados, se pueden utilizar para definiciones más largas. Las definiciones de varios párrafos requieren el <p>...</p>marcado de párrafo HTML, sin ningún espacio en blanco de marcado wiki entre ninguno de los pasajes y el salto, debido a las limitaciones de MediaWiki (consulte Wikipedia:Manual de estilo/Glosarios/Casos de prueba de errores de DD para obtener detalles técnicos) . El <p>...</p>marcado es necesario tanto antes como después del salto o el espaciado entre líneas será notablemente inconsistente. Ejemplo, con las definiciones de los términos a continuación:

==Glosario==Texto introductorio opcional.*  '''término A'''  {{ pb }} Definición. *  '''término B'''  {{ pb }} 1. Primera definición. {{ pb }} 2. Segunda definición. *  '''término C'''  {{ pb }} Comienzo de definición larga. {{ pb }} Continuación de definición larga. {{ pb }} Conclusión de definición larga.

<p>...</p>También se pueden utilizar elementos explícitos en lugar de la plantilla, por ejemplo:{{pb}}

*  '''término A'''  < p > Definición. </ p > *  '''término B'''  < p > 1. Primera definición. </ p >< p > 2. Segunda definición. </ p > *  '''término C'''  < p > Comienzo de la definición larga. </ p >< p > Continuación de la definición larga. </ p >< p > Conclusión de la definición larga. </ p >

Recuerde utilizar el cierre </p>.

No mezcle este marcado de lista desordenada con el de listas ordenadas o de definición , ya que el resultado será un marcado no válido y el formato visual no será consistente (las listas ordenadas y desordenadas tienen más sangría). Comparar:

* '''término A''' : Definición * '''término X''' :1. Primera definición. :2. Segunda definición. * '''término Y''' #Primera definición. #Segunda definición. * '''término Z''' **Primera definición. **Segunda definición.

El resultado HTML de esto es un desastre, especialmente para los usuarios de software de lectura de pantalla con discapacidad visual , a quienes se les dice, en serie, que: ha comenzado una lista desordenada de un elemento; esa lista ha terminado; ha comenzado una lista de descripción sin término pero con una definición sin asignar; esa lista terminó; comenzó otra lista desordenada de un elemento y terminó; comenzó otra lista de descripción sin término pero con dos definiciones no relacionadas con un término y luego terminó; comenzó una tercera lista desordenada de un elemento y terminó; comenzó y terminó una lista numerada de dos elementos, no asociada con el material anterior; comenzó una cuarta lista desordenada de un elemento, luego comenzó una lista desordenada incrustada de dos elementos y luego terminaron ambos. En general, no hay una relación clara entre ninguno de los términos y definiciones, o incluso una sensación de que esta es una lista de cosas que se relacionan entre sí de alguna manera.

Los glosarios independientes con un número limitado de definiciones, en su mayoría largas y detalladas, a veces se pueden formatear mejor con entradas como subtítulos. Un ejemplo de este tipo de glosario es el Glosario de la religión romana antigua . Este estilo no se debe utilizar para glosarios incrustados , ya que sobrecargará la tabla de contenidos del artículo con entradas de glosario. También producirá una tabla de contenidos demasiado larga en un glosario independiente con una gran cantidad de entradas. Cuando se utiliza este estilo, las definiciones se presentan como párrafos de prosa normales:

==A&M==Texto introductorio opcional.===término A===Definición.===término B===1. Primera definición.2. Segunda definición.

Para los casos en que la mayoría o la totalidad de las definiciones son explicaciones largas de varios párrafos, este formato es preferible a un glosario estructurado en una plantilla.

Las definiciones múltiples se numeran manualmente, como se muestra; no utilice listas ordenadas. Este tipo de glosario, en particular, a veces utiliza identificadores no numéricos con definiciones múltiples. Las definiciones de varios párrafos son como cualquier otro párrafo en prosa de Wikipedia.

==A&M==Texto introductorio opcional.===término A===Definición.===término B==='' [[ Química ]] '' : Primera definición.Más de la primera definición.'' [[ Economía ]] '' : Segunda definición.'' [[ Cestería submarina ]] '' : Tercera definición.

Los elementos HTML subyacentes <dl>, <dt>y <dd>(tal como se generan en un glosario estructurado en plantillas) también son los que se generan mediante listas de código wiki con formato inicial ;y :caracteres. (Consulte Wikipedia:Manual de estilo/Listas § Listas de descripción (definición, asociación) para obtener más información).

Este estilo de marcado es muy "frágil" y no se recomienda para glosarios, excepto los más breves y simples, ya que es probable que su estructura semántica se rompa. Incluso algo tan simple como una línea en blanco romperá una lista de este tipo. (Véase § Evite el uso de punto y coma y dos puntos en el wikimarking de glosarios, más abajo).

==Glosario==Texto introductorio opcional.; término 1 : Definición ; término 2 : 1. Primera definición. : 2. Definición de sección.

Las siguientes pautas se aplican a todos los glosarios y deben seguirse independientemente del estilo de formato que se utilice de los que se presentan más arriba. Los esquemas de Wikipedia , que presentan entradas con anotaciones en orden jerárquico (clasificado), no están cubiertos por estas pautas.

En un glosario, ordene alfabéticamente todos los términos de la A a la Z. Las entradas no se deben agregar de manera aleatoria ni en un orden arbitrario. Un carácter basado en el latín con diacríticos se ordena alfabéticamente después del carácter simple en el que se basa. Los caracteres que no se basan en el latín se ordenan alfabéticamente en el orden en que aparecen en Unicode .

Si hay entradas numéricas, preceden a las verbales, y cualquier entrada simbólica precede a ambas (es decir: "!" antes de "1" antes de "A"). Las entradas numéricas que a veces aparecen en el contexto del tema del artículo como numerales o escritas verbalmente deben darse en la forma "tres (3)" en glosarios cortos. En glosarios más largos, es más apropiado crear entradas separadas, poner la definición en una y hacer una referencia cruzada de la otra entrada a esa; en la mayoría de los casos, coloque la definición en la entrada verbal, no en la numérica. Si hay una diferencia definible en el uso entre los términos numerales y verbales en el contexto, use entradas separadas y distíngalas entre ellas con referencias cruzadas.

Si no hay entradas simbólicas y solo hay una o unas pocas entradas numéricas, se permite alfabetizar las entradas numéricas como si estuvieran escritas verbalmente, en la forma "3 (tres)", para evitar la creación de una sección de entradas numéricas muy corta.

Cree una sección (o subsección) independiente en un artículo de glosario extenso e independiente para cada letra, pero agrúpelas en rangos cuando sea apropiado, por ejemplo, "X–Z". Para glosarios independientes más breves, puede dividir el artículo completo en rangos, por ejemplo, "0–9", "A–M" y "N–Z", o no utilizar divisiones en absoluto para casos muy breves (que pueden ser candidatos para fusionarse en artículos principales sobre el tema). No divida en secciones una lista incrustada, ya que esto dificulta la edición y puede alargar en gran medida la tabla de contenidos del artículo general; si una lista incrustada es lo suficientemente larga como para beneficiarse de la división en secciones, es una buena candidata para dividirla en un artículo de glosario independiente. No cree secciones vacías.

El formato de glosario se puede utilizar para listas que no son estrictamente glosarios en el sentido habitual, y muchas de ellas tendrán fundamentos de ordenamiento no alfabético (por ejemplo, cronológico o geográfico).

En la mayoría de los glosarios, cada término del glosario comienza con una letra minúscula, a menos que sea un nombre propio o un acrónimo o sigla. Si bien escribir con mayúscula la primera letra de cada término produciría un resultado más uniforme y con forma de esquema (por eso es el estándar para listas ordenadas y desordenadas en Wikipedia), la capitalización natural produce menos ambigüedades en un glosario.

Se recomienda el uso de mayúsculas iniciales en todas las entradas solo si se cumplen simultáneamente todas las condiciones siguientes:

• Ningún término del glosario es una forma en minúscula de algo que en otros contextos suele escribirse con mayúscula.
• No hay diferencia entre la forma con mayúscula y sin mayúscula de ningún término del glosario.
• Los términos no contienen una mezcla de nombres propios y sustantivos comunes.
• De lo contrario, es poco probable que poner en mayúscula todas las entradas produzca algún tipo de ambigüedad o confusión.
• Es poco probable que el glosario se amplíe alguna vez de manera que rompa alguno de los casos anteriores (es decir, ya es exhaustivo, está estrictamente limitado por criterios de inclusión estrechos o contiene exclusivamente nombres propios).

Comience cada definición con letra mayúscula, incluso si es un fragmento de oración.

Lo anterior no se aplica al uso de listas de descripción (con o sin plantillas de glosario) para material que no forma un glosario, como una lista de personajes o un índice de diferentes modelos en una serie de productos.

Wikipedia no es un diccionario ; por lo tanto, explique los términos del glosario de forma descriptiva (tal como lo haría un artículo de enciclopedia normal, pero de forma más concisa). Solo en raras ocasiones y con moderación agregue definiciones de diccionario a un glosario en Wikipedia (generalmente solo por el bien de la exhaustividad). Las listas de definiciones de diccionario pertenecen a Wikcionario ; aún puede vincularlas desde los artículos de Wikipedia.

No añada palabras de uso cotidiano. Incluya únicamente términos especializados que sean específicos del tema del glosario o que tengan un significado especial dentro de él.

Todas las entradas deben ser verificables con fuentes confiables , al igual que el contenido de artículos normales.

Es probable que el proyecto del apéndice de glosarios de Wikcionario transwiki una copia de cualquier glosario creado en Wikipedia, y podría volver a desarrollarlo considerablemente en una dirección más diccionaria. No es necesario (y puede ser perjudicial) sincronizar las ediciones entre las dos versiones, aunque será raro que una entrada sea apropiada para existir en alguna forma en una sola versión pero no en la otra. La existencia de un glosario de Wikcionario sobre un tema que tiene un artículo principal bien desarrollado puede ser una buena indicación de que se puede desarrollar un glosario enciclopédico sobre el tema, ya sea usando el glosario del diccionario como base o comenzando desde cero. Si existen ambas versiones, deberían vincularse entre sí en sus respectivas secciones "Ver también" con una plantilla de proyecto hermano, por ejemplo (ver Wikipedia:Proyectos hermanos de Wikimedia para recomendaciones sobre la mejor opción de plantilla para varias situaciones) .{{Wiktionary|name of page at Wiktionary}}

Una definición puede tener dos o más términos encima como variaciones o alternativas con la misma definición. El caso de uso más común para esto es presentar el término en dos variantes de idioma. Esto se hace con {{ lang }} y los códigos de idioma ISO apropiados como se describe en esa plantilla. En los glosarios estructurados por plantilla, el término simple, sin marcado, debe ser el primer parámetro de {{ term }} , y la versión de marcado de idioma es el parámetro 2. Si se desea mostrar el nombre del idioma/dialecto, se puede usar la familia de la plantilla en lugar de . Ejemplo:{{lang-language-code}}{{lang}}

{{term|1=neumático | contenido={{lang-es-ES|neumático|paren=y}} } }{{término|1=neumático | content={{lang-es-ES|neumático|paren=y}} } }{{defn|1=Una cubierta de rueda resistente generalmente hecha de caucho vulcanizado.}}

Resultado:

Inglés americano : neumático

Inglés británico : neumático

Una cubierta de rueda resistente generalmente hecha de caucho vulcanizado.

La versión wikimarkup es más sencilla, pero tiene una funcionalidad muy limitada y no puede manejar entradas complejas:

; {{lang-es-ES|neumático|paren=y}}
; {{lang-es-ES|neumático|paren=y}}:Una cubierta de rueda resistente generalmente hecha de caucho vulcanizado.

En un artículo de Wikipedia, utilice identificadores consistentes para dos o más definiciones de un término. En la mayoría de los casos, las definiciones múltiples deben estar numeradas. Existen otras convenciones, como la identificación del subcampo al que pertenece cada definición, pero rara vez son mutuamente excluyentes con la numeración, y la identificación numérica es una mnemotecnia conveniente para los lectores y un referente para los editores. Debido a que los artículos pueden usar números para distinguir entre varias definiciones, evite cambiar el orden de las definiciones sin una buena razón y corrija las referencias numéricas a las definiciones cuando cambie su orden.

En general, no se deben utilizar enlaces wiki a otras páginas o secciones dentro del término en una lista de descripción, ya sea que esté formateada con plantillas de glosario o no. Las razones de WP:Manual of Style § Los encabezados de sección se aplican igualmente a los términos de la lista de descripción, ya que sirven tanto para los propósitos de subtítulos como de contenido de la lista. En el marcado estructurado con plantillas, los términos son en sí mismos destinos de enlaces; no todos los navegadores manejan adecuadamente el contenido marcado como destino de enlace y ancla de enlace saliente. Los enlaces desde dentro de un término deben evitarse especialmente en glosarios reales, donde la entrada del término debe mantenerse por sí sola dentro de ese contexto. Si hay material más detallado en otra página para el término en cuestión, enlace al término en línea o use una referencia cruzada explícita a ese material.

Los enlaces dentro del contenido de la definición se crean según corresponda, tal como en cualquier otro contenido en prosa enciclopédica.

Se pueden crear anclas (puntos a los que un enlace [[Glossary of Foo terms#weaselsnorkel]]puede apuntar directamente) en glosarios con viñetas, estilo subtítulo y wikimarkup ( ;y :), utilizando la plantilla.{{Anchor}}

Los glosarios estructurados por plantillas proporcionan automáticamente (dentro de ciertos límites) términos enlazables (ver Plantilla:Término § Estilo wiki y enlaces del término ) ), y también se pueden crear anclajes para definiciones específicas, utilizando parámetros de plantilla ( Plantilla:Defn § Hacer que la definición sea enlazable de forma independiente ) .

En glosarios con viñetas y subtítulos, se pueden colocar notas de sombrero como y , imágenes y otros materiales según se desee.{{Main}}{{See also}}

No se pueden usar Hatnotes con glosarios wikimarkup ( ;y :), excepto antes del inicio del glosario y después de su final. Esto también se aplica a todo el contenido marcado como un <div>u otro elemento de bloque, como plantillas de barra lateral que enlazan a proyectos hermanos . Se pueden agregar imágenes a la definición, pero deben estar en línea en ella, sin interrupción del enlace.

En los glosarios estructurados con plantillas, las notas breves, las imágenes y otros contenidos similares deben colocarse dentro de la definición, no entre el término y la definición, ni entre la última definición y el término siguiente. Aparte de esta restricción, todo ese contenido puede usarse normalmente dentro del bloque de definición. Puede que la sangría de las plantillas de notas breves parezca extraña dentro de una definición; la plantilla de notas breves genérica específica del glosario elimina esa sangría.{{ghat}}

Evite utilizar el marcado wiki de listas de descripción (con ;y :) para glosarios, ya que es muy limitado y tiene errores. Si bien estas listas son adecuadas para la creación de listas sangradas muy informales, el software MediaWiki no maneja definiciones complejas con elegancia en este formato ni permite líneas en blanco entre elementos sin arruinar el marcado semántico. Los ejemplos existentes deben convertirse en glosarios estructurados en plantillas, ya que la mayor parte del trabajo ya está hecho.

Utilice un estilo de glosario definido anteriormente, no un formato inventado por usted mismo, como una pseudolista creada con un estilo manual o un uso incorrecto de una lista numerada (ordenada). Tenemos estándares de formato de listas por varias razones, y no seguirlos puede confundir a los lectores y editores, obstaculizar la reutilización del contenido de Wikipedia , dificultar el procesamiento automático y generar problemas de usabilidad y accesibilidad.

En algunos casos, las tablas son más adecuadas para asociar contenido que las listas de descripciones, especialmente cuando hay múltiples valores para cada elemento.

Se espera que los artículos de glosario satisfagan las mismas condiciones que otros artículos; esto incluirá una sección introductoria bien desarrollada y referencias .

La tabla de contenidos predeterminada de Wikipedia no será muy útil con la mayoría de los glosarios. Una solución es:

__ NOTOC __{{ Tabla de contenidos compacta |center=yes|symnum=yes|refs=yes}}

o, si solo hay entradas alfabéticas de la A a la Z, simplemente:

__NOTOC__ {{ Tabla de contenidos compacta | centro = sí | referencias = sí }}

Hay varias variantes; consulte la documentación de Template:Compact ToC .

Tenga en cuenta que los encabezados de sección deben crearse manualmente, como de costumbre, y deben coincidir exactamente con los {{Compact ToC}}parámetros seleccionados.

Cada sección de una página extensa de glosario debe terminar con otra llamada a {{Compact ToC}}(o alguna otra forma de navegación seccional concisa). La tabla de contenidos compacta se puede utilizar con varios otros parámetros habilitados para mantener la visualización delgada y lineal y con un enlace a la parte superior de la página, por ejemplo:

{{ Tabla de contenidos compacta | lado = sí | centro = sí | parte superior = sí | symnum = sí | referencias = sí | nobreak = sí }}

Dependiendo de los {{Compact ToC}}parámetros establecidos, puede haber una sección para las entradas que comienzan con números, con símbolos o ambos. Si está presente, esta sección debe preceder a "A" o a la primera sección alfabética ("A–M", etc.). Las entradas que se encuentran comúnmente, pero no siempre, en forma numérica deben incluirse en esta sección y deben tener una referencia cruzada a partir de su nombre escrito, o viceversa, no deben incluirse definiciones duplicadas. Las referencias cruzadas se escriben en cursiva. Ejemplo:

{{ term | 1 = 20 tanques }} {{ defn | ''Ver [[# Veinte tanques | Veinte tanques ]] .'' }}...{{ term | 1 = Twenty Tanks }} {{ defn | ''También '''20 Tanks''' .'' Twenty Tanks fue una microcervecería galardonada en San Francisco, California, y una empresa hermana de la cervecería Triple Rock en Berkeley. }}

Para un artículo de lista de glosario que consta de una introducción simple y un glosario, se prefiere el formato Glosario de términos temáticos , con redireccionamientos al mismo desde Glosario de temas , Términos temáticos , Glosario temático , Terminología temática , Jerga temática , Jerga temática y Lista de términos temáticos (el último para cumplir con la convención de nomenclatura más general del patrón de listas de "Lista de temas ").

Para un artículo que consiste principalmente en una lista de glosarios pero tiene material en prosa bien desarrollado sobre la historia y el uso de la terminología, u otra información similar (varios párrafos), se prefiere la forma Términos temáticos , con redireccionamientos a ella desde Glosario de términos temáticos , Glosario temático y los otros nombres (recuerde que el lector no puede adivinar si el artículo se ha desarrollado de esta manera o no). Los enlaces de los redireccionamientos nombrados como "glosario" pueden ir directamente a la sección de glosario, si el material histórico y de otro tipo es extenso. Para un artículo que trata principalmente sobre la historia, el desarrollo, la difusión, etc. de la terminología como un cuerpo de la jerga de un área temática determinada (como la terminología legal, de danza, etc. en general), y puede incluir un glosario integrado de términos clave, prefiera Terminología temática , nuevamente con todos los redireccionamientos. Es razonablemente probable que un artículo de este tipo eventualmente se divida en un artículo en prosa y un artículo de glosario independiente, más desarrollado, con el tiempo.

Para un glosario de términos y personajes utilizados en una obra o serie de obras de ficción (es decir, un universo ficticio ), se prefiere la forma Glosario de terminología de nombres de obras/series/franquicias (de nuevo con redirecciones) ya que los términos forman un sistema terminológico que no existe como términos en uso fuera de ese contexto ficticio. Ejemplo: Glosario de terminología de La Materia Oscura .

El asesoramiento general en WP:Listas independientes#Convenciones de nomenclatura (por ejemplo, manejo de nacionalidades, temas de ficción, etc.) incluye también glosarios, en la medida que sea aplicable.

Los subartículos de glosarios divididos en varias páginas deben seguir las pautas de WP:Convenciones de nombres (listas largas) en la medida que sea aplicable. En resumen, deben nombrarse como la página original (principal) del glosario, con la letra o el rango de letras cubiertas del alfabeto (o números, etc.) después de dos puntos después de este título, p. ej., Glosario de términos de cestería subacuática: A–M o Términos de curling: N–Z. Según WP:Manual de estilo#Guiones , se utiliza el guion corto (–) para dividir el rango, no un guion (-), un guion largo (—), un signo menos (−) u otro carácter similar; sin embargo, la forma con guion del nombre del artículo (p. ej., Términos de curling: NZ) también debe existir como una redirección a la página del artículo real (AnomieBOT lo hará automáticamente). Escriba el guion corto en as –o haga clic en él a la derecha de la pestaña "Insertar" debajo de la ventana de edición; o consulte Cómo hacer guiones .

Los glosarios especializados pueden requerir un tipo de nombre diferente (incluso para subartículos de glosarios de varias partes), por ejemplo: Glosario de términos informáticos: Unix y Linux, Glosario de términos informáticos: Microsoft Windows, etc.

Consulte las secciones "Glosarios integrados" y "Uso de formato de glosario en listas que no son glosarios" a continuación para obtener información sobre problemas de nombres relacionados.

Un glosario que se vuelve demasiado largo (más de 400  KB ) ^[a] debe dividirse en varios artículos. Este es un límite sugerido más alto que para los artículos normales, porque generalmente no esperamos que los lectores lean un glosario de principio a fin, por lo que su longitud no debe estar limitada por la capacidad de atención, y el propósito principal de un glosario es vincular a entradas específicas y, fundamentalmente, la búsqueda dentro de la página, que se interrumpe al dividirlo. Por otro lado, los artículos muy grandes tardan más tiempo en cargarse, especialmente para editarlos o previsualizarlos.

Cuando sea necesario, los glosarios se deben dividir en fragmentos aproximadamente iguales, en lugar de intentar convertirlos en un estilo resumido o reducirlos mediante la limitación del tema del glosario. Por ejemplo, la primera división de Glosario de términos de cestería submarina podría ser Glosario de términos de cestería submarina: A–M y Glosario de términos de cestería submarina: N–Z, pero los glosarios muy largos pueden necesitar incluso más partes, y algunos glosarios tendrán secciones de una sola letra mucho más largas que otras. Si hay términos que comienzan con números o símbolos, deben ir antes de A, en secciones propias, a menos que haya suficientes como para justificar su propio subapartado.

Hay dos buenas soluciones para el título original del Glosario de términos de cestería subacuática:

• Haga que se redirija al primer fragmento e incluya allí la pista original.
• Consígalo como una página de desambiguación, con una introducción completa y enlaces a todos los fragmentos.

En cualquier caso, los demás fragmentos deben contener resúmenes de la introducción completa, de modo que no surjan múltiples entradas diferentes. El primer método es más sencillo; el segundo es preferible para glosarios tan largos que necesitan más de tres o cuatro fragmentos, o para enumerar artículos en formato de glosario pero no en orden alfabético básico (bicicletas por fabricante, guerras por año, etc.).

Se debe tener cuidado al dividir los glosarios en subartículos. Cada subartículo debe vincularse con los anteriores y posteriores, y con la página de desambiguación si existe; {{ Compact ToC }} puede ayudar con esto. Cada subartículo debe tener su propia sección de referencias, y estas deben verificarse para asegurarse de que aún funcionan. En particular, la primera instancia de una etiqueta <ref> con nombre en cada subartículo necesitará su propio texto y no puede ser simplemente una llamada secundaria . El nombre de la misma referencia no debe cambiar de subartículo a subartículo.<ref name="ref-name" />refname=

En ocasiones, un glosario incluido en un artículo puede resultar útil para los lectores, ya sea para comprender mejor la terminología del artículo, para aprender más sobre la terminología utilizada en el campo que abarca el artículo, o para ambas cosas. También puede proporcionar un glosario al que se pueda acceder mediante enlaces desde artículos relacionados, a menos que y hasta que se justifique un glosario independiente.

Algunas pautas sobre la inclusión de glosarios en los artículos, además de las pautas generales anteriores:

• El glosario debe ser una sección propia, con un encabezado que lo identifique como tal (esto no solo es ordenado, sino que permite que se pueda vincular directamente al glosario). El título de esta sección debe cumplir con WP:Manual of Style#Section headers – no repita el tema del encabezado. Tampoco debe usar verborrea excesiva (“Glosario de términos clave en la disciplina”, etc.) – manténgalo simple . Un título simple ==Glossary==está bien en la mayoría de los casos.
• Si el glosario tiene 5 términos o menos, probablemente sea mejor definir los términos de manera concisa en el contexto de la prosa del artículo, en lugar de utilizar un glosario.
• Si el glosario tiene 25 términos o más, probablemente sea mejor crear un artículo de glosario independiente.
• Si las entradas serán muy detalladas, probablemente sea mejor utilizar un glosario independiente; las entradas integradas deben ser concisas.
• Los glosarios integrados no deben incluir subtítulos en su interior (por ejemplo, para las letras del alfabeto) y deben poder editarse como una única sección. Si es lo suficientemente extenso como para necesitar subsecciones, probablemente deba ser un artículo independiente .

El método preferido para crear un glosario integrado es utilizar el estilo estructurado por plantilla y colocar el glosario bajo un único encabezado claramente etiquetado (por ejemplo, ==Glossary==). Esto requiere un poco más de trabajo que las listas con viñetas, pero ofrece la mayoría de los beneficios de un glosario independiente estructurado por plantilla y hace que sea muy fácil mover el glosario a su propia página cuando crezca.

El formato de estilo glosario no se limita a su uso en glosarios. Existen otros usos para los métodos de marcado empleados en los glosarios. Se pueden utilizar para fines de presentación de datos en otros tipos de listas. Por ejemplo, el formato de estilo glosario puede funcionar bien para presentar una lista de números de serie de aeronaves junto con sus modelos y descripciones, utilizando el mismo diseño básico que los glosarios.

Para un artículo que es una lista que no es un glosario y que utiliza formato de glosario, siga los consejos en WP:Listas independientes#Convenciones de nombres . Para la denominación de listas divididas de varias páginas, consulte WP:Convenciones de nombres (listas) . A veces, dichas listas necesitan una denominación personalizada, si no se pueden expresar de forma natural como rangos alfabéticos o numéricos, por ejemplo, Lista de automóviles: Chevrolet, Lista de automóviles: Ford, etc. Tenga en cuenta, sin embargo, el uso estandarizado de dos puntos, no de paréntesis, coma, guión, barra u otro separador. Sin embargo, cuando hay disponible una frase descriptiva en inglés natural , generalmente se prefiere esta; los artículos reales correspondientes a los ejemplos anteriores se encuentran en Lista de vehículos Chevrolet y Lista de vehículos Ford .

Los artículos que no son glosarios suelen necesitar una clasificación por secciones (numérica, temática) diferente a la de un glosario y, en consecuencia, pueden tener diferentes necesidades de tabla de contenidos. En el caso de listas largas de varias páginas , cada subartículo necesita algún tipo de navegación entre páginas hacia otros artículos de la serie. Algunas soluciones incluyen tablas de contenidos compactas especializadas y plantillas de navegación personalizadas . Estas listas también pueden tener diferentes necesidades de ordenación de secciones , por ejemplo, por fecha en una lista de eventos, en lugar de por orden alfabético.

1. Aunque la mayoría de nosotros ya comprendemos que la accesibilidad y la facilidad de uso son cruciales, muchos no son conscientes de que la validación del código , la correcta formación del mismo y la corrección semántica también son importantes. Errores de sintaxis HTML muy triviales pueden provocar fallos de representación incluso en el analizador del robusto motor de servidor MediaWiki de Wikipedia , y su efecto en cada una de las numerosas plataformas de navegadores y herramientas automatizadas del lado del usuario es impredecible. Esta no es la World Wide Web de 1995; los estándares realmente importan hoy.
2. El manejo de MediaWiki de las listas de definiciones (descripciones, asociaciones) con las características de marcado wiki de punto y coma y dos puntos ( ;y: ) es extremadamente frágil y no se puede usar para ningún glosario que no sea el más simple sin causar problemas tanto a los lectores como a los editores. En su lugar, se debe usar HTML real a través de las plantillas simples que se describen aquí (o HTML puro en casos inusuales con requisitos especiales). Los dos problemas más grandes con el marcado ;y :son que incluso una línea en blanco, para facilitar la lectura, entre definiciones conduce a un marcado destrozado (a menudo no visible para los usuarios de navegadores gráficos, pero problemático según el punto n.° 1, anterior, y muy evidente en otras aplicaciones, como lectores de pantalla para personas con discapacidad visual ). Las definiciones de varios párrafos y otras complejas solo se pueden lograr correctamente dentro de dicho marcado de una manera que las hace difíciles de editar y mantener. (Véase Wikipedia:Manual de estilo/Glosarios/Casos de prueba de errores de DD para obtener muchos detalles técnicos). Ambos problemas se eliminan utilizando el formato de glosario estructurado por plantilla presentado anteriormente.
3. En las listas de definiciones de wikimarkup, una línea en blanco entre entradas completas (es decir, entre la definición de una entrada y el término de la siguiente) para espaciar las entradas más está bien y no afectará la semántica del código o la salida, pero solo si {{glossary}} y {{glossary end}}(o etiquetas insertadas manualmente <dl>...</dl>) rodean todas las entradas (de todo el glosario, o de la sección, si el glosario está seccionado) como un bloque. Si se omiten, MediaWiki tratará cada término como su propia lista de definiciones completa y generará un código desordenado que es semánticamente inútil. Sin embargo, incluso si un editor los incluye, es muy probable que un editor posterior los elimine creyendo que son redundantes.

Para los expertos en tecnología, a continuación se ofrece una explicación del código HTML real que se mostrará en las plantillas en el navegador del lector (sin contar las distintas clases y otros detalles que proporciona automáticamente la aplicación web MediaWiki, y con un espaciado un poco más limpio para facilitar la lectura). El código es válido, está bien formado estructuralmente y es semánticamente correcto .

1. {{Glossary}}y {{Glossary end}}juntos invocan la estructura HTML <dl>...</dl> de la lista de descripción (llamada lista de definición en HTML 4, y a veces también llamada lista de asociación ); el acceso directo "dl" no está disponible en este momento, desafortunadamente
2. {{Term}}aka invoca el elemento HTML del término de lista de descripción , con una instancia de definición incrustada del elemento del término{{dt}}<dt>...</dt> <dfn>...</dfn>
3. {{Defn}}También conocido como invoca el elemento de definición de la lista de descripción.{{dd}}<dd>...</dd>

Ejemplo de código wiki:

{{glosario}}{{término |término A}}{{defn |Definición 1.}}{{término |término B}}{{defn |no=1 |Inicio de la primera definición.<p>Primera conclusión de la definición.</p>}}{{defn |no=2 |Segunda definición.}}{{fin del glosario}}

HTML representado (menos el CSS):

< dl > < dt  id = "term_a" >< dfn > término A </ dfn >/ dt > < dd > Definición 1. </ dd > < dt  id = "term_b" >< dfn > término B </ dfn >/ dt > < dd > 1.    Primera definición inicial. < p > Primera definición conclusión. </ p > </ dd > < dd > 2.    Segunda definición. </ dd > </ dl >

< dl  class = "glossary" > < dt  id = "term_a" >< dfn > término A </ dfn >/ dt > < dd > Definición 1. </ dd > < dt  id = "term_b" >< dfn > término B </ dfn >/ dt > < dd  class = "glossary" > 1.    Primera definición inicial. < p > Primera definición final. </ p > </ dd > < dd > 2.    Segunda definición. </ dd > </ dl >

Salida renderizada:

término A

Definición 1.

término B

1. Primera definición de inicio.

Primera conclusión de la definición.

2. Segunda definición.

El resultado es el mismo si pones todo el {{defn}}of term Ben una sola línea, siempre que <p>...</p>se utilice marcado para introducir el salto de párrafo en la definición:

{{definición|1. Inicio de la primera definición.<p>Conclusión de la primera definición.</p>}}

Es decir, la siguiente mezcla de marcado HTML y marcado MediaWiki, que intenta utilizar espacios simples para crear un salto de párrafo, ya no funciona en el interior <dd>...</dd>(y por lo tanto {{defn|...}}), a partir de 2023 (y desde aproximadamente 2014):

{{definición|1. Primera definición de inicio.Primera conclusión de la definición.}}

El resultado se ejecutará junto en la salida:

1. Primera definición de inicio. Primera definición de conclusión.

Este comportamiento es coherente con el hecho de que MediWiki no crea párrafos automáticamente dentro de otros elementos de bloque en línea, incluidos <blockquote>y <li>. (Los elementos de bloque en línea son aquellos elementos de bloque que, en las recomendaciones de WHATWG, es decir, en prácticamente todos los navegadores modernos, tienen un valor CSS predeterminado de display: inline-block;).

Existen otras formas de páginas de presentación de contenido cuasi-navegativas en Wikipedia:

• Wikipedia: Categorías, listas y plantillas de navegación
• Wikipedia:Índices
• Wikipedia:Esquemas
• Wikipedia:Artículos de índice de conjuntos
• Wikipedia:Listas independientes
• Wikipedia:Líneas de tiempo