summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/xltabular
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-09-29 20:39:03 +0000
committerKarl Berry <karl@freefriends.org>2017-09-29 20:39:03 +0000
commit68787289b7a0fd4331776ca4a50f19eb086e696b (patch)
treec51ff15915ac58da419c2686ec075af2bf0edd30 /Master/texmf-dist/doc/latex/xltabular
parentc481150d3ae193500b45a1ff37f38fc2a7ab998f (diff)
xltabular (29sep17)
git-svn-id: svn://tug.org/texlive/trunk@45433 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/xltabular')
-rw-r--r--Master/texmf-dist/doc/latex/xltabular/Changes2
-rw-r--r--Master/texmf-dist/doc/latex/xltabular/doc/xltabular-doc.bib24
-rw-r--r--Master/texmf-dist/doc/latex/xltabular/doc/xltabular-doc.pdfbin24481 -> 0 bytes
-rw-r--r--Master/texmf-dist/doc/latex/xltabular/doc/xltabular-doc.tex97
-rw-r--r--Master/texmf-dist/doc/latex/xltabular/latex/xltabular.sty51
-rw-r--r--Master/texmf-dist/doc/latex/xltabular/xltabular-doc.pdfbin24481 -> 69636 bytes
-rw-r--r--Master/texmf-dist/doc/latex/xltabular/xltabular-doc.tex242
7 files changed, 221 insertions, 195 deletions
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
--- a/Master/texmf-dist/doc/latex/xltabular/doc/xltabular-doc.pdf
+++ /dev/null
Binary files 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
--- a/Master/texmf-dist/doc/latex/xltabular/xltabular-doc.pdf
+++ b/Master/texmf-dist/doc/latex/xltabular/xltabular-doc.pdf
Binary files 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}