Manual wiki/Edición/Tablas

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 fila " y comenzando en una nueva fila, los códigos para las celdas en la fila están 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 [1] (página en inglés) y HTML element#Tables (wiki en inglés). Sin embargo los elementos thead, tbody, tfoot, colgroup y col actualmente no son soportados en MediaWiki.

Una tabla puede ser útil aun 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 w:Ajedrez#el_tablero_de_ajedrez. 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

{| 
|+ -Ejemplo simple-
! Columna 1 
! Columna 2
|-
| Columna 1, Fila 1 
| Columna 2, Fila 1 
|- 
| Columna 1, Fila 2 
| Columna 2, Fila 2 
|}

y

{| 
|+ -Ejemplo simple-
! Columna 1 || Columna 2
|-
| Columna 1, Fila 1 || Columna 2, Fila 1 
|- 
| Columna 1, Fila 2 || Columna 2, Fila 2 
|}

ambos generan

-Ejemplo simple-
Columna 1	Columna 2
Columna 1, Fila 1	Columna 2, Fila 1
Columna 1, Fila 2	Columna 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
|-
! &times; !! 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
|}

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. Nota: se desanconseja utilizar esta etiqueta ya que está desaprobada en HTML 4 en beneficio del atributo style.

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 ni 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 w:en:Template talk:Table demo (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:Wikipedia.png]]
| align="center" width="150px" | [[Image:Wikipedia.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

Dos logos de Wikipedia

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 2, fila 1 (y 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:

XHTML
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 HTML element#Tables (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

{| parámetros 
|}

Leyenda

|+ leyenda

Fila

<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>

! 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, substituye 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 línea" + "|"

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 operan 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.

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

texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto texto 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 está 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

Plantillas de estilo

Algunos usuarios han creado plantillas para hacer tablas con estilo más fácilmente. En vez de recordar parámetros de tablas puede incluir una plantilla de estilo apropiada después de {|. Esta ayuda conserva el formato de tablas consistente y puede permitir que un simple cambio en la plantilla repare un problema o realce la apariencia de todas las tablas que la usen. Por ejemplo:

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

se convierte en:

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

simplemente reemplazando la sección border="1" cellpadding="2" con {{tablabonita}}, porque esta plantilla contiene las siguientes reglas de estilo:

border="2" cellpadding="4" cellspacing="0" style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; font-size: 95%;"

.

Todas estas plantillas deberían estar organizadas/listadas en un solo lugar como aquí.

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>
Drenthe
Flevoland
Friesland
Gelderland
Groningen
Limburg
North Brabant (capital: [[Den Bosch]]) 
North Holland
Overijssel
South Holland
Utrecht
Zeeland
</gallery>

da:

Véase también

(links en inglés)

Enlaces externos

(links en inglés)

HTML tables to wiki converter at cnic.org
csv2wp - converts comma-separated values (CSV) format to pipe syntax. You may use this to import tables from Excel etc. (more information)
HTML tables to wiki converter at wackyboy.com
HTML tables to wiki converter at uni-bonn.de
HTML tables to wiki converter at diberri.dyndns.org
pywikipediabot (can convert HTML tables to wiki)

Nombre	Efecto	En que juego se encuentra
Pokeball	Pokeball normal	Todas las versiones
Great Ball	Mejor que un Pokeball	Todas las versiones