htab documentation

htab() is a GNU Octave function to produce nice lay-outs of tables in html and Latex.

Features

• There are two ways to input data:
  • as a string, in which tags are used to distinguish table cells and styling directives;
  • as a cell array, in which one or more tables are stored as two-dimensional cell arrays.
• Nested tables are possible.
• Different horizontal and vertical rules can be drawn between rows and columns. (They are "collapsed" mainly due to the standard way of defining and drawing them in Latex.)
• Latex output to be applied with the array package is assumed at default, but in addition one can apply the longtable and/or booktabs packages.
• Styling of cells comprises of: horizontal alignment, left- and rightside padding (i.e. whitespace), wrapping of long lines, column spanning, conversion of numerical data into text, conversion of the ordinary computer notation of exponents of numbers (e.g. "1e3" is converted to "1 × 10³"), and extra arbitrary styling by direct insertion of html and/or Latex codes.

Below a complete list of all directives (or styling commands) sorted by feature is given.

Function call

Function htab is called like this:

r = htab(tbl);

or:

r = htab(tbl,opt);

Input

Note that in this documentation a "string" is always synonym to a "row vector of characters", in GNU Octave terms.

The first input argument tbl contains information on the table(s). We can think of it as either:

• tbl = stbl;

  where stbl is a string.

  Table cells and styling directives are distinguished in the following way by the default tags in string stbl:

    <htab>
      <tabsty>...</tabsty>
      <colsty>...<csep>...<csep>...</colsty>
      cell data 1,1<csep>cell data 1,2<sty>...</sty><csep>cell data 1,3<rsep>
      cell data 2,1<csep>cell data 2,2              <csep>cell data 2,3<rsep>
    </htab>
  

  Table cells within a row are separated by <csep>. The number of columns in a table is defined by the row which has the largest number of instances of <csep>. If this row has N instances of <csep>, the table has N+1 columns.

  When a cell spans over several columns, no <csep> may be skipped (contrary to html or Latex coding)! If the cell in column K on a particular row has the directive that it spans over M columns, data in the cells K+1, K+2, ... and K+M-1 will be ignored and instances of <csep> will be expected between cells K+1 and K+2, between cells K+2 and K+3, ... and (if cell K+M-1 is not in the last column of the table:) between cells K+M-1 and K+M.

  Table rows are separated by <rsep>. If there are no characters, or just whitespace characters, between the last <rsep> and the final tag </htab>, no new row is assumed.

  The fields <tabsty>...</tabsty> and <colsty>...</colsty> are optional. They may only appear in the first table cell!

  The field <sty>...</sty> is issued in a table cell to indicate directives. There are no tags to explicitly indicate cell content data. Leading and trailing whitespace in the cell contents will be removed.

  The three dots ... in the above code are to be replaced by styling directives. The coding of the directives is explained below.

or:

• ctbl = { ... s, ..., rtbl, ... };
  tbl = ctbl;
  

  where one-dimensional cell array ctbl has an arbitrary number of elements. Each element is either:

  • a string s. Such a string may not contain a table. The string simply contains text before or after a table, or between tables;

  or:

  • a struct rtbl. Such a struct must contain a table defined by the following fields:
    • "tabsty". The field contains a string or a struct by which directives exclusively pertaining to the (whole) table are given;
    • "colsty". The field contains a one-dimentional cell array of strings or a one-dimensional cell array of struct's, by which directives are given. Each element in the array corresponds to a table column;
    • "rowsty". The field contains a one-dimentional cell array of strings or a one-dimensional cell array of struct's, by which directives are given. Each element in the array corresponds to a table row;
    • "cellsty". The field contains a two-dimentional cell array of strings or a two-dimensional cell array of struct's, by which directives are given. Each element in the array corresponds to a table cell;
    • "celldat". The field contains a two-dimentional cell array by which content data is given for each respective table cell.

      Content data may have any value. Strings will not be converted. Integers, reals, booleans will be converted into obvious text representations. Also cell arrays and struct's are converted into text representations (in json form).

      If a particular table cell contains a nested table, the fields "cellsty" and "celldat" of the particular table cell contain the directive "nested-table" and a one-dimensional cell array of the same type as ctbl, respectively.

The optional seconde input argument opt contains a struct, which may have one or more of the following fields:

• "tagsigils". This field contains a struct by which the user can set tag sigils (tag markers), different from the default ones. We distinguish "outer tag sigils", which are the first and last characters of any tag, and "inner tag sigils", which are characters put between an outer tag sigil and the tag name. Because there are single tags and tag pairs, the inner tag sigils are differentiated accordingly. The defaults are:

    opt.tagsigils.outer = {"<",">"};
    opt.tagsigils.single = {"",""};
    opt.tagsigils.pair = {"","","/",""};
  

  So, with the defaults, the tags in "<htab>...<csep>...<rsep>...</htab>" are recognised.

  If one would set for example:

    opt.tagsigils.outer = {"[","]"};
    opt.tagsigils.single = {"@",""};
    opt.tagsigils.pair = {"-","","","-"};
  

  the tags in "[-htab]...[@csep]...[@rsep]...[htab-]" are recognised.

  Of course, one has to choose sigils by which tags are distinctive. Function htab does not provide for much error checking.

• "tagrenaming". This field contains a struct by which the user can set one or more new tag names for the default ones. These are the default tag names: htab, tabsty, colsty, sty, csep, rsep, space, semicolon, empty, and contents.

  For example, to have "<tab>" (with the default tag sigils) instead of the default "<csep>", one issues:

    opt.tagrenaming.csep = "tab";
  

Output

The output argument r is a struct, which has the following fields:

• "html". The field contains a string in html code;
• "htmlheaderstyle". The fields contains a string in css code, which can be put between the html <style> and </style> elements within the header in a html file;
• "latex". The field contains a string in Latex code;
• "htmlfile". The field contains a string with the total web page in html code, which is ready to be saved to a file;
• "latexfile". The field contains a string with the total document in Latex code, which is ready to be saved to a file.

Example 1

The following input (as a string):

<htab>
  <tabsty> default-vert-sep single; default-hor-sep single </tabsty>
  <colsty>
    col-width 30 %<csep>
    col-width 10 %; col-double .; col-right-sep none; <csep>
    col-width 10 %<csep>
    col-width 30 %<csep>
    col-width 20 %; col-hor-align center
  </colsty>
  cell 1,1<csep>cell 1,2
                <sty>col-span 2; hor-align left</sty>
                        <csep>cell 1,3<csep>cell 1,4<csep>cell 1,5<rsep>
  cell 2,1<csep>123.456 <csep>cell 2,3<csep>cell 2,4<csep>cell 2,5<rsep>
  cell 3,1<csep>1.23456 <csep>cell 3,3<csep>cell 3,4<csep>cell 3,5<rsep>
  cell 4,1 This cell contains much text to show wrapping. Of course, this 
    also depends on the size of the applied font.
          <csep>cell 4,2<csep>cell 4,3<csep>cell 4,4<csep>cell 4,5<rsep>
  cell 5,1 <sty>col-span 4; hor-align center</sty>
          <csep>cell 5,2<csep>cell 5,3<csep>cell 5,4<csep>cell 5,5<rsep>
  cell 6,1<csep>cell 6,2<csep>cell 6,3<csep>cell 6,4
                                            <htab>
                                              C-1-1<csep>C-1-2<rsep>
                                              C-2-1<csep>C-2-2<rsep>
                                              C-3-1<csep>C-3-2<rsep>
                                            </htab>
                                                    <csep>cell 6,5<rsep>
  cell 7,1<csep>cell 7,2<csep>cell 7,3<csep>cell 7,4<csep>cell 7,5
                                                          <sty>html-style font-weight:<space>bold;
                                                               latex-style {\bf<space><contents>}
                                                          </sty>     
                                                                  <rsep>
</htab>

results to this lay-out in html:

Some remarks on this example:

• By directives "col-width", column widths are set in percentages, so relative to the total width of the table. Here, the total is 100%, but a total of 100% is not required.
• Due to the directive "col-double" in the second column, the data in the second column is split at the dot, and, if the dot is found, the second part is transferred to the third column. Moreover, the horizontal alignment in the second column is set to "right", and the alignment in the third column is set to "left". Note that any data in the third column is ignored.
• By directive "col-span" in cells 1,2 and 5,1, column spanning is applied. This directive is combined with directive "hor-align" to set the horizontal alignment individually in these cells.
• Cell 6,4 contains a nested table. Table directives are inherited by the nested table from the containing table.
• Cell 7,5 contains direct html and Latex codes for printing in bold face.

Example 2

Here, the input tbl is a cell array organised like ctbl explained above:

rtbl = struct();
rtbl.tabsty = "default-vert-sep single; default-hor-sep single; default-number-format %1.8e";
rtbl.rowsty = {};
rtbl.rowsty{4} = "row-number-format %2.2e";
rtbl.rowsty{7} = "row-number-format %2.1e";
rtbl.cellsty = {};
rtbl.cellsty{1,2} = "col-double .; col-right-sep none";
rtbl.cellsty{4,2} = "number-format %2.3e";
rtbl.cellsty{5,2} = "number-format %1.0f";
c54 = [0.5*pi pi 2*pi];
c64 = {"p", "q", 3, 4};
c74 = struct();
c74.a = 1;
c74.b = [2 3];
rtbl.celldat = { ...
  "cell 1,1", "cell 1,2",  "cell 1,3", "cell 1,4";
  "cell 2,1", "1.2345e-6", "",         "1.2345e-6";
  "cell 3,1", 1.2345e-6,   "",         1.2345e-6;
  "cell 4,1", 1.2345e-6,   "",         1.2345e-6;
  "cell 5,1", 1.2345e3,    "",         c54;
  "cell 6,1", 1.2345e3,    "",         c64;
  "cell 7,1", 1.2345e3,    "",         c74;
};
tbl = {rtbl};

After processing by htab(tbl), we get this result in html:

Some remarks on this example:

• By directive "default-number-format %1.8e", numbers which have been given as numbers (not as strings), will be printed in an exponential notation with a precision of 8 digits. Therefore, the data given as strings in cells 2,2 and 2,4 is not affected by the directive, but e.g. the data given as numbers in cells 3,2 and 3,4 are affected.
• Because at default the conversion of the ordinary computer notation of exponents is switched on (see the expanations on directive "default-exponent-format" below), all exponents, given as either strings or numbers, are printed as "× 10^m". Compare e.g. cells 2,2 (string input) and 3,2 (number input).
• A different precision is issued for row 4, by directive "row-number-format %2.2e". This row directive overrides the more general table directive "default-number-format %1.8e". The effect is visible in cell 4,4. But cell 4,2 has yet again a different precision, because in this cell we have given cell directive "number-format %2.3e", which overrides the more general row directive.
• A fixed-number format without fraction is requested for cell 5,2 by its cell directive "number-format %1.0f".
• The input to cells 5,4, 6,4 and 7,4 is an numerical array, a mixed array and an struct, respectively. Such input is always printed in json code. The printing of numbers in json code is also affected by directives on number format and exponent format.
• For cell 1,2 two directives are issued. These two are column directives! And they are automatically assigned to column 2. Because of directive "col-double .", numbers (either given as strings or numbers) are split over columns 2 and 3, and all data given in column 3 is ignored.

Example 3

Also in this example, the input tbl is a cell array organised like ctbl explained above:

rtbl = struct();
rtbl.tabsty = "default-wrap off; html-table-width auto";
rtbl.rowsty = {};
rtbl.rowsty{1} = "row-top-sep top";
rtbl.rowsty{3} = "row-top-sep mid";
rtbl.rowsty{10} = "row-bottom-sep bottom";
rtbl.cellsty = {};
rtbl.cellsty{1,2} = "col-span 3";
rtbl.cellsty{2,2} = "top-sep span";
rtbl.cellsty{2,3} = "top-sep span";
rtbl.cellsty{2,4} = "top-sep span";
rtbl.celldat = { ...
  "unit",      "symbol", "",      "",     "exact definition";
  "",          "htab",   "Latex", "html", "";
  "inch",      "",       "in",    "in",   "1 inch = 2.54 centimeters";
  "css point", "pt",     "bp",    "pt",   "1 css point = (1/72) inches";
  "css pica",  "",       "",      "pc",   "1 css pica = 12 css points";
  "css pixel", "",       "",      "px",   "1 css pixel = 0.75 css points = (1/96) inches";
  "TeX point", "pt",     "pt",    "",     "1 TeX point = (1/72.27) inches";
  "TeX pica",  "",       "pc",    "",     "1 TeX pica = 12 TeX points";
  "x-height",  "ex",     "ex",    "ex",   "height of small \"x\" in the actual font";
  "M-width",   "em",     "em",    "em",   "width of capital \"M\" in the actual font";
};
tbl = {rtbl};

After processing by htab(tbl), we get this result in html:

Some remarks on this example:

• Because the texts in the cells are short, it is decided that no wrapping is needed, and directive "default-wrap off" is issued. Because of this, the table width is automatically set to the sum of the minimal widths of all columns in Latex. On the other hand, we will not have this effect in html automatically, because of the default of directive "html-table-width 100%". Therefore, we have to issue "html-table-width auto".

Directives

See the next two sections for complete lists of directives.

We distinguish "table directives", "column directives", "row directives" and "cell directives", because each directive belongs to a single category or level. This means that a directive applies either to (the styling of) the whole table, a particular column, a particular row, or a particular cell.

If a styling property is set by several directives, the directive at a lower level overrules the one at a higher level. The four levels are: "table" (highest) – "column" – "row" – "cell" (lowest).

Note that directives may be placed at a lower level. The htab program will anyhow assign such "misplaced" directives to their intrinsic categories or levels. Thus, within <sty>...</sty> and within "cellsty" fields, directives of all categories are accepted. Within <colsty>...</colsty> and within "colsty" fields, both column and table directives are accepted, but no row directives (however) and no cell directives. Within <tabsty>...</tabsty> and within "tabsty" fields, only table directives are accepted.

If the same directive is issued on several places, the last read instance will eventualy define the styling.

Table directives are inherited by the nested table from the containing table.

A directive consists of a directive name and zero or more arguments. Directives can be given as:

• a string, like this: "dir1 arg1; dir2".

  One can issue multiple directives by inserting a semicolon between them. Some directives have one or more arguments, which are separated by spaces. Tags are used to encode a semicolon, space or an empty string in arguments; the default forms of these tags are <semicolon>, <space> and <empty>, respectively.

or:

• a struct, like this: d.("dir1")={"arg1"}; d.("dir2")={};.

  The struct may contain zero or more directives, as it may contain as much fields. The field name contains a directive name; the field value contains a one dimensional cell array, of which each element is a string for the respective argument of the directive.

List of all directives, sorted by feature

• nested table: nested-table;
• column width: col-width;
• styling of vertical separators (presence, type, thickness and (partially:) colour of vertical rules): col-left-sep, col-right-sep, default-vert-sep, medium-vert-rule, thick-vert-rule, thin-vert-rule;
• styling of horizontal separators (presence, type, thickness and (partially:) colour of horizontal rules): bottom-hor-rule, bottom-sep, default-hor-sep, mid-hor-rule, row-bottom-sep, row-top-sep, span-hor-rule, top-hor-rule, top-sep;
• horizontal padding in cells: col-left-padding, col-right-padding;
• horizontal alignment in cells: col-hor-align, default-hor-align, hor-align, row-hor-align;
• wrapping of long lines in cells: col-wrap, default-wrap;
• splitting of the cell contents, and transfer of the second part to the next cell: col-double;
• column spanning: col-span;
• conversion of numerical values to text: col-number-format, default-exponent-format, default-html-exponent-format, default-latex-exponent-format, default-number-format, number-format, row-number-format;
• html/css styling: html-classes, html-style, html-table-width;
• Latex styling and coding: latex-style, latex-table-environment, latex-table-width;

Alphabetical list of all directives

bottom-hor-rule <arg1> <arg2> <arg3>

<arg1> :

number

(default : "0.6")

<arg2> :

unit "ex", "em", "mm" or "pt"

(default : "ex")

<arg3> :

non-empty string

(default : "black")

category : table

Thickness (and colour code) of horizontal rules of type "bottom".

This type is translated into \bottomrule[thickness] in Latex and this Latex code is defined by the booktabs package.

The colour is only applied in html; the colour code must be recognised in html/css.

bottom-sep <arg1>

<arg1> :

"none", "top", "mid", "span", "bottom", "single" or "double"

category : cell

Row separator type below the actual cell. The default is defined by directive "default-hor-sep".

col-double <arg1>

<arg1> :

non-empty text

category : column

The contents in the cells of the actual column is splitted just before the text given in the argument. The first part is printed in the actual column; the second part is transferred to the cell in the next column. Moreover, the horizontal alignment of actual column is set to "right", and the alignment in next column is set to "left".

Splitting and transfering is applied only if the contents of the cell consists of text (given as such), or a number (given as such). In the latter case, the splitting is applied after the number is converted to text.

At default, no such splitting and transfering are applied.

col-hor-align <arg1>

<arg1> :

"left", "right" or "center"

category : column

Horizontal alignment in the cells of the actual column. The default is defined by directive "default-hor-align".

col-left-padding <arg1> <arg2>

<arg1> :

number

<arg2> :

unit "%", "ex", "em", "mm" or "pt"

category : column

Left-side padding width in the cells of the actual column. At default, \tabcolsep is used in Latex, but no css style is set in html. This means that the default padding width is 6 pt in Latex and (perhaps) 1 px in html.

There are no versions of this directive to set the left-side padding width per row or per cell, because this is rather complicated to implement in Latex.

col-left-sep <arg1>

<arg1> :

"none", "thick", "medium", "thin", "single" or "double"

category : column

Left-side separator type in the cells of the actual column. The default is defined by directive "default-vert-sep".

This directive will overrule the possibly issued directive "col-right-sep" in the previous column, because collapse of separators is applied.

col-number-format <arg1>

<arg1> :

non-empty template

(default : "%g")

category : column

The argument contains a template as used by the sprintf() series of functions to translate a real or integer (given as such data) into text. Data which has been given as text, is not affected by this translation.

The translation is applied to the cells in the actual column.

col-right-padding <arg1> <arg2>

<arg1> :

number

<arg2> :

unit "%", "ex", "em", "mm" or "pt"

category : column

Right-side padding width in the cells of the actual column. At default, \tabcolsep is used in Latex, but no css style is set in html. This means that the default padding width is 6 pt in Latex and (perhaps) 1 px in html.

There are no versions of this directive to set the right-side padding width per row or per cell, because this is rather complicated to implement in Latex.

col-right-sep <arg1>

<arg1> :

"none", "thick", "medium", "thin", "single" or "double"

category : column

Right-side separator type in the cells of the actual column. The default is defined by directive "default-vert-sep".

col-span <arg1>

<arg1> :

integer > 0 or character "*"

category : cell

Span the actual cell over a number of columns. If "*" is given, span until the last column.

At default, no spanning is applied.

col-width <arg1> <arg2>

<arg1> :

number

(default : "15")

<arg2> :

unit "%", "ex", "em", "mm" or "pt"

(default : "%")

category : column

Width of the actual column.

col-wrap <arg1>

<arg1> :

"off" or "on"

category : column

Wrap long lines in the cells of the actual column. The default is defined by directive "default-wrap".

default-exponent-format <arg1>

<arg1> :

"off" or "on"

(default : "on")

category : table

Switch the exponent format for numbers according directives "default-html-exponent-format" and "default-latex-exponent-format" on or off.

If the switch is off, the ordinary computer notation of exponents by "e" (e.g. 1e3 for one thousand) is left unchanged.

default-hor-align <arg1>

<arg1> :

"left", "right" or "center"

(default : "left")

category : table

Horizontal alignment within each table cell.

default-hor-sep <arg1>

<arg1> :

"none", "top", "mid", "span", "bottom", "single" or "double"

(default : "none")

category : table

Horizontal separator type. Horizontal separators may appear between rows and to the top and bottom sides of the table.

One can choose between horizontal rules of different function/position. The function/position not only defines a thickness, but also vertical spacing in Latex. The thickness of types "top", "mid", "span" and "bottom" can be defined by directives "*-hor-rule".

The types "single" and "double" reflect the horizontal rules coded as \hline and \hline \hline in Latex; their thickness is defined by \arrayrulewidth (0.4 pt at default) in Latex.

default-html-exponent-format <arg1> <arg2>

<arg1> :

code

(default : " &times; 10<sup>")

<arg2> :

code

(default : "</sup>")

category : table

The first argument contains the html code between mantissa and the exponent, the second argument the html code after the exponent.

These codes are only applied if the argument of directive "default-exponent-format" is "on".

In that case, these codes are applied to each real or integer (given as such data, to be translated into text due to the number format directives) and each string (given as such data, containing the ordinary computer notation of exponents by "e") are prone.

Note that the first argument starts with an space, to obtain correct spacing.

default-latex-exponent-format <arg1> <arg2>

<arg1> :

code

(default : " \pot{")

<arg2> :

code

(default : "}")

category : table

The first argument contains the Latex code between mantissa and the exponent, the second argument the Latex code after the exponent.

These codes are only applied if the argument of directive "default-exponent-format" is "on".

In that case, these codes are applied to each real or integer (given as such data, to be translated into text due to the number format directives) and each string (given as such data, containing the ordinary computer notation of exponents by "e") are prone.

Note that the default latex code \pot{...} is not defined in standard Latex. It may be defined by: \newcommand{\pot}[1]{\ensuremath{\times}space 10\ensuremath{^{#1}}}. Because of this definition, the first argument starts with an space.

default-number-format <arg1>

<arg1> :

non-empty template

(default : "%g")

category : table

The argument contains a template as used by the sprintf() series of functions to translate a real or integer (given as such data) into text. Data which has been given as text, is not affected by this translation.

The translation is applied to each table cell.

default-vert-sep <arg1>

<arg1> :

"none", "thick", "medium", "thin", "single" or "double"

(default : "none")

category : table

Vertical separator type. Vertical separators may appear between columns and to the left and right sides of the table.

One can choose between vertical rules of different thickness. The thickness of types "thick", "medium" and "thin" can be defined by directives "*-vert-rule".

The types "single" and "double" reflect the vertical rules coded as "|" and "||" in Latex; their thickness is defined by \arrayrulewidth (0.4 pt at default) in Latex.

default-wrap <arg1>

<arg1> :

"off" or "on"

(default : "on")

category : table

Wrap long lines in each table cell.

hor-align <arg1>

<arg1> :

"left", "right" or "center"

category : cell

Horizontal alignment in the actual cell. The default is defined by directive "default-hor-align".

html-classes <arg1>

<arg1> :

"off" or "on"

(default : "on")

category : table

If set to "on", html classes are used to define rules and alignment in cells. These classes are defined within the <style> element within the <head> element in the html file.

If set to "off", rules and alignment are defined directly by style attributes in each table cell. It is recommended to say "html-classes off" in nested tables when e.g. rule types in the nested table have a different thickness, because html class names are "global" names and are not different for individual tables.

html-style <arg1>

<arg1> :

non-empty code

(default : "")

category : cell

Extra html/css style code for the actual cell. This code is appended to the end of the series of style codes within the style attribute of the <td> element. With the extra code one can thus overrule any prior html/css class or style in the actual cell.

html-table-width <arg1>

<arg1> :

non-empty code

(default : "100%")

category : table

Table width in html code.

At default, the table width in html is set to 100 %: the table will thus take the whole width of the containing html element. This is probably practical for most cases, especially for tables nested in a table. Say "html-table-width auto", so that the table width will depend on the width of the contents.

latex-style <arg1>

<arg1> :

non-empty code

(default : "")

category : cell

Extra Latex code for the actual cell. The code is inserted just around the contents. The code should therefore contain a special tag which is a placeholder of the cell contents; at default, the tag is: <contents>.

latex-table-environment <arg1>

<arg1> :

"longtable" or "tabular"

(default : "longtable")

category : table

Name of the environment by which the table is laid-out in Latex: \begin{env-name}...\end{env-name}.

latex-table-width <arg1>

<arg1> :

non-empty code

(default : "\linewidth")

category : table

Table width in Latex code.

medium-vert-rule <arg1> <arg2> <arg3>

<arg1> :

number

(default : "0.3")

<arg2> :

unit "ex", "em", "mm" or "pt"

(default : "ex")

<arg3> :

non-empty code

(default : "black")

category : table

Thickness (and colour code) of vertical rules of type "medium".

The colour is only applied in html; the colour code must be recognised in html/css.

mid-hor-rule <arg1> <arg2> <arg3>

<arg1> :

number

(default : "0.3")

<arg2> :

unit "ex", "em", "mm" or "pt"

(default : "ex")

<arg3> :

non-empty code

(default : "black")

category : table

Thickness (and colour code) of horizontal rules of type "mid".

This type is translated into \midrule[thickness] in Latex and this Latex code is defined by the booktabs package.

The colour is only applied in html; the colour code must be recognised in html/css.

nested-table

category : cell

The data in the actual cell contains a nested table.

This directive is given, if the nested table is given as a cell array ctbl.

number-format <arg1>

<arg1> :

non-empty template

(default : "%g")

category : cell

The argument contains a template as used by the sprintf() series of functions to translate a real or integer (given as such data) into text. Data which has been given as text, is not affected by this translation.

The translation is applied to the actual cell.

row-bottom-sep <arg1>

<arg1> :

"none", "top", "mid", "span", "bottom", "single" or "double"

category : row

Row separator type below the actual row. The default is defined by directive "default-hor-sep".

row-hor-align <arg1>

<arg1> :

"left", "right" or "center"

category : row

Horizontal alignment in the cells of the actual row. The default is defined by directive "default-hor-align".

row-number-format <arg1>

<arg1> :

non-empty template

(default : "%g")

category : row

The argument contains a template as used by the sprintf() series of functions to translate a real or integer (given as such data) into text. Data which has been given as text, is not affected by this translation.

The translation is applied to the cells in the actual row.

row-top-sep <arg1>

<arg1> :

"none", "top", "mid", "span", "bottom", "single" or "double"

category : row

Row separator type above the actual row. The default is defined by directive "default-hor-sep".

This directive will overrule the possibly issued directive "row-bottom-sep" on the previous row, because collapse of separators is applied.

span-hor-rule <arg1> <arg2> <arg3>

<arg1> :

number

(default : "0.15")

<arg2> :

unit "ex", "em", "mm" or "pt"

(default : "ex")

<arg3> :

non-empty string

(default : "black")

category : table

Thickness (and colour code) of horizontal rules of type "span".

This type is translated into \cmidrule[thickness] in Latex and this Latex code is defined by the booktabs package.

The colour is only applied in html; the colour code must be recognised in html/css.

thick-vert-rule <arg1> <arg2> <arg3>

<arg1> :

number

(default : "0.6")

<arg2> :

unit "ex", "em", "mm" or "pt"

(default : "ex")

<arg3> :

non-empty code

(default : "black")

category : table

Thickness (and colour code) of vertical rules of type "thick".

The colour is only applied in html; the colour code must be recognised in html/css.

thin-vert-rule <arg1> <arg2> <arg3>

<arg1> :

number

(default : "0.15")

<arg2> :

unit "ex", "em", "mm" or "pt"

(default : "ex")

<arg3> :

non-empty code

(default : "black")

category : table

Thickness (and colour code) of vertical rules of type "thin".

The colour is only applied in html; the colour code must be recognised in html/css.

top-hor-rule <arg1> <arg2> <arg3>

<arg1> :

number

(default : "0.6")

<arg2> :

unit "ex", "em", "mm" or "pt"

(default : "ex")

<arg3> :

non-empty code

(default : "black")

category : table

Thickness (and colour code) of horizontal rules of type "top".

This type is translated into \toprule[thickness] in Latex and this Latex code is defined by the booktabs package.

The colour is only applied in html; the colour code must be recognised in html/css.

top-sep <arg1>

<arg1> :

"none", "top", "mid", "span", "bottom", "single" or "double"

category : cell

Row separator type above the actual cell. The default is defined by directive "default-hor-sep".

This directive will overrule the possibly issued directive "bottom-sep" on the previous row, because collapse of separators is applied.

Calling sequence of the functions of the htab() series:

• htab() calls:
  • htab_init()
  • htab_input2interm(), which calls:
    • htab_string2interm(), which calls:
      • findtags()
      • muc_linecolumn()
      • htab_style_allocate()
      • htab_style_string2struct()
      • htab_string2interm() (thus, calls itself recursively)
    • htab_struct2interm(), which calls:
      • htab_style_string2struct()
      • htab_style_allocate()
      • htab_input2interm() (thus, a recursive call)
  • htab_interm2final(), which calls:
    • fieldvaluecascade()
    • findconsec()
    • nudiv(), nurepl(), nustring(), nustruct(), nusum()
    • valu2json(), tagexponent()
    • htab_interm2final() (thus, calls itself recursively)