Table Thingy

[bennyboer]

A Thingy #TABLE# to create tables.

[bennyboer]

Things to consider

• Import from CSV or HTML file (for example ``#TABLE, src="my-file.csv"#`
• Specify content directly: #TABLE, '<table><!--...--></table>'# using HTML pr CSV to specify tables
• Styling for tables: Maybe #TABLE, style=TABLE_STYLE# for a custom style? TABLE_STYLE should be in the style file. We probably need a new table-specific style block.
• Should also support captions

[bennyboer]

TODO

• General table layout logic
  • Support for layouting table cells
  • Support for merging cell spans
  • Support for setting individual row and column sizes
• Create table thingy
  • new table paragraph type and handler
  • Option src for specifying a CSV file
  • When option src is not specified we are looking into the first argument of the thingy for the table contents
  • Option format defined the input format we expect. For v0.1 we will only support CSV.
    • format=CSV we expect CSV format. This allows the use of the csv-separator option where you can define a custom separator to use for CSV parsing. Default separator is |.
  • Option class should work by taking the proper table style to use. This way you can style individual tables using the Thaw style file the way you want!
  • Option caption and caption-prefix to generate a caption like for images or code paragraphs.
• New style selectors specifically for a table thingy
  • Basic selector for tables: table. e. g. table { font-size: 14pt; }. This should select all table thingies.
  • Selecting a specific class of table using table.my-special-class { ... }.
  • Selecting a specific row using table.my-special-class:row(1). Will select the first row of a table with class my-special-class.
  • Selecting a specific column using table.my-special-class:column(1). Same as for rows.
  • Selecting a range of rows using table.my-special-class:rows(1, 5) should select the first to the fifth row.
  • Selecting a range of columns using table.my-special-class:columns(2, 3). See above for selecting multiple rows.
  • Selecting a specific cell using table.my-special-class:cell(1, 1). Should select the cell in the first row and column.
  • Selecting a range of cells using table.my-special-class:cells(1, 1, 3, 3). Should select all cells in rows 1, 2 and 3 and columns 1, 2 and 3.
  • Priority of applying the pseudo selectors is cell, row, column, rows, columns, where cell is the most important and columns is the least important.

Using the style selectors you should be able to style each table the way you need it.

For example you should be able to

• ... set individual borders to single cells or rows and columns
• ... set indivdual background colors to single cells or rows and columns
• ... set indivdual sizes to rows and columns (cells not supported)
• ... merge cells to cell spans using something like table.my-special-class:cells(1, 1, 3, 3) { merge: true; }
• ... horizontally and vertically align cell contents using both text-align and vertical-align.

[bennyboer]

Branch is table.

[bennyboer]

The general table layout logic has been implemented. It should suffice our layouting needs as it even supports cell span merging.

[bennyboer]

We need to change the selector:

• table will only mean the table paragraph itself (no pseudo-classes allowed)
• table-cell will take the place of the old table selector (having pseudo-classes cells, cell, row, ...)

We need this separation to allow specific margin and padding to the whole table as well as individual cells.

[bennyboer]

Only the general margin and padding of the table has to be applied and the caption typeset for the issue to be closed.

[bennyboer]

Leftovers

• Typeset caption
  • Get caption and caption-prefix from thingy
• Apply general table margin and padding from table style block (with correct class!)
• Handle when we have no more space available for the next row (push new page)

[bennyboer]

Merged to master branch. Issue is thereby done.