Listentabelle

Die Direktive list-table ermöglicht es, eine Tabelle aus Daten in einer zweistufigen Aufzählungsliste zu erstellen.

Beschreibung

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

(Siehe auch: Direktiven)

Prinzip

.. list-table::

Eigenschaften

  • Die Teillisten der Aufzählungsliste müssen die gleiche Anzahl an Listeneinträgen enthalten.
  • Zwischen der Direktive und einem vorangehenden Textkörperelement (z. B. einem Absatz mit Text) ist eine Leerzeile notwendig.

Optionen

Optional kann der list-table-Zeilenblock eine flache Liste mit Tabellenoptionen enthalten. Folgende Option wird 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 Spalten, die als Tabellenkopf verwendet werden sollen. Standardwert ist 0.

Beispiel

(Im Beispielprojekt: B_DocuElements\Tables\FB_Libdoc_ListTable)

(*
.. list-table:: Property list
    :widths: 50 50 50
    :header-rows: 1

    * - Items
      - Property 1
      - Property 2
    * - Item 1
      - angular
      - red
    * - Item 2
      - round
      - blue
*)

Listentabelle 1: