From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- macros/latex/contrib/ctable/README | 27 + macros/latex/contrib/ctable/ctable.dtx | 1290 +++++++++++++++++++++++++++ macros/latex/contrib/ctable/ctable.ins | 63 ++ macros/latex/contrib/ctable/ctable.pdf | Bin 0 -> 830921 bytes macros/latex/contrib/ctable/doc/01a | 2 + macros/latex/contrib/ctable/doc/01b | 11 + macros/latex/contrib/ctable/doc/02k | 3 + macros/latex/contrib/ctable/doc/02l | 4 + macros/latex/contrib/ctable/doc/02m | 4 + macros/latex/contrib/ctable/doc/03a | 3 + macros/latex/contrib/ctable/doc/03b | 4 + macros/latex/contrib/ctable/doc/04a | 4 + macros/latex/contrib/ctable/doc/04b | 5 + macros/latex/contrib/ctable/doc/05a | 3 + macros/latex/contrib/ctable/doc/05b | 5 + macros/latex/contrib/ctable/doc/05c | 6 + macros/latex/contrib/ctable/doc/06a | 3 + macros/latex/contrib/ctable/doc/06b | 3 + macros/latex/contrib/ctable/doc/07a | 5 + macros/latex/contrib/ctable/doc/07b | 5 + macros/latex/contrib/ctable/doc/08a | 3 + macros/latex/contrib/ctable/doc/08b | 5 + macros/latex/contrib/ctable/doc/09b | 7 + macros/latex/contrib/ctable/doc/10a | 5 + macros/latex/contrib/ctable/doc/10b | 8 + macros/latex/contrib/ctable/doc/12a | 7 + macros/latex/contrib/ctable/doc/12b | 11 + macros/latex/contrib/ctable/doc/13a | 4 + macros/latex/contrib/ctable/doc/13b | 6 + macros/latex/contrib/ctable/doc/13c | 6 + macros/latex/contrib/ctable/doc/14a | 8 + macros/latex/contrib/ctable/doc/doit | 49 + macros/latex/contrib/ctable/doc/lion.png | Bin 0 -> 32381 bytes macros/latex/contrib/ctable/doc/penguin.jpg | Bin 0 -> 2789 bytes macros/latex/contrib/ctable/inst | 152 ++++ 35 files changed, 1721 insertions(+) create mode 100644 macros/latex/contrib/ctable/README create mode 100644 macros/latex/contrib/ctable/ctable.dtx create mode 100644 macros/latex/contrib/ctable/ctable.ins create mode 100644 macros/latex/contrib/ctable/ctable.pdf create mode 100644 macros/latex/contrib/ctable/doc/01a create mode 100644 macros/latex/contrib/ctable/doc/01b create mode 100644 macros/latex/contrib/ctable/doc/02k create mode 100644 macros/latex/contrib/ctable/doc/02l create mode 100644 macros/latex/contrib/ctable/doc/02m create mode 100644 macros/latex/contrib/ctable/doc/03a create mode 100644 macros/latex/contrib/ctable/doc/03b create mode 100644 macros/latex/contrib/ctable/doc/04a create mode 100644 macros/latex/contrib/ctable/doc/04b create mode 100644 macros/latex/contrib/ctable/doc/05a create mode 100644 macros/latex/contrib/ctable/doc/05b create mode 100644 macros/latex/contrib/ctable/doc/05c create mode 100644 macros/latex/contrib/ctable/doc/06a create mode 100644 macros/latex/contrib/ctable/doc/06b create mode 100644 macros/latex/contrib/ctable/doc/07a create mode 100644 macros/latex/contrib/ctable/doc/07b create mode 100644 macros/latex/contrib/ctable/doc/08a create mode 100644 macros/latex/contrib/ctable/doc/08b create mode 100644 macros/latex/contrib/ctable/doc/09b create mode 100644 macros/latex/contrib/ctable/doc/10a create mode 100644 macros/latex/contrib/ctable/doc/10b create mode 100644 macros/latex/contrib/ctable/doc/12a create mode 100644 macros/latex/contrib/ctable/doc/12b create mode 100644 macros/latex/contrib/ctable/doc/13a create mode 100644 macros/latex/contrib/ctable/doc/13b create mode 100644 macros/latex/contrib/ctable/doc/13c create mode 100644 macros/latex/contrib/ctable/doc/14a create mode 100755 macros/latex/contrib/ctable/doc/doit create mode 100644 macros/latex/contrib/ctable/doc/lion.png create mode 100644 macros/latex/contrib/ctable/doc/penguin.jpg create mode 100755 macros/latex/contrib/ctable/inst (limited to 'macros/latex/contrib/ctable') diff --git a/macros/latex/contrib/ctable/README b/macros/latex/contrib/ctable/README new file mode 100644 index 0000000000..b39ffc2289 --- /dev/null +++ b/macros/latex/contrib/ctable/README @@ -0,0 +1,27 @@ +| +-------:|:-------------------------------------- + ctable:| Flexible typesetting of table and figure floats using key/value directives +Version:| 1.31 + Author:| Wybo Dekker + E-mail:| wybo@dekkerdocumenten.nl +License:| Released under the LaTeX Project Public License v1.3c or later + See:| http://www.latex-project.org/lppl.txt + +Short description: +ctable.sty provides commands to easily typeset centered or left or right +aligned tables and (multiple-)figure floats, with footnotes. Instead of an +environment, a command with 4 arguments is used; the first is optional and +is used for key,value pairs generating variations on the defaults and +offering a route for future extensions. + +Full documentation: +https://bitbucket.org/wybodekker/ctable/downloads/ctable.pdf + +Installation: +Execute the inst script with the --help option for more information. + +Changes in version 1.31: + - comments about tmark in captions + - use expandonce from etoolbox + - use \AtBeginDocument, not \AtEndPreamble from etoolbox + (problems with tikz) diff --git a/macros/latex/contrib/ctable/ctable.dtx b/macros/latex/contrib/ctable/ctable.dtx new file mode 100644 index 0000000000..0469db5410 --- /dev/null +++ b/macros/latex/contrib/ctable/ctable.dtx @@ -0,0 +1,1290 @@ +% \iffalse meta-comment +%<*internal> +\iffalse +% +%<*readme> +| +-------:|:-------------------------------------- + ctable:| Flexible typesetting of table and figure floats using key/value directives + Author:| Wybo Dekker + E-mail:| wybo@dekkerdocumenten.nl +License:| Released under the LaTeX Project Public License v1.3c or later + See:| http://www.latex-project.org/lppl.txt + +Short description: +ctable.sty provides commands to easily typeset centered or left or right +aligned tables and (multiple-)figure floats, with footnotes. Instead of an +environment, a command with 4 arguments is used; the first is optional and +is used for key,value pairs generating variations on the defaults and +offering a route for future extensions. + +Full documentation: +https://bitbucket.org/wybodekker/ctable/downloads/ctable.pdf + +Installation: +Execute the inst script with the --help option for more information. + +% +%<*internal> +\fi +% +%<*driver> +\ProvidesFile{ctable.dtx} +% +%\NeedsTeXFormat{LaTeX2e}[1999/12/01] +%\ProvidesPackage{ctable} +%<*package> + [2015/10/17 v1.31 ctable package for flexible typesetting of table and + figure floats using key/value directives] +% +% +%<*driver> +\documentclass{ltxdoc} +\usepackage{ctable,txfonts,paralist,desclist} +\usepackage[l2tabu,orthodox]{nag} +\usepackage[a4paper,margin=20mm,left=50mm,nohead]{geometry} +\usepackage[colorlinks]{hyperref} +\usepackage{tocloft} +\setlength\cftparskip{.5ex} +\setlength\cftbeforesecskip{.5ex} +\setlength\cftaftertoctitleskip{1ex} +\graphicspath{{./doc/}} +\definecolor{vbgreen}{rgb}{0,.6,0} +\definecolor{B}{rgb}{0.77, 0.90, 0.96} +\definecolor{Y}{rgb}{1,1,.878} +\def\REF#1{\href{http://www.ctan.org/pkg/#1}{\texttt{#1}}} +\parindent0pt\parskip1ex +\newcommand{\ROW}[3]{\parskip0pt% + \colorbox{#1}{% + \parbox{.98\hsize}{% + \rule{0pt}{1.5ex}\\% + \parbox{.6\hsize}{\includegraphics{#2}}% + \parbox{.4\hsize}{\centering{\includegraphics{#3}}}% + \\\rule{0pt}{1.5ex}% + }% + }\par% +} +\AtBeginDocument{\RecordChanges} +\AtEndDocument{\PrintChanges} +\CodelineIndex\EnableCrossrefs +\hypersetup{ + pdftitle = The ctable package, + pdfauthor = Wybo Dekker, + pdfsubject = {Typesetting centered, right, and left aligned table and figure + floats, with many configuration options}, + pdfkeywords = { + table floats, + figure floats, + key=value options, + footnotes, + booktabs, + tabularx, + threeparttable + }, + bookmarksopen +} +\begin{document} + \DocInput{ctable.dtx} + \PrintChanges + \PrintIndex +\end{document} +% +% \fi +% +% \CheckSum{0} +% +% \CharacterTable +% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z +% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z +% Digits \0\1\2\3\4\5\6\7\8\9 +% Exclamation \! Double quote \" Hash (number) \# +% Dollar \$ Percent \% Ampersand \& +% Acute accent \' Left paren \( Right paren \) +% Asterisk \* Plus \+ Comma \, +% Minus \- Point \. Solidus \/ +% Colon \: Semicolon \; Less than \< +% Equals \= Greater than \> Question mark \? +% Commercial at \@ Left bracket \[ Backslash \\ +% Right bracket \] Circumflex \^ Underscore \_ +% Grave accent \` Left brace \{ Vertical bar \| +% Right brace \} Tilde \~} +% +% +% \changes{v1.00}{2000/06/01}{ +% first release. +% } +% \changes{v1.01}{2001/03/17}{ +% making use of booktabs package +% } +% \changes{v1.02}{2002/06/24}{ +% using keyval to reduce args to 4 +% } +% \changes{v1.03}{2002/07/16}{ +% many syntactic corrections, thanks to Johannes Braams +% } +% \changes{v1.04}{2003/08/11}{ +% - caption, if empty, will not be typeset\\ +% - rotate option added\\ +% - star option added to use table* and figure*\\ +% - environments +% } +% \changes{v1.06}{2004/03/20}{ +% - left, right and center options added\\ +% - frame{sep,rule,fg,bg} options added\\ +% - error in width-setting corrected +% } +% \changes{v1.05}{2003/10/03}{ +% maxwidth option added +% } +% \changes{v1.06a}{2004/04/01}{ +% - made setting fboxsep and fboxrule only temporary\\ +% - removed superfluous space after tabulars +% } +% \changes{v1.06b}{2004/06/19}{ +% added several % at eol to remove superfluous whitespace occurring +% sometimes +% } +% \changes{v1.07}{2005/08/09}{ +% - added option sideways, option rotate now obsolete\\ +% - added option captionskip +% } +% \changes{v1.08}{2006/04/10}{ +% - standardized file setup following +% http://www.ctan.org/tex-archive/info/dtxtut/dtxtut.pdf\\ +% - mincapwidth option added\\ +% - moved newdimen definition outside ctable macro +% } +% \changes{v1.09}{2007/03/04}{ +% - added option nosuper\\ +% - corrected incorrect positioning when table is wider than mincapwidth +% } +% \changes{v1.10}{2007/08/17}{ +% - footnote markers now stay superscript with nosuper\\ +% - documentation: added many examples for the options\\ +% - corrected some unwanted white space in captions\\ +% - caption package included to correct booktabs errors in caption +% position. And for later use of its facilities\\ +% - *captionskip option redefined*: 0pt value now corresponds to LaTeX +% default +% } +% \changes{v1.11}{2007/09/07}{ +% - added some percent signs at EOL to prevent whitespace\\ +% - removed xspace usage - caused overfull badness +% } +% \changes{v1.12}{2008/04/12}{ +% option notespar added +% } +% \changes{v1.13}{2008/05/01}{ +% - cap option with empty argument will not be inserted in lot/lof\\ +% - added option continued, for continuation tables: same number as +% previous table, `(continued)' added to caption +% } +% \changes{v1.14}{2009/09/15}{ +% - nosuper propagation to later tables prohibited\\ +% - added option doinside\\ +% - use of (obsolete) carom.sty for docs discontinued\\ +% - empty labels not created\\ +% - newcolumntype warnings removed\\ +% - caption package not needed anymore +% } +% \changes{v1.15}{2009/09/17}{ +% - removed whitespace before tables\\ +% - corrected marginpars in the documentation +% } +% \changes{v1.16}{2010/06/26}{ +% - option cap={} did not suppress lot/lof entry\\ +% - notespar option now generates fully justified notes +% } +% \changes{v1.17}{2010/10/30}{ +% - doinside option propagated in subsequent ctable calls +% } +% \changes{v1.18}{2011/04/15}{ +% - added setupctable for option defaults\\ +% - added complement for several options (topcap, nosideways, et cetera) +% } +% \changes{v1.19}{2011/05/01}{ +% - sideways option did not work anymore; corrected +% } +% \changes{v1.20}{2011/08/24}{ +% - added options captionsleft, captionsright, captionsinside; (for +% setupctable only) +% } +% \changes{v1.21}{2011/09/05}{ +% - better documentation for sideways, captionsleft/right/inside options +% } +% \changes{v1.22}{2012/05/25}{ +% - allow empty lines in last (tabular) argument\\ +% - corrected error from hyperref's nameref calls (thanks Marco Daniel!) +% } +% \changes{v1.23}{2012/05/28}{ +% - footerwidth option added +% } +% \changes{v1.24}{2013/04/28}{ +% - require xcolor instead of color\\ +% - added option bgopacity\\ +% - added option sidecap (for memoir only) +% } +% \changes{v1.25}{2013/05/24}{ +% - url's to CTAN corrected +% } +% \changes{v1.26}{2013/06/15}{ +% - footerwidth option was inactive when notespar option was active +% } +% \changes{v1.27}{2013/12/19}{ +% - label option did not work with side caption\\ +% - disable transparency with warning if tikz package loaded +% } +% \changes{v1.28}{2014/02/20}{ +% - added percent characters at EOLs causing whitespace +% } +% \changes{v1.29}{2014/04/20}{ +% - reorganized inst script +% } +% \changes{v1.30}{2015/08/29}{ +% - tikz' transparency got broken when tikz loaded after ctable\\ +% - removed overfull hboxes from documentation +% } +% \changes{v1.31}{2015/10/03}{ +% - comments about tmark in captions\\ +% - use expandonce from etoolbox\\ +% - use \AtBeginDocument, not \AtEndPreamble from etoolbox +% (problems with tikz) +% } +% +% \GetFileInfo{ctable.dtx} +% +% \DoNotIndex{ \newcommand, \\, \,, +% \def, \definecolor, \hbox, \raggedright, +% \else, \ifdim, \sbox, \empty, +% \ifx, \setkeys, \end, \label, +% \specialrule, \fboxrule, \let, \tabularnewline, +% \PackageError, \fboxsep, \newbox, \textit, +% \PackageWarningNoLine, \fcolorbox, \newcolumntype, \usebox, +% \RequirePackage, \fi, \newdimen, \vspace, +% \begin, \footnotesize, \normalfont, \wd, +% \define@key, +% } +% +% \title{The \textsf{ctable} package\thanks{This document +% corresponds to \textsf{ctable}~\fileversion, dated \filedate.}} +% \author{Wybo Dekker \\ \texttt{wybo@dekkerdocumenten.nl}} +% +% \maketitle +% \begin{abstract}\noindent +% The \texttt{ctable} package provides a \texttt{ctable} +% command for the typesetting of table and figure floats. You will +% not need to type the usual nested begin...end sequences, as +% \texttt{ctable} is a command, not an environment. \texttt{ctable} +% has only 4 arguments, but the optional first one may hold many +% \textsl{key=value} pairs and makes \texttt{ctable} very flexible +% and extensible. It uses Simon Fear's \REF{booktabs} package for +% better vertical spacing around horizontal rules and it provides +% facilities for making table footnotes. +% \end{abstract} +% \tableofcontents +% \section{Introduction} +% +% \section{Purpose} The |ctable| package lets you easily typeset +% captioned table and figure floats with optional +% footnotes. Both caption and footnotes will normally be forced within the +% width of the table. +% If the width of the table is specified, then \REF{tabularx} will be used +% to typeset it, and one or more |X| column specifiers should be specified. +% Otherwise tabular will be used. +% +% This package defines the commands |\ctable|, |\tnote| and +% |\tmark|, and four |\tabularnewline| generating +% commands. The latter generate reasonable amounts of whitespace +% around horizontal rules and are also useful for tabulars +% outside this package. +% +% Since the |ctable| package imports the \REF{array} and \REF{booktabs} +% packages, all commands from those packages are available as well. +% +% Note that, in line with the comments that Simon Fear made +% describing his \REF{booktabs} package, vertical rules for column +% separation can be produced with |\ctable|, but no provisions are +% made to have them make contact with horizontal rules. +% +% \section{Usage} +% \DescribeMacro{\setupctable} +% |\ctable| defaults can be set, either in the preamble or in the body, +% with:\\ +% +% |\setupctable{options} % key=value,...|\\ +% +% \DescribeMacro{\ctable} +% |\ctable| is called with 4 parameters, of which the first is optional: \\ +% +% |\ctable[options] % key=value,...|\\ +% | {coldefs} % for \begin{tabular}|\\ +% | {foottable} % zero or more \tnote commands (see below)|\\ +% | {table rows} % rows for the table|\\ +% +% Options are given as key=value pairs, separated by comma's. +% Extra comma's, including one behind the last pair, don't hurt. +% Arguments to option should be put between braces if they contain +% comma's or equals signs. +% \section{Options} +% Currently the following option keys have been defined: +% +% { \marginparwidth25mm +% \DescribeMacro{bgopacity=...\hfill} +% Sets the opacity of the table's background color, where 1 is 100\% opaque +% (the default), and 0 is completely transparent. One application is with +% watermarking: most watermarking packages print their watermark on the +% background. |ctable|'s background color, which is opaque by default, may +% make the watermark (partially) invisible. You can avoid this by setting +% the |bgopacity| option to a value lower than 1. Note that this works only +% in PDF mode, a warning is issued otherwise.\\ +% Note: there are two limitations to transparency setting: +% \begin{compactenum} +% \item it works only in PDF mode: so it works in pdflatex and lualatex, +% but is disabled in xelatex. +% \item it disables transparency features in the tikz package; therefore, +% ctable checks if the tikz package is loaded and if so, disables its own +% transparency with a warning. That helps only if you load tikz +% \textit{before} ctable. +% \end{compactenum} +% +% \DescribeMacro{botcap\hfill} +% put the caption at the bottom of the float instead of on top of it. +% See also: |topcap|, |sidecap|. +% +% \DescribeMacro{caption=...\hfill} +% table caption; the braces are needed only if your caption contains a +% comma or an equals sign. +% +% \DescribeMacro{cap=...\hfill} +% for a short caption to go to the |\listoftables|. Without the |cap| +% option, the full caption will go into the |\listoftables|. If |cap| is +% given an empty value, \textsl{and you have loaded the |caption| package}, +% no entry in the |\listoftables| will be made. This may be useful, for +% example, with the |continued| option. +% +% \DescribeMacro{captionskip=...\hfill} +% moves the caption relative to the table; the default is |0ex|, which puts +% captions at their default \LaTeX\ positions. For the standard \LaTeX\ +% classes this means that a top caption's baseline at +% |1ex| above the top rule position of the table and a bottom caption's +% baseline at |4ex| below the bottom rule position. These dimensions may be +% different for other classes or when other packages are included. The +% |memoir| class and the |caption| package, for example, both typeset +% captions differently, and the combination of both even differs from each +% alone.\footnote{I did some measurements on the whitespace between the +% caption and the top of the table with and without using the caption +% package and/or the memoir class: standard LaTeX: 1ex; memoir: +% 2.32ex; caption: 2.69ex; both memoir and caption: 2.68ex. For the +% distances between bottom caption baselines and the table bottom I found, +% respectively: 3.90ex, 3.41ex, 3.72ex and 3.74ex } Keep in mind that when +% you use the |caption| package in the |memoir| class, |memoir|'s caption +% commands are suspended and |caption|'s commands must be used. +% +% \DescribeMacro{captionsleft\hfill} This option is defined for +% |\setupctable| only, and it is effective only where the |sideways| option +% is used. After |\setupctable{captionsleft}| all tables typeset with the +% |sideways| option will have their captions at the left. +% +% \DescribeMacro{captionsright\hfill} This option is defined for +% |\setupctable| only, and it is effective only where the |sideways| option +% is used. After |\setupctable{captionsright}| all tables typeset with the +% |sideways| option will have their captions at the right. +% +% \DescribeMacro{captionsinside\hfill} +% This option is defined for |\setupctable| only, it is the default, and it is effective +% only where the |sideways| option is used. After +% |\setupctable{captionsinside}| all tables typeset with the |sideways| +% option will have their captions at the left in one-sided documents. In +% twosided documents, captions will be on the left for odd-numbered pages +% and on the right for even-numbered pages. This is the default. +% +% \DescribeMacro{center\hfill} +% center the table in the available text width; this is the default. +% See also: |left|, |right|. +% +% \DescribeMacro{continued=...\hfill} +% if used, the table will be numbered the same as the previous table. If +% used without an argument, the caption will be suffixed with ` +% (continued)', if used with an argument, the suffix will be the argument. +% +% \DescribeMacro{doinside=...\hfill} +% command to be run inside, just before the tabular or tabularx +% environment. You can use this, for example, for the adjustment of the +% font size with |\small|. +% +% \DescribeMacro{figure\hfill} +% produce a figure float instead of a table float. See also: |table|. +% +% \DescribeMacro{footerwidth=...\hfill} +% Footnotes are typeset within the width of the table. When you use the +% |mincapwidth| option, presumably because the table is very narrow, footnotes +% are given the same width as the caption. With small footnotes this may not +% be what you want; this option can be used to give the footnotes their own width. +% Without an argument, they will be typeset within the width of of the table. +% +% \DescribeMacro{framebg={\slshape r g b}\hfill} +% set the background color of the frame (the color inside the frame) to the +% given triplet of \textsl{rgb}-values. The values should be numbers +% between 0 and 1. The default is |1 1 1| (white). +% +% +% \DescribeMacro{framefg={\slshape r g b}\hfill} +% set the foreground color of the frame (the rule color) to the given +% triplet of \textsl{rgb}-values. The values should be numbers between 0 +% and 1. The default is |0 0 0| (black). +% +% +% \DescribeMacro{framerule=...\hfill} +% draw a frame around the table with the given rule thickness. The default +% is |0pt|, so that no frame will be seen. +% +% +% \DescribeMacro{framesep=...\hfill} +% set the distance between the frame and the table to the given dimension. +% The default is |0pt|. +% +% +% \DescribeMacro{label=...\hfill} +% labels the float with |\label|. +% +% \DescribeMacro{left\hfill} +% left align the table in the available text width. See also: |center|, |right|. +% +% \DescribeMacro{maxwidth=...\hfill} +% like the \textsl{width} option, but any |X| column specifiers will be +% replaced with |l| if the resulting table width would thus stay within the +% specified maximum width. This is especially useful where the \LaTeX\ +% source is generated by a script. +% +% \DescribeMacro{mincapwidth=...\hfill} +% sets the minimum width of the float. Without this option, the width is +% set to that of the tabular, and the caption and footnotes are typeset +% within that width. This may be a problem with very narrow tables; +% |mincapwidth| can then be used to give the float a minimum width. The +% tabular will be centered in it. If you don't want the footnotes to be affected +% see the |footerwidth| option. +% +% \DescribeMacro{nonotespar\hfill} +% typeset footnotes in a table; this is the default. See also: |notespar|. +% +% \DescribeMacro{nosideways\hfill} +% undo the sideways option. See also: |sideways|. +% +% \DescribeMacro{nostar\hfill} +% use the un-starred versions of the |table| and |figure| environments; +% this is the default +% +% \DescribeMacro{nosuper\hfill} +% in the footnote table, typeset footnote markers on the line, instead of +% superscripted. +% +% \DescribeMacro{notespar\hfill} +% typeset footnotes in a paragraph instead of in a table. +% +% \DescribeMacro{pos=...\hfill} +% float position, default: |tbp|. +% +% \DescribeMacro{right\hfill} +% right align the table in the available text width. +% +% \DescribeMacro{sidecap\hfill} +% put the caption at the side of the float. Currently, this works only if +% you have loaded the |memoir| class, otherwise an error message is +% generated. The parameters for the caption, such as its vertical +% positioning, width and more, must be set with the appropriate |memoir| +% commands. See also: |botcap|, |topcap|. +% +% \DescribeMacro{sideways\hfill} +% rotate table or figure by 90 degrees anticlockwise and put it on a +% separate page. With the twoside option for the standard \LaTeX\ document +% classes, rotation will be -90 on even pages, unless the options +% |captionleft| or |captionsright| are used. If you use this option, the +% |pos| option is not allowed. See also: |nosideways|, |captionsinside|. +% +% \DescribeMacro{star\hfill} +% use the starred versions of the |table| and |figure| environments, which +% place the float over two columns when the |twocolumn| option or the +% |\twocolumn| command is active. See also: |nostar|. +% +% \DescribeMacro{super\hfill} +% in the footnote table, typeset footnote markers as superscripts; this is +% the default. See also: |nosuper|. +% +% \DescribeMacro{table\hfill} +% produce a table float (this is the default). See also: |figure|. +% +% \DescribeMacro{topcap\hfill} +% put the caption top of the float; this is the default. See also: |botcap|, |sidecap|. +% +% \DescribeMacro{width=...\hfill} +% \REF{tabularx} will be used to typeset the table at the specified +% width\,---\,one or more |X| column specifiers must be provided. +% +% } +% +% \section{The width and maxwidth options} +% When \LaTeX-sources containing tables are generated automatically by a +% script, it is often not known in advance what the maximum size of an +% |l|~column will be. A good solution for this is to use an |X|~specifier, +% typesetting the table at the text width with the \REF{tabularx} package. +% However, this will result in too much white space in cases where the +% column contains small texts only. This problem can be solved by using +% the maxwidth option instead of the width option. The |X|~specifiers will +% then be replaced with |l| as long as the width of the resulting table +% stays with the specified maximum width. +% +% \section{Tables wider than the text width} +% When you make a table wider than |\textwidth|, it will extend in the right margin. +% If it is a large table, occupying a whole page, you can use the geometry package +% and surround your ctable call with |\newgeometry{width=...,margin=...}| and |\restoregeometry|. +% However, both geometry commands imply |\clearpage|, so your table will appear on an otherwise +% empty page. +% +% Alternatively, you can center the table on the paper, extending in both margins, by using the +% option |doinside=\hspace*{}| with an appropriate negative |dimen>|. +% +% \section{Setting option defaults: setupctable} +% Every call of |\ctable| resets the options to their defaults before evaluating the +% first (optional) argument. So if you make two ctables: |\ctable[left,...| and +% |\ctable[...|, the first will be left-aligned on the page, but the second, lacking +% the |left| option, will be centered, because that is the default. If you want all +% your tables left-aligned, it's more practical to change the default by calling +% \DescribeMacro{\setupctable} +% |\setupctable{left}|, either in the preamble or somewhere in the body. In latter +% case only tables following the call will have their defaults changed. \par +% |\setupctable| can set the defaults for all options except (of course) |caption|, +% |cap|, and |label|. Actually, the initial option defaults are set by +% calling |\setupctable| as follows: +% \begin{verbatim} +% \setupctable{ +% captionskip=0pt, framerule=0pt, nostar, +% center, framesep=0pt, pos=tbp, +% continued=(continued), maxwidth=0pt, super, +% doinside={}, mincapwidth=0pt, table, +% framebg=1 1 1, nonotespar, topcap, +% framefg=0 0 0, nosideways, width=0pt +% } +% \end{verbatim} +% \section{Other commands} +% \DescribeMacro{\tnote} +% |\tnote[label]{footnote text}| places {\footnotesize +% \textsuperscript{\normalfont\textit{label}}\,footnote text} +% under the table. +% This command can only be used in |\ctable|'s third argument, i.e.\ the foottable +% argument described above. The +% label is optional, the default label is a single $a$. For more +% detailed control, you can also replace this command with something +% like |labeltext&footnotetext\NN|. +% The footnotes are placed under the table, without a rule. +% You therefore probably will want to use the |\LL| (last line) +% command if you use footnotes. +% \par +% \DescribeMacro{\tmark} +% |\tmark[label]| this command places the superscripted label in the +% table. It is equivalent with |$^{label}$|. +% The label is optional, the default label is a single $a$. +% |\tmark| may be used in captions, but only \textit{without} an argument. +% \par +% The newline generating commands are a combination of +% |\tabularnewline| and zero or one of \REF{booktabs} |\toprule|, +% |\midrule| or |\bottomrule|. These combinations have been made, and +% short names have been defined, because source texts for complex +% tables often become very crowded: +% \par +% \DescribeMacro{\NN} Normal Newline, generates just a normal new line. +% An optional dimen parameter inserts extra vertical space under the +% line. Is an alias for |\tabularnewline| +% \par +% \DescribeMacro{\FL} First Line, generates a new line and a thick +% rule with some extra space under it. +% An optional dimen parameter sets the line width; the default is 0.08em. +% Is an alias for |\toprule| +% \par +% \DescribeMacro{\ML} Middle Line: generates a new line and a thin +% rule with some extra space over and under it. +% An optional dimen parameter sets the line width; the default is 0.05em. +% Is an alias for |\tabularnewline\midrule| +% \par +% \DescribeMacro{\LL} Last Line: generates a new line and a thick +% rule with some extra space over it. +% An optional dimen parameter sets the line width; the default is 0.08em. +% Is an alias for |\tabularnewline\bottomrule| +% \par +% These macros can be used outside |\ctable| constructs. +% \par +% Finally, for completeness, here are some of \REF{booktabs}' commands +% that may be useful: +% \par +% \DescribeMacro{\toprule} |\toprule[]| +% where || is the optional thinkness of the rule. +% \par +% \DescribeMacro{\midrule} |\midrule[]|. +% \par +% \DescribeMacro{\bottomrule} |\bottomrule[]|. +% \par +% \DescribeMacro{\cmidrule} |\cmidrule[](){a-b}| +% where || can be |r|, |l|, or |rl| +% and the rule is drawn over columns |a| through |b|. +% \par +% \DescribeMacro{\morecmidrules} |\morecmidrules| +% must be used to separate two successive cmidrules. +% \par +% \DescribeMacro{\addlinespace} |\addlinespace[]| +% inserts extra space between rows. +% \par +% \DescribeMacro{\specialrule} +% |\specialrule{}{}{}|. +% \par +% See the \REF{booktabs} documentation for details. +% \newpage +% \section{Examples} +% Table~\ref{nowidth} is an example taken from the related package +% \REF{threeparttable} by Donald Arseneau, with an extra footnote. +% It was typeset with: +% \color{vbgreen} +% \begin{verbatim} +% \ctable[ +% cap = The Skewing Angles, +% caption = The Skewing Angles ($\beta$) for +% $\fam0 Mu(H)+X_2$ and $\fam0 Mu(H)+HX$~\tmark, +% label = nowidth, +% pos = h +% ]{rlcc}{ +% \tnote{for the abstraction reaction, +% $\fam0 Mu+HX \rightarrow MuH+X$.} +% \tnote[b]{1 degree${} = \pi/180$ radians.} +% \tnote[c]{this is a particularly long note, showing that +% footnotes are set in raggedright mode as we don't like +% hyphenation in table footnotes.} +% }{ \FL +% & & $\fam0 H(Mu)+F_2$ & $\fam0 H(Mu)+Cl_2$ \ML +% &$\beta$(H) & $80.9^\circ$\tmark[b] & $83.2^\circ$ \NN +% &$\beta$(Mu) & $86.7^\circ$ & $87.7^\circ$ \LL +% } +% \end{verbatim} +% \color{black} +% \ctable[ +% cap = The Skewing Angles, +% caption = The Skewing Angles ($\beta$) for +% $\fam0 Mu(H)+X_2$ and $\fam0 Mu(H)+HX$~\tmark, +% label = nowidth, +% pos = h +% ]{rlcc}{ +% \tnote{for the abstraction reaction, +% $\fam0 Mu+HX \rightarrow MuH+X$.} +% \tnote[b]{1 degree${} = \pi/180$ radians.} +% \tnote[c]{this is a particularly long note, showing that +% footnotes are set in raggedright mode as we don't like +% hyphenation in table footnotes.} +% }{ \FL +% & & $\fam0 H(Mu)+F_2$ & $\fam0 H(Mu)+Cl_2$ \ML +% &$\beta$(H) & $80.9^\circ$\tmark[b] & $83.2^\circ$ \NN +% &$\beta$(Mu) & $86.7^\circ$ & $87.7^\circ$ \LL +% } +% Table~\ref{width} is an example with a width specification, +% taken from the \REF{tabularx} documentation, with the vertical rules +% removed. +% By using the trimming parameters of the \REF{booktabs} |\cmidrule| +% command, some of the horizontal splitting was regained. +% The |left| option left aligns the table. It was typeset with: +% \color{vbgreen} +% \begin{verbatim} +% \ctable[ +% caption = Example with a specified width of 100mm, +% label = width, +% width = 100mm, +% pos = ht, +% left +% ]{c>{\raggedright}Xc>{\raggedright}X}{ +% \tnote{footnotes are placed under the table} +% }{ \FL +% \multicolumn{4}{c}{Example using tabularx} \ML +% \multicolumn{2}{c}{Multicolumn entry!} & THREE & FOUR \NN +% \cmidrule(r){1-2}\cmidrule(rl){3-3}\cmidrule(l){4-4} +% one& +% The width of this column depends on the width of the table.\tmark & +% three& +% Column four will act in the same way as column two, with the same width.\LL +% } +% \end{verbatim} +% \color{black} +% \ctable[ +% caption = Example with a specified width of 100mm, +% label = width, +% width = 100mm, +% pos = ht, +% left +% ]{c>{\raggedright}Xc>{\raggedright}X}{ +% \tnote{footnotes are placed under the table} +% }{ \FL +% \multicolumn{4}{c}{Example using tabularx} \ML +% \multicolumn{2}{c}{Multicolumn entry!} & THREE & FOUR \NN +% \cmidrule(r){1-2}\cmidrule(rl){3-3}\cmidrule(l){4-4} +% one& +% The width of this column depends on the width of the +% table.\tmark & +% three& +% Column four will act in the same way as +% column two, with the same width. \LL +% } +% +% Figures, even single ones, are always put in tabular cells. This is not +% particularly handy for single pictures, but it eases the construction of +% arrays of pictures, including sub-captions, delineation, and spacing. For a +% small example, which also shows how you can simplify the construction of +% figure arrays, see subsection~\ref{figureexample} on +% page~\pageref{figureexample}. +% +% \section{Option examples} +% In the following, small examples will be shown illustrating the effect of +% options. In the left column the relevant part of the source is shown, in the +% right column you see the result. In most cases you see a standard example on a +% light yellow background, followed by one or more variations on a light blue +% background. Where necessary, the example will show boxes to indicate the page +% and the text body. +% +% \subsection{\ttfamily\bfseries center, left, right} +% These options align the float in the page; the default is |center|: +% \medskip\\ +% \ROW{Y}{s02k}{02k} +% \ROW{B}{s02l}{02l} +% \ROW{B}{s02m}{02m} +% +% \subsection{\ttfamily\bfseries super, nosuper} +% Footnote markers in |ctable| are typeset superscripted by default. Use the +% |nosuper| option to place them on the base line: +% \medskip\\ +% \ROW{Y}{s07a}{07a} +% \ROW{B}{s07b}{07b} +% +% \subsection{\ttfamily\bfseries notespar, nonotespar} +% By default, footnotes in |ctable| are typeset in a table, one line per note. +% This corresponds with the |nonotespar| option.You can also typeset them in a paragraph, +% one after the other, by using the |notespar| option: +% \medskip\\ +% \ROW{Y}{s12a}{12a} +% \ROW{B}{s12b}{12b} +% +% \subsection{\ttfamily\bfseries continued} +% The |continued| option suffixes the caption with ` (continued)', and lowers the table +% number by one, so that it obtains the same number as the previous table. +% This option can be given an argument to replace the default suffix: +% \medskip\\ +% \ROW{Y}{s13a}{13a} +% \ROW{B}{s13b}{13b} +% \ROW{B}{s13c}{13c} +% +% \subsection{\ttfamily\bfseries mincapwidth} +% |ctable| forces caption and footnotes to stay within the width of the table. +% Sometimes, however, tables are so narrow, that this is not really what you want. +% In such cases, use the |mincapwidth| option to give caption and footnotes some +% extra room: +% \medskip\\ +% \ROW{Y}{s05a}{05a} +% \ROW{B}{s05b}{05b} +% \medskip +% You can set |mincapwidth| to a large value, say |\hsize|, if you want a one-line +% caption. Note, however, that this may influence the horizontal positioning of +% the table: values larger than |\hsize| will move a centered table out of the +% center, a value of |\hsize| will prevent the |left| and |right| options to do +% their work, because the table is already captured between the left and right +% margins. When footnotes are small, you may wish to undo the effect of the +% |mincapwidth| option on them: +% \medskip\\ +% \ROW{B}{s05c}{05c} +% \medskip +% +% \subsection{\ttfamily\bfseries maxwidth} +% When \LaTeX-sources containing tables are generated automatically by a +% script, it is often not known in advance what the maximum size of an |l| +% column will be. A good solution for this is to use an |X| specifier, +% typesetting the table at the text width with the \REF{tabularx} package. +% However, this will result in too much white space in cases where the +% column contains small texts only. This problem can be solved by using +% the maxwidth option instead of the width option. The |X| specifiers will +% then be replaced with |l| as long as the width of the resulting table +% stays with the specified maximum width. +% \medskip\\ +% \ROW{Y}{s06a}{06a} +% \ROW{B}{s06b}{06b} +% +% \subsection{\ttfamily\bfseries framerule} +% The following examples show the use of frames and backgrounds. Every table +% is typeset by |ctable| with a frame around it, but the frame is, by default, +% drawn with a zero width line, and is therefore invisible. You can make it +% visible by either changing the linewidth to a positive value or by giving it a +% background color, which will be used to fill the frame. +% +% Here is a simple table without a frame, followed by one with a red, |1pt| thick +% frame: +% \medskip\\ +% \ROW{Y}{s08a}{08a} +% \ROW{B}{s08b}{08b} +% \medskip +% As you see, the frame fits closely to the first (|\FL|) and last (|\LL|) table +% lines. This can be a reason to either remove those lines, or to introduce some +% whitespace between the frame and the table with the |framesep| option: +% \medskip\\ +% \ROW{B}{s09b}{09b} +% \medskip +% And finally, we could also frame the table by giving it a, say, yellow backgound +% instead of a red frame line, or even do both: +% \medskip\\ +% \ROW{Y}{s10a}{10a} +% \ROW{B}{s10b}{10b} +% +% \newpage +% \subsection{\ttfamily\bfseries captionskip} +% The distance between a top caption and the table is \texttt{2ex}, +% but it can be varied with \texttt{captionskip}: +% \medskip\\ +% \ROW{Y}{s03a}{03a} +% \ROW{B}{s03b}{03b} +% \medskip +% This works for bottom caption, too: +% \medskip\\ +% \ROW{Y}{s04a}{04a} +% \ROW{B}{s04b}{04b} +% +% \subsection{\ttfamily\bfseries figure, botcap}\label{figureexample} +% By default, |ctable| generates a table float, but with the |figure| option, a +% figure float is generated instead. The caption stays on top, so if you are +% accustomed to have bottom caption for your figures, you will probably also need +% the |botcap| option: +% \medskip\\ +% \ROW{Y}{s01a}{01a} +% \ROW{B}{s01b}{01b} +% +% \newpage +% \subsection{\ttfamily\bfseries doinside} +% The argument of doinside is supposed to be a command to be run inside, +% just before the tabular or tabularx environment. You can use this, for +% example, for the adjustment of the font size with |\small|: +% \medskip\\ +% \ROW{Y}{s14a}{14a} +% \StopEventually{} +% +% \section{Implementation} +% \begin{macrocode} +\RequirePackage{ifpdf,etoolbox,xcolor,xkeyval,array,tabularx,booktabs,rotating} +% \end{macrocode} +% The transparency package works only in pdf mode, and if the tikz package is not loaded; +% otherwise define a dummy |\transparent| and issue a warning. +% \begin{macrocode} +\ifpdf + \@ifpackageloaded{tikz}{ + \PackageWarning{ctable}{ + Transparency disabled: incompatible with tikz package + } + \def\transparent#1{} + }{ + \RequirePackage{transparent} + } +\else + \PackageWarningNoLine{ctable}{\MessageBreak + Transparency disabled: pdfTeX is not running in PDF mode + } + \def\transparent#1{} +\fi +% \end{macrocode} +% We need to know if the user has loaded tikz after ctable. If so, we have +% loaded the transparent package already, which then will disturb the tikz +% definitions, so we must quit with an error message. +% Some warnings depend on whether the caption package is loaded or not. +% Here a flag is set to remember that. +% \begin{macrocode} +\newif\if@CTcaptionloaded +\AtBeginDocument{ + \makeatletter + \@ifpackageloaded{tikz}{ + \@ifpackageloaded{transparent}{ + \PackageError{ctable}{You must load ctable after tikz}{} + } + }{} + \@ifpackageloaded{caption}{\@CTcaptionloadedtrue}{\@CTcaptionloadedfalse} + \makeatother +} +\def\NN{\tabularnewline} +\def\FL{\toprule} +\def\ML{\NN\midrule} +\def\LL{\NN\bottomrule} +\def\@dfltCTfgcolor#1 #2 #3={\definecolor{@dfltCTframefg}{rgb}{#1,#2,#3}} +\def\@dfltCTbgcolor#1 #2 #3={\definecolor{@dfltCTframebg}{rgb}{#1,#2,#3}} +\def\@CTfgcolor#1 #2 #3={% + \definecolor{@CTframefg}{rgb}{#1,#2,#3} + \def\@CTfgactual{@CTframefg}} +\def\@CTbgcolor#1 #2 #3={% + \definecolor{@CTframebg}{rgb}{#1,#2,#3} + \def\@CTbgactual{@CTframebg}} +\def\@CTtextsuperscript#1{% + \ifx\@CTsuper\@CTtrue\@textsuperscript{#1}\else{\footnotesize#1}\fi +} +% \end{macrocode} +% define a true and a false value +% \begin{macrocode} +\def\@CTtrue{1} +\def\@CTfalse{0} +% \end{macrocode} +% normally we do nothing special inside the float, but that can be changed with the doinside option +% \begin{macrocode} +\def\@CTdoinside{\relax} +% \end{macrocode} +% Need three booleans to remember: +% if we use tabularx, +% if we are running in the memoir class, +% \begin{macrocode} +\newif\if@CTusex +\newif\if@CTinmemoir +\@ifclassloaded{memoir}{\@CTinmemoirtrue}{\@CTinmemoirfalse} +% \end{macrocode} +% Need lots of dimens and their defaults +% \begin{macrocode} +\newdimen\@CTframesep \newdimen\@dfltCTframesep +\newdimen\@CTframerule \newdimen\@dfltCTframerule +\newdimen\@CTwidth \newdimen\@dfltCTwidth +\newdimen\@CTcaptionskip \newdimen\@dfltCTcaptionskip +\newdimen\@CTmaxwidth \newdimen\@dfltCTmaxwidth +\newdimen\@CTmincapwidth \newdimen\@dfltCTmincapwidth +\newdimen\@CTfooterwidth \newdimen\@dfltCTfooterwidth +\newdimen\@CTw % the final width +\newdimen\@CTfloatwidth +\newdimen\@CToldsep +\newdimen\@CToldrule +% \end{macrocode} +% Allocate box registers so that we can determine the widths of the +% tables +% \begin{macrocode} +\newbox\CT@t % tabular saved and measured here +% \end{macrocode} +% Option setting commands from keyval. The table position (here, top, +% bottom, page) gets a special treatment, since \LaTeX\ does not expand +% commands there. So instead of putting things like \texttt{tbp} in a +% command like |\@CTbegin| we put +% |\begin{table}[tbp]| in it. +% \begin{macrocode} + +\define@key{suCT}{bgopacity}{\def\@dfltCTbgopacity{#1}} +\define@key{suCT}{botcap}[]{\let\@dfltCTbotcap\@CTtrue} +\define@key{suCT}{captionsinside}[]{\def\rot@LR{-1} + \if@twoside\@rot@twosidetrue + \else\@rot@twosidefalse\fi} +\define@key{suCT}{captionsleft}[]{\@rot@twosidefalse\def\rot@LR{-1}} +\define@key{suCT}{captionsright}[]{\@rot@twosidefalse\def\rot@LR{0}} +\define@key{suCT}{captionskip}{\@dfltCTcaptionskip=#1} +\define@key{suCT}{center}[]{\let\@dfltCTalign\centering} +\define@key{suCT}{continued}{\def\@dflttextcontinued{#1}} +\define@key{suCT}{doinside}{\def\@dfltCTdoinside{#1}} +\define@key{suCT}{figure}[]{\def\@dfltCTtaborfig{figure}} +\define@key{suCT}{framebg}{\@dfltCTbgcolor#1=} +\define@key{suCT}{framefg}{\@dfltCTfgcolor#1=} +\define@key{suCT}{framerule}{\@dfltCTframerule=#1} +\define@key{suCT}{framesep}{\@dfltCTframesep=#1} +\define@key{suCT}{left}[]{\let\@dfltCTalign\raggedright} +\define@key{suCT}{maxwidth}{\@dfltCTmaxwidth=#1} +\define@key{suCT}{mincapwidth}{\@dfltCTmincapwidth=#1} +\define@key{suCT}{footerwidth}[-1pt]{\@dfltCTfooterwidth=#1} +\define@key{suCT}{nonotespar}[]{\let\@dfltCTnotespar\@CTfalse} +\define@key{suCT}{nosideways}[]{\let\@dfltCTsideways\empty} +\define@key{suCT}{nostar}[]{\def\@dfltCTstarred{}} +\define@key{suCT}{nosuper}[]{\let\@dfltCTsuper\@CTfalse} +\define@key{suCT}{notespar}[]{\let\@dfltCTnotespar\@CTtrue} +\define@key{suCT}{pos}{\def\@dfltCTpos{#1}} +\define@key{suCT}{right}[]{\let\@dfltCTalign\raggedleft} +\define@key{suCT}{sideways}[]{\def\@dfltCTsideways{sideways}} +\define@key{suCT}{star}[]{\def\@dfltCTstarred{*}} +\define@key{suCT}{super}[]{\let\@dfltCTsuper\@CTtrue} +\define@key{suCT}{table}[]{\def\@dfltCTtaborfig{table}} +\define@key{suCT}{topcap}[]{\let\@dfltCTbotcap\@CTfalse} +\define@key{suCT}{width}{\@dfltCTwidth=#1} + +\newcommand{\setupctable}[1]{\setkeys{suCT}{#1}} +\setupctable{ + bgopacity=1, + captionskip=0pt, + center, + continued=(continued), + doinside={}, + footerwidth=0pt, + framebg=1 1 1, + framefg=0 0 0, + framerule=0pt, + framesep=0pt, + maxwidth=0pt, + mincapwidth=0pt, + nonotespar, + nosideways, + nostar, + super, + table, + topcap, + width=0pt, +} + +\define@key{CT}{bgopacity}{\def\@CTbgopacity{#1}} +\define@key{CT}{botcap}[]{\let\@CTbotcap\@CTtrue} +\define@key{CT}{captionskip}{\@CTcaptionskip=#1} +\define@key{CT}{caption}{\def\@CTcaption{#1}} +\define@key{CT}{cap}{\def\@CTcap{#1}} +\define@key{CT}{center}[]{\let\@CTalign\centering} +\define@key{CT}{continued}[\@dflttextcontinued]{\def\@CTcontinued{#1}} +\define@key{CT}{doinside}{\def\@CTdoinside{#1}} +\define@key{CT}{figure}[]{\def\@CTtaborfig{figure}} +\define@key{CT}{framebg}{\@CTbgcolor#1=} +\define@key{CT}{framefg}{\@CTfgcolor#1=} +\define@key{CT}{framerule}{\@CTframerule=#1} +\define@key{CT}{framesep}{\@CTframesep=#1} +\define@key{CT}{label}{\def\@CTlabel{#1}} +\define@key{CT}{left}[]{\let\@CTalign\raggedright} +\define@key{CT}{maxwidth}{\@CTmaxwidth=#1} +\define@key{CT}{mincapwidth}{\@CTmincapwidth=#1} +\define@key{CT}{footerwidth}[-1pt]{\@CTfooterwidth=#1} +\define@key{CT}{nonotespar}[]{\let\@CTnotespar\@CTfalse} +\define@key{CT}{nosideways}[]{\let\@CTsideways\empty} +\define@key{CT}{nostar}[]{\def\@CTstarred{}} +\define@key{CT}{nosuper}[]{\let\@CTsuper\@CTfalse} +\define@key{CT}{notespar}[]{\let\@CTnotespar\@CTtrue} +\define@key{CT}{pos}{\def\@CTpos{#1}\def\@CTbegin{\@CTbeg[#1]}} +\define@key{CT}{right}[]{\let\@CTalign\raggedleft} +\define@key{CT}{sidecap}[]{\let\@CTbotcap\undefined} +\define@key{CT}{sideways}[]{\def\@CTsideways{sideways}} +\define@key{CT}{star}[]{\def\@CTstarred{*}} +\define@key{CT}{super}[]{\let\@CTsuper\@CTtrue} +\define@key{CT}{table}[]{\def\@CTtaborfig{table}} +\define@key{CT}{topcap}[]{\let\@CTbotcap\@CTfalse} +\define@key{CT}{width}{\@CTwidth=#1} +% \end{macrocode} +% A caption will only be generated if the \textsl{caption} option was used, with a +% non-empty value. If so, it goes in the lot/lof, unless the \textsl{cap} option +% specified a different (probably shorter) value for it. A \textsl{cap} option with +% an empty value inhibits a tof/lof entry. +% The |\expandonce| trick below is from Marco Daniel. +% It expands the arguments of |\caption| +% so that the hyperref command |\nameref| works OK. +% See http://tex.stackexchange.com/questions/57396/ +% Note that, in captions, |tmark| may only be used without its optional argument. +% \begin{macrocode} +\def\@CTCaption{ + \ifx\@CTcaption\empty\else + \def\@CTcaptionarg{\ifx\@CTlabel\empty\else\label{\@CTlabel}\fi + \@CTcaption\ \@CTcontinued\strut} + \begingroup + \ifx\@CTcap\empty + \edef\x{\endgroup\noexpand\caption[]{\expandonce\@CTcaptionarg}} + \else + \edef\x{\endgroup\noexpand\caption[\expandonce\@CTcap]% + {\expandonce\@CTcaptionarg}} + \fi + \x + \fi +} +% \end{macrocode} +% Need to redefine X columntype, but the array package would generate a warning. +% So first set the type to be redefined to |\undefined| to suppress the warning. +% Save the standard X type once in the new type Y +% \begin{macrocode} +\newcolumntype{Y}{X} +\def\@CTXcolumntype#1{% + \let\NC@find@X\undefined + \newcolumntype{X}{#1}% +} +\long\def\@CTframe#1#2#3{% + \@CToldsep\fboxsep\fboxsep\@CTframesep% + \@CToldrule\fboxrule\fboxrule\@CTframerule% + \transparent{\@CTbgopacity}% + \fcolorbox{#1}{#2}{\fboxsep\@CToldsep\fboxrule\@CToldrule\transparent{1}#3}% +} +\newcommand{\tnote}[2][a]{% + \ifx\@CTnotespar\@CTtrue% + \@CTtextsuperscript{\normalfont\textit{#1}}\,#2 + \else% + \hbox{\@CTtextsuperscript{\normalfont\textit{#1}}}\NN + \fi +} +\newcommand{\tmark}[1][a]{% + \hbox{\textsuperscript{\normalfont\textit{#1}}}} +\newdimen\@CTcurftwidth +\newcommand{\ctable}[4][]{% + \let\@CTtaborfig \@dfltCTtaborfig + \let\@CTalign \@dfltCTalign + \let\@CTsideways \@dfltCTsideways + \let\@CTcontinued \empty + \let\@CTpos \@dfltCTpos + \let\@CTcaption \empty + \let\@CTcap \undefined + \let\@CTlabel \empty + \let\@CTbotcap \@dfltCTbotcap + \let\@CTstarred \@dfltCTstarred + \let\@CTsuper \@dfltCTsuper + \let\@CTnotespar \@dfltCTnotespar + \let\@CTdoinside \@dfltCTdoinside + \let\@CTbgopacity \@dfltCTbgopacity + \@CTframerule \@dfltCTframerule + \@CTcaptionskip \@dfltCTcaptionskip + \@CTframesep \@dfltCTframesep + \@CTwidth \@dfltCTwidth + \@CTmaxwidth \@dfltCTmaxwidth + \@CTmincapwidth \@dfltCTmincapwidth + \@CTfooterwidth \@dfltCTfooterwidth + \def\@CTfgactual {@dfltCTframefg}% + \def\@CTbgactual {@dfltCTframebg}% + \def\@CTbeg {\begin{\@CTsideways\@CTtaborfig\@CTstarred}}% + \def\@CTbegin {\@CTbeg}% + \def\@CTend {\end{\@CTsideways\@CTtaborfig\@CTstarred}}% + \setkeys{CT}{#1}% +% \end{macrocode} +% Make the short caption equal to the caption if it has not been defined +% \begin{macrocode} + \ifx\@CTcap\undefined\let\@CTcap\@CTcaption\fi +% \end{macrocode} +% Issue a warning if the short caption is empty and the caption package is not loaded +% \begin{macrocode} + \ifx\@CTcap\empty + \if@CTcaptionloaded\else + \PackageWarningNoLine{ctable}{\MessageBreak + An empty cap= option prevents lot/loc entry only\MessageBreak + if the caption package is loaded!} + \fi + \fi +% \end{macrocode} +% Currently, the sidecap option can only be used from within the memoir class; +% here we test if memoir is loaded: +% \begin{macrocode} + \if@CTinmemoir\else + \ifx\@CTbotcap\undefined + \PackageError{ctable}{\MessageBreak + You can, currently, use the sidecap option only with\MessageBreak + memoir documents. Use topcap or botcap only} + \fi + \fi +% \end{macrocode} +% It makes no sense to use \textsl{width} together with \textsl{maxwidth} or +% \textsl{pos} together with \textsl{sideways} +% \begin{macrocode} + \ifdim\@CTwidth=0pt\else + \ifdim\@CTmaxwidth=0pt\else + \PackageError{ctable}{\MessageBreak + You may not use the width and maxwidth options together\MessageBreak + Use either width or maxwidth} + \fi + \fi + \ifx\@CTpos\empty + \ifx\@CTsideways\empty\else + \PackageError{ctable}{\MessageBreak + You may not use the pos and sideways options together\MessageBreak + Rotated tables and figures are always typeset on a separate page} + \fi + \fi +% \end{macrocode} +% It makes no sense to label a captionless table, because the label can't +% be placed, leaving the user wondering why references to the table get a ?? +% \begin{macrocode} + \ifx\@CTcaption\empty + \ifx\@CTlabel\empty\else + \PackageError{ctable}{\MessageBreak + You may not label a captionless table\MessageBreak + Such a label can't be referenced} + \fi + \fi +% \end{macrocode} +% save the table contents in a box, so we can determine its width, +% initially, save the table typeset with the tabular environment: +% \begin{macrocode} + \sbox\CT@t{% + \@CTXcolumntype{l}% temporarily make type X = l + \@CTframe{\@CTfgactual}{\@CTbgactual}{% + \@CTdoinside + \begin{tabular}{#2} + #4% + \end{tabular}% + }% + }% +% \end{macrocode} +% then look if we'll need the tabularx environment: +% \begin{macrocode} + \@CTusexfalse + \ifdim\@CTmaxwidth=0pt + \ifdim\@CTwidth=0pt + \else + \@CTusextrue + \fi + \else + \ifdim\wd\CT@t>\@CTmaxwidth + \@CTusextrue + \fi + \fi +% +% if so, replace tabular with tabularx: +% + \if@CTusex + \sbox\CT@t{% + \@CTXcolumntype{Y}% restore X + \@CTframe{\@CTfgactual}{\@CTbgactual}{% + \@CTdoinside + \begin{tabularx}{\ifdim\@CTwidth>0pt\@CTwidth\else\@CTmaxwidth\fi}{#2} + #4% + \end{tabularx}% + }% + }% + \fi +% \end{macrocode} +% the |CT@t| box now contains the table as we want to typeset it; +% determine its width: +% \begin{macrocode} + \@CTw=\wd\CT@t +% \end{macrocode} +% Now find the width of the float, |\@CTfloatwidth|; everything in it will +% be centered within that width. +% Normally we'll use the width of the table, |\@CTw|, but if the +% mincapwidth, |\@CTmincapwidth| was set wider than the table, that will be used: +% \begin{macrocode} + \@CTfloatwidth=\ifdim\@CTmincapwidth>\@CTw + \@CTmincapwidth + \else + \@CTw + \fi +% \end{macrocode} +% |\@CTbegin| is now defined as something like |\begin{table}[tbp]|. +% \begin{macrocode} + \@CTbegin + \ifx\@CTcontinued\empty\else\addtocounter{\@CTtaborfig}{-1}\fi + \@CTalign + \begin{minipage}{\@CTfloatwidth}\parindent0pt + \ifx\@CTbotcap\@CTfalse\@CTCaption\vskip\@CTcaptionskip\fi + \ifx\@CTbotcap\undefined% + \begin{sidecaption}[\@CTcap]{\@CTcaption}[\@CTlabel] + \fi + \centering{\usebox\CT@t}% insert the tabular + \def\@CTfootnotes{#3}% + \ifx#3\empty\else{% append footnotes, if any +% \end{macrocode} +% Footnotes: if the |footerwidth| is 0pt (the default), typeset the footer as +% wide as the caption (which may be wider than the table because of the +% |mincapwidth| option); if it is -1pt (because |footerwidth| was set without an argument) +% make it as wide as the table; otherwise, give it the width set by the +% |footerwidth| option. +% \begin{macrocode} + \@CTcurftwidth=\ifdim\@CTfooterwidth=-1pt\@CTw\else + \ifdim\@CTfooterwidth=0pt\hsize\else + \@CTfooterwidth\fi\fi + \footnotesize + \ifx\@CTnotespar\@CTtrue% + \\[.2ex] + \begin{minipage}{\@CTcurftwidth}% + #3% + \end{minipage}% + \else% + \\ + \begin{tabularx}{\@CTcurftwidth}{r@{\,}>{\raggedright}X} + #3% + \end{tabularx}% + \fi + } + \fi + \ifx\@CTbotcap\undefined\end{sidecaption}\fi + \ifx\@CTbotcap\@CTtrue\vskip\@CTcaptionskip\@CTCaption\fi + \end{minipage} + \@CTend +} +% \end{macrocode} +% \Finale +\endinput diff --git a/macros/latex/contrib/ctable/ctable.ins b/macros/latex/contrib/ctable/ctable.ins new file mode 100644 index 0000000000..141cb1a6f5 --- /dev/null +++ b/macros/latex/contrib/ctable/ctable.ins @@ -0,0 +1,63 @@ +%% +%% Copyright (C) 2005 by Wybo Dekker +%% +%% This file may be distributed and/or modified under the conditions of +%% the LaTeX Project Public License, either version 1.2 of this license +%% or (at your option) any later version. The latest version of this +%% license is in: +%% +%% http://www.latex-project.org/lppl.txt +%% +%% and version 1.2 or later is part of all distributions of LaTeX version +%% 1999/12/01 or later. +%% + +\input docstrip.tex +\keepsilent + +\usedir{tex/latex/ctable} + +\preamble + +This is a generated file. + +Copyright (C) 2005 by Wybo Dekker + +This file may be distributed and/or modified under the conditions of +the LaTeX Project Public License, either version 1.2 of this license +or (at your option) any later version. The latest version of this +license is in: + + http://www.latex-project.org/lppl.txt + +and version 1.2 or later is part of all distributions of LaTeX version +1999/12/01 or later. + +\endpreamble + +\generate{\file{ctable.sty}{\from{ctable.dtx}{package}}} + +\obeyspaces +\Msg{**************************************************************} +\Msg{* *} +\Msg{* To finish the installation you have to move the following *} +\Msg{* file into a directory searched by TeX: *} +\Msg{* *} +\Msg{* ctable.sty *} +\Msg{* *} +\Msg{* To produce the documentation: *} +\Msg{* 1. generate the graphics needed by running doit in doc *} +\Msg{* 2. run the file ctable.dtx through LaTeX: *} +\Msg{* *} +\Msg{* pdflatex --interaction=batchmode ctable.dtx > /dev/null *} +\Msg{* makeindex -q -s gglo.ist -o ctable.gls ctable.glo *} +\Msg{* makeindex -q -s gind.ist -o ctable.ind ctable.idx *} +\Msg{* pdflatex --interaction=batchmode ctable.dtx > /dev/null *} +\Msg{* (or maybe adapt the inst script to do that and *} +\Msg{* install everything at the same time) *} +\Msg{* *} +\Msg{* Happy TeXing! *} +\Msg{* *} +\Msg{**************************************************************} + +\endbatchfile diff --git a/macros/latex/contrib/ctable/ctable.pdf b/macros/latex/contrib/ctable/ctable.pdf new file mode 100644 index 0000000000..e46fd6f53a Binary files /dev/null and b/macros/latex/contrib/ctable/ctable.pdf differ diff --git a/macros/latex/contrib/ctable/doc/01a b/macros/latex/contrib/ctable/doc/01a new file mode 100644 index 0000000000..0e80db425c --- /dev/null +++ b/macros/latex/contrib/ctable/doc/01a @@ -0,0 +1,2 @@ +\ctable[caption = a table]{c}{ +}{\FL Table's first row\LL} diff --git a/macros/latex/contrib/ctable/doc/01b b/macros/latex/contrib/ctable/doc/01b new file mode 100644 index 0000000000..798f951413 --- /dev/null +++ b/macros/latex/contrib/ctable/doc/01b @@ -0,0 +1,11 @@ +\newcommand{\F}[1]{ + \includegraphics[width=\hsize]{#1} +} +\newcolumntype{H}[1]{>{\hsize=#1\hsize}X} +\ctable[ + caption = a figure, + figure, botcap, + width=.4\hsize, +]{H{.4}H{.6}}{}{\FL + \F{penguin}& \F{lion}\LL +} diff --git a/macros/latex/contrib/ctable/doc/02k b/macros/latex/contrib/ctable/doc/02k new file mode 100644 index 0000000000..056aba4b8b --- /dev/null +++ b/macros/latex/contrib/ctable/doc/02k @@ -0,0 +1,3 @@ +\ctable[ + caption = Centered, +]{c}{}{\FL Table's first row\LL} diff --git a/macros/latex/contrib/ctable/doc/02l b/macros/latex/contrib/ctable/doc/02l new file mode 100644 index 0000000000..33d9df6fe6 --- /dev/null +++ b/macros/latex/contrib/ctable/doc/02l @@ -0,0 +1,4 @@ +\ctable[ + caption = Left, + left +]{c}{}{\FL Table's first row\LL} diff --git a/macros/latex/contrib/ctable/doc/02m b/macros/latex/contrib/ctable/doc/02m new file mode 100644 index 0000000000..d5beb91b4d --- /dev/null +++ b/macros/latex/contrib/ctable/doc/02m @@ -0,0 +1,4 @@ +\ctable[ + caption = Right, + right +]{c}{}{\FL Table's first row\LL} diff --git a/macros/latex/contrib/ctable/doc/03a b/macros/latex/contrib/ctable/doc/03a new file mode 100644 index 0000000000..4b3fb78340 --- /dev/null +++ b/macros/latex/contrib/ctable/doc/03a @@ -0,0 +1,3 @@ +\ctable[ + caption = Caption, +]{c}{}{\FL Table's first row\LL} diff --git a/macros/latex/contrib/ctable/doc/03b b/macros/latex/contrib/ctable/doc/03b new file mode 100644 index 0000000000..f374419a3f --- /dev/null +++ b/macros/latex/contrib/ctable/doc/03b @@ -0,0 +1,4 @@ +\ctable[ + caption = Caption, +captionskip = 1ex, +]{c}{}{\FL Table's first row\LL} diff --git a/macros/latex/contrib/ctable/doc/04a b/macros/latex/contrib/ctable/doc/04a new file mode 100644 index 0000000000..08cdac9a4a --- /dev/null +++ b/macros/latex/contrib/ctable/doc/04a @@ -0,0 +1,4 @@ +\ctable[ + caption = Caption, + botcap +]{c}{}{\FL Table's first row\LL} diff --git a/macros/latex/contrib/ctable/doc/04b b/macros/latex/contrib/ctable/doc/04b new file mode 100644 index 0000000000..13139d781b --- /dev/null +++ b/macros/latex/contrib/ctable/doc/04b @@ -0,0 +1,5 @@ +\ctable[ + caption = Caption, +captionskip = -2ex, + botcap +]{c}{}{\FL Table's first row\LL} diff --git a/macros/latex/contrib/ctable/doc/05a b/macros/latex/contrib/ctable/doc/05a new file mode 100644 index 0000000000..525352a3d1 --- /dev/null +++ b/macros/latex/contrib/ctable/doc/05a @@ -0,0 +1,3 @@ +\ctable[ + caption = a lengthy caption +]{c}{}{\FL row1\LL} diff --git a/macros/latex/contrib/ctable/doc/05b b/macros/latex/contrib/ctable/doc/05b new file mode 100644 index 0000000000..9d39045b5f --- /dev/null +++ b/macros/latex/contrib/ctable/doc/05b @@ -0,0 +1,5 @@ +\ctable[ + mincapwidth = 40mm, + caption = a lengthy caption +]{c}{\tnote{this is a footnote}} +{\FL row1\tmark\LL} diff --git a/macros/latex/contrib/ctable/doc/05c b/macros/latex/contrib/ctable/doc/05c new file mode 100644 index 0000000000..494bd3593a --- /dev/null +++ b/macros/latex/contrib/ctable/doc/05c @@ -0,0 +1,6 @@ +\ctable[ + mincapwidth = 40mm, + footerwidth, + caption = a lengthy caption +]{c}{\tnote{footnote}} +{\FL row1\tmark\LL} diff --git a/macros/latex/contrib/ctable/doc/06a b/macros/latex/contrib/ctable/doc/06a new file mode 100644 index 0000000000..53b78d2a75 --- /dev/null +++ b/macros/latex/contrib/ctable/doc/06a @@ -0,0 +1,3 @@ +\ctable[framerule=.1pt, maxwidth=3cm +]{lX}{}{\FL 1 & first row\LL} + diff --git a/macros/latex/contrib/ctable/doc/06b b/macros/latex/contrib/ctable/doc/06b new file mode 100644 index 0000000000..e333228401 --- /dev/null +++ b/macros/latex/contrib/ctable/doc/06b @@ -0,0 +1,3 @@ +\ctable[framerule=.1pt, maxwidth=3cm +]{lX}{}{\FL 1 & test\LL} + diff --git a/macros/latex/contrib/ctable/doc/07a b/macros/latex/contrib/ctable/doc/07a new file mode 100644 index 0000000000..d0e5e9d9ca --- /dev/null +++ b/macros/latex/contrib/ctable/doc/07a @@ -0,0 +1,5 @@ +\ctable{c}{ + \tnote{First footnote} + \tnote[b]{Second footnote} +}{\FL Table's\tmark\ first\tmark[b]\ row\LL} + diff --git a/macros/latex/contrib/ctable/doc/07b b/macros/latex/contrib/ctable/doc/07b new file mode 100644 index 0000000000..4adcd36845 --- /dev/null +++ b/macros/latex/contrib/ctable/doc/07b @@ -0,0 +1,5 @@ +\ctable[nosuper]{c}{ + \tnote[a.]{First footnote} + \tnote[b.]{Second footnote} +}{\FL Table's\tmark\ first\tmark[b]\ row\LL} + diff --git a/macros/latex/contrib/ctable/doc/08a b/macros/latex/contrib/ctable/doc/08a new file mode 100644 index 0000000000..e79af4a90f --- /dev/null +++ b/macros/latex/contrib/ctable/doc/08a @@ -0,0 +1,3 @@ +\ctable[ + caption = Frame, +]{c}{}{\FL Table's first row\LL} diff --git a/macros/latex/contrib/ctable/doc/08b b/macros/latex/contrib/ctable/doc/08b new file mode 100644 index 0000000000..10e78f42d0 --- /dev/null +++ b/macros/latex/contrib/ctable/doc/08b @@ -0,0 +1,5 @@ +\ctable[ + caption = Frame, + framerule = 2pt, + framefg = .8 0 0 +]{c}{}{\FL Table's first row\LL} diff --git a/macros/latex/contrib/ctable/doc/09b b/macros/latex/contrib/ctable/doc/09b new file mode 100644 index 0000000000..80270e12ea --- /dev/null +++ b/macros/latex/contrib/ctable/doc/09b @@ -0,0 +1,7 @@ +\ctable[ + caption = Frame, + framerule = 1pt, + framefg = .8 0 0, + framesep=10pt +]{c}{}{\FL Table's first row\LL} + diff --git a/macros/latex/contrib/ctable/doc/10a b/macros/latex/contrib/ctable/doc/10a new file mode 100644 index 0000000000..e9b244cb77 --- /dev/null +++ b/macros/latex/contrib/ctable/doc/10a @@ -0,0 +1,5 @@ +\ctable[ + caption = Frame, + framebg = 1 1 0, + framesep=10pt +]{c}{}{\FL Table's first row\LL} diff --git a/macros/latex/contrib/ctable/doc/10b b/macros/latex/contrib/ctable/doc/10b new file mode 100644 index 0000000000..386b009a93 --- /dev/null +++ b/macros/latex/contrib/ctable/doc/10b @@ -0,0 +1,8 @@ +\ctable[ + caption = Frame, + framerule = 2pt, + framesep = 5pt, + framebg = 1 1 0, + framefg = 1 0 0, + framesep=10pt +]{c}{}{\FL Table's first row\LL} diff --git a/macros/latex/contrib/ctable/doc/12a b/macros/latex/contrib/ctable/doc/12a new file mode 100644 index 0000000000..5ea6601073 --- /dev/null +++ b/macros/latex/contrib/ctable/doc/12a @@ -0,0 +1,7 @@ +\ctable{c}{ + \tnote{First note} + \tnote[b]{Second note} + \tnote[c]{Third note} +}{\FL Table's\tmark\ first\tmark[b]\ row + with footnotes\tmark[c]\LL} + diff --git a/macros/latex/contrib/ctable/doc/12b b/macros/latex/contrib/ctable/doc/12b new file mode 100644 index 0000000000..a1e2fd49a5 --- /dev/null +++ b/macros/latex/contrib/ctable/doc/12b @@ -0,0 +1,11 @@ +\ctable[notespar]{c}{ + \tnote[a]{First note.} + \tnote[b]{Second note.} + \tnote[c]{Third note, this one is a + little longer and forces a + new line at the end.\\} + \tnote[d]{And here is e very long note: + \input{thuan}} +}{\FL Table's\tmark\ first\tmark[b]\ row + with footnotes\tmark[c]\LL} + diff --git a/macros/latex/contrib/ctable/doc/13a b/macros/latex/contrib/ctable/doc/13a new file mode 100644 index 0000000000..accb3b37bb --- /dev/null +++ b/macros/latex/contrib/ctable/doc/13a @@ -0,0 +1,4 @@ +\ctable[ + caption = Caption, + mincapwidth = 50mm, +]{c}{}{\FL Table's first row\LL} diff --git a/macros/latex/contrib/ctable/doc/13b b/macros/latex/contrib/ctable/doc/13b new file mode 100644 index 0000000000..d57b0659cb --- /dev/null +++ b/macros/latex/contrib/ctable/doc/13b @@ -0,0 +1,6 @@ +\addtocounter{table}{1} % remove for source +\ctable[ + caption = Caption, + mincapwidth = 50mm, + continued +]{c}{}{\FL Table's first row\LL} diff --git a/macros/latex/contrib/ctable/doc/13c b/macros/latex/contrib/ctable/doc/13c new file mode 100644 index 0000000000..71feba3cb6 --- /dev/null +++ b/macros/latex/contrib/ctable/doc/13c @@ -0,0 +1,6 @@ +\addtocounter{table}{1} %remove for source +\ctable[ + caption = Caption, + mincapwidth = 50mm, + continued = \textit{(contd)} +]{c}{}{\FL Table's first row\LL} diff --git a/macros/latex/contrib/ctable/doc/14a b/macros/latex/contrib/ctable/doc/14a new file mode 100644 index 0000000000..15745b30c9 --- /dev/null +++ b/macros/latex/contrib/ctable/doc/14a @@ -0,0 +1,8 @@ +\ctable[ + caption=Doinside, + doinside = \scriptsize]{l}{ +}{\FL + This table has all rows \NN + set at script size \LL +} + diff --git a/macros/latex/contrib/ctable/doc/doit b/macros/latex/contrib/ctable/doc/doit new file mode 100755 index 0000000000..e9d627786d --- /dev/null +++ b/macros/latex/contrib/ctable/doc/doit @@ -0,0 +1,49 @@ +#!/bin/bash + +# doit - make all or some example picture sets. + +# Usage: doit # make them all +# doit nnx # make nnx.pdf and snnx.pdf +# +# pictures are numbered 01, 02, etc. +# nn[a-z] has code to typeset a \ctable; for nn[k-z] page layout will be shown +# for each nn[a-z] two pdfs are generated: +# nn[a-z].pdf for the ctable picture +# and snn[a-z].pdf for the source code verbatim. +# The prefix (s) for source verbatims and (empty) for result files is set by PRE +set=${1:-[0-9][0-9][a-z]} +for j in $set; do + # source verbatim + { cat <<-'EOD' + \documentclass{article} + \usepackage[a4paper,margin=20mm,noheadfoot]{geometry} + \pagestyle{empty} + \begin{document}\ttfamily + \fontsize{10}{12 pt}\selectfont + \begin{verbatim} + EOD + grep -v "remove from source" $j + cat <<-'EOD' + \end{verbatim} + \end{document} + EOD + } >s$j.tex + + mk --noprint --noview s$j.tex >/dev/null && mk -c s$j + pdfcrop s$j.pdf s$j.pdf >& /dev/null + # result + { echo '\documentclass[twoside]{article}' + [[ $j =~ [k-z] ]] && echo '\usepackage[papersize={56mm,40mm},showframe,margin=1mm,noheadfoot]{geometry}' + cat <<-'EOD' + \usepackage{ctable} + \usepackage{txfonts} + \pagestyle{empty} + \parindent0pt + \begin{document} + EOD + cat $j + echo '\end{document}' + } > $j.tex + mk --noprint --noview $j.tex >/dev/null && mk -c $j + pdfcrop $j.pdf $j.pdf >& /dev/null +done diff --git a/macros/latex/contrib/ctable/doc/lion.png b/macros/latex/contrib/ctable/doc/lion.png new file mode 100644 index 0000000000..0026477896 Binary files /dev/null and b/macros/latex/contrib/ctable/doc/lion.png differ diff --git a/macros/latex/contrib/ctable/doc/penguin.jpg b/macros/latex/contrib/ctable/doc/penguin.jpg new file mode 100644 index 0000000000..342ccda220 Binary files /dev/null and b/macros/latex/contrib/ctable/doc/penguin.jpg differ diff --git a/macros/latex/contrib/ctable/inst b/macros/latex/contrib/ctable/inst new file mode 100755 index 0000000000..9754480f51 --- /dev/null +++ b/macros/latex/contrib/ctable/inst @@ -0,0 +1,152 @@ +#!/bin/bash + dtxname=ctable + dtxtype=package + ext=sty + delete=($dtxname.$ext README.tex doc/\*.tex) + dtxversion=$(grep " v[0-9.]\+[a-z]\{0,1\} $dtxname $dtxtype" $dtxname.dtx |sed 's/.* v\([0-9.]\+[a-z]\{,1\}\) .*/\1/') +executables=(mk texlog_extract zip getopt pdfseparate pdflatex) + + version=1.00 + myname=$(basename $0) + +<<'DOC' += inst - install ctable + += Synopsis +inst [options] + +Without any options, inst installs ctable in the first writable +TEXMFMAIN, TEXMFLOCAL or TEXMFHOME tree. + +Options: +-h,--help print this help and exit +-H,--Help print full documentation via less and exit +-V,--version print version and exit + + += Description +inst must be run in its own directory (|./inst|) and then does the following: +- generates the documentation for isodoc, +- installs ctable in one of your TeX trees: TEXMFMAIN, TEXMFLOCAL or TEXMFHOME. + The first one writable by you will chosen. +- creates a zip file named |ctable-x.yy.zip| for upload to CTAN +- cleans up + += Author and copyright +Author Wybo Dekker +Email U{wybo@dekkerdocumenten.nl}{wybo@dekkerdocumenten.nl} +License Released under the U{www.gnu.org/copyleft/gpl.html}{GNU General Public License} +DOC + + die() { echo -e "$myname: $Err$@$Nor" 1>&2; exit 1; } + help() { sed -n '/^= Synopsis/,/^= /p' $0|sed '1s/.*/Usage:/;/^= /d'; exit; } +helpall() { sed -n '/^<<.DOC.$/,/^DOC$/p' $0|sed -n '1d;$d;p'|less; exit; } +version() { echo $version; exit; } + +Nor='\e[0m' # reset color ] +Err='\e[31;1m' # light red ] + +setdir() { # create installation directory + for i in MAIN LOCAL HOME; do + tree=$(kpsewhich --expand-var \$TEXMF$i) + test -w $tree && break + tree= + done + [[ -n $tree ]] || die "Could not find a writable TeX tree" + insttex=${tree}/tex/latex/$dtxname + instsrc=$tree/source/latex/$dtxname + instdoc=$tree/doc/latex/$dtxname + mkdir -p $insttex || die could not create $insttex + mkdir -p $instsrc || die could not create $instsrc + mkdir -p $instdoc || die could not create $instdoc +} + +testexecs() { # test presence of executables + for i in ${executables[*]}; do + type $i &> /dev/null || die executable $i not found + done +} + +readme() { # generate the README file +sed -n '/^%<\*readme>/,/^%<\/readme>/p + /\\changes{v'$dtxversion'}/,/^% }/p' $dtxname.dtx | +sed 's/^%//;s/\\\\$// + / Author:/i\ +Version:| '$dtxversion' + /<.readme>/d + /^ }/d + s/ \\changes.*/Changes in version '$dtxversion':/ + s/$\\Rightarrow\$/=>/g + s/\\textbackslash/\\/g + s/\\text\(sl\|it\){\([^}]\+\)}/\/\2\//g # \textsl{...} -> /.../ + s/{\([^}]*\)}/\1/g # keep last, removes all {...} + ' >README + grep "Changes in version" README >/dev/null || die changes not detected +} + +makeall() { + grep '%<\*install>' $dtxname.dtx >/dev/null && # for self-extracting dtx files + delete+=($dtxname.ins) || + echo y |tex $dtxname.ins >/dev/null + + # install any .ttf files + mkdir -p ~/.fonts + find doc -name '*.ttf' -exec cp {} ~/.fonts \; + fc-cache ~/.fonts + + readme # create the README file + + # compile all examples + cd doc + ln -sf ../$dtxname.sty || exit 1 # use the version to be installed + for i in [0-9][0-9]?; do + if [ ! -f $i.pdf -o ! -f s$i.pdf ]; then + ./doit || exit 1 + break + fi + done + cd .. + + mk --noprint --noview $dtxname.dtx && mk -c $dtxname.dtx # make $dtxname.pdf +} + +installall() { + # install and cleanup + echo installing in $tree + + rm -rf $insttex/* $instsrc/* $instdoc/* + find doc \( -type l -o -name '*.pdf' \) -delete + cp -f $dtxname.$ext $insttex + cp -a $dtxname.{ins,dtx} $instsrc + cp -a README inst $dtxname.pdf $instdoc + mktexlsr $tree 2>/dev/null + for i in ${delete[@]}; do rm -f $i; done + cd .. + zipfile=$dtxname/$dtxname-$dtxversion.zip + rm -f $zipfile + zip -rq $zipfile $dtxname/* -x $dtxname/test\* + cd $dtxname +} + +options=$(getopt \ + -n $myname \ + -o hHV \ + -l help,Help,version \ + -- "$@" +) || exit 1 +eval set -- "$options" +while [ $# -gt 0 ]; do + case $1 in + (-h|--help) help;; + (-H|--Help) helpall;; + (-V|--version) version;; + (--) shift; break;; + (*) break;; + esac +done +[[ -z $1 ]] || die No arguments expected + +testexecs +setdir +makeall +installall -- cgit v1.2.3