summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/csvsimple/csvsimple.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-09-26 22:25:30 +0000
committerKarl Berry <karl@freefriends.org>2013-09-26 22:25:30 +0000
commit1297f178ba3a3f477c3af759f9a281c91e4e79de (patch)
treed30d6e4a95b6e6c8ee1144b58a4ed0b2b0778c3e /Master/texmf-dist/doc/latex/csvsimple/csvsimple.tex
parentfbcbe9b36240e101914f4b687e609ef5e03b3747 (diff)
csvsimple (26sep13)
git-svn-id: svn://tug.org/texlive/trunk@31777 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/csvsimple/csvsimple.tex')
-rw-r--r--Master/texmf-dist/doc/latex/csvsimple/csvsimple.tex86
1 files changed, 76 insertions, 10 deletions
diff --git a/Master/texmf-dist/doc/latex/csvsimple/csvsimple.tex b/Master/texmf-dist/doc/latex/csvsimple/csvsimple.tex
index 6d9ea7e7b6c..aff18dbd3a9 100644
--- a/Master/texmf-dist/doc/latex/csvsimple/csvsimple.tex
+++ b/Master/texmf-dist/doc/latex/csvsimple/csvsimple.tex
@@ -1,9 +1,9 @@
% \LaTeX-Main\
-%% The LaTeX package csvsimple - version 1.06 (2012/11/08)
+%% The LaTeX package csvsimple - version 1.07 (2013/09/25)
%% csvsimple.sty: Simple LaTeX CSV file processing
%%
%% -------------------------------------------------------------------------------------------
-%% Copyright (c) 2008-2012 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
+%% Copyright (c) 2008-2013 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
%% -------------------------------------------------------------------------------------------
%%
%% This work may be distributed and/or modified under the
@@ -51,10 +51,37 @@
\setlength{\bibitemsep}{\smallskipamount}
\addbibresource{\jobname.bib}
-\usepackage[documentation]{tcolorbox}
+\usepackage[most,documentation]{tcolorbox}
+\tcbset{skin=enhanced}
\usepackage{longtable}
\usepackage{csvsimple}
+
+\lstdefinestyle{mydocumentation}{style=tcbdocumentation,
+ classoffset=0,
+ texcsstyle=\color{blue},
+ % LaTeX and other packages
+ moretexcs={arrayrulecolor,draw,includegraphics,ifthenelse,isodd,lipsum,path,pgfkeysalso},
+ classoffset=1,
+ moretexcs={%
+ csvset,csvreader,csvautotabular,csvloop,csvautolongtable,csvstyle,
+ csvnames,csvheadset,csviffirstrow,csvifoddrow,csvfilteraccept,
+ csvfilterreject,csvline,thecsvrow,thecsvinputline,csvlinetotablerow,
+ },
+ texcsstyle=\color{Definition}\bfseries,
+ classoffset=2,
+ keywordstyle=\color{Option}\bfseries,
+ % option list
+ morekeywords={%
+ },
+ classoffset=0% restore default
+ }
+
+\tcbset{documentation listing style=mydocumentation,%
+ docexample/.style={enhanced,colframe=Navy!50!ExampleFrame,colback=Navy!5!ExampleBack,fontlower=\footnotesize,
+ bicolor,colbacklower=ExampleBack!5!white,drop fuzzy shadow},
+}
+
\tcbmakedocSubKey{docCsvKey}{csv}
\newcommand{\csvlisting}[1]{%
@@ -72,17 +99,21 @@
pdfkeywords={csv file, comma separated values, key value syntax}
}
-\def\version{1.06}%
-\def\datum{2012/11/08}%
+\def\version{1.07}%
+\def\datum{2013/09/25}%
\makeindex
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{document}
\begin{center}
-\vspace*{5mm}\par
-{\bfseries\LARGE The \texttt{csvsimple} package\par}
-{\large Version \version\ (\datum)\par}\bigskip
+\vspace*{5mm}
+\begin{tcolorbox}[enhanced,
+ center upper,width=10cm,boxrule=0.4pt,
+ colback=white,colframe=black!50!yellow,drop fuzzy midday shadow=black!50!yellow]
+{\bfseries\LARGE The \texttt{csvsimple} package\par}\medskip
+{\large Manual for version \version\ (\datum)\par}
+\end{tcolorbox}\bigskip
{\large Thomas F.~Sturm%
\footnote{Prof.~Dr.~Dr.~Thomas F.~Sturm, Institut f\"{u}r Mathematik und Informatik,
Universit\"{a}t der Bundeswehr M\"{u}nchen, D-85577 Neubiberg, Germany;
@@ -101,7 +132,7 @@
\tableofcontents
-
+\enlargethispage*{1cm}
\section{Introduction}%
The |csvsimple| package is applied to the processing of
CSV\footnote{CSV file: file with comma separated values.} files.
@@ -128,7 +159,7 @@ The package |csvsimple| loads the packages
\subsection{First Steps}
Every line of a processable CSV file has to contain an identical amount of
-comma separated values. The curly braces |{}| of \TeX\ groups can be used
+comma\footnote{See \refKey{/csv/separator} for other separators than comma.} separated values. The curly braces |{}| of \TeX\ groups can be used
to mask a block which may contain commas not to be processed as separators.
The first line of such a CSV file is usually but not necessarily a header line
@@ -852,6 +883,41 @@ Additionally, the commands defined by the key values of
\end{docCsvKey}
+\begin{docCsvKey}{separator}{=\meta{sign}}{no default, initially |comma|}
+ \catcode `|=12
+ Sets the \meta{sign} which is treates as separator between the data values
+ of a data line. Feasible values are:
+ \begin{itemize}
+ \item\texttt{comma}: This is the initial value with '\texttt{,}' as separator.
+ \item\texttt{semicolon}: Sets the separator to '\texttt{;}'.
+\begin{dispExample}
+% \usepackage{tcolorbox} for tcbverbatimwrite
+\begin{tcbverbatimwrite}{testsemi.csv}
+ name;givenname;matriculation;gender;grade
+ Maier;Hans;12345;m;1.0
+ Huber;Anna;23456;f;2.3
+ Wei\ss{}b\"{a}ck;Werner;34567;m;5.0
+\end{tcbverbatimwrite}
+
+\csvautotabular[separator=semicolon]{testsemi.csv}
+\end{dispExample}
+
+ \item\texttt{pipe}: Sets the separator to '\texttt{|}'.
+\begin{dispExample}
+% \usepackage{tcolorbox} for tcbverbatimwrite
+\begin{tcbverbatimwrite}{pipe.csv}
+ name|givenname|matriculation|gender|grade
+ Maier|Hans|12345|m|1.0
+ Huber|Anna|23456|f|2.3
+ Wei\ss{}b\"{a}ck|Werner|34567|m|5.0
+\end{tcbverbatimwrite}
+
+\csvautotabular[separator=pipe]{pipe.csv}
+\end{dispExample}
+ \end{itemize}
+\end{docCsvKey}
+
+\clearpage
\begin{docCsvKey}{file}{=\meta{file name}}{no default, initially |unknown.csv|}
Sets the \meta{file name} of the CSV file to be processed.
\end{docCsvKey}