Plantilla:Aviso/doc

La metaplantilla {{aviso}} se usa para crear una caja de mensaje con estilos semánticos coherentes, y es la base de plantillas como {{referencias}}, {{destruir}}, etc. Ofrece diversos colores e imágenes predeterminadas en caso de que no se especifique un parámetro imagen, entre otros beneficios.

Uso

Uso básico

{{Aviso|Texto.}}

{{Aviso|Encabezado.|Texto.}}

Uso complejo

{{Aviso
| tipo = estilo
| imagen = Commons-emblem-query.svg
| imagen derecha = Commons-emblem-query.svg
| estilo = background: #afa;
| encabezado = El encabezado del mensaje, visible en dispositivos de escritorio y dispositivos móviles.
| texto = <br>El resto del aviso, visible solo en dispositivos de escritorio. En dispositivos móviles se puede ver tocando el aviso.
| pie = El pie del aviso tampoco se ve en dispositivos móviles hasta que el usuario no toque el aviso.
}}

Parámetros

encabezado − Encabezado del aviso, visible por defecto en dispositivos de escritorio y dispositivos móviles.
texto − Texto del aviso, visible en dispositivos de escritorio por defecto y en dispositivos móviles solo al tocar el aviso.
tipo − Si no se especifica este parámetro, se usará el tipo predeterminado (aviso), que tiene una barra superior azul como en el ejemplo de uso simple de más arriba.
imagen
- Sin parámetro − Si no se especifica el parámetro, la plantilla utiliza la imagen predeterminada. La imagen predeterminada usada depende del parámetro tipo.
- Una imagen − Nombre de la imagen principal del aviso, por ejemplo |imagen=Ejemplo.png, o si se desea cambiar el tamaño y los parámetros por defecto de la imagen, |imagen=[[Archivo:Ejemplo.png|100px]].
- ninguna − Significa que no se utiliza ninguna imagen.
- vacío − Significa que no se usa ninguna imagen pero se usa una superficie vacía de tamaño igual al de la imagen predeterminada, de modo que el texto se alinea bien con los textos de otras plantillas de aviso (véanse los ejemplos «especiales» de más abajo).
imagen derecha
- Sin parámetro − Si no se especifica el parámetro imagen derecha, no se muestra ninguna otra imagen en la parte derecha.
- Una imagen − Nombre de la imagen derecha del aviso, por ejemplo |imagen=Ejemplo.png, o si se desea cambiar el tamaño y los parámetros por defecto de la imagen, |imagen=[[Archivo:Ejemplo.png|100px]].
estilo − Un valor opcional de CSS usado por la metaplantilla de avisos, por ejemplo: |estilo=background:red;

Ejemplos

Estilos

Según el valor que se especifique al parámetro tipo, la metaplantilla mostrará un recuadro con una banda de distinto color e icono, como se puede ver en los siguientes ejemplos:

{{Aviso
| tipo = protección
| encabezado = <code>tipo = <u>protección</u></code>
| texto = <br>Protección y semiprotección de páginas, como {{ep|página bloqueada}}.
}}

{{Aviso
| tipo = serio
| encabezado = <code>tipo = <u>serio</u></code>
| texto = <br>Plantilla crítica de mantenimiento, como advertencias ({{ep|no es una votación}}), borrado rápido ({{ep|destruir}}) o previa revisión de hasta un mes ({{ep|promocional}} o similares), o bloqueos de usuarios ({{ep|Títere}}).
}}

{{Aviso
| tipo = contenido
| encabezado = <code>tipo = <u>contenido</u></code>
| texto = <br>Cuestiones de contenido, como {{ep|no neutralidad}}, {{ep|PA}} y similares.
}}

{{Aviso
| tipo = estilo
| encabezado = <code>tipo = <u>estilo</u></code>
| texto = <br>Cuestiones de estilo, como {{ep|copyedit}}, {{ep|wikificar}} y similares. 
}}

{{Aviso
| tipo = fusionar
| encabezado = <code>tipo = <u>fusionar</u></code>
| texto = <br>Propuestas de fusión o traslado, como {{ep|fusionar}} y {{ep|transferir a}}.
}}

{{Aviso
| tipo = desarrollo
| encabezado = <code>tipo = <u>desarrollo</u></code>
| texto = <br>Páginas en desarrollo, como {{ep|en desarrollo}}, {{ep|traducción}} o similares.
}}

{{Aviso
| tipo = aviso
| encabezado = <code>tipo = <u>aviso</u></code>
| texto = <br>Plantilla informativa, como avisos para artículos ({{ep|evento actual}}), usuarios ({{ep|PU borrada}}), o discusiones ({{ep|polémico}}), por ejemplo.
}}

Imágenes

En muchos casos es más apropiado usar imágenes más específicas para cada aviso creado con esta plantilla. Para una lista con imágenes sugeridas, véase esta categoría en Wikimedia Commons. Los siguientes ejemplos usan el parámetro imagen para especificar una imagen diferente de las imágenes predeterminadas. El tamaño recomendado es 40px.

Detalles técnicos

Si necesitas usar caracteres especiales en el parámetro encabezado, entonces debes evitarlos así:

{{Aviso
| encabezado = <div>
El signo igual = y las llaves { } funcionan bien.
Pero aquí hay una barra {{!}} y dos llaves de fin }}. 
Y ahora una barra y llaves de fin |}}.
</nowiki>
</div>
}}

Esta plantilla usa clases CSS para la mayoría de su aspecto, por lo que se pueden crear «pieles» o skins.

Esta plantilla utiliza internamente HTML en lugar de código wiki para el código de la tabla. Esta es la manera típica para hacer metaplantillas ya que el código wiki tiene algunos inconvenientes. Por ejemplo, hace más complicado usar ParserFunctions y caracteres especiales en los parámetros.

Categorías donde se incluyen los artículos marcados

Protección: Categoría:Wikipedia:Plantillas de protección
Serio: Categoría: Wikipedia:Plantillas críticas de mantenimiento
Contenido: Categoría:Wikipedia:Plantillas de contenido
Estilo: Categoría:Wikipedia:Plantillas de estilo
Fusión: Categoría:Wikipedia:Plantillas de fusiones
Desarrollo: Categoría:Wikipedia:Plantillas de desarrollo
Aviso: Categoría:Wikipedia:Plantillas de avisos

Redirecciones

No olvides documentar las plantillas de mantenimiento siguiendo este formato.

TemplateData

Esta es la documentación de la plantilla, generada mediante TemplateData, que es utilizada también para su inserción y modificación en el editor visual.

TemplateData para Aviso

Sin descripción.

Parámetros de la plantilla
Parámetro		Descripción	Tipo	Estado
Encabezado	`encabezado` `1`	Encabezado del aviso, visible en todos los dispositivos	Contenido	obligatorio
Texto	`texto` `2` `contenido`	Texto del aviso. En dispositivos móviles se ve solo tras tocar el aviso.	Contenido	sugerido
Pie	`pie`	Texto al pie. En dispositivos móviles se ve solo tras tocar el aviso.	Contenido	opcional
Tipo de aviso	`tipo`	Tipo de aviso, según los tipos definidos.	Cadena	sugerido
Imagen	`imagen`	Icono a mostrar a la izquierda del aviso.	Archivo	sugerido
Imagen derecha	`imagen derecha`	Icono a mostrar a la derecha del aviso.	Archivo	opcional
Estilo CSS adicional	`estilo`	sin descripción	Cadena	opcional
Clase CSS adicional	`clase`	sin descripción	Cadena	opcional