WMarkDown WMarkDown

Menu
Content
Por KyMAN. Creado a fecha 2021/12/04. Última modificación a fecha 2021/12/04.

Tablas

El módulo de las tablas busca agilizar y facilitar la escritura de tablas en WMarkDown, basándose en el sistema de tablas de MediaWiki, pero con algunas diferencias. La sintaxis para crear una tabla en WMarkDown viene siendo con una línea con la que se inicia con la apertura de corchete seguido de un cierre de exclamación, y se entiende como tabla hasta que halla una línea que se inicia con un un cierre de exclamación seguida de un cierre de corchete. Cada línea se entiende como una tupla si ésta se inicia con tubería, sino, será como un comentario dentro de la propia tabla. No existen los saltos de línea.

NOTA: Las tablas de WMarkDown están diseñadas para contenido muy simplificado (Datos, textos muy pequeños, etc.).

Un ejemplo de tabla podría ser lo siguiente:

WMarkDown HTML Resultado

                    
  • Language md
  • Lines 8
  • Characters 303
[! style="width:100%;" Esto es un comentario y se ignorará de la tabla. |^Cabecera|ejemplo1|ejemplo2|ejemplo3|ejemplo4|ejemplo5 |tupla1 |dato1 |dato2 |dato3 |dato4 |dato5 |compacto|dato1|dato2|dato3|dato4|dato5 |colspan|dato1|||dato 2, 3 y 4|dato5 |_pie|||||Esto es el pie de tabla. !]

                    
  • Language html
  • Lines 42
  • Characters 1398
<table style="width"> <thead> <tr> <th>Cabecera</th> <th>ejemplo1</th> <th>ejemplo2</th> <th>ejemplo3</th> <th>ejemplo4</th> <th>ejemplo5</th> </tr> </thead> <tbody> <tr> <td>tupla1</td> <td>dato1</td> <td>dato2</td> <td>dato3</td> <td>dato4</td> <td>dato5</td> </tr> <tr> <td>compacto</td> <td>dato1</td> <td>dato2</td> <td>dato3</td> <td>dato4</td> <td>dato5</td> </tr> <tr> <td>colspan</td> <td>dato1</td> <td colspan="3">dato 2, 3 y 4</td> <td>dato5</td> </tr> </tbody> <tfoot> <tr> <th>pie</th> <th colspan="5">Esto es el pie de tabla.</th> </tr> </tfoot> </table>

Cabeceraejemplo1ejemplo2ejemplo3ejemplo4ejemplo4
tupla1dato1dato2dato3dato4dato5
compactodato1dato2dato3dato4dato5
colspandato1dato 2, 3 y 4dato5
pieEsto es el pie de tabla.

Como podemos ver en el ejemplo anterior, podemos ponerle atributos a la etiqueta HTML en la línea de apertura, y también podemos ver que una línea sin cabecera de tubería también se considera un comentario, que aunque no salga reflejado en el HTML final, sí nos permite hacer breves comentarios de puntos específicos de la propia tabla. También tenemos marcas que identifican si la tupla pertenece a la cabecera, cuerpo o pie de página donde:

  • Si la tupla empieza por "^", "¨" o "-" se considerará cabecera.
  • Si la tupla empieza por "_" se considerará pie.
  • Si la tupla empieza por "#" se considera que será tanto cabecera como pie.
  • Si la tupla empieza por algo distinto se considerará cuerpo.

Cualquiera de estos elementos pueden poner en cualquier punto de la tabla, sin embargo, las cabeceras se unirán, en el orden en el que fueron establecidas, en la THEAD, en la parte superior de la tabla; lo mismo con los pie de tabla pero en la parte inferior, en la etiqueta TFOOT; y los elementos de cuerpo, que se ordenarán en el cuerpo de la misma forma que las cabeceras y los pies, en la etiqueta TBODY.

Cada celda puede contener elementos WMarkDown como enlaces, componentes, etc. Siempre que éstos sólo posean una única línea y no contengan el caracter de la tubería.

Finalmente, estas tablas son capaces de representar COLSPAN, a partir del número de tuberías que precede a la celda, donde si es una se considerará una celda normal de 1 casilla; mientras que si son de más se considerará que ocupan el número de tuberías que la preceden.

NOTA: Un punto interesante de este tipo de tablas es que se ignoran los espacios antes y después del texto de una celda, por lo que permite escribir las tablas con la forma misma de la tabla, dando un índice visual en texto plano WMarkDown muy interesante para ciertas cosas.
IMPORTANTE: Para dejar una celda vacía simplemente hemos de escribir su tubería, y a continuación, un espacio en blanco que la separe de la tubería de la siguiente celda.
Files