stringtranslate.com

Wikipedia: Manual de estilo/Glosarios

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 (estilo enciclopedia) . (Por ejemplo, ver Glosario de arquitectura ).

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

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

Terminología

Cada artículo de Wikipedia con un título del tipo "Glosario de términos temáticos ", o similar, es un glosario, al igual que las secciones del glosario dentro de algunos artículos. Estos son distintos de los esquemas , que se titulan con el formato "Esquema del tema " 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. Sin embargo, el formato del glosario no se limita únicamente 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 consistentemente a lo largo de esta guía:

glosario
Una 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
Un artículo de lista independiente o una lista incrustada en un artículo , que consta de entradas en orden alfabético y en uno de los estilos prescritos . A continuación se tratan las diferencias, a efectos de redacción de glosarios, entre el sistema independiente y el integrado.
entrada
Un concepto discreto que puede nombrarse sin ambigüedades con un término y describirse o abordarse de otro modo con una definición .
término
Un nombre o etiqueta para una entrada , distinguible de otras entradas. Por lo general, 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 forma enciclopédica descriptiva. Si bien algunas definiciones pueden parecerse a un diccionario (por ejemplo, para conceptos simples o entradas para las cuales aún no se han encontrado fuentes confiables suficientes para proporcionar 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 para elegir son estructurado en plantilla, estilo viñeta 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 en forma de plantilla).

Estilos de formato del glosario

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

Estructurado por plantilla

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

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

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

Para producir un glosario estructurado en plantilla, siga estos sencillos pasos:

  1. El glosario en su totalidad (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. Un término se proporciona en su propia línea usando la plantilla y automáticamente aparece en negrita.{{term}}
  3. A continuación, se proporciona una definición en su propia línea utilizando la plantilla y sigue el término o una definición anterior.{{defn}}

No convierta los términos individuales de un glosario estructurado en plantilla en títulos. Hacerlo producirá resultados confusos . Los términos serán enlazables sin ser encabezados.

Utilice las plantillas como un conjunto y no mezcle plantillas de glosario con código de lista de descripción de wikimarkup ( ;y :estilo) u otro marcado.

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

Formato

Los glosarios estructurados por plantillas utilizan etiquetas semánticas y accesibles que cumplen con los estándares web , por los motivos detallados anteriormente. Algún código de ejemplo, que muestra varias opciones de formato, como podría aparecer en un artículo de glosario independiente dividido en secciones por letra del alfabeto:

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 estructurada por plantilla (usando estas plantillas o creada manualmente con HTML), una definición se comporta, dentro de sus <dd>...</dd>límites, como la prosa y el marcado normales. Se pueden utilizar varios párrafos con facilidad y las comillas en bloque, las listas anidadas y otras estructuras se pueden utilizar libremente , a diferencia de otros estilos. La flexibilidad y el poder de las etiquetas HTML son mucho más ricos que los proporcionados por las funciones de wikimarkup ;y :lista de descripción o *lista desordenada, que no funcionan correctamente debido a errores y características incorrectas 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>etiquetas.

Dentro de un , todo el texto y otro contenido debe 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 }} {{term|1=término A}} {{defn|1=Definición del término A.}} {{term|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.}} { {term|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>

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

estilo bala

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

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 crean mejor utilizando un formato estructurado por plantillas.

Se pueden utilizar bloques de texto, debidamente marcados, 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 wikimarkup entre cualquiera 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 corte o el espacio entre líneas será notablemente inconsistente. Ejemplo, con definiciones debajo de los términos:

<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 > Inicio de la definición larga. </ p >< p > Continuación de larga definición. </ p >< p > Conclusión de la larga definición. </p>

Recuerde utilizar el cierre </p>.

No mezcle y combine 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 se sangrarán más). Comparar:

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: se ha iniciado una lista desordenada de un elemento; esa lista ha terminado; se ha iniciado una lista de descripción sin ningún término pero con una definición no asignada; esa lista terminó; otra lista desordenada de un elemento comenzó y terminó; otra lista de descripción sin ningún término pero con dos definiciones no relacionadas con un término que comenzó y luego terminó; una tercera lista desordenada de un elemento comenzaba y terminaba; una lista numerada de dos elementos, no asociados con el material anterior, iniciados y finalizados; Comenzó una cuarta lista desordenada de un elemento, luego comenzó una lista desordenada incrustada de dos elementos y luego ambos terminaron. Por lo general, no existe una relación clara entre ninguno de los términos y definiciones, ni siquiera la sensación de que se trata de una lista de cosas que se relacionan entre sí de alguna manera.

Estilo de subtítulo

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

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

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

Estilo punto y coma y dos puntos

Los elementos subyacentes <dl>, <dt>y <dd>HTML (tal como se generan en un glosario estructurado por plantilla) también son los que se generan en las listas de wikicode formateadas con caracteres iniciales ;y :. (Consulte Wikipedia: Manual de estilo/Listas § Listas de descripción (definición, asociación) para obtener más detalles).

Este estilo de marcado es muy "frágil" y no se recomienda para glosarios, excepto los más cortos y simples, ya que es probable que su estructura semántica se rompa. Incluso algo tan simple como una línea en blanco romperá dicha lista. (Consulte § Evite el wikimarkup de punto y coma para los glosarios, a continuación).

Pautas generales para escribir glosarios

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

Alfabetizar

En un glosario, ordene alfabéticamente todos los términos de la A a la Z. Las entradas no deben agregarse al azar ni en un orden arbitrario. Un carácter latino con signos diacríticos se ordena alfabéticamente después del carácter simple en el que se basa. Los caracteres no latinos están ordenados alfabéticamente por orden de aparición 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, ya sea como números o escritas verbalmente, deben presentarse en la forma "tres (3)" en glosarios breves. En los 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 con esa; En la mayoría de los casos, coloque la definición en la entrada verbal, no numérica. Si hay una diferencia definible en el uso entre los términos numéricos y verbales en el contexto, use entradas separadas y distinga entre ellas con referencias cruzadas.

Si no hay entradas simbólicas y sólo una o unas pocas entradas numéricas, se permite ordenar alfabéticamente 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) separada en un artículo largo e independiente del glosario 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 ninguna división para casos muy cortos (que pueden ser candidatos para fusionarlos en los artículos principales sobre el tema). No seccione una lista incrustada, ya que esto impide la edición y puede alargar considerablemente el índice general del artículo; Si una lista incrustada es lo suficientemente larga como para beneficiarse de la sección, es un buen candidato para dividirla en un artículo de glosario independiente y separado. No cree secciones vacías.

Alternativas

El formato de glosario se puede utilizar para listas que no son estrictamente glosarios en el sentido habitual, y muchas de ellas tendrán criterios de ordenación no alfabéticos (por ejemplo, cronológicos o geográficos).

Utilice capitalización natural

En la mayoría de los glosarios, comience cada término del glosario con una letra minúscula, a menos que sea un nombre propio o un acrónimo/inicialidad. Si bien poner en mayúscula la primera letra de cada término produciría un resultado más uniforme, parecido a un esquema (razón por la cual este es el estándar para listas ordenadas y desordenadas en Wikipedia), el uso de mayúsculas naturales produce menos ambigüedades en un glosario.

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

Comienza cada definición con una 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 caracteres o un índice de diferentes modelos en una serie de productos.

Que incluir

Wikipedia no es un diccionario ; en consecuencia, explique los términos del glosario de forma descriptiva (tal como lo haría un artículo normal de una enciclopedia, pero de manera más concisa). Sólo en raras ocasiones y con moderación se añaden definiciones de diccionario a un glosario en Wikipedia (normalmente únicamente para que esté completo). Las listas de definiciones de diccionarios pertenecen a Wikcionario ; aún puede vincularlos desde artículos de Wikipedia.

No agregue palabras cotidianas. Incluya sólo términos especializados específicos o que tengan un significado especial dentro del tema del glosario.

Todas las entradas deben ser verificables con fuentes confiables , al igual que el contenido de un artículo normal.

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 de alguna forma solo en una 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 un buen indicio de que se puede desarrollar un glosario enciclopédico sobre el tema, ya sea utilizando el glosario del diccionario como base o comenzando desde cero. Si ambas versiones existen, deben vincularse entre sí en sus respectivas secciones "Ver también" con una plantilla de proyecto hermano, por ejemplo (consulte Wikipedia: proyectos hermanos de Wikimedia para obtener recomendaciones sobre la mejor opción de plantilla para diversas situaciones) .{{Wiktionary|name of page at Wiktionary}}

Cómo manejar múltiples variantes de un término

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

{{término|1=neumático | contenido={{lang-en-US|tire|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 : tire
Inglés británico : tire
Una cubierta de rueda resistente generalmente hecha de caucho vulcanizado.

La versión de 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}}:Un revestimiento de rueda resistente generalmente hecho de caucho vulcanizado.

Cómo manejar múltiples definiciones

En un artículo de Wikipedia, utilice identificadores coherentes para dos o más definiciones de un término. En la mayoría de los casos, se deben numerar varias definiciones. Existen otras convenciones, como la identificación del subcampo al que pertenece cada definición, pero rara vez se excluyen mutuamente con la numeración, y la identificación numérica es una mnemónica conveniente para los lectores y un referente para los editores. Debido a que los artículos pueden usar números para distinguir entre múltiples 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.

Enlace

Enlaces salientes

Los enlaces wiki a otras páginas o secciones generalmente no deben usarse dentro del término en una lista de descripción, ya sea que estén formateados con plantillas de glosario o no. Los fundamentos de WP: Manual de estilo § Títulos de sección se aplican igualmente bien a los términos de la lista de descripción, ya que sirven tanto para los subtítulos como para el contenido de la lista. En el marcado estructurado por plantilla, los términos son en sí mismos objetivos de enlace; No todos los navegadores manejan adecuadamente el contenido marcado como destino del enlace y como ancla del enlace saliente. Se debe evitar especialmente la vinculación desde dentro de un término en los glosarios reales, donde la entrada del término debe ser independiente 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 utilice una referencia cruzada explícita a ese material.

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

Enlaces entrantes

Los anclajes (puntos a los que un enlace como [[Glossary of Foo terms#weaselsnorkel]]puede apuntar directamente) se pueden crear 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 vinculables (consulte Plantilla:Término § Estilo wiki y vinculación del término ) , y también se pueden crear anclajes para definiciones específicas, utilizando parámetros de plantilla ( Plantilla:Defn § Creación de la definición enlazable de forma independiente ) .

Notas de sombrero, imágenes, etc.

En los glosarios con viñetas y subtítulos, se pueden colocar Hatnotes como y , imágenes y otro material como se desee.{{Main}}{{See also}}

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

En los glosarios estructurados con plantillas, las notas de sombrero, 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 siguiente término. Aparte de esta restricción, todo ese contenido se puede utilizar normalmente dentro del bloque de definición. Es posible que la sangría de las plantillas de notas de sombrero le parezca incómoda dentro de una definición; la plantilla genérica de notas de sombrero específica del glosario elimina esa sangría.{{ghat}}

Evite el wikimarkup de punto y coma para los glosarios

Evite el uso de la lista de descripciones wikimarkup (con ;y :) para los glosarios, ya que es muy limitada y tiene errores. Si bien estas listas están bien para la creación de listas con sangría muy informal, 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 sólo los estilos estándar

Utilice un estilo de glosario definido anteriormente, no su propio formato inventado, como una pseudolista creada con estilo manual o el mal uso de una lista numerada (ordenada). Contamos con estándares de formato de listas por varias razones, y no seguirlos puede confundir a lectores y editores, dificultar la reutilización del contenido de Wikipedia , dificultar el procesamiento automatizado e introducir problemas de usabilidad y accesibilidad.

En algunos casos, las tablas son más adecuadas para asociar contenido que las listas de descripción, especialmente cuando hay varios valores para cada elemento.

Artículos de glosario independientes

Disposición

Se espera que los artículos del glosario cumplan las mismas condiciones que otros artículos; Esto incluirá una sección principal 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 __{{ ToC compacto |centro=yes|symnum=yes|refs=yes}}

o, si sólo hay entradas alfabéticas de la A a la Z, simplemente:

__NOTOC__ {{ ToC compacto | centro = si | referencias =}}

Hay varias variantes; consulte la documentación de Plantilla: ToC compacto .

Tenga en cuenta que los títulos de las secciones deben crearse manualmente, como de costumbre, y deben coincidir exactamente con los {{Compact ToC}}parámetros seleccionados.

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

{{ ToC compacto | lado =| centro = si | arriba = si | número simultáneo =| referencias =| nobreak = si }}

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

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

Convenciones de nombres

  • WP:NCGLOSARIOS
  • MOS:NCGLOSARIOS

Para un artículo de lista de glosario que consta de una introducción simple y un glosario, se prefiere el formulario Glosario de términos temáticos , con redirecciones a él desde Glosario de materia , Términos de materia , Glosario de materia , Terminología de materia , Jerga de materia , Argot de materia y Lista de términos de materia (el último que cumple con la convención de nomenclatura más general del patrón de listas de "Lista de materias ").

Para un artículo que consiste principalmente en una lista de glosario pero que 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 de asunto , con redirecciones a él desde el Glosario de Términos de materia , Glosario de materias y los demás nombres (recuerde que el lector no puede adivinar si el artículo se ha desarrollado de esta manera o no). Los enlaces de las redirecciones denominadas "glosario" pueden ir directamente a la sección del 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 jurídica, de danza, etc. en general) y que puede incluir un glosario integrado de términos clave. , prefiera la terminología de Asunto , nuevamente con todas las redirecciones. Es razonablemente probable que con el tiempo un artículo de este tipo se divida en un artículo en prosa y en un artículo de glosario independiente y más desarrollado.

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 nombre de obra/serie/franquicia (nuevamente con redirecciones) ya que los términos forman un sistema terminológico que no existe como término en uso fuera de ese contexto ficticio. Ejemplo: Glosario de terminología de His Dark Materials .

El consejo general en WP: Listas independientes#Convenciones de nomenclatura (por ejemplo, manejo de nacionalidades, temas ficticios, etc.) también incluye glosarios, en la medida en que corresponda.

Los subartículos de los glosarios divididos de varias páginas deben seguir las pautas de WP:Convenciones de nomenclatura (listas largas) en la medida que corresponda. 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, por ejemplo, Glosario de términos de cestería submarina: A– Términos M o rizado: N–Z. Según WP:Manual of Style#Dashes , el guión final (–) se usa para dividir el rango, no un guión (-), guión largo (—), menos (−) u otro carácter similar; sin embargo, la forma con guión del nombre del artículo (por ejemplo, Curling Terms: NZ) también debe existir como redirección a la página real del artículo (AnomieBOT lo hará automáticamente). Escriba el guión como &ndash;o haga clic en él a la derecha de la pestaña "Insertar" debajo de la ventana de edición; o ver Cómo hacer guiones .

Los glosarios especializados pueden requerir un tipo diferente de nombre (incluso para los 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 de glosario", a continuación, para conocer problemas de nombres relacionados.

Crecimiento y división del artículo.

Un glosario que sea demasiado largo (más de 400  KB aproximadamente ) [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 extensión no necesita estar limitada por la capacidad de atención, y el propósito principal de un glosario es vincular a temas específicos. entradas y, fundamentalmente, búsquedas dentro de la página, que se rompen al dividirlas. Por otro lado, los artículos muy grandes tardan más en cargarse, especialmente para editarlos o obtener una vista previa.

Cuando sea necesario, los glosarios normalmente deben dividirse en partes aproximadamente iguales, en lugar de intentar convertirlos a un estilo resumido o reducirlos reduciendo el tema del glosario. Por ejemplo, la primera división del Glosario de términos de cestería submarina podría ser en 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 las secciones de algunas letras son 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 subartículo.

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

En cualquier caso, los otros fragmentos deben tener resúmenes del cliente potencial completo, de modo que no evolucionen múltiples clientes potenciales 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 enumerar artículos en formato de glosario pero no en orden alfabético básico (bicicletas por fabricante, guerras por año, etc.).

Es necesario 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 la hay; {{ Compact ToC }} puede ayudar con esto. Cada subartículo debe tener su propia sección de referencias, y estas deben revisarse para asegurarse de que aún funcionen. 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 un subartículo a otro.<ref name="ref-name" />refname=

Glosarios integrados

En ocasiones, un glosario incluido en un artículo puede resultar útil para los lectores, ya sea para comprender mejor la terminología de un artículo, para aprender más sobre la terminología utilizada en un campo cubierto por el artículo, o ambas cosas. También puede proporcionar un glosario al que se puede vincular desde artículos relacionados, a menos y hasta el momento en 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 método preferido para crear un glosario integrado es utilizar el estilo estructurado por plantilla y colocar el glosario bajo un título único y claramente etiquetado (p. ej. ==Glossary==). Esto requiere un poco más de trabajo que las listas con viñetas, pero proporciona la mayoría de los beneficios de un glosario independiente estructurado en plantilla y hace que sea muy fácil mover el glosario a su propia página cuando el glosario crece.

Usar formato de glosario en listas que no son de glosario

El formato de estilo glosario no se limita a su uso en glosarios. Hay otros usos para los métodos de marcado empleados en los glosarios. Se pueden utilizar con fines de presentación de datos en otros tipos de listas. Por ejemplo, el formato 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 no es una lista de glosario que utiliza formato de glosario, siga los consejos en WP: Listas independientes#Convenciones de nomenclatura . Para nombrar listas divididas de varias páginas, consulte WP:Convenciones de nomenclatura (listas) . Estas listas a veces necesitan nombres personalizados, si no se pueden expresar naturalmente 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 una coma entre paréntesis. , 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 Listado de vehículos Chevrolet y Listado de vehículos Ford .

Los no glosarios a menudo necesitan una sección diferente (numérica, temática) que un glosario y, en consecuencia, pueden tener diferentes necesidades en materia de índices. Para 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 contenido 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 alfabéticamente.

Notas técnicas

  1. Si bien la mayoría de nosotros ya comprendemos que la accesibilidad y la usabilidad son cruciales, muchos no son conscientes de que la validación del código , el buen formato y la corrección semántica también son importantes. Errores de sintaxis HTML muy triviales pueden causar fallas en la 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 navegador 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 que hace MediaWiki de las listas de definiciones (descripción, asociación) con las características de wikimarkup de punto y coma y dos puntos ( ;y: ) es muy frágil y no puede usarse excepto para los glosarios más simples sin causar problemas tanto a los lectores como a los editores. En su lugar, se debe utilizar HTML real a través de las plantillas simples que se describen aquí (o HTML simple en casos inusuales con requisitos especiales). Los dos mayores problemas con el marcado ;y :son que incluso una línea en blanco, para facilitar la lectura, entre las definiciones conduce a un marcado alterado (a menudo no visible para los usuarios de navegadores gráficos, pero problemático según el punto 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 haga difíciles de editar y mantener. (Consulte 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 enteras (es decir, entre la definición de una entrada y el término de la siguiente) para espaciar más las entradas está bien y no afectará la semántica del código o la salida, pero solo si {{glossary}} y {{glossary end}}(o <dl>...</dl>etiquetas insertadas manualmente) 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 completa de definiciones y generará 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.

Salida HTML real de glosarios estructurados por plantillas

Para aquellos con mentalidad técnica, la siguiente es una explicación del marcado HTML real que el navegador del lector representará a partir de las plantillas (sin contar varias clases y otros detalles que son proporcionados automáticamente por la aplicación web MediaWiki, y con espacios limpios). poco para la legibilidad humana). El código valida, está estructuralmente bien formado y 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 ); Desafortunadamente, el acceso directo "dl" no está disponible en este momento.
  2. {{Term}}también conocido como invoca el elemento HTML del término de lista de descripción , con una instancia de definición incrustada del elemento de 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>Conclusión de la primera 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.    Inicio de la primera definición. < p > Conclusión de la primera definición. </ p > </ dd > < dd > 2.    Segunda definición. </ dd > </ dl >


Salida renderizada:
término A
Definición 1.
término B
1. Inicio de la primera definición.

Conclusión de la primera definición.

2. Segunda definición.

El resultado es el mismo si pones todo {{defn}}en term Buna línea, siempre y cuando <p>...</p>se utilice el 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 combinación de marcado HTML y marcado de MediaWiki, que intenta utilizar espacios en blanco simples para crear un salto de párrafo, ya no funciona internamente <dd>...</dd>(y por lo tanto {{defn|...}}), a partir de 2023 (y desde aproximadamente 2014):

{{definir|1. Inicio de la primera definición.Conclusión de la primera definición.}}

El resultado se ejecutará junto en la salida:

1. Inicio de la primera definición. Conclusión de la primera definición.

Este comportamiento es consistente con MediWiki que no puede crear 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, según las recomendaciones de WHATWG, es decir, en casi todos los navegadores modernos, tienen un valor CSS predeterminado de display: inline-block;.)

Notas

  1. ^ Consorcio World Wide Web (W3C) (14 de diciembre de 2017). "4.4.9 El elemento dl". HTML 5.2: Recomendación del W3C . Consultado el 23 de noviembre de 2018 .{{cite web}}: CS1 maint: numeric names: authors list (link).
  1. ^ Estos límites de tamaño se refieren al tamaño de prosa legible (ver también RfC al respecto ), no al total de bytes de los datos de la página. La Wikipedia: pauta sobre el tamaño de los artículos lo define así: "Prosa legible" es el cuerpo principal del texto, excluyendo material como notas a pie de página y secciones de referencia ("ver también", "enlaces externos", bibliografía, etc.), diagramas e imágenes. , tablas y listas, enlaces Wiki y URL externas, y formato y marcado. Como esto excluye las "listas" y los glosarios, aparte de su sección principal, que consisten enteramente en listas, esto parece eximir a los glosarios y otros artículos de listas de las limitaciones de longitud del "tamaño de prosa legible", dejando solo límites técnicos a la longitud del glosario. Charla de Wikipedia: El tamaño del artículo ha sido objeto de debate recurrente, con sugerencias de tamaño máximo práctico que varían ampliamente con el tiempo, desde 200 KB a 400 KB como límites sugeridos. La Wikipedia: pauta de división prefiere 100 KB, pero supone una lectura de arriba a abajo, que no es la forma en que se utilizan normalmente los glosarios. Discusiones de consenso sobre esto en la charla de Wikipedia: El tamaño de los artículos ha llegado repetidamente a la conclusión de que, si es posible, se debe evitar la división de listas como glosarios porque reduce enormemente su utilidad, capacidad de búsqueda y edición. Ver en particular: Charla de Wikipedia: Tamaño del artículo/Archivo 1# ¿Estado actual? (2007), charla de Wikipedia: Tamaño del artículo/Archivo 5#Es hora de revisar el argumento de los problemas técnicos, desaconseja dividir la lista más larga de artículos (2010) y charla de Wikipedia:Tamaño del artículo/Archivo 5#Excepciones: listas, tablas (2011) .

Ver también

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