From 68787289b7a0fd4331776ca4a50f19eb086e696b Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 29 Sep 2017 20:39:03 +0000 Subject: xltabular (29sep17) git-svn-id: svn://tug.org/texlive/trunk@45433 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/xltabular/Changes | 2 + .../doc/latex/xltabular/doc/xltabular-doc.bib | 24 -- .../doc/latex/xltabular/doc/xltabular-doc.pdf | Bin 24481 -> 0 bytes .../doc/latex/xltabular/doc/xltabular-doc.tex | 97 --------- .../doc/latex/xltabular/latex/xltabular.sty | 51 ----- .../doc/latex/xltabular/xltabular-doc.pdf | Bin 24481 -> 69636 bytes .../doc/latex/xltabular/xltabular-doc.tex | 242 +++++++++++++++++++-- 7 files changed, 221 insertions(+), 195 deletions(-) delete mode 100644 Master/texmf-dist/doc/latex/xltabular/doc/xltabular-doc.bib delete mode 100644 Master/texmf-dist/doc/latex/xltabular/doc/xltabular-doc.pdf delete mode 100644 Master/texmf-dist/doc/latex/xltabular/doc/xltabular-doc.tex delete mode 100644 Master/texmf-dist/doc/latex/xltabular/latex/xltabular.sty (limited to 'Master/texmf-dist/doc') diff --git a/Master/texmf-dist/doc/latex/xltabular/Changes b/Master/texmf-dist/doc/latex/xltabular/Changes index 18d0a004dd8..1fcac8c7233 100644 --- a/Master/texmf-dist/doc/latex/xltabular/Changes +++ b/Master/texmf-dist/doc/latex/xltabular/Changes @@ -1 +1,3 @@ +0.02 2017-09-28 - added optional argument for horizontal alignment + - extended documentation 0.01 2017-09-27 - first CTAN version diff --git a/Master/texmf-dist/doc/latex/xltabular/doc/xltabular-doc.bib b/Master/texmf-dist/doc/latex/xltabular/doc/xltabular-doc.bib deleted file mode 100644 index 61a0505f8fa..00000000000 --- a/Master/texmf-dist/doc/latex/xltabular/doc/xltabular-doc.bib +++ /dev/null @@ -1,24 +0,0 @@ -@ctan{ltablex, - Title = {The \texttt{ltablex} package}, - Author = {Anil Goel}, - url = {/macros/latex/contrib/ltablex/}, - version = {1.1}, - date = {2014-08-13}, -} - -@ctan{tabularx, - Title = {The \texttt{tabularx} package}, - Author = {David Carlisle}, - url = {/macros/latex/contrib/carlisle/}, - version = {2.11}, - date = {2016-02-03}, -} - -@ctan{Pak-longtable, - Title = {The \texttt{longtable} package}, - Author = {David Carlisle}, - url = {/macros/latex/required/tools/longtable.pdf}, - date = {2014-10-28}, - version = {4.11}, -} - diff --git a/Master/texmf-dist/doc/latex/xltabular/doc/xltabular-doc.pdf b/Master/texmf-dist/doc/latex/xltabular/doc/xltabular-doc.pdf deleted file mode 100644 index 3eeb578e52a..00000000000 Binary files a/Master/texmf-dist/doc/latex/xltabular/doc/xltabular-doc.pdf and /dev/null differ diff --git a/Master/texmf-dist/doc/latex/xltabular/doc/xltabular-doc.tex b/Master/texmf-dist/doc/latex/xltabular/doc/xltabular-doc.tex deleted file mode 100644 index ccf08acce59..00000000000 --- a/Master/texmf-dist/doc/latex/xltabular/doc/xltabular-doc.tex +++ /dev/null @@ -1,97 +0,0 @@ -%% $Id: xltabular-doc.tex 586 2017-09-27 17:00:55Z herbert $ -% -\listfiles -\documentclass[fontsize=11pt,DIV=14,parskip=half-]{scrartcl} -\usepackage{fontspec} -\usepackage{graphicx} -\usepackage{multido} -\usepackage[%usefilenames, - TT={Scale=0.88,FakeStretch=0.9}, - SS={Scale=0.9}, - RM={Scale=0.9}, - DefaultFeatures={Ligatures=TeX}]{lucida-otf} % support opentype math fonts -\usepackage{xltabular} -\makeatletter -\let\XLVersion\xltabular@version -\makeatother - -\usepackage{dtk-logos} % for Wikipedia W -\usepackage{ragged2e} - -\usepackage{biblatex} -\addbibresource{\jobname.bib} - -\pagestyle{headings} - -\title{Package \texttt{xltabular} \\--\\ v.~\XLVersion} -\author{Rolf Niepraschk \and Herbert Voß} -\begin{document} -\maketitle -\tableofcontents - -\section{Introduction} - -The package \texttt{ltablex} supports an environment \texttt{tabularx} with -the possiblity of pagebreaks and the same header/footer definitions as in -the package \texttt{longtable}. But the old bevaviour of the \texttt{tabularx} -environment is no more possible. - -The package \texttt{xltabular} defines an environment of the same name -which behaves like a \texttt{tabularx} as a \texttt{longtable}. In short: -it is a \texttt{longtable} with the column specifier \texttt{X}. But it leaves the -\texttt{tabularx} environment with its original behaviour. - - -\section{Examples} - -\newcommand\B{XXXXXXXXXXXXXXXXXXXXXXXXXXXX\\} -\newcommand\BB{\B\B\B\B\B\B\B\B\B\B\B\B\B\B\B} -\newcommand\BBB{\BB\BB\BB\BB} - -\listoftables - -\begin{tabularx}{\linewidth}{@{}X@{}} -\captionaboveof{table}{The original \texttt{tabularx} environment: pagebreak not possible!}\\ -\BBB -\end{tabularx} - - -\begin{xltabular}{\linewidth}{@{}X@{}} -\caption{the \texttt{xltabular} environment with \texttt{longtable} property}\\[\belowcaptionskip] -\BB\\ -Now a manuel \texttt{\textbackslash pagebreak} is used\\ -\pagebreak -\BBB -\end{xltabular} - - - -\begin{xltabular}{\linewidth}{@{}>{\ttfamily}l>{\RaggedRight}X@{}} -\caption{File endings (only for a demonstration \ldots)}\\\hline -.ext & Beschreibung\\\hline -\endfirsthead -\multicolumn{2}{@{}l}{\ldots\ \small Fortsetzung}\\\hline -.ext & Beschreibung\\\hline -\endhead -\hline -\multicolumn{2}{r@{}}{\small Fortsetzung\ldots}\\ -\endfoot -\hline -\endlastfoot -aux & (auxiliary) Hilfsdatei, enthält Querverweise usw. \\ -bbl & (bibliography) Hilfsdatei, enthält die Einträge für die Literatur\\ -bib & (bibtex) enthält die Literaturdaten\\ -blg & (bibliography log) enthält die Ausgaben eines Bib\TeX-Laufs\\ -cfg & (config) Konfigurationsdatei\\ -clo & (class options) Definitionen für die Dokumentenklasse - und die entsprechenden Klassen-Optionen\\ -\end{xltabular} - - - -\nocite{*} -\printbibliography - - -\end{document} - diff --git a/Master/texmf-dist/doc/latex/xltabular/latex/xltabular.sty b/Master/texmf-dist/doc/latex/xltabular/latex/xltabular.sty deleted file mode 100644 index 5a356850a43..00000000000 --- a/Master/texmf-dist/doc/latex/xltabular/latex/xltabular.sty +++ /dev/null @@ -1,51 +0,0 @@ -%% $Id: xltabular.sty 586 2017-09-27 17:00:55Z herbert $ -%% -%% This file is distributed under the terms of the LaTeX Project Public -%% License from CTAN archives in directory macros/latex/base/lppl.txt. -%% Either version 1.3 or, at your option, any later version. -%% -% Copyright 2017 Herbert Voss hvoss@tug.org -% Rolf Niepraschk Rolf.Nieprasch@gmx.de -%% -\def\xltabular@version{0.01 } -\ProvidesPackage{xltabular} - [2017/09/27 v\xltabular@version `xltabular' package (hv,rn)] - -\RequirePackage{tabularx} -\let\ORIGi@tabularx=\tabularx -\let\ORIGi@endtabularx=\endtabularx -\let\ORIGi@TX@endtabularx=\TX@endtabularx -% -\RequirePackage{ltablex} -\let\ORIGii@tabularx=\tabularx -\let\ORIGii@TX@endtabularx=\TX@endtabularx -% -\let\ORIG@longtable=\longtable -\let\ORIG@LT@capti@n=\LT@capti@n -% -% restore original tabularx -\let\tabularx=\ORIGi@tabularx -\let\endtabularx=\ORIGi@endtabularx -\let\TX@endtabularx=\ORIGi@TX@endtabularx -% -% define a new tabularx like the one from "ltablex" -% -\newenvironment{xltabular} - {\let\TX@endtabularx=\ORIGii@TX@endtabularx - \let\endtabularx\endxltabular - \ORIGii@tabularx} - {\def\@currenvir{tabularx}} -% -% In "longtable" Erhöhung des Zählers "table" nur durch "\caption" -\def\LT@capti@n{% - \refstepcounter{table}% - \ORIG@LT@capti@n -} -\def\longtable{% - \addtocounter{table}\m@ne - \ORIG@longtable -} - -\endinput -%% -%% End of file `xltabular.sty'. diff --git a/Master/texmf-dist/doc/latex/xltabular/xltabular-doc.pdf b/Master/texmf-dist/doc/latex/xltabular/xltabular-doc.pdf index 3eeb578e52a..bf2f53846b2 100644 Binary files a/Master/texmf-dist/doc/latex/xltabular/xltabular-doc.pdf and b/Master/texmf-dist/doc/latex/xltabular/xltabular-doc.pdf differ diff --git a/Master/texmf-dist/doc/latex/xltabular/xltabular-doc.tex b/Master/texmf-dist/doc/latex/xltabular/xltabular-doc.tex index ccf08acce59..6e37847f7dc 100644 --- a/Master/texmf-dist/doc/latex/xltabular/xltabular-doc.tex +++ b/Master/texmf-dist/doc/latex/xltabular/xltabular-doc.tex @@ -1,30 +1,56 @@ -%% $Id: xltabular-doc.tex 586 2017-09-27 17:00:55Z herbert $ +%% $Id: xltabular-doc.tex 592 2017-09-29 06:52:56Z herbert $ % \listfiles -\documentclass[fontsize=11pt,DIV=14,parskip=half-]{scrartcl} +\documentclass[paper=a4,fontsize=11pt,DIV=13,parskip=half-, + captions=tableabove,twoside=on]{scrartcl} \usepackage{fontspec} -\usepackage{graphicx} -\usepackage{multido} -\usepackage[%usefilenames, - TT={Scale=0.88,FakeStretch=0.9}, - SS={Scale=0.9}, - RM={Scale=0.9}, - DefaultFeatures={Ligatures=TeX}]{lucida-otf} % support opentype math fonts +%\usepackage[%usefilenames, +% TT={Scale=0.88,FakeStretch=0.9}, +% SS={Scale=0.9}, +% RM={Scale=0.9}, +% DefaultFeatures={Ligatures=TeX}]{lucida-otf} % support opentype math fonts +\setmainfont{AccanthisADFStdNo3}[ + UprightFont =*-Regular, + BoldFont =*-Bold, + ItalicFont =*-Italic, + BoldItalicFont=*-BoldItalic, +] +\setsansfont{GilliusADF}[ + UprightFont =*-Regular, + BoldFont =*-Bold, + ItalicFont =*-Italic, + BoldItalicFont=*-BoldItalic, +] +\setmonofont{Anonymous Pro}[Scale=MatchLowercase,FakeStretch=0.9] + +\usepackage[english]{babel} +\usepackage{scrlayer-scrpage} +\automark[section]{section} +\automark*[subsection]{} +\pagestyle{scrheadings} + +\usepackage{selnolig} +\nolig{oe}{o|e} + \usepackage{xltabular} \makeatletter \let\XLVersion\xltabular@version \makeatother +\usepackage{fancyvrb} +\usepackage{blindtext} \usepackage{dtk-logos} % for Wikipedia W \usepackage{ragged2e} -\usepackage{biblatex} +\usepackage[bibstyle=dtk]{biblatex} \addbibresource{\jobname.bib} -\pagestyle{headings} +\raggedbottom +\usepackage[colorlinks,linktocpage]{hyperref} +\newcommand*\cs[1]{\texttt{\textbackslash#1}} \title{Package \texttt{xltabular} \\--\\ v.~\XLVersion} -\author{Rolf Niepraschk \and Herbert Voß} +\author{Rolf Niepraschk\thanks{Rolf.Niepraschk@gmx.de} \and Herbert Voß\thanks{hvoss@tug.org}} \begin{document} \maketitle \tableofcontents @@ -41,32 +67,158 @@ which behaves like a \texttt{tabularx} as a \texttt{longtable}. In short: it is a \texttt{longtable} with the column specifier \texttt{X}. But it leaves the \texttt{tabularx} environment with its original behaviour. +The syntax of the environment is similiar to the one of \texttt{tabularx}: + +\begin{verbatim} +\begin{xltabular}[hPos]{width}{ l X ...} +\caption{...\label{...}}\\ +tabular body +\end{xltabular} +\end{verbatim} + +For the optional argument \texttt{hPos} (horizontal position) the values \texttt{l}, +\texttt{r} and \texttt{c} (default) +are possible. The environment \texttt{xltabular} uses \texttt{longtable} for +typesetting the tabular. The original \texttt{longtable} increases the counter +\texttt{table} in any case, with or without a caption. This is not the case +with \texttt{xltabular}: no \cs{caption}, no counter change. + + + \section{Examples} -\newcommand\B{XXXXXXXXXXXXXXXXXXXXXXXXXXXX\\} +\newcommand\B{Some nonsense text which fills at least one line + of a tabular called nonsense tabular with text.\\} \newcommand\BB{\B\B\B\B\B\B\B\B\B\B\B\B\B\B\B} \newcommand\BBB{\BB\BB\BB\BB} \listoftables - -\begin{tabularx}{\linewidth}{@{}X@{}} -\captionaboveof{table}{The original \texttt{tabularx} environment: pagebreak not possible!}\\ -\BBB + +\markboth{Examples}{} +\vspace{1cm} + + +\subsection{The standard \texttt{tabularx} environment} + +\begin{Verbatim}[frame=lines] +\captionaboveof{table}{Using the original \texttt{tabularx} environment: + a pagebreak not possible! This is the reason why the tabular moves + to the next page.} +\begin{tabularx}{0.75\linewidth}{@{} lX @{}} +left column & \blindtext\\ +l & \blindtext\\ +left column & \blindtext\\ +l & \blindtext\\ \end{tabularx} +\end{Verbatim} +\captionaboveof{table}{Using the original \texttt{tabularx} environment: + a pagebreak not possible! This is the reason why the tabular moves + to the next page.} +\begin{tabularx}{0.75\linewidth}{@{} lX @{}} + left column & \blindtext\\ + l & \blindtext\\ + left column & \blindtext\\ + l & \blindtext\\ +\end{tabularx} -\begin{xltabular}{\linewidth}{@{}X@{}} -\caption{the \texttt{xltabular} environment with \texttt{longtable} property}\\[\belowcaptionskip] + +%\begin{tabularx}{\linewidth}{@{}X@{}} +%\captionaboveof{table}{Another example for the original \texttt{tabularx} environment: +%%%pagebreak not possible!}\\ +%\BBB +%\end{tabularx} + +\clearpage + +\subsection{The new environment \texttt{xltabular}} +For the demonstration we use a tabular with only one X column. There is no difference +to an example with more or other column specifiers. + +\begin{Verbatim}[frame=lines] +\begin{xltabular}{\linewidth}{@{} X @{}} +\caption{the \texttt{xltabular} environment with \texttt{longtable} + property}\\[\belowcaptionskip] +\BB\\ +Now a manuel \cs{pagebreak} is used and on the +following page an automatic pagebreak is done by \texttt{longtable}.\\ + +\pagebreak + +\BBB +\end{xltabular} +\end{Verbatim} + +\begin{xltabular}{\linewidth}{@{} X @{}} +\caption{the \texttt{xltabular} environment with \texttt{longtable} + property}\\[\belowcaptionskip] \BB\\ -Now a manuel \texttt{\textbackslash pagebreak} is used\\ +Now a manuel \cs{pagebreak} is used and on the +following page an automatik pagebreak is done by \texttt{longtable}.\\ + \pagebreak + \BBB \end{xltabular} +The command \cs{BBB} does nothing else then printing a lot of lines +with nonsense. + + +\setcapwidth{0.75\linewidth} + +\begin{Verbatim}[frame=lines] +\begin{xltabular}[l]{0.75\linewidth}{@{} lX @{}} +\caption{The \texttt{xltabular} environment with \texttt{longtable} property + and left aligned by setting the optional argument.}\\[\belowcaptionskip]\hline +Left column & At first a line with some nonsense text to show how long this line is. + The caption has the same width as the text.\\ +left column & \blindtext\\ +left column & \blindtext\\ +left column & \blindtext\\ +left column & \blindtext\\\hline +\end{xltabular} +\end{Verbatim} + + + +\begin{xltabular}[l]{0.75\linewidth}{@{} lX @{}} + \caption{The \texttt{xltabular} environment with \texttt{longtable} property + and left aligned by setting the optional argument.}\\[\belowcaptionskip]\hline + Left column & At first a line with some nonsense text to show how long this line is. + The caption has the same width as the text.\\ + left column & \blindtext\\ + left column & \blindtext\\ + left column & \blindtext\\ + left column & \blindtext\\\hline +\end{xltabular} + + + + +\subsection{\texttt{tabularx} without a caption} + +Here comes another \texttt{tabularx} but without a caption. It should +\emph{not} increase the \texttt{table} counter. The following tabular +in the next section should have the correct number! + +\begin{tabularx}{\linewidth}{@{} >{\ttfamily}l>{\RaggedRight}X @{}}\hline +.ext & Beschreibung\\\hline + aux & (auxiliary) Hilfsdatei, enthält Querverweise usw. \\ + bbl & (bibliography) Hilfsdatei, enthält die Einträge für die Literatur\\ + bib & (bibtex) enthält die Literaturdaten\\ + blg & (bibliography log) enthält die Ausgaben eines Bib\TeX-Laufs\\ + cfg & (config) Konfigurationsdatei\\ + clo & (class options) Definitionen für die Dokumentenklasse und die entsprechenden + Klassen-Optionen\\ +\end{tabularx} -\begin{xltabular}{\linewidth}{@{}>{\ttfamily}l>{\RaggedRight}X@{}} +\subsection{\texttt{xltabular} with header/footer definitions} + +\begin{Verbatim}[frame=lines] +\begin{xltabular}{\linewidth}{@{} >{\ttfamily}l >{\RaggedRight}X @{}} \caption{File endings (only for a demonstration \ldots)}\\\hline .ext & Beschreibung\\\hline \endfirsthead @@ -83,8 +235,52 @@ bbl & (bibliography) Hilfsdatei, enthält die Einträge für die Literatur\\ bib & (bibtex) enthält die Literaturdaten\\ blg & (bibliography log) enthält die Ausgaben eines Bib\TeX-Laufs\\ cfg & (config) Konfigurationsdatei\\ -clo & (class options) Definitionen für die Dokumentenklasse - und die entsprechenden Klassen-Optionen\\ +clo & (class options) Definitionen für die Dokumentenklasse und die entsprechenden +[...] +Klassen-Optionen\\ +\end{xltabular} +\end{Verbatim} + +\begin{xltabular}{\linewidth}{@{} >{\ttfamily}l >{\RaggedRight}X @{}} +\caption{File endings (only for a demonstration \ldots)}\\\hline +.ext & Beschreibung\\\hline +\endfirsthead +\multicolumn{2}{@{}l}{\ldots\ \small Fortsetzung}\\\hline +.ext & Beschreibung\\\hline +\endhead +\hline +\multicolumn{2}{r@{}}{\small Fortsetzung\ldots}\\ +\endfoot +\hline +\endlastfoot + aux & (auxiliary) Hilfsdatei, enthält Querverweise usw. \\ + bbl & (bibliography) Hilfsdatei, enthält die Einträge für die Literatur\\ + bib & (bibtex) enthält die Literaturdaten\\ + blg & (bibliography log) enthält die Ausgaben eines Bib\TeX-Laufs\\ + cfg & (config) Konfigurationsdatei\\ + clo & (class options) Definitionen für die Dokumentenklasse und die entsprechenden + Klassen-Optionen\\ + aux & (auxiliary) Hilfsdatei, enthält Querverweise usw. \\ + bbl & (bibliography) Hilfsdatei, enthält die Einträge für die Literatur\\ + bib & (bibtex) enthält die Literaturdaten\\ + blg & (bibliography log) enthält die Ausgaben eines Bib\TeX-Laufs\\ + cfg & (config) Konfigurationsdatei\\ + clo & (class options) Definitionen für die Dokumentenklasse und die entsprechenden + Klassen-Optionen\\ + aux & (auxiliary) Hilfsdatei, enthält Querverweise usw. \\ + bbl & (bibliography) Hilfsdatei, enthält die Einträge für die Literatur\\ + bib & (bibtex) enthält die Literaturdaten\\ + blg & (bibliography log) enthält die Ausgaben eines Bib\TeX-Laufs\\ + cfg & (config) Konfigurationsdatei\\ + clo & (class options) Definitionen für die Dokumentenklasse und die entsprechenden + Klassen-Optionen\\ + aux & (auxiliary) Hilfsdatei, enthält Querverweise usw. \\ + bbl & (bibliography) Hilfsdatei, enthält die Einträge für die Literatur\\ + bib & (bibtex) enthält die Literaturdaten\\ + blg & (bibliography log) enthält die Ausgaben eines Bib\TeX-Laufs\\ + cfg & (config) Konfigurationsdatei\\ + clo & (class options) Definitionen für die Dokumentenklasse und die entsprechenden + Klassen-Optionen\\ \end{xltabular} -- cgit v1.2.3