Die table-Anweisung wird durch die table-Erweiterung bereitgestellt.

Diese Anweisung kann HTML-Tabellen aus Daten im CSV-Format (Komma-separierte Werte) oder DSV-Format (Trennzeichen-separierte Werte) erzeugen.

Beispiele

[[!table  data="""
Kunde    |Betrag
Fulanito |134,34
Menganito|234,56
Menganito|234,56
"""]]

[[!table  class="book_record" format=csv file="data/books/record1"]]

Im zweiten Beispiel sollte die record1-Seite ähnlich wie das Folgende aussehen:

"Title","Perl Best Practices"
"Author","Damian Conway"
"Publisher","O’Reilly"

Um eine Zelle zu erhalten, die über mehrere Spalten geht, kann man die folgenden Zellen leer lassen. Zum Beispiel:

[[!table  data="""
links||rechts|
a|b|c|d
diese Zelle geht über **4** Spalten|||
"""]]

Verwendung

  • data - Werte für die Tabelle.
  • file - Eine Datei im Wiki, die die Daten enthält.
  • format - Das Format der Daten, entweder csv, dsv oder auto (letzteres ist voreingestellt).
  • delimiter - Das Zeichen, durch das die Zellen getrennt werden. Im DSV-Format ist der senkrechte Strich (|) voreingestellt, im CSV-Format das Komma (,).
  • class - Eine CSS-Klasse für das HTML-Element <table>.
  • header - In der Voreinstellung, oder wenn row angegeben wird, wird die erste Zeile der Daten als Tabellenüberschrift verwendet. Mit no wird eine Tabelle ohne Überschrift erzeugt, mit column wird die erste Spalte als Überschrift verwendet.

Für Tabellen, die Tabulatoren als Trennzeichen verwenden (diese erhält man oft beim Kopieren aus einem Browser oder einer Tabellenkalkulation), muss der delimiter auf das Tabulator-Zeichen gesetzt werden. In den meisten Browsern ist es schwierig, dieses einzugeben - vermutlich ist es am einfachsten, es aus den Tabellen-Daten zu kopieren.

Beachte, dass der Inhalt einer Zelle beliebige Ikiwiki- und Mardown-Anweisungen enthalten kann.