Sintaxis de Tablas

De WikiRoca
Ir a la navegación Ir a la búsqueda

Sintaxis con barras verticales

Aunque la sintaxis HTML para tablas funcione, el código wiki puede ser usado para crear una tabla de la siguiente forma:

  • La tabla entera comienza con una línea "{| parámetros opcionales para la tabla " y finaliza con la línea "|}".
  • Una leyenda opcional se incluye con la línea "|+ leyenda " luego de "{|".
  • El código para una fila consiste en una línea "|- parámetros opcionales para la tabla " y comenzando en una nueva fila, los códigos para las celdas en la fila estan separados por nueva línea o "|".
  • Datos de tabla son los códigos para las celdas; el código de la celda esta formado por "| valor " o "| parámetros de celda | valor ".
  • Una fila de títulos de columna se identifica usando "!" en lugar de "|", excepto para la separación entre un parámetro de celda y un valor; la diferencia con una fila normal depende del navegador, los títulos de columna están frecuentemente presentados en negritas.
  • La primera celda de la fila es identificada como fila de títulos si comienza la línea con "!" en lugar de "|", y comienzan las subsecuentes celdas de datos en una nueva línea.

Los parámetros de tabla y de celdas son los mismos como en HTML, ver Demostración de Tablas (página en inglés) y Elementos en Tablas (wiki en inglés). Sin embargo los elementos thead, tbody, tfoot, colgroup y col actualmente no son soportados en MediaWiki.

Una tabla puede se útil aún si ninguna de sus celdas tiene contenido, notablemente porque con el uso de colores de fondo de celdas la tabla puede ser un diagrama vea por ejemplo el artículo de Tabla de Ajedrez en Wikipedia. Una "imagen" en forma de una tabla es mucho más conveniente para editar una imagen subida.

Cada fila debe tener el mismo número de celdas que las otras filas, así el número de columnas en la tabla continúa siendo consistente (a menos que haya celdas que abarquen varias columnas o filas, vea colspan y rowspan en ejemplo mezcla más abajo). Para celdas vacías, use el espacio “non-breaking”   como contenido para asegurar que las celdas sean mostradas.

Ejemplos

Ejemplo simple

{| 
| Celda 1, Fila 1 
| Celda 2, Fila 1 
|- 
| Celda 1, Fila 2 
| Celda 2, Fila 2 
|}

y

{| 
| Celda 1, Fila 1 || Celda 2, Fila 1 
|- 
| Celda 1, Fila 2 || Celda 2, Fila 2 
|}

ambos generan

Celda 1, Fila 1 Celda 2, Fila 1
Celda 1, Fila 2 Celda 2, Fila 2

Tabla de multiplicar

Hemos complicado un poco esta tabla poniendo atributos de alineación a celdas y a filas enteras para que pueda apreciar cómo se ponen los atributos a nivel de fila y a nivel de celda cuando las celdas se escriben sobre la misma línea de código.

Obsérvese también que NO se pueden mezclar en una misma línea de código una celda de datos y una celda de título.

Código fuente

{| border="1" cellpadding="2"
|+ Tabla de multiplicar
|-
! × !! align="right" | 1 !! align="right" | 2 !! align="right" | 3
|-
! align="right" | 1
| align="right" | 1 || align="right" | 2 || align="right" | 3
|- align="right"
! 2
| 2 || 4 || 6
|- align="right"
! 3
| 3 || 6 || 9
|- align="right"
! 4
| 4 || 8 || 12
|- align="right"
! 5
| 5 || 10 || 15
|}

Apariencia

Tabla de multiplicar
× 1 2 3
1 1 2 3
2 2 4 6
3 3 6 9
4 4 8 12
5 5 10 15

Color; alcance de parámetros

Hay dos formas de especificar el color del texto y del fondo para una sola celda:

{| 
| bgcolor=red | <font color=white> abc
| def
| style="background:red; color:white" | ghi
| jkl
|}

da

abc def ghi jkl

Como se ve “font” funciona para una sola celda, aún sin etiqueta de cierre: la etiqueta de cierre es añadida por el sistema.

Como otros parámetros, los colores pueden también ser especificados para una fila completa o para una tabla completa; los parámetros para una fila sobrescriben los valores para la tabla, y los de una celda sobrescriben los de la fila:

{| style="background:yellow; color:green"
|- 
| abc
| def
| ghi
|- style="background:red; color:white"
| jkl
| mno
| pqr
|-
| stu
| style="background:silver" | vwx
| yz
|}

da

abc def ghi
jkl mno pqr
stu vwx yz

La especificación HTML 4.01 define dieciséis colores, aquí se muestran con sus valores hexadecimales:

Negro #000000 Plata #c0c0c0 Marrón #800000 Rojo #ff0000
Azul marino #000080 Azul #0000ff Púrpura #800080 Fucsia #ff00ff
Verde #008000 Lima #00ff00 Oliva #808000 Amarillo #ffff00
Verde azulado #008080 Aguamarina #00ffff Gris #808080 Blanco #ffffff

Ancho, alto

El ancho y el alto de toda la tabla puede ser especificado, como así también el alto de una fila. Para especificar el ancho de una columna uno puede especificar el ancho de una celda en la columna arbitrariamente. Si no se especifica el ancho para todas las columnas, y/o el alto de todas las filas, entonces habrá alguna ambigüedad, y el resultado dependerá del navegador.

{| style="width:400px; height:200px" border="1"
|- 
| abc
| def
| ghi
|- style="height:100px" 
| jkl
| style="width:200px" |mno
| pqr
|-
| stu
| vwx
| yz
|}

da

abc def ghi
jkl mno pqr
stu vwx yz

Posición

Uno puede ubicar la tabla en sí, y todo el contenido de una fila, y el contenido de una celda, pero no con un solo parámetro todo el contenido de una tabla, vea "Table demo" en la Wikipedia] (en inglés). No use, bajo ninguna circunstancia, “float” para ubicar una tabla. Esto rompería la presentación de la página a fuentes de gran tamaño.

“Ejemplo mezcla”

Aquí hay un ejemplo más avanzado que muestra más opciones disponibles para “maquillar” tablas. Puede jugar con estos ajustes en su propia tabla para ver los efectos que tienen. No todas estas técnicas pueden ser apropiadas en todos los casos; ya que adicionar fondos coloreados, por ejemplo, puede no ser una buena idea. Trate de mantener el “maquillaje” en sus tablas relativamente simple –recuerde , otras personas estarán editando también el artículo. Este ejemplo le da una idea de lo que es posible.

Código fuente

{| border="1" cellpadding="5" cellspacing="0" align="center"
|+'''Una tabla ejemplo'''
|-
! style="background:#efefef;" | Primer encabezado
! colspan="2" style="background:#ffdead;" | Segundo encabezado
|-
| arriba a la izquierda
|  
| rowspan=2 style="border-bottom:3px solid grey;" valign="top" |
lado derecho
|-
| style="border-bottom:3px solid grey;" | abajo a la izquierda
| style="border-bottom:3px solid grey;" | abajo en el medio
|-
| colspan="3" align="center" |
{| border="0"
|+''Una tabla en otra tabla''
|-
| align="center" width="150px" | [[Image:Murc wiki 80.png]]
| align="center" width="150px" | [[Image:Murc wiki 80.png]]
|-
| align="center" colspan="2" style="border-top:1px solid red; border-right:1px
          solid red; border-bottom:2px solid red; border-left:1px solid red;" |
Dos logos de Wikipedia
|}
|}

Apariencia

Una tabla ejemplo
Primer encabezado Segundo encabezado
arriba a la izquierda  

lado derecho

abajo a la izquierda abajo en el medio
Una tabla en otra tabla
Murc wiki 80.png Wiki roca logo 3.gif

Dos logos de WikiRoca

Ejemplo avanzado

{| align=right border=1
| Celda 1, fila 1 
|rowspan=2| Celda 2, fila 1 (y 2) 
| Celda 3, fila 1 
|- 
| Celda 1, fila 2 
| Celda 3, fila 2 
|}
Celda 1, fila 1 Celda 2, fila 1 (y 2) Celda 3, fila 1
Celda 1, fila 2 Celda 3, fila 2

Note la tabla flotante a la derecha


Tabla anidada

{| border=1
| &alpha;
|
{| bgcolor=#ABCDEF border=2
|tabla
|-
|anidada
|}
|la tabla original de nuevo
|}

da una tabla anidada

α
tabla
anidada
la tabla original de nuevo

Las tablas anidadas deben comenzar en una nueva línea.

Otras sintaxis de tablas

Otros tipos de sintaxis de tablas que soporta MediaWiki son:

  1. XHTML
  2. HTML y sintaxis wiki <td>

Los tres son soportados por MediaWiki y crean (actualmente) una visualización HTML válida, pero la sintaxis con barras verticales es la más simple, excepto tal vez para las personas que ya están familiarizadas con HTML. También, HTML y sintaxis wiki <td> no necesariamente permanecerán soportadas por los navegadores en el futuro por venir, especiamente por las computadoras de mano (handheld) con posibilidad de acceder a internet.

Vea también Elementos en tabla (wiki en inglés). Note sin embargo que los elementos thead, tbody, tfoot, colgroup y col actualmente no son soportados en MediaWiki.

Comparación

Comparación de sintaxis de tablas
 XHTML HTML & Wiki-td Wiki-pipe
Tabla <table></table> <table></table>
{| parámetros 
|}
Leyenda <caption></caption> <caption></caption>
|+ leyenda
Fila <tr></tr> <tr>
|- parámetros 
Celda de datos

<td>celda1</td>
<td>celda2</td>

<td>celda1
<td>celda2

| celda1
| celda2
Celda de datos <td>celda1</td> <td>celda2</td> <td>celda3</td> <td>celda1 <td>celda2 <td>celda3
|celda1||celda2||celda3
Celda encabezado <th></th> <th>
! encabezado
Tabla ejemplo
1 2
3 4
<table>
   <tr>
      <td>1</td>
      <td>2</td>
   </tr> 
   <tr>
      <td>3</td> 
      <td>4</td> 
   </tr>
</table>
<table>
   <tr>
      <td> 1 <td> 2
   <tr>
      <td> 3 <td> 4
</table>
{| 
| 1 || 2
|- 
| 3 || 4
|}
Tabla ejemplo
1 2
3 4
5 6
<table>
   <tr>
      <td>1</td>
      <td>2</td>
   </tr> 
   <tr>
      <td>3</td>
      <td>4</td>
   </tr>
   <tr>
      <td>5</td>
      <td>6</td>
   </tr>
</table>
<table>
   <tr>
      <td> 1 <td> 2
   <tr>
      <td> 3 <td> 4
   <tr>
      <td> 5 <td> 6
</table>
{| 
| 1 || 2 
|- 
| 3 || 4 
|- 
| 5 || 6 
|}
Pro

Puede ser previsualizado/depurado con cualquier editor XHTML


Puede dársele un formato para mejor lectura


Bien conocido

Puede ser previsualizado/depurado con cualquier editor HTML


Puede dársele un formato para mejor lectura


Bien conocido


Ocupa menos espacio que XHTML

Fácil de escribir


Fácil de leer


Ocupa menos espacio

Cons

Tedioso


Ocupa mucho espacio


Difícil de leer rápidamente

Confusa, especialmente para gente con poca experiencia en HTML


Formato pobre


Pobremente desarrollado


Generalmente tiene aspecto raro


Puede no tener soporte de navegadores en el futuro

Sintaxis no familiar


Estructura rígida


No se pueden colocar sangrías


El texto (como en etiquetas HTML) puede ser más fácil de leer para algunas personas que series de barras verticales, signos de suma, de exclamación, etc.

 XHTML HTML & Wiki-td Wiki-pipe

Sintaxis de barras verticales en terminos de presentación HTML

La sintaxis de barras verticales, desarrollada por Magnus Manske del proyecto Wikpedia, sustituye barras verticales (|) por HTML. Hay un script on-line que convierte tablas HTML a sintaxis de tablas de barras verticales.

Las barras verticales deben estar al comienzo de una nueva línea, excepto cuando separan parámetros de contenido o cuando se usan || para separar celdas en una misma línea. Los parámetros son opcionales.

Tablas

Una tabla está definida por {| ''parámetros'' |} que es igual <table ''parámetros''>Insertar texto sin formato aquí </table>

Cuidado: Debe incluir un espacio entre {| y los parámetros, o el primer parámetro será ingnorado.

Filas

Las etiquetas <tr> serán generadas automáticamente por la primera fila. Para comenzar una nueva fila, use

|-

que resulta en <tr> Los parámetros pueden ser adicionados de la siguiente forma: |- parámetros que resultan en <tr parámetros>

Nota:

  • Las etiquetas <tr> serán automáticamente abiertas al primer equivalente <td>
  • Las etiquetas <tr> serán automáticamente cerradas a los equivalentes <tr> y </table>

Celdas

Las celdas son generadas por cualquiera de las siguientes formas:

|celda1
|celda2
|celda3

o

|celda1||celda2||celda3

ambas son iguales a

<td>celda1</td><td>celda2</td><td>celda3</td>

así "||" es igual a "nueva linea" + "|"

Parámetros en celdas pueden ser usados de la siguiente forma:

|parámetros|celda1||parámetros|celda2||parámetros|celda3

que resultará en <td parámetros>

Encabezados

Las funciones funcionan de la misma forma que TD, excepto "!" es usado en vez del "|" de comienzo. "!!" puede ser usado en vez de "||". Los parámetros sin embargo usan "|". Ejemplo:

!parámetros|celda1

Leyendas

Una etiqueta <caption> (leyenda) es creada por

|+ Leyenda

que genera

<caption>Leyenda</caption>

También puede usar parámetros:

|+ parámetros|Leyenda

que generará

<caption parámetros>Leyenda</caption>

Texto próximo a una tabla

(Para ver los efectos debe aumentar o disminuir el tamaño de la fuente del navegador; también puede cambiar el ancho de la ventana del navegador.)

Puede usar align=right, y el texto que sigue a la tabla aparecerá a la izquierda de la misma.

Tabla de multiplicar 5*3
× 1 2 3
1 1 2 3
2 2 4 6
3 3 6 9
4 4 8 12
5 5 10 15

aquí comienza el texto inmediatamente después de la tabla de multiplicar 5*3 texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto suficiente de este texto. Plantilla:Clear

Sin embargo, no puede colocar texto preformateado, este puede solaparse a la tabla. Para prevenir esto use <br style="clear:both;">:

Tabla de multiplicar 4*3
× 1 2 3
1 1 2 3
2 2 4 6
3 3 6 9
4 4 8 12

aquí comienza el texto inmediatamente después de la tabla de multiplicar 4*3… texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto este es el fin del texto ahora viene el claro BR:

el texto preformateado empezaría solo luego de que la tabla finalizó texto texto texto texto

Puede usar align=left, y la tabla aparecerá a la izquierda y el texto que sigue a la misma a la derecha (pero posiblemente demasiado cerca):

Tabla de multiplicar 2*3
× 1 2 3
1 1 2 3
2 2 4 6

aquí comienza el texto inmediatamente después de la tabla de multiplicar 2*3 texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto

Plantilla:Clr

Espacio alrededor de una tabla, imagen o texto

Para crear espacio alrededor de una tabla, imagen o texto cree una tabla de 1x1 alrededor de éstos con “cellpadding:

Tabla de multiplicar
× 1 2 3
1 1 2 3
2 2 4 6
Jam2007.gif

texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto

Texto en caja

texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto TeXto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto Plantilla:Clr

Ajustando el ancho de las columnas

Si quiere forzar el ancho de columna a sus propios requerimientos más que aceptar el ancho del mayor elemento en una celda de una columna entonces siga este ejemplo. Note que el espacio alrededor del texto esta impuesto.

{| border="1" cellpadding="2"
!width="50"|Nombre
!width="225"|Efecto
!width="225"|En que juego se encuentra
|-
|Pokeball
|Pokeball normal
|Todas las versiones
|-
|Great Ball
|Mejor que un Pokeball
|Todas las versiones
|}
Nombre Efecto En que juego se encuentra
Pokeball Pokeball normal Todas las versiones
Great Ball Mejor que un Pokeball Todas las versiones

Ajustando parámetros

Al comienzo de una celda adicione su parámetro seguido de una sola barra vertical. Por ejemplo width=300px| esto determinará una celda con un ancho de 300 pixels. Para establecer más de un parámetro deje un espacio entre cada uno.

Código Wikipedia

{|
|-
| bgcolor=red|celda1 || width=300px bgcolor=blue|celda2 || bgcolor=green|celda3
|}

Que se verá así en su navegador

celda1 celda2 celda3

Alineación del punto decimal

Un método para obtener columnas de números alineadas en el punto decimal es como sigue:

<blockquote>
{| cellpadding=0 cellspacing=0
|align=right| 432 || . || 1
|-
|align=right| 43 || . || 21
|-
|align=right| 4 || . || 321
|}
</blockquote>

que da

432 . 1
43 . 21
4 . 321

En casos simples uno puede administrar un rasgo de tabla y simplemente comenzar la línea con un espacio y poniendo espacios en la posición de los números:

432.1
 43.21
  4.321


Galería

Como un subproducto de la característica de galería de imágenes, una tabla puede ser hecha con una etiqueta de galería; si una entrada de texto contiene un link, la entrada entera es ignorada.

<gallery>
castor
lobato
scout
esculta
rover
scouter
</gallery>

da:

Links externos

(links en inglés)