Tables¶

For table rendering, we use htmltabs (link to repository) developed by Patrick Schulz rather than other table packages known from TeX.

Include htmltabs¶

Add this line to the preamble

\usepackage{htmltabs}

Table Markup¶

Mapping XHTML -> LaTeX¶

The htmltabs markup reflects the structure of a HTML table.

XML	TeX	Description
<table>…</table>	\begin{htmltab}[…] … \end{htmltab}
<col />	\HTcol[…]	vor thead
<colgroup>…</colgroup>	\HTcolgroup[…]{…}	before thead
<thead>…</thead>	\begin{thead}[…] … \end{thead}	after tbody
<tfoot>…</tfoot>	\begin{tfoot}[…] … \end{tfoot}	after tbody, before thead
<tbody>…</tbody>	\begin{tbody}[…] … \end{tbody}
<tr>…</tr>	\HTtr[…]{…}
<td>…</td>	\HTtd[…]{…}
<th>…</th>	\HTth[…]{…}

It is important that the grid is kept: for x columns and y rows (taking into account colspan and rowspan) there must be x × y cells.

Attributes and CSS Properties¶

The following "attributes" can be included in the optional argument (if empty, omit) of all "elements":

• style={} contains CSS property-value pairs, syntax within the curly braces is as in XML, e.g.

\HTtd[style={<CSS-Eigenschaft-1>:<CSS-Wert-1>; <CSS-Eigenschaft-2>: <CSS-Wert-2>; … }]{<Inhalt>}

The CSS properties in the HTML can be transferred directly to TeX. The same applies to the environments:

\begin{htmltab}[style={<CSS-Eigenschaft-1>:<CSS-Wert-1>; <CSS-Eigenschaft-2>: <CSS-Wert-2>; … }]
  …

Currently implemented CSS properties:

• margin, with or without -top, -left, -right, -bottom: length
• padding, with or without -top, -left, -right, -bottom: length
• border, with or without -top, -left, -right, -bottom; with or without -width, -style, -color
  • if -width/-style/-color and -top/-left/-right/-bottom is omitted:
    • one value: style
    • two values: width style
    • three values: width style color. Applies to all sides of the element.
• border-style: solid, dashed, dotted, none, double
• border-color: TeX color name (needs to be defined first with \definecolor{<name>}{<color-space>}{<color-declaration>}) or hex value \#rrggbb
• border-width: length
  If there is no side with -top/-left/-right/-bottom given, several values are possible:
  • if there is one value it applies to all sides
  • two values: top/bottom and left/right
  • three values: top and left/right and bottom
  • four values: top and right and bottom and left
• border-collapse: none, collapse
• vertical-align: top, middle, bottom
• background-color: Hintergrundfarbe. TeX color name or hex value \#rrggbb
• color: text color. TeX color name or hex value \#rrggbb
• font-size: font size. xx-small, x-small, small, normal, large, x-large, xx-large
• font-weight: font weight. bold, normal
• font-family: font family. use values for generic font-families, e.g. sans-serif, serif, monospace
• font-style: font style: normal, italic
• font-variant: font variant: normal, small-caps
• text-align: right, center, left, justified
• hyphen: none (no hyphenation), auto (TeX-hyphenation)

• class=<name> corresponds to the class attribute in HTML.
• the \HTcol-Element can yield a width attribute with a given column width, e.g.
  

  \col[width=20mm,style={text-align: center}]
  \col[width=0.2,style={text-align:justified,hyphen=auto}]

  
  The first column would have a fixed width of 20mm, the second a relative width of 20% of the width of the entire table.
  The first column is centered, the second is justified with activated hyphenation. Permissible values for column widths are:
  • Length (number and measurement unit) for fixed with columns,
  • Number <= 1 for relative width (0.5 is half of the table width)
  • Number > 1 Anteile auf Gesamtsumme bezogen, e.g. three columns with width=20, width=10 and width=30 mean, that the first is one third of the total width (20/60), the secnd is a sixth (10/60) and the third is a half (30/60) of the total width.
• Htmltab can also have width, this would then correspond to the total width of the table. If this information is missing, the table is set in its original width, but at most the width of the type area (more precisely: \linewidth).
• \HTtd and \HTth may contain rowspan and colspan-attributes. They should include an integer.
  

  \HTtd[rowspan=2,colspan=2,style={vertical-align: middle; text-align: center}]{<content>}

  
  This cell would be stretched over two columns and two rows, its contents would be centered vertically and horizontally.

Example:¶

\begin{htmltab}[class=box]
  \begin{thead}
    \HTtr[style={text-align: center}]{%
       \HTtd[style={text-align: center; vertical-align: bottom}]{<Table head column 1>}
       \HTtd{<Table head column 2>}
       \HTtd{<Table head column 3>}
    }
  \end{thead}
  \begin{tfoot}
    \HTtr[colspan=3]{%
       \HTtd{<Table foot column 1–3>}
    }
  \end{tfoot}
  \begin{tbody}
    \HTtr{%
       \HTtd[rowspan=2]{<Table body row  1-2 column 1>}
       \HTtd{<Table body row   1 column 2>}
       \HTtd{<Table body row  1 column 3>}
    }
    \HTtr{%
       \HTtd{<Table body row  2 column 2>}
       \HTtd{<Table body row  2 column 3>}
    }
    \HTtr{%
       \HTtd{<Table body row  3 column 1>}
       \HTtd{<Table body row  3 column 2>}
       \HTtd{<Table body row  3 column 3>}
    }
  \end{tbody}
\end{htmltab}

Overridable properties and baretabular class¶

• Certain CSS properties are not transferred to TeX by default, as these could possibly overwrite the publisher's specifications for table layouts:
  **width on all elements that are not <col>, <colgroup>, or <table>
  • further properties can be configured in the publisher style (e.g. background-color in <thead>, padding-* an td, etc.)
• the baretabular-Klasse is a special case: If <table> has this class, all CSS properties are effective

Caption, Source and Floating¶

htmltabs alleine entspricht den tabular-Umgebungen in Standard-LaTeX.

Die Auszeichnung von Caption, Zähler, Quelle und Legende entspricht tpFigure:

\begin{tpTable}[<Floatpos>]
  \tpCaption{<Caption>}
  \tpSource{<Quelle>}
  \tpLegend{<Legende>}
  \tpNumber{<Zähler>}
  \begin{htmltab}
    …
  \end{htmltab}
\end{tpTable}

• <Floatpos> ist die Gleitposition (t,p,h,b; vgl. tpFigure); fehlt das optionale Argument, wird die Tabelle nicht-gleitend und dort platziert, wo sie im Quelltext steht.
• Die Tabelle kann nur umbrechen, wenn sie nicht gleitet!, d.h. wenn die tpTable-Umgebung komplett fehlt; oder wenn tpTable da ist, aber kein optionales Argument hat.

Gedrehte Tabellen¶

Auszeichnung in Word¶

Damit eine Tabelle um 90 Grad gedreht wird, muss entweder in Word die Textrichtung der ersten Zelle gedreht werden oder vor der Tabelle ein leerer Absatz mit dem Absatzformat table_rotated stehen.

Auszeichnung in LaTeX¶

Im TeX wird das ganze mit dem Attribut orientation="landscape" im optionalen Argument der Gleitungebung gekennzeichnet, z.B.

\begin{tpTable*}[orientation="landscape"]
…
\end{tpTable*}

Die Angabe von float-pos wird dabei immer mit "p" überschrieben, demnach kann (und sollte) das Attribut bei gedrehten Tabellen entfallen. Dasselbe funktioniert genau so auch mit Bildern.

Tabellen auf mehrere Seiten umbrechen¶

Um Tabellen auf mehrere Seiten (mit sich wiederholendem Tabellenkopf zu umbrechen, muss der Tabelle ein leerer Absatz mit dem Absatzformat table_pagewrap vorangestellt werden.