diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/ticket/manual.tex')
| -rw-r--r-- | Master/texmf-dist/doc/latex/ticket/manual.tex | 436 |
1 files changed, 393 insertions, 43 deletions
diff --git a/Master/texmf-dist/doc/latex/ticket/manual.tex b/Master/texmf-dist/doc/latex/ticket/manual.tex index 414474bd64c..8b39dfece1d 100644 --- a/Master/texmf-dist/doc/latex/ticket/manual.tex +++ b/Master/texmf-dist/doc/latex/ticket/manual.tex @@ -1,7 +1,11 @@ \documentclass[a4paper,KOMA,landscape]{powersem} \usepackage[stmo,button,display]{ifmslide} +%\usepackage[stmo,button]{ifmslide} +%\usepackage[draft]{ifmslide} +\definecolor{background}{gray}{.9} +%\nobuttons %% user definitions \newcommand{\ticket}{{\code{ticket.sty}}} \newcommand{\bs}{{\mtt\\}} @@ -18,55 +22,65 @@ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \begin{document} -\slidepagestyle{panel} \panelposition{bottom} \pageTransitionDissolve \sffamily -\orgname{TU Darmstadt -- Institute of Mechanics -- AG4} - \title{\begin{minipage}[t]{0.98\textwidth}\begin{center} - {\mdseries \ticket{} v0.3c October 10, 2000}\\[1ex] - Making labels, visting cards, pins with \LaTeX\\ + {\mdseries \ticket{} v0.4b November 30, 2010}\\[1ex] + Making labels, visiting cards, pins and flash-cards with \LaTeX\\[1ex] A short introduction \end{center}\end{minipage}} -\author{\scalebox{1}[1.3]{Thomas Emmel}} +\author{\scalebox{1}[1.1]{Thomas Emmel} \href{mailto:thomas@family-emmel.de}% + {thomas@family-emmel.de}} -\address{\href{mailto:emmel@mechanik.tu-darmstadt.de}% - {emmel@mechanik.tu-darmstadt.de}} -\orgurl{http://coulomb.mechanik.tu-darmstadt.de/} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\slidepagestyle{empty} +\releasebutton \buttonsize(10mm,4mm)(8,8) \freebutton(263,180)[h] \begin{slide} \maketitle \end{slide} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\slidepagestyle{empty} -\panelposition{outsidebottom} \hidebackground \pageTransitionReplace \centerslidesfalse \begin{slide} \section{A short introduction} - \ticket{} provides an easy to handle interface to produce - visiting cards, labels for your files, stickers, pins and + + \ticket{} provides a simple interface to produce + visiting (or calling) cards, labels for your files, stickers, pins and other stuff for your office, conferences etc.\\[2ex] All you need is a definition of your \lq{}ticket\rq{} included in a ticket definition file (\code{.tdf}),\\ $\rightarrowtail$ see \hyperlink{tdf}{ticket definition file}\\ and the two commands \code{\bs{}ticketdefault} and \code{\bs{}ticket}.\\ $\rightarrowtail$ see \hyperlink{ticket}{how to fill your ticket}\\[2ex] - What you get is shown in some examples:\\ + See these examples to get an idea what you can get:\\ $\rightarrowtail$ \href{ex_file.pdf}{\code{ex\_file}} back labels for your files...\\ $\rightarrowtail$ \href{ex_pin.pdf}{\code{ex\_pin}} pins for a conference...\\ - $\rightarrowtail$ \href{ex_vcard.pdf}{\code{ex\_vcard}} visiting-cards...\\ + $\rightarrowtail$ \href{ex_vcard.pdf}{\code{ex\_vcard}} visiting-cards (also business cards, name cards...)\\ + $\rightarrowtail$ \href{ex_marks.pdf}{\code{ex\_marks}} different markers used...\\ + $\rightarrowtail$ \href{ex_flashcard.pdf}{\code{ex\_flashcard}} flash-cards, try it...\\ + $\rightarrowtail$ \href{ex_flashcard_dup.pdf}{\code{ex\_flashcard\_dup}} in duplex mode\\ + $\rightarrowtail$ \href{ex_flashcard_rm.pdf}{\code{ex\_flashcard\_rm}} in rows\\ +\end{slide} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\begin{slide} + \section{How to use it} + + Just add this line to the header of your latex-file: + + \code{\bs{}usepackage[{\itshape tdf-file,other options}]\{ticket\}} + + Use the letter or article documentclass and + set up the paper-size that you need. \end{slide} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \begin{slide} - \section{ticket definition file}\hypertarget{tdf}{} -A sample ticket definition (\code{lz1680.tdf}) for a product of the german company -\lq{}LEITZ\rq{} is: -\begin{center} + \section{The ticket definition file}\hypertarget{tdf}{} +A sample ticket definition (\code{lz1680.tdf}) for a \lq{}LEITZ\rq{}-product is:\\[-4ex] +\begin{quote} \begin{minipage}[t]{0.5\textwidth} {\scriptsize \begin{verbatim} @@ -87,35 +101,36 @@ A sample ticket definition (\code{lz1680.tdf}) for a product of the german compa \end{verbatim} } \end{minipage} -\end{center} +\end{quote} The meaning of \code{\bs{}unitlength} is obvious, \code{\bs{}hoffset} and -\code{\bs{}voffset} are used to adjust the output. +\code{\bs{}voffset} are used to adjust the printed output. \code{\bs{}ticketNumbers\{n$_x$\}\{n$_y$\}} are the number of the tickets on the sheet in horizontal and vertical direction. \code{\bs{}ticketSize\{width\}\{height\}} is the size of one ticket and -\code{\bs{}ticketDistance\{dist$_x$\}\{dist$_y$\}} are existing distances +\code{\bs{}ticketDistance\{dist$_x$\}\{dist$_y$\}} are spaces between the tickets. \end{slide} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \begin{slide} - \section{missing ticket definition file} -If you like to test a new ticket definition or there is no need to -provide such a file \ticket{} assumes default values which can be + \section{Missing the ticket definition file} +If you like to test a new ticket definition or you like to create only a single output without reusing those definitions anymore, \ticket{} assumes default values which can be redefined in your file.\\ -Simply call \ticket{} without any ticket definition:\\ -\code{\bs{}usepackage[other options]\{ticket\}} +Simply call \ticket{} without any ticket definition: + +\code{\bs{}usepackage[{\itshape other options}]\{ticket\}} + +and add your definitions directly to the head of the file after loading ticket.sty. \end{slide} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \begin{slide} - \section{how to fill your ticket}\hypertarget{ticket}{} - \ticket{} opens a picture-environment for all tickets. You can put things - in this picture with \code{\bs{}ticketdefault} and \code{\bs{}ticket}. - Both commands have one argument.\\ - \code{\bs{}ticketdefault} is used to put a default background to your - ticket, which will not changed for all tickets. - You have to \code{\bs{}renewcommand} \code{\bs{}ticketdefault} every time - you change this background:\\[-5ex] - \begin{center} + \section{How to fill your ticket}\hypertarget{ticket}{}% + \ticket{} enables a picture-environment for all tickets. + You can put things + into this picture with \code{\color{red}\bs{}ticketdefault} and \code{\color{red}\bs{}ticket}. + Both commands offer one argument.\\ + \code{\color{red}\bs{}ticketdefault} is used to put a default and unique background to your ticket, that will be -- of course -- not changed for all tickets unless + you change it with \code{\bs{}renewcommand}:\\[-5ex] + \begin{quote} \begin{minipage}[t]{.5\textwidth} {\scriptsize \begin{verbatim} @@ -127,11 +142,11 @@ Simply call \ticket{} without any ticket definition:\\ \normalsize } \end{minipage} - \end{center} - \code{\bs{}ticket} is used to provide the content which will be changed + \end{quote} + \code{\color{red}\bs{}ticket} is used to provide the content which will be changed for the individual tickets. The simplest way to do that is to define a new - command like this: - \begin{center} + command like this:\\[-5ex] + \begin{quote} \begin{minipage}[t]{0.5\textwidth} {\scriptsize \begin{verbatim} @@ -142,15 +157,350 @@ Simply call \ticket{} without any ticket definition:\\ \end{verbatim} } \end{minipage} - \end{center} + \end{quote} +\end{slide} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\def\cross{% + \begin{picture}(0,0)% + \put(-2,0){\line(1,0){4}}\put(0,-2){\line(0,1){4}}% + \end{picture}}% +\begin{slide} + \section{Additional Options} +Most of the options other than the tdf-file are used to create marks +or decorations around the ticket:\\ +\begin{picture}(0,0)(-350,10)\color{red} + \put(0,0){\cross}% + \put(0,10){\cross}% + \put(20,0){\cross}% + \put(20,10){\cross}% +\end{picture}% +\begin{picture}(0,0)(-380,10)\color{red} + \put(0,0){\cross}% + \put(0,10){\cross}% + \put(20,0){\cross}% + \put(20,10){\cross}% +\end{picture}% +{\color{red}\bfseries crossmark \\} +Add a cross at all four corners of the ticket\\ +\begin{picture}(0,0)(-350,10)\color{red} + \put(0,0){\circle{2}}% + \put(0,10){\circle{2}}% + \put(20,0){\circle{2}}% + \put(20,10){\circle{2}}% +\end{picture}% +\begin{picture}(0,0)(-380,10)\color{red} + \put(0,0){\circle{2}}% + \put(0,10){\circle{2}}% + \put(20,0){\circle{2}}% + \put(20,10){\circle{2}}% +\end{picture}% +{\color{red}\bfseries circlemark \\} +Add a circle at all four corners\\ +\begin{picture}(0,0)(-350,10)\color{red} + \put(-1,0){\line(-1,0){2}} + \put(0,-1){\line(0,-1){2}} + \put(-1,10){\line(-1,0){2}} + \put(0,11){\line(0,1){2}} + \put(21,0){\line(1,0){2}} + \put(20,-1){\line(0,-1){2}} + \put(21,10){\line(1,0){2}} + \put(20,11){\line(0,1){2}} +\end{picture}% +\begin{picture}(0,0)(-380,10)\color{red} + \put(-1,0){\line(-1,0){2}} + \put(0,-1){\line(0,-1){2}} + \put(-1,10){\line(-1,0){2}} + \put(0,11){\line(0,1){2}} + \put(21,0){\line(1,0){2}} + \put(20,-1){\line(0,-1){2}} + \put(21,10){\line(1,0){2}} + \put(20,11){\line(0,1){2}} +\end{picture}% +{\color{red}\bfseries emptycrossmark \\} +A crossmark where the part of the cross inside the ticket is not visible\\ +\begin{picture}(0,0)(-350,10)\color{red} + \put(-1,0){\line(-1,0){2}} + \put(0,-1){\line(0,-1){2}} + \put(-1,10){\line(-1,0){2}} + \put(0,11){\line(0,1){2}} + \put(20,-1){\line(0,-1){2}} + \put(20,11){\line(0,1){2}} +\end{picture}% +\begin{picture}(0,0)(-380,10)\color{red} + \put(0,-1){\line(0,-1){2}} + \put(0,11){\line(0,1){2}} + \put(21,0){\line(1,0){2}} + \put(20,-1){\line(0,-1){2}} + \put(21,10){\line(1,0){2}} + \put(20,11){\line(0,1){2}} +\end{picture}% +{\color{red}\bfseries cutmark \\} +Just add cutmarks at the outer region of the page\\ +\begin{picture}(0,0)(-350,10)\color{red} + \put(0,0){\line(0,1){10}} + \put(0,0){\line(1,0){20}} + \put(20,10){\line(-1,0){20}} + \put(20,10){\line(0,-1){10}} +\end{picture}% +\begin{picture}(0,0)(-380,10)\color{red} + \put(0,0){\line(0,1){10}} + \put(0,0){\line(1,0){20}} + \put(20,10){\line(-1,0){20}} + \put(20,10){\line(0,-1){10}} +\end{picture}% +{\color{red}\bfseries boxed \\} +Add a frame around each ticket\\ +The option {\color{red}\bfseries rowmode} creates the tickets in rows instead of columns, +which might be useful in some cases. +\end{slide} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\begin{slide} + \section{Special commands} +You can add additional page-breaks with \code{\bs{}newpage\bs{}ticketreset}. This clears the ticket-buffers and sets the corresponding values to initial values. + +This can be used if you create a handful of tickets multiple times. + +The command \code{\bs{}backside} is useful for flash-cards, see the use-cases below. +\end{slide} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\begin{slide} + \section{Organising and reading input} + In general it is a good idea to create a file that contains all definitions and the whole latex-setup and a second file that contains only the data that you like to print which can be referenced by \code{\bs{}input}. + +For example, if you reference a huge database of names of people which are used for the pins of a conference, you can easily write a script (perl, python...) that extracts the data to a file that is itself latex-formated with a \code{\bs{}myticket\{ \}\{ \}\{ \}} on each line. + +Sometimes -- of course -- you only have to print only a small amount of data and all data can easily be written to a single file. + +Sometimes a small generator-function can help to create numbers on tickets: + +\begin{quote} + \begin{minipage}[t]{0.5\textwidth} + {\scriptsize +\begin{verbatim} +\newcounter{numcards} +... +\begin{document} +... +\whiledo{\thenumcards<25}{\stepcounter{numcards}\acard{\thenumcards}}% +\end{verbatim} + } + \end{minipage} +\end{quote} + +\end{slide} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\begin{slide} + \section{Use-cases} + Some examples were referenced at the beginning of this manual. I will finish this short introduction with an overview of special examples and their implementations: + +\subsection{Files and pins} +This is a simple example for your files. The same applies to pins. Start with a \code{\bs{}ticketdefault}, with this background: +\begin{quote} + \begin{minipage}[t]{0.5\textwidth} + {\scriptsize +\begin{verbatim} +\renewcommand{\ticketdefault}{% + \put(155,5){\begin{sideways}% + \includegraphics[width=35mm]{ifmlogoc}\end{sideways}}% + \put(150,50){\begin{rotate}{180}\Huge C O M P U T E R\end{rotate}}% +} +\end{verbatim} + } + \end{minipage} +\end{quote} +\end{slide} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\begin{slide} +\vspace*{10mm} +Now, create the content of the \code{\bs{}ticket} which differs: +\begin{quote} + \begin{minipage}[t]{0.5\textwidth} + {\scriptsize +\begin{verbatim} +\newcommand{\filelabel}[3]{\ticket{% + \put(33,48){\begin{sideways}\bfseries\Large#1\end{sideways}}% + \put(43,5){\begin{sideways}% + \begin{minipage}[t]{50mm}% + {\bfseries\large#2}\\[2ex]\large#3% + \end{minipage}% + \end{sideways}}% +}} +\end{verbatim} + } + \end{minipage} +\end{quote} + +And fill the tickets: +\begin{quote} + \begin{minipage}[t]{0.5\textwidth} + {\scriptsize +\begin{verbatim} +\begin{document} +... +\filelabel{1}{\LaTeX{} - styles}{Standard styles\\Own styles\\% + \hspace*{5mm}\bfseries ifmslide\\\hspace*{5mm}\bfseries ticket}% +... +\end{verbatim} + } + \end{minipage} +\end{quote} +\end{slide} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\begin{slide}\vspace*{-4mm} +\subsection{Visiting-cards} +In this example, the \code{\bs{}ticketdefault} is empty, since we need a front and and background that differs: +\begin{quote} + \begin{minipage}[t]{0.5\textwidth} + {\scriptsize +\begin{verbatim} +\renewcommand{\ticketdefault}{}% + +\newcommand{\vcardfront}[5]{\ticket{% + \put( 63, 5){\includegraphics[width=40mm,angle=90,origin=bl]{ifmlogoc}} + \put( 63.2, 2){\color{uni}your logo} + \put( 5, 13){\color{uni}\line(1,0){56}} + \put( 7, 10){\small your company} + \put( 7,6.5){\small street 1}\put( 7, 3){\small xxxxx city and state} + \put( 7, 24){\small phone:}\put( 7, 20){\small fax:} + \put(6,40){\bfseries\LARGE #1} + \put(7,36){#2}\put(15,24){\small #3}\put(15,20){\small #4}\put( 7,16){\small #5} + }} + +\newcommand{\vcardback}[1]{\ticket{% + \put( 7, 26){\small private:} + \put( 5, 23){\color{uni}\line(1,0){56}} + \put( 7,19){\small% + \begin{minipage}[t]{50mm}{#1}\hss\end{minipage}}% +}} +\end{verbatim} + } + \end{minipage} +\end{quote} +\end{slide} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\begin{slide}\vspace*{10mm} +And fill the tickets: +\begin{quote} + \begin{minipage}[t]{0.5\textwidth} + {\scriptsize +\begin{verbatim} +% a counter, which makes life easier... +\newcounter{numcards} + +\begin{document} +... +% ten cards for the front +\whiledo{\thenumcards<10}{% + \stepcounter{numcards}% + \vcardfront{Mr. X}{Degree/Profession}{+YY/XXXX/ZZZ ZZ ZZ}{+YY/XXXX/ZZZ ZZ ZZ} + {yourmail@your-provider.xxx}} +\setcounter{numcards}{0} +% and ten for the backside +\whiledo{\thenumcards<10}{% + \stepcounter{numcards}% + \vcardback{phone: ---/HH HH HHH\\fax: ---/HH HH HHH\\homestreet 7\\everywhere}} +... +\end{verbatim} + } + \end{minipage} +\end{quote} +\end{slide} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\begin{slide}\vspace*{-4mm} +\subsection{Flashcards} +In this case we work with two different \code{\bs{}ticket}-definitions since we have a file +with two different commands. However, this can be changed according to your taste: +\begin{quote} + \begin{minipage}[t]{0.5\textwidth} + {\scriptsize +\begin{verbatim} +% now what do you like to put in your ticket +\newcommand{\card}[2]{\ticket{% + \put(32.5,15){\makebox[0mm]{\centering{\huge{\textbf{#1}}}}} + }} +\newcommand{\raiz}[3]{\ticket{% + \put(2,31){{$\sqrt{\enspace}$}} + \put(32.5,15){\makebox[0mm]{{\huge{\textit{{ #1 }}}}}} +}} +\end{verbatim} + } + \end{minipage} +\end{quote} + +All data is in a file: +\begin{quote} + \begin{minipage}[t]{0.5\textwidth} + {\scriptsize +\begin{verbatim} +... +\begin{document} +\input{words} +\end{verbatim} + } + \end{minipage} +\end{quote} +\end{slide} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\begin{slide}\vspace*{10mm} +Now change the command for the backside: +\begin{quote} + \begin{minipage}[t]{0.5\textwidth} + {\scriptsize +\begin{verbatim} +\renewcommand{\card}[2]{\ticket{% + \put(3,30){\parbox{58mm}{\large{\textbf{ #1:}}}}% + \put(4,23){\parbox[t]{58mm} {\small {\blt #2}}}% + }} +\renewcommand{\raiz}[3]{\ticket{% + \put(3,30){\parbox{58mm}{\textbf{#1:} #2}}% + \put(3,13){\parbox{58mm}{#3}}% + }} +\end{verbatim} + } + \end{minipage} +\end{quote} + +Use the special command \code{\bs{}backside}, do some further adjustment for your printer and reread the file: +\begin{quote} + \begin{minipage}[t]{0.5\textwidth} + {\scriptsize +\begin{verbatim} +\backside% +\oddsidemargin=8pt +\input{words} +... +\end{verbatim} + } + \end{minipage} +\end{quote} + +If you want to print this on a duplex-printer rearrange the pages with this command for example: +\begin{quote} + \begin{minipage}[t]{0.5\textwidth} + {\scriptsize +\begin{verbatim} +psselect -p1,3,2,4 ex_flashcard.ps ex_flashcard_dup.ps ... +\end{verbatim} + } + \end{minipage} +\end{quote} \end{slide} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \begin{slide} - \section{special commands} -You can add additional pagebreaks with \code{\bs{}newpage\bs{}ticketreset}. This clears the ticket-buffers and sets the corresponding values to initial values.\\ + \section{Acknowledgements...} + Many thanks to those who used ticket.sty for many years and helped + to find some small bugs and those who provided ticket-definition-files (tdf) + and suggestions for new features. + + Many special thanks to Santiago Mejia who created an initial version + of the flash-card use-case. \end{slide} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \end{document} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% LocalWords: Emmel tdf ticketdefault pdf vcard usepackage documentclass lz +% LocalWords: LEITZ unitlength hoffset voffset ticketNumbers ticketSize dist +% LocalWords: ticketDistance renewcommand crossmark circlemark emptycrossmark +% LocalWords: cutmark newpage ticketreset perl myticket todo Mejia |