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, consulte el Glosario de arquitectura ).
Con el fin de explicar la jerga para 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 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 incrustadas en secciones de artículos . Los glosarios independientes normalmente se titulan "Glosario de términos temáticos ". Un glosario dentro de un artículo generalmente comienza con un título con el título "Glosario".
Terminología
Cada artículo en Wikipedia con un título en forma de "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 en la forma "Esquema del tema " y también pueden incluir definiciones, pero están organizados como una jerarquía y usan su propio estilo de formato no cubierto en esta guía. Sin embargo, el formato del glosario no se limita solo a los glosarios en el sentido tradicional. El marcado de la 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
- 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 . Las diferencias, a efectos de redacción de glosarios, entre autónomo e integrado se tratan a continuación.
- entrada
- Un concepto discreto que se puede nombrar sin ambigüedades con un término y describir o abordar 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 como resultado 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 plazo de la entrada de forma enciclopédica descriptiva. Si bien algunas definiciones pueden ser similares a las de un diccionario (por ejemplo, para conceptos simples o entradas para las que 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 mueva a Wiktionary. . 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 propio glosario.
- estilo
- Los tres estilos de formato del glosario para elegir son plantilla estructurada , al estilo de la bala , y al estilo de la subpartida . Son mutuamente excluyentes. (Por cierto, este glosario que está leyendo ahora mismo en esta sección de Terminología tiene una estructura de plantilla).
Estilos de formato de glosario
Hay tres estilos para elegir al crear un glosario: plantilla estructurada , bala-estilo , y al estilo de la subpartida .
Estructurado por plantilla
Existe un conjunto especial de plantillas que se utilizan para formatear el contenido del glosario. Las plantillas son:
- {{ glosario }}: esta plantilla se utiliza al principio de un bloque de entradas del 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 definición del término en prosa.
- {{ glosario end }}: esta plantilla finaliza el bloque de entradas del glosario
Casi todos los glosarios independientes y la mayoría integrados son buenos candidatos para el formato estructurado por plantillas. Así es como se ve 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.}}{{final del glosario}} |
|
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 del glosario. Proporciona muchos beneficios y la sintaxis no tarda en aprender. Glosarios que utilizan este estilo:
- Son más accesibles para quienes usan lectores de pantalla , lo cual es importante para Wikipedia.
- Tener entradas directamente vinculables y otros beneficios editoriales (con una compensación de simplicidad), como la coherencia del código.
- Mejore la riqueza y la usabilidad de las aplicaciones de Wikipedia , y haga que los glosarios sean más fáciles de analizar y reutilizar de diversas formas por parte de 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
- Puede ampliarse de forma coherente, por ejemplo, para incluir metadatos o para estilos y definiciones especiales.
- Será más fácil de reconfigurar si Wikipedia decide cambiar el formato de todo el sitio, como suele hacer .
Para producir un glosario con estructura de plantilla, siga estos sencillos pasos:
- El glosario como un todo (o cada parte, si está dividido en secciones, por ejemplo, "A – M") está rodeado por una plantilla y una etiqueta correspondiente .
{{glossary}}
{{glossary end}}
- Un término se da en su propia línea usando la plantilla y automáticamente se escribe en negrita.
{{term}}
- 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 términos individuales en un glosario estructurado por plantilla en títulos. Si lo hace, producirá una salida confusa . Los términos se podrán vincular sin ser encabezados.
Utilice las plantillas como un conjunto y no mezcle y combine plantillas de glosario con el 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 la posibilidad de formatear el artículo como un glosario de estilo de subtítulo , en párrafos regulares.
Formateo
Los glosarios estructurados por plantillas utilizan marcas semánticas y accesibles que se adhieren a los estándares web , por las razones que se detallan 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:
== 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. |
|
Como se muestra en el ejemplo, varias definiciones utilizan varias {{defn}}
plantillas. Consulte la documentación de las plantillas para las características avanzadas de , y .{{term}}
{{defn}}
{{glossary}}
Con plantilla estructurada (usando estas plantillas, o creada manualmente con HTML), una definición se comporta, dentro de sus
límites, como la prosa y el marcado normales. Se pueden usar varios párrafos con facilidad, y las comillas en bloque, las listas anidadas y otras estructuras se pueden usar libremente , a diferencia de los otros estilos. La flexibilidad y el poder de las etiquetas HTML son mucho más ricas que las proporcionadas por wikimarkup ;
y la :
lista de descripción o las *
características de la lista desordenada, 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 un ...
marcado.
Dentro de a {{glossary}}
, todo el texto y otros contenidos deben estar dentro de a {{defn}}
. El siguiente marcado no es válido en varios lugares, como se indica:
{{glosario}} {{tn | Main | Las notas de sombrero 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[[Archivo: misplaced_image .png | thumb | right | 300px | Esta imagen no puede estar entre el término y la definición como esta. ]] {{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.Entre definiciones no hay lugar para una cita o cualquier otra cosa. {{defn}} | no = 2 | 1 = Segunda definición del término B.Un párrafo (o lo que sea) no puede estar entre entradas completas, sin
{{glossary end}}
cerrar el glosario antes del contenido y un nuevo{{glossary}}
formato de glosario para abrir nuevamente después de que el contenido se interpola. {{término}} | 1 = término C
{{defn}} | 1 = Definición del término C. {{glosario final}}
Dicho contenido adicional 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 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 ' '' & ndash; definición.* '' ' término B ' '' & ndash; 1. Primera definición. & Nbsp; 2. Segunda definición. |
|
Este estilo sencillo se utiliza a menudo en glosarios incrustados. Las listas numeradas (que comienzan con en #
lugar de *
) no deben usarse, 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 plantilla .
Los bloques de texto, debidamente marcados, se pueden utilizar para definiciones más largas. Las definiciones de varios párrafos requieren el ... ...
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
marcado es necesario tanto antes como después del salto o el interlineado será notablemente inconsistente. Ejemplo, con definiciones debajo de los términos:
== Glosario ==Texto introductorio opcional.* '' ' término A ' ''*: Definición.* '' ' término B ' ''*: 1. Primera definición.*: 2. Segunda definición.* '' ' término C ' ''*: Comienzo de la definición larga. |
|
No es necesario envolver el primer párrafo de una definición de varios párrafos en ...
etiquetas; es decir, esto no es necesario:
* '' 'término C' ''*: Comienzo de una definición larga.Continuación de la definición larga.
Conclusión de la definición larga.
No mezcle y combine la lista de definiciones y el marcado de lista ordenada (o desordenada), ya que el formato no será coherente (las listas ordenadas y desordenadas se sangran más). 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. |
|
Estilo de subtítulo
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 dicho glosario es el Glosario de la religión romana antigua . Este estilo no debe usarse para glosarios incrustados , ya que abrumará la tabla de contenido del artículo con entradas de glosarios. También producirá una ToC demasiado larga en un glosario independiente con una gran cantidad de entradas. Cuando se usa este estilo, las definiciones se presentan como párrafos en prosa normales:
== A & ndash; M ==Texto introductorio opcional.=== término A ===Definición.=== término B ===1. Primera definición.2. Segunda definición. |
|
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 por plantilla.
Las definiciones múltiples 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.
== A & ndash; M ==Texto introductorio opcional.=== término A ===Definición.=== término B ==='' [[Química]] '' : Primera definición.Más de primera definición.'' [[Economía]] '' : Segunda definición.'' [[Tejido de cestas bajo el agua]] '' : Tercera definición. |
|
Directrices generales para la redacción de glosarios
Las siguientes pautas se aplican a todos los glosarios y deben seguirse independientemente del estilo de formato presentado anteriormente que se utilice. Los esquemas de Wikipedia , que incluyen entradas con anotaciones en un orden jerárquico (clasificado), no están cubiertos por estas pautas.
Alfabetizar
En un glosario, alfabetice todos los términos de la A a la Z. Las entradas no deben agregarse al azar o en un orden arbitrario. Un carácter de origen latino con diacríticos se alfabetiza después del carácter simple en el que se basa. Los caracteres no basados en el latín se ordenan alfabéticamente en el orden de aparición en Unicode .
Si hay entradas numéricas, preceden a las verbales y las entradas simbólicas preceden 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 números o deletreadas verbalmente se deben dar 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 a esa; poner la definición en la entrada verbal no numérica en la mayoría de los casos. 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 solo 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. .
Haga una sección separada (o subsección) en un artículo de glosario independiente extenso 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 usar ninguna división para casos muy breves (que pueden ser candidatos para fusionar en artículos principales sobre el tema). No seccione una lista incrustada, ya que esto impide la edición y puede alargar en gran medida la tabla de contenido general del artículo; si una lista incrustada es lo suficientemente larga como para que se beneficie de la sección, es un buen candidato para dividirla en un artículo de glosario independiente. 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 muchos de ellos tendrán una justificación de ordenación no alfabética (por ejemplo, cronológica o geográfica).
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 / inicial. Si bien poner en mayúscula la primera letra de cada término produciría un resultado más uniforme, similar a un esquema (por lo que este es el estándar para las listas ordenadas y desordenadas en Wikipedia), las mayúsculas naturales producen menos ambigüedades en un glosario.
Se recomienda el uso de mayúsculas iniciales en todas las entradas solo si todo lo siguiente se aplica simultáneamente:
- Ningún término en el glosario es una forma en minúscula de algo que en otros contextos generalmente se escribe con mayúscula
- No hay diferencia entre la forma en mayúscula y sin mayúscula de cualquier término en el glosario
- Los términos no contienen una mezcla de nombres propios y sustantivos comunes.
- De lo contrario, es poco probable que poner en mayúsculas todas las entradas produzca alguna forma de ambigüedad o confusión.
- Es poco probable que el glosario se amplíe de una manera que rompa uno de los casos anteriores (es decir, ya sea exhaustivo, esté estrictamente limitado por criterios de inclusión estrictos o contenga exclusivamente nombres propios).
Comience 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 ; correspondientemente, explique los términos del glosario de forma descriptiva (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 para completarlo). Las listas de definiciones de diccionario pertenecen al Wikcionario ; aún puede vincularlos desde los artículos de Wikipedia.
No agregue palabras cotidianas. Incluya solo 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 del artículo regular.
Es probable que el proyecto del apéndice de glosarios de Wiktionary transwiki sea una copia de cualquier glosario creado en Wikipedia, y podría volver a desarrollarlo considerablemente en una dirección más de diccionario. 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 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 utilizando el glosario del diccionario como base o partiendo de cero. Si ambas versiones existen, deben enlazarse 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 elección de plantilla para diversas situaciones) .{{Wiktionary|name of page at Wiktionary}}
Cómo manejar múltiples variantes de un término
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 plantillas, el término simple, sin marcado, debe ser el primer parámetro de {{ term }}, y la versión del lenguaje marcado es el parámetro 2. Si se desea mostrar el nombre del idioma / dialecto, la familia de plantillas puede ser utilizado en lugar de . Ejemplo:{{lang-language-code}}
{{lang}}
{{término | 1 = neumático | contenido = {{lang-en-US | neumático | paren = y}} }}{{término | 1 = neumático | contenido = {{lang-en-GB | neumático | paren = y}} }}{{defn | 1 = Una cubierta de rueda elástica generalmente hecha de caucho vulcanizado.}}
Resultado:
- Inglés americano : tire
- Inglés británico : tire
- Un revestimiento de rueda elástico generalmente hecho 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-en-US | neumático | paren = y}} ; {{lang-en-GB | neumático | paren = y}}: Un revestimiento de rueda elástico generalmente hecho de caucho vulcanizado.
Cómo manejar múltiples definiciones
En un artículo de Wikipedia, use identificadores consistentes 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 un mnemónico 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 wikilinks 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 del Manual de estilo § Los títulos de las secciones se aplican igualmente bien a los términos de la lista descriptiva, 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 destinos de enlaces; no todos los navegadores manejan correctamente el contenido marcado como destino de enlace y como ancla de enlace saliente. La vinculación desde el interior de un término debe evitarse especialmente en los 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.
Ejemplos: |
---|
Enlace en línea: Referencia cruzada:
Nota de sombrero:
|
Los enlaces dentro del contenido de la definición se crean según corresponda, al igual que en cualquier otro contenido en prosa enciclopédica.
Enlaces entrantes
Los anclajes (puntos a los que un enlace [[Glossary of Foo terms#weaselsnorkel]]
puede apuntar directamente) se pueden crear en glosarios con viñetas, estilo de 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
), y también se pueden crear anclas para definiciones específicas, utilizando parámetros de plantilla .Notas de sombrero, imágenes, etc.
En glosarios de estilo de viñetas y subtítulos, se pueden colocar notas similares a y , imágenes y otro material como se desee.{{Main}}
{{See also}}
Las notas de sombrero no se pueden utilizar en absoluto con wikimarkup ( ;
y :
) glosarios, excepto antes del comienzo del glosario y después de su final. Esto también se aplica a todo el contenido marcado como uno u otro elemento de bloque, como las plantillas de la barra lateral que se vinculan a proyectos hermanos . Se pueden agregar imágenes a la definición, pero deben estar integradas en ella, sin romper el enlace.
En los glosarios con estructura de plantilla, 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. Puede que la sangría de las plantillas de notas de sombrero tenga un aspecto incómodo dentro de una definición; la plantilla de nota de sombrero genérica específica del glosario elimina esa sangría.{{ghat}}
Evite el wikimarkup con punto y coma y dos puntos para glosarios
Evite usar wikimarkup de lista de descripciones (con ;
y :
) para glosarios, ya que es muy limitado y con 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 por plantillas, ya que la mayor parte del trabajo ya está hecho.
Utilice solo 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). Tenemos estándares de formato de listas por varias razones, y no seguirlos puede confundir a los 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
Diseño
Se espera que los artículos del glosario satisfagan las mismas condiciones que otros artículos; esto incluirá una sección principal bien desarrollada y referencias .
La tabla de contenido predeterminada de Wikipedia no será muy útil con la mayoría de los glosarios. Una solucion es:
__ NOTOC __ {{ Compact ToC | center = yes | symnum = yes | refs = yes}}
o, si solo hay entradas alfabéticas de la A a la Z, simplemente:
__NOTOC __ {{Compact ToC | center = yes | refs = yes}}
Hay varias variantes; consulte la documentación de Template: Compact ToC .
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 extenso debe terminar con otra llamada a {{Compact ToC}}
(o alguna otra forma de navegación seccional concisa). Compact ToC se puede usar 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:
{{Compact ToC | side = yes | center = yes | top = yes | symnum = yes | refs = yes | nobreak = yes}}
Dependiendo de los {{Compact ToC}}
parámetros establecidos, puede haber una sección para entradas que comiencen con números, con símbolos o ambos. Si está presente, esta sección debe preceder a la "A" o lo que sea 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 tener referencias cruzadas. de su nombre deletreado, 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 fue una microcervecería galardonada en San Francisco, California, y una empresa hermana de la cervecería Triple Rock en Berkeley.}}
Convenciones de nombres
Para un artículo de la lista glosario que consiste en un simple plomo y un glosario, la forma Glosario de sujetos términos se prefiere, con redirecciones a ella desde Glosario de sujeto , Asunto términos , Asunto glosario , Asunto terminología , Asunto jerga , Asunto argot , y ( para cumplir con la convención de nomenclatura más general del patrón de listas de "Lista de materias ") Lista de términos de materias .
Para un artículo que consiste principalmente en una lista de glosarios pero que tiene material en prosa bien desarrollado sobre la historia y el uso de la terminología, u otra información similar (vale varios párrafos), se prefiere el formulario Términos del tema , con redireccionamientos desde el Glosario de sujetos términos , Asunto glosario y los otros nombres (recordar que el lector no puede adivinar si el artículo se ha desarrollado de esta manera). Los enlaces de los redireccionamientos denominados "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 determinada (como legal, danza, etc., terminología en general), y puede incluir un glosario integrado de términos clave. , prefiera la terminología del tema , de nuevo con todas las redirecciones. Es razonablemente probable que dicho artículo eventualmente se divida en un artículo en prosa y un artículo de glosario independiente y más desarrollado con el tiempo.
Para un glosario de términos y personajes usados 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 redireccionamientos) 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 su terminología sobre materiales oscuros .
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 que sea aplicable.
Los sub-artículos de los glosarios divididos de varias páginas deben seguir las pautas de WP: Convenciones de nomenclatura (listas largas) en la medida que sea aplicable. En resumen, deben nombrarse como la página del glosario original (principal), 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 tejido de cestas bajo el agua: A– M o Curling términos: N-Z . Por WP: Manual de estilo # Guiones , el guión (-) se usa para dividir el rango, no un guión (-), guión em (-), menos (-) u otro carácter similar; sin embargo, la forma dividida con guión del nombre del artículo (por ejemplo, términos curling: NZ ) también debe existir como una redirección a la página del artículo real. Escriba el en-guión como –
o haga clic en él a la derecha de la pestaña "Insertar" debajo de la ventana de edición; o vea Cómo hacer guiones .
Los glosarios especializados pueden requerir un tipo diferente de nombre (incluso para los sub-artículos de los 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 incrustados" y "Uso de formato de glosario en listas que no son de glosario" , a continuación, para conocer los problemas relacionados con los nombres.
Crecimiento y división de artículos
Un glosario demasiado extenso (más de unos 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 se abran paso a través de un glosario de la cabeza a la cola, 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 elementos específicos. entradas y, lo que es más importante, búsqueda en la página, que se interrumpe al dividir. Por otro lado, los artículos muy grandes tardan más en cargarse, especialmente para editarlos o previsualizarlos.
Cuando sea necesario, los glosarios generalmente deben dividirse en partes aproximadamente iguales, en lugar de intentar convertir a un estilo de resumen, o reducir el tema del glosario. Por ejemplo, la primera división del Glosario de términos de tejido de cestas bajo el agua podría estar en Glosario de términos de tejido de cestas bajo el agua: A – M y Glosario de términos de tejido de cestas bajo el agua: N – Z , pero los glosarios muy largos pueden necesitar incluso más partes, y algunos glosarios tendrán algunas secciones de una letra 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 para justificar su propio subartículo.
Hay dos buenas soluciones para el título original del Glosario de términos de tejido de cestas bajo el agua :
- Haga que redirija al primer fragmento e incluya allí el prospecto original.
- Tenlo como una página de desambiguación, con un prospecto completo y enlaces a todos los fragmentos.
En cualquier caso, los otros fragmentos deben tener resúmenes del cliente potencial completo, de modo que no evolucionen varios clientes potenciales diferentes. El primer método es más sencillo; el segundo es preferible para glosarios tan largos que necesiten 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 enlazar con los anteriores y posteriores, y con la página de desambiguación si existe; {{ Compact ToC }} puede ayudar con esto. Cada sub-artículo debe tener su propia sección de referencias, y estas deben verificarse para asegurarse de que aún funcionen. En particular, la primera instancia de una etiqueta 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=
Glosarios incrustados
En ocasiones, un glosario incluido en un artículo puede ser ú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 para ambos. También puede proporcionar un glosario al que se puede vincular desde artículos relacionados, a menos y hasta que se justifique un glosario independiente.
Algunas pautas sobre la inclusión de glosarios dentro de 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 glosario (esto no solo es ordenado, permite enlazar directamente con el glosario). El título de esta sección debe ajustarse a WP: Manual de estilo # Encabezados de sección : no repita el tema en el encabezado. Tampoco debe usar un exceso de verborrea ("Glosario de términos clave en la disciplina", etc.); manténgalo simple . Una llanura
==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 forma concisa en contexto en 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 incrustadas deben ser concisas.
- Los glosarios incrustados no deben tener subtítulos dentro de ellos (por ejemplo, para las letras del alfabeto) y deben ser simplemente editables como una sola sección. Si es lo suficientemente grande como para necesitar subsecciones, probablemente debería ser un artículo separado .
El método preferido para crear un glosario incrustado es utilizar el estilo estructurado por plantilla y colocar el glosario bajo un título único y claramente etiquetado (por ejemplo ==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 estructurado por plantilla independiente y hace que sea muy fácil mover el glosario a su propia página cuando el glosario se alarga.
Usar formato de glosario en listas que no son de glosario
El formato de estilo de 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 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 no es una lista de glosario que usa 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 largas) . 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. Sin embargo, tenga en cuenta el uso estandarizado de dos puntos, no un paréntesis, coma , guión, barra u otro separador.
Los que no son glosarios a menudo necesitan secciones diferentes (numéricas, temáticas) que un glosario y, en consecuencia, pueden tener diferentes necesidades de tabla de contenido. 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 por orden alfabético.
Notas técnicas
- Si bien la mayoría de nosotros ya entendemos 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 de renderizado incluso en el analizador del robusto motor del servidor MediaWiki de Wikipedia , y su efecto en cada una de las numerosas plataformas de navegador y herramientas automatizadas del usuario es impredecible. Esta no es la World Wide Web de 1995; los estándares realmente importan hoy.
- El manejo de MediaWiki de las listas de definiciones con las características de punto y coma y dos puntos (
;
y:
) wikimarkup es muy frágil , y no se puede usar para ningún otro 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 desnudo 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 desordenado (no visible para el usuario, pero problemático según el punto # 1, arriba), y las definiciones de varios párrafos solo pueden ser correctas. logrado de una manera que los hace difíciles de editar. (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 plantillas presentado anteriormente. - En las listas de definiciones de wikimarkup, una línea en blanco entre las entradas completas (es decir, entre la definición de una entrada y el término de la siguiente) para espaciar las entradas 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 ) 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á un código desordenado que es semánticamente inútil.- ...
Salida HTML real de glosarios estructurados por plantillas
Para los que tienen una mentalidad técnica, la siguiente es una explicación del marcado HTML real que el navegador del lector procesará a partir de las plantillas (sin contar varias clases y otros detalles que se proporcionan automáticamente por la aplicación web MediaWiki, y con el espaciado limpiado un poco para la legibilidad humana). El código se valida , está estructuralmente bien formado y es semánticamente correcto .
{{Glossary}}
y{{Glossary end}}
juntos invocan la estructura HTML de la
lista de descripción (llamada lista de definición en HTML 4, y algunas veces también llamada lista de asociación ); el acceso directo "dl" no está disponible en este momento, lamentablemente- ...
{{Term}}
aka invoca el elemento HTML del término de la lista de descripción , con una instancia de definición incrustada del elemento del término{{dt}}
- ...
...
{{Defn}}
aka invoca el elemento de definición de la lista de descripción{{dd}}
- ...
- Wikicode de ejemplo:
{{glosario}}{{término | término A}}{{defn | Definición 1.}}{{término | término B}}{{defn | no = 1 | Inicio de la primera definición.Conclusión de la primera definición.
}}{{defn | no = 2 | Segunda definición.}}{{final del glosario}}
- HTML representado (menos 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. & # 160; & # 160; Inicio de la primera definición.< p > Conclusión de la primera definición. p > dd > < dd > 2. & # 160; & # 160; Segunda definición. dd > dl >
Con clases CSS mostradas |
---|
< dl class = "glossary" > < dt class = "glossary" id = "term_A" > < dfn class = "glossary" > término A dfn > dt > < dd class = "glossary" > Definición 1. dd > < dt class = "glossary" id = "term_B" > < dfn class = "glossary" > término B dfn > dt > < dd class = "glossary" > 1. & # 160; & # 160; Inicio de la primera definición.< p > Conclusión de la primera definición. p > dd > < dd class = "glosario" > 2. & # 160; & # 160; 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 se pone la totalidad ...{{defn}}
de term B
en una sola línea, siempre y cuando
el marcado se utiliza para introducir el salto de párrafo en la definición:
{{defn | 1. Inicio de la primera definición.Conclusión de la primera definición.
}}
Es decir, la siguiente mezcla de marcado HTML y marcado MediaWiki, tratando de usar espacios en blanco simples para crear un salto de párrafo, ya no funciona adentro
(y por lo tanto {{defn|...}}
), a partir de 2014:
{{defn |1. Inicio de la primera definición.Conclusión de la primera definición.}}
El resultado se ejecutará en conjunto en la salida:
- 1. Inicio de la primera definición. Conclusión de la primera definición.
Este comportamiento es consistente con MediWiki que falla en auto-párrafos dentro de otros elementos de bloque en línea, incluyendo y
.
Notas
- ^ 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 ..
- ^ Estos límites de tamaño se refieren al tamaño de la prosa legible
"prosa legible" es el cuerpo principal del texto, con exclusión de material, tal como notas al pie y secciones de referencia ( "véase también", "enlaces externos", bibliografía, etc.), diagramas e imágenes , tablas y listas, Wikilinks y URL externas, y formato y marcado.
Dado que esto excluye las "listas" y los glosarios, además de su sección principal, que consisten enteramente en listas, esto parece eximir a los glosarios y otros artículos de las listas de las limitaciones de extensión 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 un debate recurrente, con sugerencias de tamaño práctico máximo que varían ampliamente con el tiempo de 200 KB a 400 KB como límites sugeridos. La Wikipedia: Dividir directriz prefiere 100 KB, pero presume de arriba hacia abajo lectura, que no es cómo se utilizan normalmente glosarios. Discusiones de consenso sobre esto en la charla de Wikipedia: el tamaño del artículo 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 editabilidad. 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, desaconsejar la división de la mayoría de los artículos de listas largas (2010) y Charla de Wikipedia: Tamaño del artículo / Archivo 5 # Excepciones: Listas, Tablas (2011) . no el total de bytes de los datos de la página. La Wikipedia: Tamaño del artículo directriz lo define así:
Ver también
Hay algunas otras formas de páginas de presentación de contenido de casi navegación en Wikipedia:
- Wikipedia: categorías, listas y plantillas de navegación
- Wikipedia: índices
- Wikipedia: contornos
- Wikipedia: artículos de índice de conjuntos
- Wikipedia: listas independientes
- Wikipedia: líneas de tiempo