((META (EMPTY-STRING title "Zettelmarkup: Tables") (WORD role "manual") (TAG-SET tags ("#manual" "#zettelmarkup" "#zettelstore")) (WORD syntax "zmk") (ZID-SET back ("00001007010000" "00001007030000" "00001007800000" "00001007990000" "00001012920513")) (ZID-SET backward ("00001007010000" "00001007030000" "00001007800000" "00001007990000" "00001012920513")) (NUMBER box-number "1") (STRING copyright "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (TIMESTAMP created "20210126175322") (ZID-SET forward ("00001004100000" "00001007040000")) (WORD lang "en") (EMPTY-STRING license "EUPL-1.2-or-later") (TIMESTAMP modified "20241212153641") (TIMESTAMP published "20241212153641") (WORD visibility "public")) (BLOCK (PARA (TEXT "Tables are used to show some data in a two-dimensional fashion.") (SOFT) (TEXT "In zettelmarkup, tables are not specified explicitly, but by entering ") (FORMAT-EMPH () (TEXT "table rows")) (TEXT ".") (SOFT) (TEXT "Therefore, a table can be seen as a sequence of table rows.") (SOFT) (TEXT "A table row is nothing but a sequence of ") (FORMAT-EMPH () (TEXT "table cells")) (TEXT ".") (SOFT) (TEXT "The length of a table is the number of table rows, the width of a table is the maximum length of its rows.")) (PARA (TEXT "The first cell of a row must begin with the vertical bar character (") (FORMAT-QUOTE () (LITERAL-INPUT () "|")) (TEXT ", U+007C) at the first position of a line.") (SOFT) (TEXT "The other cells of a row begin with the same vertical bar character at later positions in that line.") (SOFT) (TEXT "A cell is delimited by the vertical bar character of the next cell or by the end of the current line.") (SOFT) (TEXT "A vertical bar character as the last character of a line will not result in a table cell.") (SOFT) (TEXT "It will be ignored.") (SOFT) (TEXT "Inside a cell, you can specify any ") (LINK-ZETTEL () "00001007040000" (TEXT "inline elements")) (TEXT ".")) (PARA (TEXT "For example:")) (VERBATIM-CODE (("" . "zmk")) "| a1 | a2 | a3|\n| b1 | b2 | b3\n| c1 | c2") (PARA (TEXT "will be rendered in HTML as:")) (REGION-BLOCK (("" . "example")) ((TABLE () ((CELL (TEXT "a1")) (CELL (TEXT "a2")) (CELL (TEXT "a3"))) ((CELL (TEXT "b1")) (CELL (TEXT "b2")) (CELL (TEXT "b3"))) ((CELL (TEXT "c1")) (CELL (TEXT "c2")) (CELL))))) (HEADING 1 () "header-row" "header-row" (TEXT "Header row")) (PARA (TEXT "If any cell in the first row of a table contains an equal sing character (") (FORMAT-QUOTE () (LITERAL-INPUT () "=")) (TEXT ", U+003D) as the very first character, then this first row will be interpreted as a ") (FORMAT-EMPH () (TEXT "table header")) (TEXT " row.")) (PARA (TEXT "For example:")) (VERBATIM-CODE (("" . "zmk")) "| a1 | a2 |= a3|\n| b1 | b2 | b3\n| c1 | c2") (PARA (TEXT "will be rendered in HTML as:")) (REGION-BLOCK (("" . "example")) ((TABLE ((CELL (TEXT "a1")) (CELL (TEXT "a2")) (CELL (TEXT "a3"))) ((CELL (TEXT "b1")) (CELL (TEXT "b2")) (CELL (TEXT "b3"))) ((CELL (TEXT "c1")) (CELL (TEXT "c2")) (CELL))))) (HEADING 1 () "column-alignment" "column-alignment" (TEXT "Column alignment")) (PARA (TEXT "Inside a header row, you can specify the alignment of each header cell by a given character as the last character of a cell.") (SOFT) (TEXT "The alignment of a header cell determines the alignment of every cell in the same column.") (SOFT) (TEXT "The following characters specify the alignment:")) (UNORDERED (INLINE (TEXT "the colon character (") (FORMAT-QUOTE () (LITERAL-INPUT () ":")) (TEXT ", U+003A) forces a centered alignment,")) (INLINE (TEXT "the less-than sign character (") (FORMAT-QUOTE () (LITERAL-INPUT () "<")) (TEXT ", U+0060) specifies an alignment to the left,")) (INLINE (TEXT "the greater-than sign character (") (FORMAT-QUOTE () (LITERAL-INPUT () ">")) (TEXT ", U+0062) will produce right aligned cells."))) (PARA (TEXT "If no alignment character is given, a default alignment is used.")) (PARA (TEXT "For example:")) (VERBATIM-CODE (("" . "zmk")) "|=Left<|Right>|Center:|Default\n|123456|123456|123456|123456|\n|123|123|123|123") (PARA (TEXT "will be rendered in HTML as:")) (REGION-BLOCK (("" . "example")) ((TABLE ((CELL-LEFT (TEXT "Left")) (CELL-RIGHT (TEXT "Right")) (CELL-CENTER (TEXT "Center")) (CELL (TEXT "Default"))) ((CELL-LEFT (TEXT "123456")) (CELL-RIGHT (TEXT "123456")) (CELL-CENTER (TEXT "123456")) (CELL (TEXT "123456"))) ((CELL-LEFT (TEXT "123")) (CELL-RIGHT (TEXT "123")) (CELL-CENTER (TEXT "123")) (CELL (TEXT "123")))))) (HEADING 1 () "cell-alignment" "cell-alignment" (TEXT "Cell alignment")) (PARA (TEXT "To specify the alignment of an individual cell, you can enter these characters for alignment as the first character of that cell.")) (PARA (TEXT "For example:")) (VERBATIM-CODE (("" . "zmk")) "|=Left<|Right>|Center:|Default\n|>R|:C|<L\n|123456|123456|123456|123456|\n|123|123|123|123") (PARA (TEXT "will be rendered in HTML as:")) (REGION-BLOCK (("" . "example")) ((TABLE ((CELL-LEFT (TEXT "Left")) (CELL-RIGHT (TEXT "Right")) (CELL-CENTER (TEXT "Center")) (CELL (TEXT "Default"))) ((CELL-RIGHT (TEXT "R")) (CELL-CENTER (TEXT "C")) (CELL-LEFT (TEXT "L")) (CELL)) ((CELL-LEFT (TEXT "123456")) (CELL-RIGHT (TEXT "123456")) (CELL-CENTER (TEXT "123456")) (CELL (TEXT "123456"))) ((CELL-LEFT (TEXT "123")) (CELL-RIGHT (TEXT "123")) (CELL-CENTER (TEXT "123")) (CELL (TEXT "123")))))) (HEADING 1 () "rows-to-be-ignored" "rows-to-be-ignored" (TEXT "Rows to be ignored")) (PARA (TEXT "A line that begins with the sequence ") (LITERAL-INPUT () "|%") (TEXT " (vertical bar character (") (FORMAT-QUOTE () (LITERAL-INPUT () "|")) (TEXT ", U+007C), followed by a percent sign character (“%”, U+0025)) will be ignored.") (SOFT) (TEXT "For example, this allows to specify a horizontal rule that is not rendered.") (SOFT) (TEXT "Such tables are emitted by some commands of the ") (LINK-ZETTEL () "00001004100000" (TEXT "administrator console")) (TEXT ".") (SOFT) (TEXT "For example, the command ") (LITERAL-CODE () "get-config box") (TEXT " will emit:")) (VERBATIM-CODE () "|=Key        | Value  | Description\n|%-----------+--------+---------------------------\n| defdirtype | notify | Default directory box type") (PARA (TEXT "This is rendered in HTML as:")) (REGION-BLOCK (("" . "example")) ((TABLE ((CELL (TEXT "Key")) (CELL (TEXT "Value")) (CELL (TEXT "Description"))) ((CELL (TEXT "defdirtype")) (CELL (TEXT "notify")) (CELL (TEXT "Default directory box type"))))))))