Plantilla: Ambox


Documentación de plantilla [ ver ] [ editar ] [ historial ] [ purgar ]

{{ Ambox }} son las siglas de A rticle m essage box , que es una metaplantilla . Se utiliza para crear cuadros de mensaje para las plantillas que se utilizan en los artículos , como {{ underlinked }}. Ofrece varios colores, imágenes y algunas otras características diferentes.

Uso básico

El cuadro a continuación muestra los parámetros más comunes que son aceptados por {{ Ambox }}. El propósito de cada uno se describe a continuación.

{{Ambox| nombre =| subst =  {{subst: substcheck}} | pequeño = {{{pequeño |}}}| tipo =| imagen =| secta = {{{1 |}}}| problema =| hablar = {{{hablar |}}}| arreglar =| fecha = {{{fecha |}}}| gato =| todo =}}

Uso completo

Parámetros completos

El cuadro "Todos los parámetros" muestra todos los parámetros posibles para esta plantilla. Sin embargo, no se recomienda copiar esto, porque nunca será necesario utilizar todos los parámetros simultáneamente.

Parámetros comunes

nombre

El parámetro de nombre especifica el nombre de la plantilla, sin el prefijo del espacio de nombres de la plantilla. Por ejemplo, {{ Underlinked }} especifica |name=Underlinked.

Este parámetro debe actualizarse si la plantilla se mueve alguna vez. El propósito de este parámetro es doble:

  • Si se sustituye incorrectamente , permite que la metaplantilla notifique el nombre de la plantilla que se ha sustituido, lo que puede ayudar a los editores a solucionar el problema.
  • Permite que la plantilla tenga una visualización más útil en su página de plantilla, por ejemplo, para mostrar la fecha incluso cuando no se especifica, y para aplicar la categorización de la propia plantilla.

subst

El parámetro subst permite a la metaplantilla detectar si la plantilla se ha sustituido incorrectamente y dar una advertencia adecuada. También agregará dichas páginas a Categoría: Páginas con plantillas sustituidas incorrectamente . Simplemente copie el código exactamente como aparece en el cuadro.

pequeña

El pequeño parámetro debe pasarse a través de la plantilla, ya que esto permitirá a los editores usar el pequeño formato especificando |small=leften un artículo:

De lo contrario, se producirá el formato estándar:

Otras variaciones:

  • Para plantillas que nunca deben ser pequeñas, especifique |small=noo no pase el parámetro pequeño en absoluto.
  • Para las plantillas que siempre deben ser pequeñas, solo especifíquelas |small=left.
  • Para las plantillas que deberían ser pequeñas por defecto , intente |small={{{small|left}}}. Esto permitirá que un editor anule el uso |small=node un artículo.

Para usar un cuadro pequeño que ajuste su ancho para que coincida con el texto, use |style=width: auto; margin-right: 0px;y |textstyle=width: auto;juntos:

Consulte la sección § a continuación para obtener más información sobre cómo limitar la |small=visualización a los casos en los que la plantilla se utiliza para una sección en lugar de para todo el artículo (recomendado, para evitar la visualización inconsistente de la parte superior del artículo).

tipo

El parámetro de tipo define el color de la barra izquierda y la imagen que se usa por defecto. El tipo no se elige en función de la estética, sino que se basa en el tipo de problema que describe la plantilla. Los siete tipos disponibles y sus imágenes predeterminadas se muestran a continuación.

Si no se proporciona ningún parámetro de tipo, la plantilla predeterminada es |type=notice.

imagen

Puede elegir una imagen específica para usar en la plantilla utilizando el parámetro de imagen . Las imágenes se especifican utilizando la sintaxis estándar para insertar archivos en Wikipedia (consulte Wikipedia: Manual de estilo / Imágenes # Cómo colocar una imagen ). Los anchos de 40-50 px son típicos. Por ejemplo:

  • {{ POV }} especifica |image=[[File:Unbalanced scales.svg|40px|link=|alt=]]y se ve así:
  • {{ underlinked }} especifica |image=[[File:Ambox wikify.svg|50x40px|link=|alt=]]y se ve así:

Tenga en cuenta:

  • Si no se especifica ninguna imagen, se utiliza la imagen predeterminada correspondiente al tipo . (Ver #tipo arriba).
  • Si |image=nonese especifica, no se utiliza ninguna imagen y el texto utiliza toda el área del cuadro de mensaje.
  • Si un icono es puramente decorativo y también es de dominio público , se puede mejorar la accesibilidad suprimiendo el enlace a la página del archivo añadiendo " |link=|alt=" como se ve arriba.

secta

Muchas plantillas de mensajes de artículos comienzan con el texto Este artículo ... y a menudo es deseable que esta redacción cambie a Esta sección ... si la plantilla se usa en una sección. El valor de este parámetro reemplazará la palabra "artículo". Varias posibilidades para el uso incluyen: |sect=list, |sect=table, |sect="In popular culture" material, etc.

Si utiliza esta función, asegúrese de eliminar las dos primeras palabras ("Este artículo") del texto de la plantilla; de lo contrario, se duplicará.

Una forma común de facilitar esta funcionalidad es pasar |sect={{{1|}}}. Esto permitirá a los editores escribir section, por ejemplo, como el primer parámetro sin nombre de la plantilla para cambiar la redacción. Por ejemplo, produce:{{Advert|section}}

Otro enfoque es pasar |sect={{{section|{{{sect|}}}}}}para proporcionar un valor con nombre. Otra es usar para analizar el valor de un positivo y pasar si es verdadero.{{Yesno}}|sect=section

Estos enfoques se pueden combinar , y esto se recomienda. El siguiente código listo para usar:

| sect = {{#ifeq:{{yesno|def=|1={{{sect|{{{section}}}}}} }}|yes|section|{{{sect|{{{section|{{{1|}}}}}}}}} }}

habilita lo siguiente:

  • Cualquier valor positivo que puede detectar será utilizado con el parámetro llamado en la plantilla basada en Ambox para conseguir "sección" en lugar de "artículo": , , etc. Se recomienda para permitir tanto y de manera que los editores no tienen que adivinar qué uno funcionará. El código de muestra anterior hace esto por usted.{{Yesno}}|section=y|sect=True|sect=|section=
  • Cualquier otro valor pasó, de cualquier manera, sustituirá "artículo": |section and its subsections, |1=list, |sect=section, |section=table, etc.

También es aconsejable restringir el uso del |small=parámetro para que dependa de que la plantilla se aplique a una sección (o lo que sea) en lugar de a todo el artículo, para evitar que se utilice la versión pequeña de la plantilla en la parte superior del artículo. donde sería incompatible con otros banners de limpieza / disputa de todo el artículo:

| small = {{#if:{{{sect|{{{section|{{{1|}}}}}}}}}|{{#if:{{{small|{{{left|}}}}}}|left}} }}

(En este caso, cualquier valor de |small=o |left=activará la pantalla pequeña izquierda, siempre |sect=que también se haya proporcionado algún valor de o uno de sus alias en esa plantilla). Este código se puede copiar y pegar y usar con el código anterior cuadra. Consulte, por ejemplo, Plantilla: Trivia y su Plantilla: Trivia / casos de prueba para observar la funcionalidad combinada.

emitir y arreglar

El parámetro de problema se utiliza para describir el problema con el artículo. Trate de que sea breve y directo (aproximadamente de 10 a 20 palabras) y asegúrese de incluir un enlace a una política o directriz relevante .

El parámetro de corrección contiene texto que describe lo que se debe hacer para mejorar el artículo. Puede ser más largo que el texto en cuestión , pero por lo general no debe tener más de dos oraciones.

Cuando la plantilla está en su forma compacta (cuando se coloca dentro de {{ varios problemas }}) o en forma pequeña (cuando se usa |small=left), el problema es el único texto que se mostrará. Por ejemplo, {{ Estilo de cita }} define

  • |issue=This article '''has an unclear citation style'''.
  • |fix=The references used may be made clearer with a different or consistent style of [[Wikipedia:Citing sources|citation]], [[Wikipedia:Footnotes|footnoting]], or [[Wikipedia:External links|external linking]].

Cuando se usa de forma independiente, produce el texto completo:

Pero cuando se usa dentro de {{ Multiple issues }} o con |small=leftél, solo muestra el problema:

hablar

Algunas plantillas de mensajes de artículos incluyen un enlace a la página de discusión y permiten que un editor especifique un encabezado de sección para enlazar directamente a la sección relevante. Para lograr esta funcionalidad, simplemente pase el parámetro de conversación a través, es decir|talk={{{talk|}}}

Este parámetro puede entonces ser utilizado por un editor de la siguiente manera:

  • |talk=SECTION HEADING - el enlace apuntará a la sección especificada en la página de discusión del artículo, p. Ej. |talk=Foo
  • |talk=FULL PAGE NAME- la plantilla se vinculará a la página especificada (que puede incluir un ancla de sección ), por ejemplo|talk=Talk:Banana#Foo

Notas:

  • Cuando este parámetro es usado por una plantilla, el enlace de la página de discusión aparecerá en la propia plantilla (para demostrar la funcionalidad) pero esto solo se mostrará en los artículos si el parámetro está realmente definido.
  • Para asegurarse de que siempre haya un enlace a la página de discusión, puede usar |talk={{{talk|#}}}.
  • Si la página de discusión no existe, no habrá ningún enlace, sea cual sea el valor del parámetro.

fecha

Pasar el parámetro de fecha a la metaplantilla significa que un editor (o más comúnmente un bot ) puede especificar la fecha en la que se etiqueta el artículo . Esto se mostrará después del mensaje en una fuente más pequeña.

Pasar este parámetro también habilita la categorización de limpieza mensual cuando el parámetro cat también está definido.

info

Este parámetro es para especificar información adicional. Todo lo que agregue aquí aparecerá después de la fecha y no se mostrará si la plantilla se incluye en {{ varios problemas }}.

remocion

Si lo especifica |removalnotice=yes, el siguiente aviso se mostrará después de la fecha y después del texto de información :

  • Aprenda cómo y cuándo eliminar este mensaje de plantilla .

Esto no se mostrará si la plantilla se incluye en {{ varios problemas }}.

gato

Este parámetro define una categoría de limpieza mensual. Si |cat=CATEGORYentonces:

  • Los artículos se colocarán en Categoría: CATEGORÍA desde FECHA si |date=DATEse especifica.
  • los artículos se colocarán en Categoría: CATEGORÍA si no se especifica la fecha.

Por ejemplo, {{ No footnotes }} especifica, |cat=Articles lacking in-text citationspor lo que un artículo con la plantilla se colocará en Categoría: artículos que carecen de citas en el texto de junio de 2010 .{{No footnotes|date=June 2010}}

El parámetro cat no debe estar vinculado ni debe Category:usarse el prefijo .

todas

El parámetro all define una categoría en la que se deben colocar todos los artículos.

El todo parámetro no debe estar vinculada, ni debe el prefijo Category:ser utilizado.

Parámetros adicionales

imagen derecha

Se puede especificar una imagen en el lado derecho del cuadro de mensaje usando este parámetro. La sintaxis es la misma que para el parámetro de imagen , excepto que el valor predeterminado es sin imagen.

smallimage y smallimageright

Las imágenes para la caja de formato pequeño se pueden especificar usando estos parámetros. No tendrán ningún efecto a menos que |small=leftse especifique.

clase

Clases CSS personalizadas para aplicar al cuadro. Si agrega varias clases, deben estar separadas por espacios.

estilo y el estilo de texto

Se pueden definir valores CSS opcionales, sin comillas " "pero con punto ;y coma al final .

  • estilo especifica el estilo utilizado por toda la tabla de cuadro de mensajes. Esto se puede usar para hacer cosas como modificar el ancho de la caja.
  • estilo de texto se refiere a la celda de texto.

texto y texto pequeño

En lugar de especificar el problema y la solución , es posible utilizar el parámetro de texto .

El texto personalizado para el formato pequeño se puede definir utilizando smalltext .

enlaces sencillos

Normalmente en Wikipedia, los enlaces externos tienen un icono de flecha junto a ellos, como este: Example.com . Sin embargo, en los cuadros de mensaje, el icono de flecha está suprimido de forma predeterminada, así: Example.com . Para obtener el estilo normal de enlace externo con el ícono de flecha, use |plainlinks=no.

cat2 , cat3 , all2 y all3

  • cat2 y cat3 proporcionan categorías mensuales adicionales; ver #cat .
  • all2 y all3 proporcionan categorías adicionales en las que se colocan todos los artículos, al igual que #todos .

Notas técnicas

  • Esta metaplantilla utiliza las clases CSS de ambox en MediaWiki: Common.css . Las clases también se pueden usar directamente en una wikitable si se necesita una funcionalidad especial. Consulte la guía práctica para eso.
  • Si necesita usar caracteres especiales en el parámetro de texto, debe escaparlos de esta manera:
{{Ambox| texto = 
El signo igual = y una llave de inicio y finalización {} funcionan bien tal como están.Pero aquí hay una pipa & # 124; y dos llaves finales }} .Y ahora una tubería y tirantes finales |}} .
}}
  • Las
    etiquetas que rodean el texto en el ejemplo anterior generalmente no son necesarias. Pero si el texto contiene saltos de línea, a veces obtenemos un espaciado de línea extraño. Esto sucede especialmente cuando se utilizan listas de puntos verticales. Luego usa las etiquetas div para arreglar eso.
  • Esta plantilla usa clases CSS en MediaWiki: Common.css para la mayor parte de su apariencia, por lo que es totalmente personalizable.
  • Internamente, esta metaplantilla usa marcado HTML en lugar de wikimarkup para el código de la tabla. Esa es la forma habitual en que se hacen las meta-plantillas, ya que wikimarkup tiene varios inconvenientes. Por ejemplo, dificulta el uso de funciones del analizador y algunos caracteres especiales en los parámetros.
  • Las imágenes predeterminadas para esta metaplantilla están en formato png en lugar de en formato svg. La razón principal es que algunos navegadores web más antiguos tienen problemas con el fondo transparente que MediaWiki representa para las imágenes svg. Las imágenes png aquí tienen un color de fondo transparente optimizado a mano para que se vean bien en todos los navegadores. Tenga en cuenta que los íconos svg solo se ven algo mal en los navegadores antiguos, por lo que dicha optimización manual solo vale la pena para los íconos muy utilizados.
  • Para obtener más detalles técnicos, consulte la página de discusión y los enlaces "Consulte también" a continuación. Dado que esta plantilla funciona casi exactamente como {{ Tmbox }}, {{ Imbox }}, {{ Cmbox }} y {{ Ombox }}, sus páginas de discusión y páginas relacionadas también pueden contener más detalles.

TemplateData

Mbox family

There are seven metatemplates in the Module:Message box family:
  • {{Ambox}}, for messageboxes on article pages.
  • {{Cmbox}}, for messageboxes on category pages.
  • {{Imbox}}, for messageboxes on file (image) pages.
  • {{Tmbox}}, for messageboxes on talk pages.
  • {{Fmbox}}, for header and footer messageboxes.
  • {{Ombox}}, for messageboxes on other types of page.
  • {{Mbox}}, for messageboxes that are used in different namespaces and change their presentation accordingly.

Closely related metatemplates:

  • {{Asbox}}, for messageboxes in article stubs.
  • {{Dmbox}}, for messageboxes on disambiguation or set-index pages.
  • {{Ivmbox}}, a simple full-width box with default ivory background intended to frame important messages or notices.

Templates intended to be used in conjunction with Mboxes:

  • {{Ombox/shortcut}}, an alternative to {{Shortcut}} for use in Mbox templates

See also

  • Wikipedia:Classes in Ambox – Describes how to use the ambox CSS classes directly in wikitables and HTML tables.
  • Wikipedia:Manual of Style/Article message boxes – The style guideline for creating article message boxes.
  • Template talk:Ambox – For discussion about these matters.