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: