Esta guía práctica describe cómo usar los atributos de clases en ambox para crear cuadros de mensajes de artículos como {{ cleanup }} . Las clases CSS de ambox se definen en MediaWiki:Common.css . Esta guía describe cómo usar las clases directamente en tablas wiki y tablas HTML .
También existe una plantilla meta {{ ambox }} que facilita la creación de cuadros de mensajes de artículos. Tiene documentación de uso y ejemplos y puede manejar los casos de uso más comunes. Pero {{ ambox }} es principalmente un contenedor delgado para las clases. Si/cuando necesites una funcionalidad más avanzada, puedes usar las clases directamente en una wikitable o tabla HTML como se describe en esta guía.
Los atributos de clase para las plantillas {{ tmbox }} , {{ imbox }} , {{ cmbox }} y {{ ombox }}ambox ambox-style también funcionan como se describe en esta guía. Simplemente cambie el nombre de " " a, por ejemplo, " tmbox tmbox-style" para obtener un cuadro de mensaje de página de discusión marrón.
Si estos cuadros no se parecen, es posible que necesites actualizar la memoria caché de tu navegador web :
Esto sucede cuando los atributos de clase se han actualizado pero aún están almacenados en caché en el navegador. Por lo general, esto desaparece en unos días.
Ejemplo de uso simple con el color de "aviso" azul predeterminado:
{| clase = "ambox" |- | clase = "mbox-image" | Imagen | clase = "mbox-text" | Algún texto. |} Un ejemplo un poco más complejo con el color violeta "mover/fusionar/dividir/transwiki propuestas" y una imagen:
{| class = "ambox ambox-move" |- | class = "mbox-image" | [[ Imagen : Edit-copy purple.svg | 40px ]] | class = "mbox-text" | Algún texto. |} Todos los estilos de los cuadros de mensajes de los artículos se definen como clases CSS en MediaWiki:Common.css . Esto permite que los cuadros de mensajes tengan aspectos . Es decir, se pueden anular en las hojas de estilo para diferentes aspectos de Wikipedia y también en su propio monobook.css .
Aquí están los nombres de las clases ambox y lo que definen.
{| class = "ambox ambox-notice" | class = "mbox-image" | [[ Image : Gnome globe current event.svg | 42px ]] | class = "mbox-text" | < div > '''Este artículo o sección documenta un [[ vuelo espacial ]] actual .''' < br > El contenido puede cambiar a medida que avanza la misión. </ div > | class = "mbox-imageright" | [[ Image : Shuttle.svg | 20px ]] |} En el ejemplo anterior:
MediaWiki tiene algunas rarezas al manejar contenido en tablas. Por eso, aquí también aplicamos un par de <div> </div>etiquetas alrededor del texto del cuerpo del mensaje. Nos permiten escribir el texto en varias líneas en lugar de una línea contigua sin que aparezcan saltos de párrafo extraños. En este caso, solo necesitábamos que las líneas de ejemplo fueran lo suficientemente cortas para que quepan en el cuadro de ejemplo de código. Pero este truco puede ser muy conveniente al escribir mensajes largos. Tenga en cuenta que las etiquetas div lamentablemente causan un margen adicional alrededor del texto, así que úselas solo si es necesario.
También aplicamos una <br>etiqueta para forzar un salto de línea exactamente donde lo queremos.
MediaWiki también entiende el marcado HTML. Tenga en cuenta que no se trata realmente de marcado HTML, sino de "marcado wiki HTML", ya que MediaWiki lo procesa igual que el marcado wiki. A continuación se muestra el ejemplo anterior, pero ahora con marcado HTML:
< tabla clase = "ambox ambox-notice" > < tr > < td clase = "mbox-image" > [[Imagen:Globo de Gnome evento actual.svg|42px]] < td clase = "mbox-text" >< div >'''Este artículo o sección documenta un [[vuelo espacial]] actual.'''< br > El contenido puede cambiar a medida que avanza la misión. </ div > < td class = "mbox-imageright" > [[Image:Shuttle.svg|20px]] </ table >El ejemplo anterior no utiliza etiquetas de fin </td>y fin </tr>. Esas etiquetas de fin no suelen ser necesarias, ya que MediaWiki las agrega automáticamente cuando muestra las páginas. Pero hay algunas excepciones:
<td>etiquetas de inicio y fin), pero no hay saltos de línea. A continuación, se muestran dos ejemplos que pueden causar problemas:<td class="mbox-text"> {{{text|}}}<td class="mbox-text">{{{text|}}}</td><td class="mbox-text"> {{{text|}}} </td><br />etiquetas finales, ya que MediaWiki no maneja el marcado wiki HTML en muchos de los mensajes del sistema.Las clases mbox y las metaplantillas mbox como {{ ambox }} y {{ tmbox }} están diseñadas de tal manera que funcionan sin problemas en todos los navegadores web. Estas son algunas de las cosas de las que se encargan:
Estas cosas son lo que llamamos "flujo de caja" apropiado.
Para que un mbox tenga un ancho del 80 % y un flujo de caja adecuado, debe tener al menos una celda "mbox-text" y otra celda de al menos 1 px de ancho en la misma fila de la tabla. Esa otra celda suele ser una celda "mbox-image", pero si no tiene una celda con imagen, puede simplemente agregar una celda vacía:
<td></td>Sin embargo, las celdas vacías tienen un ancho predeterminado de al menos 3 px (ancho + relleno), lo que a veces puede ser bastante visible. Por eso, para mayor comodidad, existe la clase mbox-empty-cell que establece la celda con un ancho de solo 1 px, sin borde ni relleno:
<td class="mbox-empty-cell"></td>La celda vacía puede estar a la izquierda o a la derecha de la celda de texto, ambas funcionan.