Projekt

Allgemein

Profil

Tabellen » Historie » Revision 2

Revision 1 (Patrick Schulz, 29.01.2021 12:23) → Revision 2/29 (Maren Pufe, 12.02.2021 13:58)

h1. Tabellen 

 In der preample angeben: 
 \usepackage{htmltabs} 

 


 h2. Auszeichnung von Tabellen mit Lupinos htmltabs-Renderer ("Repo im firmeninternen GitLab":https://gitlab.le-tex.de/htmltabs/htmltabs/-/tree/master/releases) 

 h3. Mapping xhtml -> LaTeX 

 html-Strukturen werden im Grunde 1:1 abgebildet:  
 |_. XML |_. LaTeX |_. Anmerkungen | 
 |<table>…</table>|\begin{htmltab}[…] … \end{htmltab}| | 
 |<col />|\HTcol[…]| vor thead | 
 |<colgroup>…</colgroup>|\HTcolgroup[…]{…}| vor thead | 
 |<thead>…</thead>|\begin{thead}[…] … \end{thead}| vor tbody!| 
 |<tfoot>…</tfoot>|\begin{tfoot}[…] … \end{tfoot}| vor tbody, nach thead! | 
 |<tbody>…</tbody>|\begin{tbody}[…] … \end{tbody}| | 
 |<tr>…</tr>|\HTtr[…]{…}| | 
 |<td>…</td>|\HTtd[…]{…}| | 
 |<th>…</th>|\HTth[…]{…}| | 

 Wichtig ist, dass das Raster eingehalten wird: bei x Spalten und y Zeilen müssen    (unter Berücksichtigung von colspan und rowspan) x×y Zellen existieren. 

 h3. Attribute und CSS-Eigenschaften 

 Im optionalen Argument (wenn leer, weglassen) aller "Elemente" können folgende "Attribute" stehen: 
 * @style={}@ beinhaltet CSS-Eigenschafts-Werte-Paare, Syntax innerhalb der geschweiften Klammer ist wie in XML, z.B.  
  <pre><code class="text">\HTtd[style={<CSS-Eigenschaft-1>:<CSS-Wert-1>; <CSS-Eigenschaft-2>: <CSS-Wert-2>; … }]{<Inhalt>}</code></pre> 
  Hier kann das CSS aus dem XML eigentlich direkt durchgeschleift werden. 
  Analog bei den Umgebungen:  
  <pre><code class="text">\begin{htmltab}[style={<CSS-Eigenschaft-1>:<CSS-Wert-1>; <CSS-Eigenschaft-2>: <CSS-Wert-2>; … }] 
   …</code></pre> 
 Bisher implementierte CSS-Eigenschaften: 
 ** @margin@, jeweils mit und ohne @-top@, @-left@, @-right@, @-bottom@: Längenangabe 
 ** @padding@, jeweils mit und ohne @-top@, @-left@, @-right@, @-bottom@: Längenangabe 
 ** @border@, jeweils mit und ohne @-top@, @-left@, @-right@, @-bottom@; jeweils mit oder ohne @-width@, @-style@, @-color@ 
 *** Wenn -width/-style/-color *und* Richtungsangabe weggelassen werden: 1 Wert: style; 2 Werte: width style; 3 Werte: width style color. Für alle Richtungen. 
 ** @border-style@: @solid@, @dashed@, @dotted@, @none@ 
 ** @border-color@: Farbname oder @\#rrggbb@ 
 ** @border-width@: Längenangabe 
 Bei Angaben ohne Richtung sind mehrere Werte möglich: bei 1 Wert: alle Richtungen; 2 Werte: top/bottom und links/rechts; 3 Werte: top links/rechts bottom; 4 Werte: top rechts bottom links  
 ** @border-collapse@: @none@, @collapse@ 
 ** @vertical-align@: @top@, @middle@, @bottom@ 
 ** @text-align@: @right@, @center@, @left@, @justified@ 
 ** @hyphen@: @none@ (keine Silbentrennung), @auto@ (TeX-Silbentrennung) 
 * @class=<name>@ entspricht dem class-Attribut bei XML/html. 
 * das @\HTcol@-Element kann ein @width@-Attribut mit der vorgegebenen Spaltenbreite erhalten, z.B.  
   <pre><code class="text">\col[width=20mm,style={text-align: center}] 
 \col[width=0.2,style={text-align:justified,hyphen=auto}]</code></pre> 
   Die erste Spalte würde demnach eine fixe Breite von 20mm bekommen, die zweite eine relative Breite von 20% der Breite der gesamten Tabelle. 
   Die erste Spalte ist zentriert, die zweite erhält Blocksatz mit aktivierter Silbentrennung. 
  Zulässige Werte für Spaltenbreiten sind:  
 ** Längen (also Zahl+Einheit) für Spalten fixer Breite,  
 ** Zahlen <= 1    für Breiten relativ zur Gesamtbreite der Tabelle (0.5 entspräche halbe Gesamtbreite; 0.2 ein Fünftel der Gesamtbreite, etc.) 
 ** Zahlen > 1     werden zusammen addiert und die Spalten entsprechend ihrem Anteil an der Summe gestreckt. Z.B. drei Spalten mit @width=20@, @width=10@ und @width=30@ bedeutet, dass die erste ein Drittel der Gesamtbreite einnimmt (20/60), die zweite ein sechstel (10/60) und die dritte die restliche hälfte (30/60) 
 * Auch @htmltab@ kann @width@ haben, dies entspräche dann der Gesamtbreite der Tabelle. Fehlt die Angabe, wird die Tabelle in ihrer _natürlichen Breite_ gesetzt, höchstens aber Satzspiegelbreite (genauer: @\linewidth@). 
 * @\HTtd@ und @\HTth@ können überdies @rowspan@ und @colspan@-Attribute enthalten, die eine ganze Zahl als Wert bekommen, z.B. 
 <pre><code class="text">\HTtd[rowspan=2,colspan=2,style={vertical-align: middle; text-align: center}]{<content>}</code></pre> 
   Diese Zelle würde über zwei Spalten *und* zwei Zeilen gestreckt, ihr Inhalt wird vertikal und horizontal zentriert. 

 h3. Beispiel: 

 <pre><code class="text"> 
 \begin{htmltab}[class=box] 
   \begin{thead} 
     \HTtr[style={text-align: center}]{% 
        \HTtd[style={text-align: center; vertical-align: bottom}]{<Inhalt Kopf Spalte 1>} 
        \HTtd{<Inhalt Kopf Spalte 2>} 
        \HTtd{<Inhalt Kopf Spalte 3>} 
     } 
   \end{thead} 
   \begin{tfoot} 
     \HTtr[colspan=3]{% 
        \HTtd{<Inhalt Fuss Spalten 1–3>} 
     } 
   \end{tfoot} 
   \begin{tbody} 
     \HTtr{% 
        \HTtd[rowspan=2]{<Inhalt Zeile 1-2 Spalte 1>} 
        \HTtd{<Inhalt Zeile 1 Spalte 2>} 
        \HTtd{<Inhalt Zeile 1 Spalte 3>} 
     } 
     \HTtr{% 
        \HTtd{<Inhalt Zeile 2 Spalte 2>} 
        \HTtd{<Inhalt Zeile 2 Spalte 3>} 
     } 
     \HTtr{% 
        \HTtd{<Inhalt Zeile 3 Spalte 1>} 
        \HTtd{<Inhalt Zeile 3 Spalte 2>} 
        \HTtd{<Inhalt Zeile 3 Spalte 3>} 
     } 
   \end{tbody} 
 \end{htmltab} 
 </code></pre>