diff options
author | Karl Berry <karl@freefriends.org> | 2013-09-26 22:25:30 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2013-09-26 22:25:30 +0000 |
commit | 1297f178ba3a3f477c3af759f9a281c91e4e79de (patch) | |
tree | d30d6e4a95b6e6c8ee1144b58a4ed0b2b0778c3e /Master/texmf-dist/doc/latex/csvsimple/csvsimple.tex | |
parent | fbcbe9b36240e101914f4b687e609ef5e03b3747 (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.tex | 86 |
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} |