CSV-Tabelle

Die Direktive csv-table kann verwendet werden, um eine Tabelle aus CSV-Daten (comma-separated values) zu erzeugen.

Beschreibung

Die Direktivenmarkierung besteht aus einem expliziten Markup-Start („.. “) gefolgt vom Typ der Direktive (csv-table) und zwei Doppelpunkten.

(Siehe auch: Direktiven)

Prinzip

.. csv-table::

Eigenschaften

  • Zwischen der Direktive und einem vorangehenden Textkörperelement (z. B. einem Absatz mit Text) ist eine Leerzeile notwendig..

Optionen

Optional kann der Zeilenblock eine flache Liste mit Tabellenoptionen enthalten. Folgende Optionen werden erkannt:

widths : integer [integer...]

Gewichtung der Spaltenbreiten

Eine durch Komma oder Leerzeichen getrennte Liste relativer Spaltenbreiten. Standardmäßig sind die Spalten gleich breit (100%/#Spalten).

header-rows : integer

Kopfzeilentabelle

Die Anzahl der Zeilen, die als Tabellenkopf verwendet werden sollen. Standardwert ist 0.

stub-columns : integer

Kopfspaltentabelle

Die Anzahl der Tabellenspalten, die als Tabellenkopf verwendet werden sollen. Standardwert ist 0.

header : CSV data

Ergänzende Daten für den Tabellenkopf, die unabhängig von und vor jeder Kopfzeile hinzugefügt werden.

Beispiel

Das folgende Beispiel zeigt eine Kopfzeilentabelle mit vier Spalten und zwei Zeilen.
(Im Beispielprojekt: B_DocuElements\Tables\FB_Libdoc_CSVTable)

(*
.. csv-table:: Property list
   :header: "Items", "Property 1", "Property 2", "Property 3"
   :widths: 10, 15, 15, 15

   "Item 1", 1.67, angular, red
   "Item 2", "not specified", round, blue
*)

oder

(*
.. csv-table:: Property list
   :header-rows: 1
   :widths: 10, 15, 15, 15

   "Items", "Property 1", "Property 2", "Property 3"
   "Item 1", 1.67, angular, red
   "Item 2", "not specified", round, blue
*)

CSV-Tabelle 1: