diagbox Package (v2.2): Making Table Heads with Diagonal Lines

Size: px

Start display at page:

Download "diagbox Package (v2.2): Making Table Heads with Diagonal Lines"

树林
6 years ago
Views:

1 diagbox Package (v2.2) Making Table Heads with Diagonal Lines Leo Liu 2016/12/28 1 Introduction diagbox is a replacement of old slashbox package 1. I write this package simply because that slashbox is not available in TEX Live for licening problems. slashbox has no explicit license information available, but diagbox is under LPPL. diagbox is a modern alternative of slashbox. I changed the user interface to use a key-value syntax, get rid of some restrictions of slashbox, use pict2e to draw diagonal lines. Especially, this package also provides ability to make a box with two diagonal lines in it. ll these can be obtained by a \diagbox command. s a replacement of slashbox, diagbox package also provides compatible macros of slashbox, but the result is a little different. To use diagbox, ε-tex is needed. nd diagbox requires pict2e, keyval, calc, and fp packages. 2 Usage 2.1 asic usage To load the package, just put this in the preamble: \usepackage{diagbox} \diagbox \diagbox is the main command. It can take two arguments, to produce a box with a diagonal line from north west to south east. For example: 1 y Koichi Yasuoka and Toru Sato. vailable on CTN://macros/latex/contrib/slashbox/slashbox.sty 1

2 1 \begin{tabular}{ l ccc } Day Time Mon Tue Wed Morning used used fternoon used used 2 \hline 3 \diagbox{time}{day} & Mon & Tue & Wed \\ 4 \hline 5 Morning & used & used & \\ 6 fternoon & & used & used \\ 7 \hline 8 \end{tabular} \diagbox can also take three arguments, to draw a table head with two diagbox lines. For example, 1 \begin{tabular}{ l ccc } 2 \hline 3 \diagbox{time}{room}{day} & Mon & Tue & Wed \\ 4 \hline 5 Morning & used & used & \\ 6 fternoon & & used & used \\ 7 \hline 8 \end{tabular} Room Day Mon Tue Wed Time Morning used used fternoon used used 2.2 More options \diagbox can take a key-value list as an optional argument to specify the width and height of the box, the direction of the diagonal line, and the trimming margins: width Specify the width of the box explicitly. If it is omitted, diagbox will calculate the width automatically. height Specify the height of the box explicitly. If it is omitted, diagbox will calculate the height automatically. In the argument, one can use \line as a line height. dir Specify the direction of the diagonal line. The value can be NW, NE, SW and SE. Default value is NW. The meaning of the values see below. \diagbox[dir= direction ]{}{} in a table looks: NW or SE SW or NE 2

3 \diagbox[dir= direction ]{}{M}{} in a table looks: M M NW NE SW SE M M innerwidth Specify the width of the inner content box. innerwidth option is useful when specifying column width. For example: \begin{tabular}{ p{2cm} } \hline \diagbox[innerwidth=2cm]{}{} \\ \hline \end{tabular} innerleftsep, innerrightsep Specify the distances between the border of the inner content box and the border of the diagonal box. We have: innerleftsep + innerwidth + innerrightsep = width. For example: \begin{tabular}{ c } \hline \diagbox[innerleftsep=.5cm,innerrightsep=0pt]{}{} \\ \hline \end{tabular} outerleftsep, outerrightsep Specify the distances between the border of the diagonal box and the border of the tabular cell. Usually they are negative values, which satisfy outerleftsep + LEFTtabcolsep = 0 pt, outerrightsep + RIGHTtabcolsep = 0 pt. where LEFTtabcolsep and RIGHTtabcolsep are the distances between verticle lines and the tabular cell content (the diagonal box). For example: \begin{tabular}{ r@{\hspace{20pt}} l } \hline \diagbox[outerrightsep=-20pt]{}{} & C \\ \hline & CC \\ \hline \end{tabular} C CC 3

4 leftsep, rightsep Specify the left and right distances, which are equivalent to: innerleftsep := leftsep, outerleftsep := leftsep, innerrightsep := rightsep, outerrightsep := rightsep. trim Specify the margin to be trimmed. The value can be l, r, and lr, rl. This helps the slash line exceeds the boundary column specifier is used. Note: trim=l has the same effect as leftsep=0pt, and trim=r has the same effect as rightsep=0pt. font Specify the font of the cell. \diagbox[font=\footnotesize\itshape]{small}{italic} linewidth Specify the line width of the diagonal lines. Small Italic linecolor Specify the line color of the diagonal lines. (color or xcolor is needed.) \diagbox[linewidth=2pt,linecolor=blue]{}{} Here is a more complex example to show the usage of the options: 1 c c r@{} } 2 \hline 3 \diagbox[width=5em,trim=l]{time}{day} & Mon & Tue & Wed\\ 4 \hline 5 Morning & used & used & used\\ 6 \hline 7 fternoon & & used & \diagbox[dir=sw,height=2em,trim=r]{}{} \\ 8 \hline 9 \end{tabular} Day Time Mon Tue Wed Morning used used used fternoon used What s more, you can use \\ to break lines in \diagbox. Manual setting of the height of the head may be needed. For example, 1 \begin{tabular}{ c } 2 \hline 3 \diagbox[height=3\line]{line\\heads}{column\\heads} \\ 4

5 4 \hline 5 \end{tabular} line heads column heads 2.3 Compatibility with slashbox \backslashbox \slashbox diagbox package emulates slashbox and also prevents slashbox to be loaded. diagbox package provides \slashbox and \backslashbox which syntax similar to slashbox package. However, the results of the two packages are a little different. These two commands are for compatibility only, it is better to use \diagbox instead for new documents. \backslashbox works as \diagbox, but it takes two optional arguments to specify the width and trim options. \slashbox works as \diagbox[dir=sw], and takes two optional arguments to specify the width and trim options. For example, 1 \begin{tabular}{ c c c } \hline alpha 2 \backslashbox[2cm]{num}{alpha} num 3 & & \\\hline & 1 & 1 \\\hline & 2 & 2 \\\hline 6 \end{tabular} 3 Known issues and TODO Known issues: The result of \slashbox and \backslashbox is different with slashbox package. The algorithms to calculate the width and height are different; and the results of the second optional argument of \slashbox (i.e. trim key in \diagbox) in the two packages are differernt. This is not a bug. slashbox. Usually the width calculated by diagbox is more safe than The cell with \diagbox should be the widest one of the column. Otherwise the slash line cannot exceeds the boundary. For example, 5

6 Very long term 1 \begin{tabular}{ c } \hline 2 \diagbox{}{} \\\hline 3 Very long term \\\hline 4 \end{tabular} This can be solved by setting a wider width option of \diagbox manually. TODO: Improve the document of the source code. The algorithm of \diagbox@triple should be explained in detail. However, the explanations would be only available in Chinese, I m sorry. 6

7 diagbox v2.2 English Version 2016/12/28 4 diagbox slashbox 1 slashbox TEX Live LPPL diagbox slashbox key-value slashbox pict2e slashbox diagbox slashbox diagbox ε-tex pict2e keyval calc fp \usepackage{diagbox} \diagbox \diagbox 1 Koichi Yasuoka Sato Toru CTN://macros/latex/contrib/slashbox/ slashbox.sty 7

8 1 \begin{tabular}{ l ccc } Day Time Mon Tue Wed Morning used used fternoon used used 2 \hline 3 \diagbox{time}{day} & Mon & Tue & Wed \\ 4 \hline 5 Morning & used & used & \\ 6 fternoon & & used & used \\ 7 \hline 8 \end{tabular} \diagbox 1 \begin{tabular}{ l ccc } 2 \hline 3 \diagbox{time}{room}{day} & Mon & Tue & Wed \\ 4 \hline 5 Morning & used & used & \\ 6 fternoon & & used & used \\ 7 \hline 8 \end{tabular} Room Day Mon Tue Wed Time Morning used used fternoon used used 5.2 \diagbox key-value width height dir NW NE SW SE NE SW SE NW NW \diagbox[dir= ]{}{} NW SE SW NE \diagbox[dir= ]{}{M}{} NW M NE M SW M SE M 8

9 innerwidth innerwidth \begin{tabular}{ p{2cm} } \hline \diagbox[innerwidth=2cm]{}{} \\ \hline \end{tabular} innerleftsep, innerrightsep innerleftsep + innerwidth + innerrightsep = width. \begin{tabular}{ c } \hline \diagbox[innerleftsep=.5cm,innerrightsep=0pt]{}{} \\ \hline \end{tabular} outerleftsep, outerrightsep outerleftsep + LEFTtabcolsep = 0 pt, outerrightsep + RIGHTtabcolsep = 0 pt. LEFTtabcolsep RIGHTtabcolsep \begin{tabular}{ r@{\hspace{20pt}} l } \hline \diagbox[outerrightsep=-20pt]{}{} & C \\ \hline & CC \\ \hline \end{tabular} C CC leftsep, rightsep innerleftsep := leftsep, outerleftsep := leftsep, innerrightsep := rightsep, outerrightsep := rightsep. 9

10 trim l, r, lr trim=l leftsep=0pt trim=r rightsep=0pt font \diagbox[font=\footnotesize\itshape]{small}{italic} linewidth linecolor color xcolor \diagbox[linewidth=2pt,linecolor=blue]{}{} Small Italic 1 c c r@{} } 2 \hline 3 \diagbox[width=5em,trim=l]{time}{day} & Mon & Tue & Wed\\ 4 \hline 5 Morning & used & used & used\\ 6 \hline 7 fternoon & & used & \diagbox[dir=sw,height=2em,trim=r]{}{} \\ 8 \hline 9 \end{tabular} Day Time Mon Tue Wed Morning used used used fternoon used \diagbox \\ 1 \begin{tabular}{ c } 2 \hline 3 \diagbox[height=3\line]{line\\heads}{column\\heads} \\ 4 \hline 5 \end{tabular} line heads column heads 10

11 5.3 slashbox \backslashbox \slashbox diagbox slashbox slashbox diagbox slashbox \slashbox \backslashbox \slashbox \backslashbox slashbox \diagbox \backslashbox \diagbox \diagbox width trim \slashbox \diagbox[dir=sw] \diagbox width tirm 1 \begin{tabular}{ c c c } \hline alpha 2 \backslashbox[2cm]{num}{alpha} num 3 & & \\\hline & 1 & 1 \\\hline & 2 & 2 \\\hline 6 \end{tabular} 6 \slashbox \backslashbox slashbox \slashbox \diagbox trim bug diagbox slashbox \diagbox Very long term 1 \begin{tabular}{ c } \hline 2 \diagbox{}{} \\\hline 3 Very long term \\\hline 4 \end{tabular} \diagbox width \diagbox@triple 11

12 7 Implementation / 7.1 key-value 1 \RequirePackage{keyval} pict2e 2 \RequirePackage{pict2e} fp 3 \RequirePackage{fp} 4 \FPmessagesfalse calc 5 \RequirePackage{calc} array 6 \RequirePackage{array} 7.2 \diagbox 7 \newbox\diagbox@boxa 8 \newbox\diagbox@boxb 9 \newbox\diagbox@boxm 10 \newdimen\diagbox@wd 11 \newdimen\diagbox@ht 12 \newdimen\diagbox@insepl 13 \newdimen\diagbox@insepr 14 \newdimen\diagbox@outsepl 15 \newdimen\diagbox@outsepr 16 \def\diagbox@clear{% 17 \diagbox@wd=\z@ 18 \diagbox@ht=\z@ 19 \diagbox@insepl=\tabcolsep 20 \diagbox@insepr=\tabcolsep 21 \diagbox@outsepl=-\tabcolsep 22 \diagbox@outsepr=-\tabcolsep 23 } 7.3 \diagbox 12

13 \PackageWarning{diagbox}% 27 {You should not set width/innerwidth option more than once.}% 28 \fi 29 \line \def\line{\normalbaselineskip}% p{ } innerleftsep + innerwidth + innerrightsep = width. innerwidth 39 \define@key{diagbox}{innerwidth}{% 40 \unless\ifdim\diagbox@wd=\z@ 41 \PackageWarning{diagbox}% 42 {You should not set width/innerwidth option more than once.}% 43 \fi 44 \setlength{\diagbox@wd}{#1+\diagbox@insepl+\diagbox@insepr}} outerleftsep + LEFTtabcolsep = 0 pt, outerrightsep + RIGHTtabcolsep = 0 pt. 45 \define@key{diagbox}{outerleftsep}{% 46 \setlength{\diagbox@outsepl}{#1}} 47 \define@key{diagbox}{outerrightsep}{% 48 \setlength{\diagbox@outsepr}{#1}} innerleftsep := leftsep, outerleftsep := leftsep, innerrightsep := rightsep, outerrightsep := rightsep. 13

14 trim=l leftsep=0pt trim=r rightsep=0pt \ifcsname 58 \setlength{\csname 59 \setlength{\csname 60 \else 61 \PackageError{diagbox}{Unknown trim option `#1'.}{l, r, lr and rl are supported.}% 62 \fi}} \unless\ifcsname 66 \PackageError{diagbox}{Unknown direction `#1'.}{NW, NE, SW, SE are supported.}% \fi} picture 82 14

15 83 84 \begin{picture} \end{picture}} SE \put(0,0) NW SE 94 NE SW NE 100 key-value \begingroup \setkeys{diagbox}{dir=nw,#1}% #2 109 \end{tabular}}% #3 113 \end{tabular}}% \else 15

16 \fi 120 \fi \fi \endgroup} #1 130 \end{tabular}}% #2 134 \end{tabular}}% #3 138 \end{tabular}}} \put(0,0) 150 \put(0,\y) 151 \put(\x,\y) \Line(0,\yym)(\x,0) 154 \Line(\xm,\y)(\x,0)} 16

17 \put(0,\y) 157 \put(\x,\y) 158 \put(\x,0) \Line(0,0)(\xxm,\y) 161 \Line(0,0)(\x,\yym)} \put(0,\y) 164 \put(0,0) 165 \put(\x,0) \Line(0,\ym)(\x,\y) 168 \Line(\xm,0)(\x,\y)} \put(0,0) 171 \put(\x,0) 172 \put(\x,\y) \Line(0,\y)(\xxm,0) 175 \Line(0,\y)(\x,\ym)} key-value \begingroup \setkeys{diagbox}{dir=nw,#1}% \FPneg\bi\yb 189 \FPadd\ci\xb\xm \FPneg\ci\ci 17

18 190 \FPmul\di\xm\yb 191 \FPadd\bj\ya\ym \FPneg\bj\bj 192 \FPneg\cj\xa 193 \FPmul\dj\xa\ym 194 \FPsub\u\dj\di 195 \FPupn{v}{bj ci * bi cj * -}% 196 \FPupn{delta}{bi dj * bj di * - cj ci - * 4 * % 197 v u + copy * % swap root}% 199 \ifdim\diagbox@wd=\z@ 200 \FPupn{x}{2 bj bi - delta v u - + / /}% 201 \diagbox@wd=\x\p@ 202 \else 203 \edef\x{\strip@pt\diagbox@wd}% 204 \fi 205 \ifdim\diagbox@ht=\z@ 206 \FPupn{y}{2 cj ci - delta v u + - / /}% 207 \diagbox@ht=\y\p@ 208 \else 209 \edef\y{\strip@pt\diagbox@ht}% 210 \fi 211 \FPsub\xxm\x\xm 212 \FPsub\yym\y\ym 213 $\vcenter{\hbox{\diagbox@pict}}$% 214 \endgroup} 7.5 \diagbox 215 \newcommand\diagbox[3][]{% 216 \@ifnextchar\bgroup 217 {\diagbox@triple{#1}{#2}{#3}}{\diagbox@double{#1}{#2}{#3}}} slashbox slashbox 218 \expandafter\xdef\csname ver@slashbox.\@pkgextension\endcsname{9999/99/99} \slashbox \slashbox 219 \def\slashbox{% 220 \def\diagbox@slashbox@options{dir=sw,}% 221 \slashbox@} 18

19 \backslashbox \backslashbox 222 \def\backslashbox{% \ifx\relax#1\relax\else \unexpanded{width=#1,}}% 230 \fi \unexpanded{trim=#1,}}% \endinput 8 v1.0 General: v2.0 General: trim trim slashbox \diagbox: \diagbox@double: trim slashbox \diagbox@triplebox: v2.1 General: innerwidth innerleftsep, innerrightsep outerleftsep, outerrightsep height \line width height font linewidth, linecolor leftsep, rightsep v2.2 General: fp nomessages catoptions calc \widthof

20 9 Index / Symbols \@tempskipa , 75 \backslashbox... 5, 11, 222 \bi \bj C \ci \cj \color D \di , 194 \diagbox.... 1, 7, 215, 236 \diagbox@boxa... 7, 90, 96, 106, 115, 116, 122, 127, 141, 149, 156, 163, 170, 182, 183 \diagbox@boxb... 8, 91, 97, 110, 115, 118, 122, 135, 145, 151, 158, 165, 172, 184, 185 \diagbox@boxm , 131, 143, 150, 157, 164, 171, 186, 187 \diagbox@clear 16, 103, 178 \diagbox@dia \diagbox@dir.. 64, 87, 181 \diagbox@dir@ne \diagbox@dir@nw \diagbox@dir@se \diagbox@dir@sw \diagbox@double.. 101, 217 \diagbox@double@pict@ne , 100 \diagbox@double@pict@nw 94 \diagbox@double@pict@se , 94 \diagbox@double@pict@sw \diagbox@font... 80, 81, 107, 111, 128, 132, 136 \diagbox@ht. 11, 18, 33, 85, 91, 93, 96, 99, 121, 122, 205, 207, 209 \diagbox@insepl... 12, 19, 36, 44, 50, 107, 116, 118, 128, 132, 142 \diagbox@insepr... 13, 20, 38, 44, 53, 111, 116, 118, 136, 144, 146 \diagbox@outsepl , 21, 46, 51, 85, 86 \diagbox@outsepr , 22, 48, 54, 85 \diagbox@part. 87, 104, 179 \diagbox@pict. 82, 124, 213 \diagbox@save@line. 31, 34 \diagbox@setlinecolor , 78, 92, 98, 152, 159, 166, 173 \diagbox@slashbox@options , 223, 227, 228, 233, 234, 236 \diagbox@triple.. 176, 217 \diagbox@triple@pict@ne \diagbox@triple@pict@nw \diagbox@triple@pict@se \diagbox@triple@pict@sw \diagbox@triple@setbox@ne \diagbox@triple@setbox@nw , 139, 140 \diagbox@triple@setbox@se , 147 \diagbox@triple@setbox@sw \diagbox@triplebox \diagbox@wd , 17, 25, 29, 40, 44, 85, 91, 93, 97, 99, 114, 116, 118, 199, 201, 203 \dj , 194 E \empty , 81 F \FPmessagesfalse L \line , 32, 34 \linethickness N \normalbaselineskip P \PackageWarning , 41 S \slashbox , 11, 219 \slashbox@.. 221, 224, 225 \slashbox@@ , 232 T \tabcolsep.. 19, 20, 21, 22 U \u X \x , 153, 154, 157, 158, 161, 165, 167, 168, 171, 172, 175, 201, 203, 211 \xa , 192, 193 \xb , 189 \xm , 168, 186, 189, 190, 211 \xxm , 174,

21 Y \y , 151, 154, 156, 157, 160, 163, 167, 168, 172, 174, 175, 207, 209, 212 \ya , 191 \yb , 188, 190 \ym , 175, 187, 191, 193, 212 \yym , 161,

For example: Day Time Mon Tue Wed Morning used used fternoon used used 1 \begin{tabular}{ l ccc } 3 \diagbox{time}{day} & Mon & Tue & Wed \\ 5 Morning

$For example: Day Time Mon Tue Wed Morning used used fternoon used used 1 \begin{tabular}{ l ccc } 3 \diagbox{time}{day} & Mon & Tue & Wed \\ 5 Morning$ diagbox Package (v2.0) 中文版 Making Table Heads with Diagonal Lines Leo Liu leoliu.pku@gmail.com 2011/11/23 1 Introduction diagbox is a replacement of old slashbox package 1. I write this package simply