Wikipedia: Manual de estilo / Infoboxes
 | Esta guía es parte del Manual de estilo de Wikipedia en inglés . Es un estándar generalmente aceptado que los editores deben intentar seguir, aunque es mejor tratarlo con sentido común y pueden aplicarse excepciones ocasionales . Cualquier modificación importante de esta página debe reflejar el consenso . En caso de duda, discuta primero en la página de discusión . |
| Manual de estilo (MoS) |
|---|
|
| Cuadros de información de WikiProject | ||||
|---|---|---|---|---|
| Lista de infoboxes | ||||
| Estilo y ayuda | ||||
| ||||
| Limpiar | ||||
| ||||
| Edificio | ||||
| ||||
| Que hacer | ||||
| ||||
Un cuadro de información es un panel, generalmente en la parte superior derecha de un artículo, junto a la sección principal (en la versión de escritorio de Wikipedia ), o al final de la sección principal de un artículo (en la versión móvil ), que resume la clave características del tema de la página. Los cuadros de información también pueden incluir una imagen, un mapa o ambos.
Los infoboxes de Wikipedia casi siempre usan la función de software de plantilla . (Es posible codificar manualmente un cuadro de información utilizando el marcado de tabla , pero este método no tiene las ventajas de estandarización y reutilización de la plantilla). Las plantillas tienen parámetros; para que funcione correctamente, los valores de los parámetros deben especificarse cuando se inserta la plantilla en la página. Esto permite que cada cuadro de información muestre información relevante para el tema del artículo, mientras que solo requiere una cantidad mínima de codificación dentro de cada artículo.
Propósito
Al considerar cualquier aspecto del diseño de infobox, tenga en cuenta el propósito de un infobox: resumir (y no suplantar) los hechos clave que aparecen en el artículo (un artículo debe permanecer completo con su infobox de resumen ignorado, con las excepciones que se indican a continuación). Cuanta menos información contiene, más eficazmente cumple ese propósito, lo que permite a los lectores identificar los hechos clave de un vistazo. Por necesidad, algunos infoboxes contienen más que unos pocos campos; sin embargo, siempre que sea posible, presente la información en forma breve y excluya cualquier contenido innecesario. Evite los enlaces a las secciones del artículo; la tabla de contenido proporciona esa función.
Al igual que con cualquier directriz, habrá excepciones en las que una pieza de información especializada clave sea difícil de integrar en el cuerpo del texto, pero en las que esa información se pueda colocar en el cuadro de información. Entre los ejemplos destacados se incluyen los códigos ISO 639 en {{ Idioma del cuadro de información }} y la mayoría de los parámetros en {{ Chembox }}.
El uso de un cuadro de información también hace que los datos que contiene estén disponibles para reutilizadores de terceros, como DBpedia, en un formato granular legible por máquina, que a menudo utiliza microformatos .
Criterios de diseño
Enfoque global
El proceso recomendado para crear una plantilla de infobox es simplemente comenzar y reunir tantos requisitos como sea posible. Primero pruebe el formato base para una nueva plantilla como una tabla estática, luego, una vez que se alcance el consenso, migrarlo al formato de plantilla. La plantilla debe revisarse antes de usarse extensamente en artículos en caso de que la plantilla o los parámetros definidos necesiten modificaciones para minimizar las repeticiones. Si se agregan nuevos campos y parámetros, los artículos deben actualizarse para reflejar los nuevos requisitos. Si se cambia el nombre de los parámetros o se eliminan, es probable que muchos artículos no se vean afectados, ya que se ignoran los parámetros extraños.
Estilo, color y formato
La coherencia general debe tener como objetivo todos los artículos que utilicen el mismo cuadro de información. Una buena pauta es no agregar un formato de estilo extraño sobre eso en un cuadro de información predeterminado sin una buena razón. Los recuadros de información pueden tender hacia una abreviatura mayor que la que se suele utilizar en los cuerpos de los artículos. Es probable que las pautas generales WP: NBSP (uso de espacios sin interrupciones), WP: MOSNUM (números y fechas) y WP: COLOR (uso del color) sean particularmente relevantes. Al igual que con las plantillas de navegación , el propósito del cuadro de información es su utilidad, no su apariencia; por lo tanto, los infoboxes no deben ser arbitrariamente decorativos.
Imagenes
Al agregar una imagen a un cuadro de información, NO se deben usar miniaturas. Las plantillas de Infobox deben implementar el módulo InfoboxImage para ayudar con el formato de las imágenes, por lo que simplemente proporcionar el nombre del archivo funcionará. Por ejemplo, para usar File: Image PlaceHolder.png , simplemente puede usar |image=Image PlaceHolder.png. Los subtítulos deben especificarse con la |caption=opción. Cada infobox es diferente y se debe consultar la documentación de la infobox en cuestión para conocer los parámetros adecuados para que coincidan con la imagen y el título. Si InfoboxImage aún no se aplica plenamente en la caja de información que está utilizando, el mismo alt=, upright=, title=, etc, las opciones pueden ser llamados usando la sintaxis de la imagen ampliada , llamando frameless, nothumb. (Es posible que desee agregar una solicitud a la página de discusión del cuadro de información para que se agreguen los parámetros que faltan).
Coherencia entre infoboxes
Para mantener la coherencia, se aplican las siguientes pautas:
- Antes de crear una nueva plantilla de cuadro de información, compruebe primero si ya existe un cuadro de información adecuado.
- Nombra la plantilla [[Template: Infobox some subject]] ( algún tema debe estar en singular y en mayúsculas según el uso normal; , por ejemplo, "Infobox liquidación" o "Infobox NFL player").
- La plantilla {{ infobox }} se puede utilizar para crear un nuevo infobox fácilmente. Si por alguna razón {{ infobox }} no es adecuado y la tabla se va a crear manualmente, el código de plantilla debe usarse
class="infobox"para la declaración de la tabla principal. Esto selecciona automáticamente la alineación, los tamaños de fuente y el espaciado correctos para adaptarse a los cuadros de información existentes. Se sugiere un ancho de 22 ems (22emen CSS ) como declaración adicional para que coincida con el {{ infobox }} predeterminado. - La plantilla debe tener una línea de título grande y en negrita. Para ello, se puede utilizar un título de tabla o un encabezado. Debe tener el nombre común del tema del artículo, pero puede contener el nombre completo (oficial); no es necesario que coincida con el título de Wikipedia del artículo, pero volver a usarlo (con {{ PAGENAMEBASE }}) suele estar bien. No debe contener un enlace.
- Los parámetros en los infoboxes deben:
- ser nombrado, no numerado, para facilitar su uso futuro.
- use minúsculas a menos que sean nombres propios.
- Sea coherente entre los infoboxes. Por ejemplo, {{ Infobox person }} usa
|birth_date=, al igual que muchos otros infoboxes biográficos, por lo que sería confuso que un nuevo infobox biográfico usara, digamos|date of birth=, en lugar de reutilizar el nombre del parámetro existente. - Utilice el caso de la serpiente (por ejemplo
|birth_date=). No caso de camello (p|birthDate=. Ej. ) O caso de título (p|BirthDate=. Ej. ) - representar espacios usando un guión bajo , por ejemplo,
|birth_place=no|birth-place=.
- Los cuadros de información que usan coordenadas geográficas deben usarse
|coordinates=como nombre de parámetro, con la plantilla {{ coord }} en el valor del parámetro. - Si un parámetro no es aplicable o no hay información disponible, debe dejarse en blanco y la plantilla codificada para ocultar de forma selectiva la información o proporcionar valores predeterminados para los parámetros que no están definidos.
Causas de inconsistencia
Varios factores pueden causar inconsistencias en la información resumida disponible para un tipo particular de artículo:
- Incoherencia de diseño
- Los infoboxes, en particular las bifurcaciones de infobox para la misma categoría de artículos, deben mantener una apariencia coherente con los infoboxes relacionados, especialmente en relación con el diseño, el color y la estructura. Por ejemplo, los lectores esperan cierto grado de similitud al ver el artículo de Londres frente a la ciudad de Nueva York .
- Incompletitud histórica
- Es posible que cierta información deseada simplemente se haya perdido con el tiempo. Por ejemplo, un cuadro de información que describe un banco moderno puede proporcionar cierta información financiera que no estaría disponible para uno medieval.
- Incoherencia jerárquica
- Los cuadros de información que indican relaciones jerárquicas pueden tener requisitos sutilmente diferentes según el lugar de la jerarquía en el que se encuentre el tema del artículo. Por ejemplo, un cuadro de información para corporaciones será diferente entre un artículo que describe una empresa matriz e indica sus subsidiarias y un artículo que describe una subsidiaria e indica su matriz.
- Incoherencia de funciones
- Los elementos de un solo conjunto pueden tener características opcionales que normalmente se enumerarían en un cuadro de información. Por ejemplo, un cuadro de información para un artículo sobre una universidad puede incluir un lema; pero no todas las universidades los tienen.
- Falta de información
- Es posible que algunos elementos de las cajas de información no estén disponibles o no estén disponibles en absoluto, como los productores de un álbum o una película. En estos casos, es mejor proporcionar la información disponible mientras se ocultan los campos para los que la información puede no estar disponible.
Consideraciones generales de diseño
La disponibilidad de campos opcionales no significa que todos los campos deban convertirse en opcionales, ni que se deba agregar una gran cantidad de campos que se usan con poca frecuencia sin tener en cuenta el diseño y la facilidad de uso de la plantilla de cuadro de información. En algunos casos, el marcado para el campo aún debe descargarse incluso si no se muestra. No se recomienda crear plantillas demasiado largas con varios campos irrelevantes.
Al diseñar una plantilla de cuadro de información, considere las siguientes preguntas:
- ¿Es el campo de valor?
- ¿Qué importancia tiene el campo para los artículos que utilizarán el cuadro de información? ¿Es información resumida o un detalle más extenso lo que puede ubicarse mejor en el cuerpo de un artículo?
- ¿Será el campo relevante para muchos de los artículos que utilizarán el cuadro de información?
- Si el campo es relevante para muy pocos artículos, probablemente no debería incluirse en absoluto. Por el contrario, se pueden incluir campos muy comunes (y hacerlos opcionales) incluso si no son aplicables a algunos de los artículos en cuestión.
- ¿Qué posibilidades hay de que el campo esté vacío?
- Cualquier campo que pueda estar razonablemente vacío probablemente debería ser opcional. Sin embargo, un campo que normalmente está vacío puede no ser particularmente útil o relevante.
- ¿Se puede reutilizar el nombre del campo desde otro lugar?
- Por ejemplo, si agrega un campo para la fecha en la que murió el sujeto, a una plantilla de cuadro de información biográfico, use
|death_date=de {{ Persona de cuadro de información }}, y no un nombre similar como|date_of_death=o|died=. - ¿Es para personas, lugares u organizaciones?
- Si es así, incluya un microformato hCard; consulte el proyecto de microformato
- ¿Es para un evento con fecha?
- (Como un lanzamiento de disco o un evento deportivo) Si es así, incluya un microformato de hCalendar: consulte el proyecto de microformato
Cuadros de información geográfica
Los recuadros de información para elementos geográficos (por ejemplo, ciudades y países) generalmente deben encabezarse con el título del artículo, aunque se puede sustituir la versión formal de un nombre (por ejemplo, República de Montenegro en Montenegro ). Cuando se desambigua el título del artículo, el nombre simple puede encabezar el cuadro de información, siempre que el tema sea claro (por ejemplo, São Paulo en São Paulo (estado) ). Los nombres alternativos o nativos pueden aparecer debajo de esto si son beneficiosos. Los nombres históricos extensos suelen ser mejores en un segundo cuadro de información, como en Augsburgo .
Plantillas dinámicas
En teoría, los campos de un cuadro de información deberían ser coherentes en todos los artículos que lo utilicen; en la práctica, sin embargo, esto rara vez es el caso, por varias razones. Las plantillas de Infobox deben diseñarse para adaptarse dinámicamente a la ausencia o presencia de campos particulares.
Al igual que las cajas de información estáticas, están diseñadas para presentar información resumida sobre el tema de un artículo, de modo que temas similares tengan un aspecto uniforme y en un formato común. Sin embargo, la técnica de la plantilla permite actualizaciones de estilo y de texto común desde un lugar central, la página de la plantilla.
Si bien existen varias alternativas a los infoboxes dinámicos, como usar varias plantillas (bifurcadas) o dejar campos en blanco, deben evitarse por varias razones:
- Los lectores superan en gran medida a los editores
- El grupo más importante a considerar son los lectores ocasionales de Wikipedia, que nunca harán una edición significativa. Las plantillas de cuadro de información que contienen muchos campos en blanco, signos de interrogación o "Desconocidos" presentan una apariencia poco profesional.
- Los editores de artículos superan en gran medida a los editores de plantillas
- El editor promedio simplemente usará plantillas sin hacer cambios en ellas. Para facilitarles las cosas, debemos intentar minimizar el número de plantillas diferentes con las que deben estar familiarizados; por lo tanto, no es deseable crear múltiples bifurcaciones de plantillas.
Requisito
Evalúe el requisito de un nuevo cuadro de información antes de diseñar uno. Se deben considerar algunos puntos al iniciar un nuevo cuadro de información:
- Parámetros diferenciados suficientes y apropiados
- No puede ser abordado por los infoboxes existentes
- No se puede abordar creando un contenedor de cuadros de información existentes
Implementaciones
Basar una nueva plantilla de infobox en Template: Infobox permite al diseñador concentrarse en qué campos incluir. Funcionalidades como el estilo predeterminado y la supresión de filas en un artículo que no tiene valor para un campo en particular se resuelven automáticamente.
Plantillas condicionales
Las funciones del analizador se pueden utilizar para mostrar u ocultar de forma selectiva contenido particular (como filas de tablas) dentro de un cuadro de información en función del valor de uno o más parámetros de la plantilla.
Por ejemplo, un parámetro puede estar diseñado para mostrarse solo si existe otro parámetro. Una prueba simplista para mostrar un título solo cuando hay una imagen presente podría ser:
| título = {{#if: {{{ imagen | }}} | {{{ título | }}} }}Meta-plantillas resueltas por nombre
Varias sub-plantillas (y plantillas independientes) tienen un prefijo de nombre común. Se incluyen en un cuadro de información basado en el valor de un parámetro en particular, que actúa como el sufijo del nombre. Por ejemplo, creamos {{Infobox Ship/Military}}y {{Infobox Ship/Civilian}}y usamos {{Infobox Ship/{{{type}}}}}. Usar |type=Militaryen un artículo hace {{Infobox Ship/Military}}que se use.
Cajas de información de varias partes
En lugar de que cada campo corresponda a un parámetro en una plantilla, el cuadro de información consta de una subplantilla individual para cada campo; ver, por ejemplo, Plantilla: Taxobox .
Interacción entre múltiples plantillas
Las plantillas se pueden diseñar de forma modular, de modo que sean posibles varias combinaciones. Incluso puede aparecer una combinación en la página como un solo cuadro de información.
Por ejemplo, si el grupo de WikiProject Saints quisiera diseñar una plantilla basada en su cuadro de información estático, podrían usar Plantilla: Biografía del cuadro de información y diseñar una plantilla específica del proyecto con solo información adicional, y las páginas mostrarían ambas "apiladas" juntas.
Usar infoboxes en artículos
El uso de infoboxes no es obligatorio ni prohibido para ningún artículo. La inclusión de un cuadro de información, qué cuadro de información incluir y qué partes del cuadro de información usar, se determina a través de la discusión y el consenso entre los editores de cada artículo individual.
El significado dado a cada parte del cuadro de información debe ser el mismo en todas las instancias de ese tipo de cuadro de información . Por ejemplo, para un tipo de infobox en particular, si uno de sus campos se llama "peso", sería inapropiado usar este campo a veces para denotar "peso al nacer" y otras veces "peso al vencimiento".
Cada tipo de cuadro de información debe tener documentación que indique cómo se puede utilizar cada parte / campo.
Al igual que las plantillas de navegación , las cajas de información deben evitar los iconos de banderas. Para obtener más información sobre los iconos de banderas, consulte MOS: BANDERA .
Referencias en infoboxes
Las referencias son aceptables en algunos casos, pero generalmente no son necesarias en los infoboxes si el contenido se repite (y se cita) en otro lugar o si la información es obvia. Si el material requiere una referencia (consulte WP: MINREF para conocer las pautas) y la información no aparece también en el cuerpo del artículo, la referencia debe incluirse en el cuadro de información. Sin embargo, los editores deben considerar primero incluir el hecho en el cuerpo del artículo.
Etnicidad en infoboxes
La comunidad de Wikipedia ha decidido en este RfC no permitir el uso del ethnicity =parámetro en infoboxes.
Nacionalidad y ciudadanía
La mayoría de los infoboxes de biografía tienen nacionalidad y ciudadanía. Generalmente, se debe evitar el uso de cualquiera de los dos cuando el país al que pertenece el sujeto se puede inferir del país de nacimiento, como se especifica con |birthplace=.
Cuando sea necesario, por ejemplo, debido a un cambio de nacionalidad después del nacimiento, doble "ciudadanía" u otros escenarios inusuales, use a |nationality=menos que |citizenship=sea más apropiado debido a razones legales poco comunes. El uso simultáneo de la nacionalidad y la ciudadanía rara vez o nunca debería ser necesario (los casos complejos deben explicarse en la prosa del artículo). Ninguno de los campos debe utilizarse para especificar la etnia.
Infoboxes y estilo de usuario
Los usuarios pueden tener CSS de usuario que oculta cualquier cuadro de información en sus propios navegadores.
Para ocultar todos los infoboxes, añada lo siguiente a Especial: MiPágina / common.css (para todas las pieles , o especial: MiPágina / skin.css por sólo la piel actual), en una línea por sí mismo:
. cuadro de información { pantalla : ninguno ; }Alternativamente, puede agregar el siguiente código a su common.js o en un script de usuario del navegador que es ejecutado por una extensión como Greasemonkey :
$ ( '.infobox' ). ocultar ();Tenga en cuenta que, aunque idealmente toda la información de un cuadro de información también debería encontrarse en el cuerpo principal de un artículo, no existe un cumplimiento perfecto de esta guía. Por ejemplo, la jerarquía taxonómica completa en , y el OMIM y otros códigos de bases de datos médicas de a menudo no se encuentran en el contenido del artículo principal. El cuadro de información también suele ser la ubicación de la imagen más significativa, incluso la única, de un artículo.{{Taxobox}}{{Infobox disease}}
Ver también
Lista de plantillas
- Wikipedia: Lista de infoboxes - listado principal
- Todas las páginas con títulos que comienzan con Plantilla: Infobox , una lista recién generada de plantillas que comienzan con "Infobox ..."
Otra información del cuadro de información
- Ayuda: Infobox
- Wikipedia: Índice de plantilla / Limpieza § Cuadro de información necesario
- Todas las páginas con títulos que comienzan con Wikipedia: WikiProject Infobox , una lista recién generada de WikiProjects relevantes
- Wikipedia: Arbitraje / Solicitudes / Caso / Infoboxes
- Wikipedia: Disinfoboxes , un ensayo
- Wikipedia: Disinfoboxes: una refutación , un ensayo
- Wikipedia: Ley de inclusión de infobox , un ensayo
Otros tipos de plantillas
- Wikipedia: plantillas de navegación: pies de página de artículos diseñados para proporcionar enlaces a varios artículos relacionados
- Wikipedia: mensajes de la interfaz de MediaWiki: mensajes que se muestran en los cuadros de la interfaz web de Wikipedia, reservados para uso interno del sistema y solo modificables por los administradores
- Wikipedia: índice de plantilla - directorio de todas las plantillas
- Cajas de información de Wikipedia
- Wikipedia Manual de estilo (contenido)
- Ayuda de la plantilla de Wikipedia
