From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- macros/latex/contrib/chletter/README | 27 + macros/latex/contrib/chletter/chletter.dtx | 1656 ++++++++++++++++++++++++++++ macros/latex/contrib/chletter/chletter.ins | 62 ++ macros/latex/contrib/chletter/chletter.pdf | Bin 0 -> 134462 bytes 4 files changed, 1745 insertions(+) create mode 100644 macros/latex/contrib/chletter/README create mode 100644 macros/latex/contrib/chletter/chletter.dtx create mode 100644 macros/latex/contrib/chletter/chletter.ins create mode 100644 macros/latex/contrib/chletter/chletter.pdf (limited to 'macros/latex/contrib/chletter') diff --git a/macros/latex/contrib/chletter/README b/macros/latex/contrib/chletter/README new file mode 100644 index 0000000000..42c873f8d2 --- /dev/null +++ b/macros/latex/contrib/chletter/README @@ -0,0 +1,27 @@ +{chletter}[2010/10/10 v2.0 Swiss letter document class] + +The chletter class is suited for typesetting letters with letterhead +corresponding to the Swiss norm SN 010130. + +The default letterhead fits into ISO 269 C5 & C6/5 windowed envelopes, +both right windowed and left windowed. + +This class is mostly compatible with the standard LaTeX2e classes. It +is not limited to letters and may be used as a generic document class. + +Its basic usage is very simple and user friendly. It is appropriate to +quickly typeset casual documents and letters. + +However the class is highly configurable and may be used within complex +setups to provide automated letters composition. + +The chletter code is very compact and highly optimized, dropping the +obsolete legacy (namely LaTeX 2.09) for the sake of efficiency. + +Provided files: +chletter.dtx code and documentation +chletter.ins install script +chletter.pdf documentation + +Copyright 2010 Boris Oriet +The licence is LPPL 1.3c. \ No newline at end of file diff --git a/macros/latex/contrib/chletter/chletter.dtx b/macros/latex/contrib/chletter/chletter.dtx new file mode 100644 index 0000000000..7a50fa21ed --- /dev/null +++ b/macros/latex/contrib/chletter/chletter.dtx @@ -0,0 +1,1656 @@ +% \iffalse meta-comment +% +% Copyright 2008, 2009, 2010 by Boris Oriet +% ------------------------------------------------------- +% +% This file may be distributed and/or modified under the +% conditions of the LaTeX Project Public License, either version 1.3c +% of this license or (at your option) any later version. +% The latest version of this license is in: +% +% http://www.latex-project.org/lppl.txt +% +% and version 1.3c or later is part of all distributions of LaTeX +% version 2008/05/04 or later. +% +% This file has the LPPL maintenance status "author-maintained". +% +% \fi +% +% \iffalse +%<*driver> +\ProvidesFile{chletter.dtx} +\documentclass[a4paper]{ltxdoc} +\usepackage{hypdoc} +\pdfstringdefDisableCommands{\def\url{}} +\makeatletter +\let\PrintMacroName\HDorg@PrintMacroName +\let\PrintDescribeMacro\HDorg@PrintDescribeMacro +\makeatother +\setlength\parindent{0pt} +\setlength\unitlength{.59pt} +\CodelineIndex +\begin{document} + \DocInput{chletter.dtx} +\end{document} +% +% \fi +% +% \CheckSum{1057} +% +% \CharacterTable +% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z +% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z +% Digits \0\1\2\3\4\5\6\7\8\9 +% Exclamation \! Double quote \" Hash (number) \# +% Dollar \$ Percent \% Ampersand \& +% Acute accent \' Left paren \( Right paren \) +% Asterisk \* Plus \+ Comma \, +% Minus \- Point \. Solidus \/ +% Colon \: Semicolon \; Less than \< +% Equals \= Greater than \> Question mark \? +% Commercial at \@ Left bracket \[ Backslash \\ +% Right bracket \] Circumflex \^ Underscore \_ +% Grave accent \` Left brace \{ Vertical bar \| +% Right brace \} Tilde \~} +% +% \changes{v1.0}{2008/07/29}{Initial version} +% \changes{v1.1}{2009/11/05}{Internal interim version, minor changes} +% \changes{v2.0}{2010/10/10}{Code overhaul, new features, code frozen} +% +% \title{The \textsf{chletter} Document Class +% \thanks{This document corresponds to \textsf{chletter} v2.0, dated 2010/10/10.}} +% \author{Boris \textsc{Oriet}\\\url{http://boris.oriet.net}} +% \maketitle +% \bigskip\bigskip +% \tableofcontents +% \pagebreak +% +% \section{Introduction} +% +% The \textsf{chletter} class is suited for typesetting letters with letterhead +% corresponding to the swiss norm SN~010130.\bigskip +% +% The default letterhead is set according to Swiss rules. It fits into both right +% and left windowed ISO 269 C5 and C6/5 envelopes.\bigskip +% +% This class is mostly compatible with the standard \LaTeXe{} classes. +% It is not limited to letters and may be used as a generic document class.\bigskip +% +% Its basic usage is very simple and user friendly. +% It is appropriate to quickly typeset casual documents and letters.\bigskip +% +% It is however highly configurable and may be used within complex setups +% to provide automated letters composition. +% +% \section{Usage} +% +% The following examples describe the regular usage of the \textsf{chletter} class. +% Basically, this class behaves in a similar way to a standard class and accepts the +% regular \textsf{letter} commands, including the dedicated |letter| environment. +% Much like with standard classes, the only mandatory commands are |\documentclass| +% and the |document| environment (|\begin{document}| and |\end{document}|). +% +% \subsection{A basic letter} +% +% This example shows the plain usage of the \textsf{chletter} class.\medskip +% +% |\author|, |\address| and |\date| are markup commands which store +% global values used to build the letterhead. The |letter| environment actually creates the +% letter with its letterhead and all the needed layout. |\opening|, |\closing|, |\encl| and +% |\cc| are mainly formatting commands. To have multiple lines in a field, one may use +% |\newline| (shortcut |\\| as in this example) or |\par| (shortcut is an empty line).\medskip +% +% Please note that this example would also compile straightforward with the +% standard \textsf{letter} class (giving a somewhat different output). +% +% \begin{verbatim} +% \documentclass{chletter} +% +% \author{My name} +% \address{My address\\My city} +% \date{Location, \today} +% +% \begin{document} +% \begin{letter}{Name\\Address\\City} +% \opening{Salutation,} +% Hello World! +% \closing{Valediction.} +% \encl{enclosures} +% \cc{other recipients} +% \end{letter} +% \end{document} +% \end{verbatim} +% +% \begin{figure} +% \begin{picture}(596,842)(0,0) +% \fontsize{7}{7}\selectfont +% \thicklines +% \put(0,0){\framebox(596,842){}} +% \thinlines +% \put(72,758){My name} +% \put(72,746){My address} +% \put(72,734){My city} +% \put(334,758){Location, October 10, 2010} +% \put(334,686){Name} +% \put(334,674){Address} +% \put(334,662){City} +% \put(108,542){Salutation,} +% \put(108,518){Hello World!} +% \put(108,494){Valediction.} +% \put(334,446){My name} +% \end{picture} +% \caption{Standard letter output by \textsf{chletter}.} +% \end{figure} +% +% \subsection{A customized letter} +% +% This example provides a good overview of the different class options and macros.\medskip +% +% The |leftwin| option is to be used with a left windowed envelope, inverting the sender's +% and recipient's addresses. The |leftsig| option places the signature against the left body +% margin. The |foldmark| option will include a thin line to help folding of C6/5 letters. +% The |footfill| option will throw the letter foot against the document footer, for refined +% vertical balancing.\medskip +% +% |\makelabels| creates an addtional envelope page with only the recipient's address and +% the sender's return address. |\addresswidth| adjusts the letterhead layout (here it is +% computed to right align the date field, mimicking the standard \textsf{letter} class +% behaviour). |\location|, |\name|, |\return| and |\telephone| are supplementary markup +% commands. |\object| and |\ps| are extra layout commands. |\longindentation| (which is +% also provided by the standard \textsf{letter} class) enables alignement of the text with +% the addresses.\medskip +% +% Please note that lines with a comment (|%|) should be removed to allow compilation with the +% standard \textsf{letter} class. +% +% \begin{verbatim} +% \documentclass[leftwin,leftsig,foldmark,footfill]{chletter} +% +% \settowidth\addresswidth{\today} % +% +% \makelabels +% +% \location{Our Company} +% \name{My name} +% \return{\fromlocation, My address, My city} % +% \address{My address\\My city} +% \telephone{My phone\\My email} +% \signature{My signature\\\footnotesize My position} +% \title{\textbf{About the \textsf{chletter} document class}} +% +% \begin{document} +% \begin{letter}{Name\\Address\\City} +% \object % +% \opening{Dear \toname,} +% Body text. +% \closing{Yours truly,} +% \encl{Enclosures} +% \cc{Other recipients} +% \ps{P. S.}{Don't forget\par\hspace{\longindentation}long indentation!} +% \end{letter} +% \end{document} +% \end{verbatim} +% +% \begin{figure} +% \begin{picture}(596,842)(0,0) +% \fontsize{7}{7}\selectfont +% \thicklines +% \put(0,0){\framebox(596,842){}} +% \thinlines +% \put(424,758){Our Company} +% \put(424,746){My name} +% \put(424,734){My address} +% \put(424,722){My city} +% \put(424,710){\tiny My phone} +% \put(424,698){\tiny My email} +% \put(72,686){\textsuperscript{\underline{Our Company, My address, My city}}} +% \put(72,674){Name} +% \put(72,662){Address} +% \put(72,650){City} +% \put(424,614){October 10, 2010} +% \put(0,554){\line(1,0){18}} +% \put(108,542){\textbf{About the \textsf{chletter} document class}} +% \put(108,512){Dear Name,} +% \put(108,482){Body text.} +% \put(108,452){Yours truly,} +% \put(108,400){My signature} +% \put(108,388){\tiny My position} +% \put(72,168){\makebox(36,0)[r]{\strut encl~}} +% \put(108,168){\makebox(0,0)[l]{\strut Enclosures}} +% \put(72,144){\makebox(36,0)[r]{\strut cc~}} +% \put(108,144){\makebox(0,0)[l]{\strut Other recipients}} +% \put(72,120){\makebox(36,0)[r]{\strut P. S.~}} +% \put(108,120){\makebox(0,0)[l]{\strut Don't forget}} +% \put(424,108){\makebox(0,0)[l]{\strut |long indentation|!}} +% \end{picture} +% \caption{Customized letter output by \textsf{chletter}.} +% \end{figure} +% +% \begin{figure} +% \begin{picture}(596,842)(0,0) +% \fontsize{7}{7}\selectfont +% \thicklines +% \put(0,0){\framebox(596,842){}} +% \thinlines +% \put(72,686){\textsuperscript{\underline{Our Company, My address, My city}}} +% \put(72,674){Name} +% \put(72,662){Address} +% \put(72,650){City} +% \end{picture} +% \caption{Cover page output by \textsf{chletter}.} +% \end{figure}\pagebreak +% +% \section{Compatibility} +% +% The \textsf{chletter} class is based upon the standard classes of the \LaTeXe{} distribution. +% Many documents founded on these classes will also compile with \textsf{chletter}. +% +% \subsection{With the \LaTeXe{} \textsf{letter} class} +% +% The \textsf{chletter} class is `source compatible' (ascending) with the standard +% \textsf{letter} class. For the most part a file which compiles with \textsf{letter} will +% recompile straightforward with \textsf{chletter}. There are however some functional +% differencies, which are described in the following sections. +% +% \subsection{With other \LaTeXe{} classes} +% +% The \textsf{chletter} class is largely `source compatible' (ascending) with other standard +% \LaTeXe{} classes. It doesn't implement the sectioning mecanism, but accepts the related +% commands (|\section| for example). Some commands behave differently (|\maketitle| for +% example). Obvsiously, any command specific to the \textsf{chletter} class will prevent +% compilation with other classes. +% +% \subsection{With older versions of \textsf{chletter}} +% +% The \textsf{chletter} class has been completely overhauled between versions |1.0| and |2.0|. +% The new code is far more compact and efficient, so is its usage (the commands no more have +% a plethora of optional arguments). The versions of the class are mostly `source compatible,' +% given the deprecated commands are not used: |\conc| (replaced by |\object|), |\letterindent|, +% |\letterskip|, |\fromheight| (replaced by |\titletopheight|, |\toheight| (replaced by +% |\titlemidheight|) and |\stockheight| (replaced by |\titlebotheight|). To add a +% `compilability layer', the following code can be inserted in the preamble: +% \begin{verbatim} +% \newcommand\conc[2]{\object{#2}} +% \let\letterindent\parindent +% \let\letterskip\parskip +% \let\fromheight\titletopheight +% \let\toheight\titlemidheight +% \let\stockheight\titlebotheight +% \end{verbatim} +% +% \subsection{With upcoming versions of \textsf{chletter}} +% +% The \textsf{chletter} class is now considered mature and won't evolve further +% (the code is frozen). The class has been thoroughly tested, and there are no known deficiencies. +% +% \subsection{With other packages} +% +% The \textsf{chletter} class is generic in the sense that it doesn't rely on anything but +% the \LaTeXe\ kernel. There is no known command clash with any package.\medskip +% +% Please note that a \textsf{chextras} companion package is available (but not mandatory). +% It simplifies the preparation of documents and letters by loading and setting up font, +% linguistic and other common packages. It also implements a `glue code' for full source +% compatibility with older \textsf{chletter v1.0} documents. +% +% \section{Configuration} +% +% The default values used by the \textsf{chletter} class are balanced for casual writing of +% simple articles (the class can eventually replace the standard \textsf{article} class) and +% letters (of course). Nevertheless this class is highly configurable and customizable. +% +% \subsection{Class options} +% +% The \textsf{chletter} class accepts the options provided by the \LaTeXe\ default classes. +% These options are: |a4paper|, |a5paper|, |b5paper|, |letterpaper|, |legalpaper|, +% |executivepaper|, |landscape|, |10pt|, |11pt|, |12pt|, |oneside|, |twoside|, |draft|, |final|, +% |leqno|, |fleqn|, |onecolumn|, |twocolumn|. The defaults are: |a4paper|, |10pt|, |oneside|, +% |final|, |onecolumn|. Additionally, the \textsf{chletter} class provides four extra options +% (described just below) to adjust the general layout of the letters.\bigskip +% +% \DescribeMacro{leftwin} +% \DescribeMacro{leftsig} +% \DescribeMacro{foldmark} +% \DescribeMacro{footfill} +% |leftwin| places the recipient's address to the left of the letterhead rather than to the +% right. |leftsig| aligns the signature with the left body margin rather than with the right +% address. |foldmark| puts a thin line to help folding of C6/5 letters. |footfill| adds an +% infinite glue between the signature and the letter foot. +% +% \subsection{Page layout} +% +% The default page layout provided by the \textsf{chletter} class, while generic enough, +% leaves more place for the text than the standard classes do.\bigskip +% +% \DescribeMacro{\textwidth} +% \DescribeMacro{\textheight} +% \DescribeMacro{\oddsidemargin} +% \DescribeMacro{\evensidemargin} +% In a single sided document, the space between the top left corner of the page and the main +% text is (|1in + 36pt|, |1in + 36pt|); |36pt| are left for the header and the footer, along +% with |72pt| for the right and bottom margins. For A4 paper, the defaults are the following +% (values in inches and centimeters are rounded): +% \begin{verbatim} +% \textwidth 416pt [5.75in or 14.5cm] +% \textheight 630pt [8.75in or 22cm] +% \oddsidemargin 36pt [.5in or 1.25cm] +% \evensidemargin 0pt +% \end{verbatim} +% +% \DescribeMacro{\titlehead} +% \DescribeMacro{\titletopheight} +% \DescribeMacro{\titlemidheight} +% \DescribeMacro{\titlebotheight} +% \DescribeMacro{\titlemargin} +% \DescribeMacro{\titlewidth} +% \DescribeMacro{\addressmargin} +% \DescribeMacro{\addresswidth} +% These values are used for the letterhead layout. They are related to the \TeX\ origin, which +% is (|1in|, |1in|) from the top left corner of the page. Please remember that |1in = 72.27pt|. +% |\titlehead| controls the vertical placement of the first baseline of the letterhead. +% |\titlemargin| and |\titlewidth| control the horizontal position and width of the letterhead. +% |\addressmargin| is where the title is split in two. |\addresswith| is the width of the right +% address fields. The title is built by opening a |letter| environment or by calling directly +% |\maketitle|. For A4 paper, the defaults are the following (values in inches and centimeters +% are rounded): +% \begin{verbatim} +% \titlehead 12pt [.16in or .4cm] +% \titletopheight 72pt [1in or 2.5cm] +% \titlemidheight 72pt [1in or 2.5cm] +% \titlebotheight 72pt [1in or 2.5cm] +% \titlemargin 0pt +% \titlewidth 452pt [6.25in or 16 cm] +% \addressmargin 262pt [3.625in or 9.25cm] +% \addresswidth 190pt [2.625in or 6.75cm] +% \end{verbatim} +% +% \begin{figure} +% \begin{picture}(595,842)(0,0) +% \fontsize{5}{5}\selectfont +% \thicklines +% \put(0,0){\framebox(596,842){}} +% \thinlines +% \put(74,758){|fromname|} +% \put(74,746){|fromaddress|} +% \put(336,758){|date|} +% \put(336,686){|toname|} +% \put(336,674){|toaddress|} +% \multiput(72,770)(0,-72){4}{\line(1,0){452}} +% \multiput(72,770)(262,0){2}{\line(0,-1){216}} +% \put(524,770){\line(0,-1){662}} +% \put(108,554){\line(0,-1){446}} +% \put(108,108){\line(1,0){416}} +% \put(110,542){|salutation|} +% \put(110,518){|text|} +% \put(110,494){|valediction|} +% \put(336,446){|signature|} +% \put(25,788){\vector(-1,0){25}}\put(47,788){\vector(1,0){25}} +% \put(0,788){\makebox(72,0){|1in|}} +% \put(170,788){\vector(-1,0){98}}\put(236,788){\vector(1,0){98}} +% \put(72,788){\makebox(262,0){|addressmargin|}} +% \put(398,788){\vector(-1,0){64}}\put(460,788){\vector(1,0){64}} +% \put(334,788){\makebox(190,0){|addresswidth|}} +% \put(272,806){\vector(-1,0){200}}\put(324,806){\vector(1,0){200}} +% \put(72,806){\makebox(452,0){|titlewidth|}} +% \put(560,800){\vector(0,-1){30}}\put(560,812){\vector(0,1){30}} +% \put(524,800){\makebox(72,12){|1in|}} +% \put(560,728){\vector(0,-1){30}}\put(560,740){\vector(0,1){30}} +% \put(524,728){\makebox(72,12){|titletopheight|}} +% \put(560,656){\vector(0,-1){30}}\put(560,668){\vector(0,1){30}} +% \put(524,656){\makebox(72,12){|titlemidheight|}} +% \put(560,584){\vector(0,-1){30}}\put(560,596){\vector(0,1){30}} +% \put(524,584){\makebox(72,12){|titlebotheight|}} +% \put(182,320){\vector(-1,0){74}}\put(260,320){\vector(1,0){74}} +% \put(108,320){\makebox(226,0){|longindentation|}} +% \put(396,320){\vector(-1,0){62}}\put(462,320){\vector(1,0){62}} +% \put(334,320){\makebox(190,0){|indentedwidth|}} +% \put(292,90){\vector(-1,0){184}}\put(340,90){\vector(1,0){184}} +% \put(108,90){\makebox(416,0){|textwidth|}} +% \end{picture} +% \caption{The default \textsf{chletter} layout.} +% \end{figure} +% +% \subsection{The \texttt{letter} environment} +% +% The |letter| environment performs some special actions in the scope of writing letters. At +% its beginning, it generates the letterhead according to its arguments and some previously +% defined values (see below). The |letter| environment takes in account some global options, +% for example |twocolumn|... so yes, it is possible to write two column letters! At its +% closing, the |letter| environment generates a cover page if needed (see below).\bigskip +% +% \DescribeEnv{letter} +% The |letter| environment takes one `mandatory' argument : the recipient's address. The +% address should be formatted with newline markers (|\\|) as in the standard |letter| class. +% The argument is `tokenized' into |\toname| and |\toaddress|, which can be used in the +% letter body. The `token separator' is the first encountered |\\|\,. Please note that an +% invocation of the |letter| environment without argument will retrieve previously defined +% |\toname| and |\toaddress| values (empty by default).\medskip +% +% There is an optional argument to specify if the letter is to be indented |[i]| or not |[n]| +% where |[n]| is the default. Please note that this option will alter the formatting of general +% \LaTeX\ lists and \textsf{chletter} |\ps|, |\cc| and |\encl| commands (see below).\bigskip +% +% It is possible to open multiple |letter| environments within a single document. Global +% values may be shared between each letter (see next page). Please remember that environments +% involve some locality; for example a length value altered within a |letter| environment +% will recover its initial value outside of the environment.\medskip +% +% An ordinary usage would be: +% \begin{verbatim} +% \begin{letter}[i]{Toname\\ToAddressFirstLine\\...\\ToAddressLastLine} +% ... +% \end{letter} +% \end{verbatim} +% +% \subsubsection{Cover page} +% +% \DescribeMacro{\makelabels} +% Unlike the standard \textsf{letter} class, this macro doesn't involve a complex mecanism +% using the |.aux| file to build a labels page (the main reason why the standard class is +% fragile). Anyway, the \textsf{chletter} class provides a way to generate dedicated cover +% pages. The |\makelabels| command will set a flag which is checked at the closing of the +% |letter| environment. The default behaviour is to put the recipient's address and, as +% requested by the Swiss post, the return address above it, separated by a line. |\makelabels| +% doesn't take any argument. +% +% \subsubsection{Page breaking} +% +% These commands are intended to (try to) control the place where a page break occur. +% They may be used anywhere in a document.\medskip +% +% \DescribeMacro{\stopbreaks} +% |\stopbreaks| will try to prevent all page breaks after its invocation.\bigskip +% +% \DescribeMacro{\startbreaks} +% |\startbreaks| cancels the behaviour of |\stopbreaks|. +% +% \subsubsection{Letter counter} +% +% \DescribeMacro{\theletter} +% At each new |letter| environment opened, this counter is incremented. Please note that +% |thepage| and |thefootnote| counters are reset at the same time. +% +% \subsubsection{Letter markup} +% +% The commands described here are usually put in the preamble, but they may be called from +% anywhere in the document. They store their argument in associated values which will be +% retrieved by the |letter| environment, for example to build the letterhead. They are common +% to a bunch of letter classes.\medskip +% +% \DescribeMacro{\name} +% \DescribeMacro{\address} +% \DescribeMacro{\location} +% \DescribeMacro{\telephone} +% \DescribeMacro{\return} +% The values stored by these commands are respectively: |\fromname|, |\fromaddress|, +% |\fromlocation|, |\telephonenum| and |\returnaddress|. |\telephone| and |\return| will +% format their output (respectively small text and underlined superscript text). Please note +% that |\return| is not defined in the standard \textsf{letter} class. These values are used +% to build the expeditor's address fields: +% \begin{verbatim} +% \name{My Name} +% \address{My Street\\My City} +% \return{My Return Address} +% \end{verbatim} +% +% \DescribeMacro{\date} +% The date field (stored by kernel |\@date| value) can be customized by, for example: +% \begin{verbatim} +% \date{Here, \today} +% \end{verbatim} +% +% \DescribeMacro{\signature} +% The value stored by this macro is |\fromsig|, which is used by the |\closing| command to +% output the signature field (see below).\bigskip +% +% Please note that |\fromname| and |\fromsig| values default to |\@author| (initialized by +% \LaTeX, modified by the standard |\author| command). The |\@date| field defaults to +% |\today|, which will be localized by a linguistic package (\textsf{babel} or +% \textsf{polyglossia}).\medskip +% +% To prevent any value from appearing, it has to be emptied by the corresponding command, +% for example: |\date{}|.\medskip +% +% These macros can contain anything that fits in a |\parbox|, including some special stuff +% (using dedicated packages): |\location{\includegraphics{mylogo.pdf}}|\medskip +% +% Any of the values stored by these commands can be retrieved anywhere in the letter (given +% the corresponding value is accessible, |\@author| and |\@date| requiring a |\makeatletter|): +% |I, \fromname, declare...| +% +% \subsubsection{Letter body} +% +% These commands are mostly used within a letter environment, but they may be called at +% document level for special purpose. Their foremost intend is formatting, although they are +% able to retrieve or store their value at will.\medskip +% +% \DescribeMacro{\object} +% This command will simply output the text given in its argument, followed by a |\bigskip|. +% The |\object| command stores its argument in |\@title| and actually outputs it. If the +% argument is either empty or null, then the |\object| command will output the value of +% |\@title| previously set by a |\title| command. Remember that the default |\@title| value +% is an error (set by the \LaTeX\ kernel): +% \begin{verbatim} +% \title{Answer to your previous letter} +% ... +% \begin{document} +% \begin{letter}{...} +% \object +% \end{verbatim} +% +% Please note that the following code is functionally equivalent (the |\@title| value set by +% both methods is global (available outside of the current letter environment): +% \begin{verbatim} +% \begin{document} +% \begin{letter}{...} +% \object{Answer to your previous letter} +% \end{verbatim} +% +% \DescribeMacro{\opening} +% This command outputs the text given in its argument (adding a |\medskip| vertical space +% after it): +% \begin{verbatim} +% \opening{Dear Sir,} +% \end{verbatim} +% +% It stores its argument in |\salutation| for further use. |\salutation| can also be defined +% previously and be recalled by an |\opening| with an empty or null argument: +% \begin{verbatim} +% \renewcommand{\salutation}{Dear Sir,} +% ... +% \begin{document} +% \begin{letter}{...} +% \opening +% \end{verbatim} +% +% \DescribeMacro{\closing} +% This command issues a |\medskip|, outputs the text given in its argument and generates +% the signature field, which should provide its own vertical spacing (by default it is +% |4\bigskip| above the signature and |2\bigskip| below): +% \begin{verbatim} +% \closing{Yours sincerely,} +% \end{verbatim} +% +% The signature field placement can be altered by invocation of |leftsig| as a +% class option. The signature field will contain the value defined by: +% \begin{itemize} +% \item[---] |\fromsig| (set by |\signature{...}|) in the first place; +% \item[---] |\fromname| (set by |\name{...}|) if no |\signature| given; +% \item[---] |\@author| (set by |\author{...}|) if no |\name| given (eventually empty). +% \end{itemize} +% +% The |\closing| macro stores its argument in |\valediction| for later use. As usual, the +% |\valediction| value can also be defined before and be output by an invocation of +% |\closing| with an empty or null argument: +% \begin{verbatim} +% \renewcommand{\valediction}{Yours sincerely,} +% \begin{document} +% \begin{letter}{...} +% ... +% \closing{} +% \end{verbatim} +% +% Depending on the class option |footfill|, an extra vertical glue will be added after the +% signature, in order to balance the appearance of the letter foot. |footfill| pushes the +% letter foot text against the document footer (usually the the letter foot is filled by the +% |\ps|, |\encl| and |\cc| commands). Please note that for a weaker balance a |\vfil| could +% be manually added after the |\closing| command.\bigskip +% +% Be aware of the locality of macros. |\salutation| and |\valediction| values are local to +% the current |letter| environment if defined within the environment (usually by |\opening| +% and |\closing| commands), global otherwise. Please look at the \LaTeX\ documentation for +% further explanations. +% +% \subsubsection{Letter foot} +% +% Some formatting commands are intended to be used at the end of the letter (although they +% can be used anywhere in the document, even outside of a letter environment---just as any +% formatting command provided by the \textsf{chletter} class).\bigskip +% +% \DescribeMacro{\ps} +% This command is generic in the sense that it is nothing but a shortcut for a \LaTeX\ list. +% It takes two mandatory arguments. The text contained in the arguments is output as an +% indented paragraph. The indentation margin is set by the standard \LaTeX\ |\leftmargin| +% value (which defaults to |18pt| at document level, |0pt| after the |\closing| of a default +% letter and |36pt| after the |\closing| of an indented |[i]| letter). Here is an example use: +% \begin{verbatim} +% \ps{P.S.}{This is a post scriptum} +% \end{verbatim} +% +% \DescribeMacro{\encl} +% This command is a shortcut for |\ps{\enclname}{...}| and takes one mandatory argument. +% Regular use is: +% \begin{verbatim} +% \encl{1. Your previous letter\\2. My Curriculum Vit\ae} +% \end{verbatim} +% +% \DescribeMacro{\cc} +% This command is a shortcut for |\ps{\ccname}{...}| and takes one mandatory argument. +% Regular use is: +% \begin{verbatim} +% \cc{1. First other recipient\\2. Second other recipient} +% \end{verbatim} +% +% |\enclname| and |\ccname| are set to |{encl}|, respectively |{cc}| by default. +% They will be adjusted by a linguistic package (\textsf{babel} or \textsf{polyglossia}). +% +% \subsection{Sectioning} +% +% \DescribeMacro{section} +% \DescribeMacro{subsection} +% \DescribeMacro{subsubsection} +% \DescribeMacro{paragraph} +% \DescribeMacro{subparagraph} +% The class is intended to output short documents (mainly letters!), so the sectioning mecanism +% is minimalist (no index nor table of contents generation). The stock sectioning commands are +% here: |section|, |subsection|, |subsubsection|, |paragraph|, |subparagraph|, but are merely +% formating commands which select some text style and vertical space. As usual, these commands +% take one mandatory argument. +% +% \subsection{Environments} +% +% \DescribeMacro{description} +% \DescribeMacro{verse} +% \DescribeMacro{quotation} +% \DescribeMacro{quote} +% These environments are available and behave as ordinary in the \textsf{chletter} class. +% The default list values (at document level) are:|\labelsep6pt|, |\labelwidth12pt|, +% |\leftmargin18pt|. Please note that |\labelwidth| and |\labelsep| are redefined by a +% |\closing| command to |\leftmargin2\parindent|, |\labelwidth3\labelwidth|. +% +% \subsection{Paragraphing} +% +% \DescribeMacro{\parindent} +% \DescribeMacro{\parskip} +%|\parindent| and |\parskip| respectively default to |18pt| and |9pt| at document level. If +% a |letter| environment is called with the |[i]| option, |\parindent| is kept at its previous +% value. With the default |[n]| option, |\parindent| is locally set to |0| (zero).\bigskip +% +% Please note that the actual value of |\parindent| while a |\closing| command is issued +% will alter the layout of \LaTeX\ lists (in fact |\ps|, |\encl| and |\cc| are lists): the +% |leftmargin| value (which defaults to |18pt|) is then defined as three times the value of +% |\parindent| (thus |0pt| for a default letter and |36pt| for an indented letter). +% +% \StopEventually +% +% \section{Implementation} +% +% The \textsf{chletter} code is fairly compact (less than 300 lines) and highly optimized +% (it relies on \TeX\ primitives wherever practical), dropping the obsolete legacy (namely +% \LaTeX\ 2.09) for the sake of efficiency.\bigskip +% +% Appart from the options described until now, it is possible (and allowed!) to `hook' into +% certain pieces of the class code. This enables a degree of customization and extensibility. +% It would be quite straightforward to add, for example, mail merging features through a +% dedicated package. +% +% \subsection{Initial code} +% +% \begin{macrocode} +%<*chletter.cls> +% \end{macrocode} +% \begin{macrocode} +\NeedsTeXFormat{LaTeX2e} +\ProvidesClass{chletter}[2010/10/10 v2.0 Swiss letter document class] +% \end{macrocode} +% +% \subsubsection{Declaring options} +% +% \begin{macro}{leftwin} +% \begin{macro}{leftsig} +% \begin{macro}{foldmark} +% \begin{macro}{footfill} +% There are four specific options: |leftwin|, |leftsig|, |foldmark| and |footfill|, +% corresponding to the format of the letter (left envelope window, left signature, folding +% mark for C6/5 covers, letter foot balancing). The default is to not set any of these options. +% All other options are borrowed from the standard classes. +% +% \begin{macrocode} +\DeclareOption{a4paper}{\paperheight297mm\paperwidth210mm} +\DeclareOption{a5paper}{\paperheight210mm\paperwidth148mm} +\DeclareOption{b5paper}{\paperheight250mm\paperwidth176mm} +\DeclareOption{letterpaper}{\paperheight11in\paperwidth8.5in} +\DeclareOption{legalpaper}{\paperheight14in\paperwidth8.5in} +\DeclareOption{executivepaper}{\paperheight10.5in\paperwidth7.25in} +\DeclareOption{landscape} +{\@tempdima\paperheight\paperheight\paperwidth\paperwidth\@tempdima} +\DeclareOption{10pt}{\def\@ptsize{0}} +\DeclareOption{11pt}{\def\@ptsize{1}} +\DeclareOption{12pt}{\def\@ptsize{2}} +\DeclareOption{oneside}{\@twosidefalse\@mparswitchfalse} +\DeclareOption{twoside}{\@twosidetrue\@mparswitchtrue} +\DeclareOption{draft}{\overfullrule5\p@} +\DeclareOption{final}{\overfullrule\z@} +\DeclareOption{leqno}{\input{leqno.clo}} +\DeclareOption{fleqn}{\input{fleqn.clo}} +\DeclareOption{onecolumn}{\@twocolumnfalse\@leftsigfalse} +\DeclareOption{twocolumn}{\@twocolumntrue\@leftsigtrue} +\DeclareOption{leftwin}{\@leftwintrue} +\DeclareOption{leftsig}{\@leftsigtrue} +\DeclareOption{foldmark}{\@foldmarktrue} +\DeclareOption{footfill}{\@footfilltrue} +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% +% These booleans will be evaluated at the end of the class code. They are |false| until the +% associated option is selected. +% +% \begin{macrocode} +\newif\if@leftwin +\newif\if@leftsig +\newif\if@foldmark +\newif\if@footfill +% \end{macrocode} +% +% \subsubsection{Executing options} +% +% Swiss letters are written on A4 paper. Default font size is |10pt|, like in other standard +% classes. Other switches are set at kernel level. +% +% \begin{macrocode} +\ExecuteOptions{a4paper,10pt} +\ProcessOptions\relax +% \end{macrocode} +% +% Loading this |.clo| file leads to a lot of redundancy. But we want compatibility. +% +% \begin{macrocode} +\input{size1\@ptsize.clo} +% \end{macrocode} +% +% \subsubsection{Loading packages} +% +% The \textsf{chletter} class does not load additional packages. +% +% \subsection{Document layout} +% +% This class tries to provide quite a universal layout, not only suitable for letters, but +% also for other types of short documents. There are anyway some values specific to letters, +% principally the letterhead values. +% +% \subsubsection{Letter counter} +% +% \begin{macro}{theletter} +% Each time a letter is created by a |letter| environment, this counter is incremented. +% +% \begin{macrocode} +\newcounter{letter} +% \end{macrocode} +% \end{macro} +% +% \subsubsection{Letter dimensions} +% +% These dimensions concern the letterhead, where |\titlehead| is the absolute position of +% its first baseline. The title matter is vertically stacked in three strips, each one with +% its own height. |\titlemargin| is the absolute position of the letterhead margin, to which +% the letterhead matter is relative. |\longindentation| and |\indentedwidth| are to be used +% within a |letter| environment and will be computed on the fly by |\maketitle|, along with +% |\addressmargin| or |\addresswidth|. +% +% \begin{macrocode} +\newdimen\titlehead +\newdimen\titletopheight +\newdimen\titlemidheight +\newdimen\titlebotheight +% \end{macrocode} +% \begin{macrocode} +\newdimen\titlemargin +\newdimen\titlewidth +\newdimen\addressmargin +\newdimen\addresswidth +% \end{macrocode} +% \begin{macrocode} +\newdimen\longindentation +\newdimen\indentedwidth +% \end{macrocode} +% +% \subsubsection{Paragraphing} +% +% We prefer inter paragraph skips in a letter. Swiss letters are rarely indented but the +% |letter| environement offers an option to do so. Indentation is still enabled at +% document level. Setting |\normallineskip| to zero prevents layout inconsistencies. +% +% \begin{macrocode} +\parskip9\p@ +\parindent18\p@ +% \end{macrocode} +% \begin{macrocode} +\normallineskip\z@ +% \end{macrocode} +% +% \subsubsection{Page layout} +% +% All dimensions are measured from a point |1in| from the top left corner of the page. +% Remember that |1in = 72.27pt = 2.54cm| = |72bp| and |1pt| = |65536sp|.\medskip +% +% Regarding the header, |12pt| (more or less one line) are reserved, plus |24pt| spacing +% before the main text. The footer space is |36pt|, including body to footer gap. +% +% \begin{macrocode} +\headheight12\p@ +\headsep24\p@ +% \end{macrocode} +% \begin{macrocode} +\footskip36\p@ +% \end{macrocode} +% +% Regarding the text dimensions, we remove approximately |1in| at each side, plus |36pt| +% horizontally (corresponding to the margin, see below) and |72pt| vertically +% (corresponding to the header and footer, see above). The trick in the definition +% of |\textwidth| and |\textheight| is to have integer values for A4 paper. +% +% \begin{macrocode} +\textwidth\paperwidth +\advance\textwidth-9536004sp +\titlewidth\textwidth +\advance\textwidth-36\p@ +% \end{macrocode} +% \begin{macrocode} +\textheight\paperheight +\advance\textheight-14093310sp +% \end{macrocode} +% +% The left margin of the odd pages is set to |1in + 36pt| (more or less |4cm|). Sizes of the +% marginal notes are adapted to quite small margins. Top margin is set to zero. +% +% \begin{macrocode} +\oddsidemargin36\p@ +\evensidemargin\z@ +% \end{macrocode} +% \begin{macrocode} +\marginparwidth48\p@ +\marginparsep6\p@ +\marginparpush6\p@ +% \end{macrocode} +% \begin{macrocode} +\topmargin\z@ +% \end{macrocode} +% +% The footnotes values are somewhat larger than the default. +% +% \begin{macrocode} +\footnotesep12\p@ +\skip\footins12\p@ +% \end{macrocode} +% +% \subsubsection{Title layout} +% +% What we call `title' here is the letterhead, with the addresses fields and all this kind of +% stuff. Title is always placed on an odd page at an absolute position. +% +% \begin{macro}{\titlehead} +% The vertical position of the title is controled by the |\titlehead| value (by analogy with +% |\headheight| which sets the first baseline of the running head). Please note that +% letterhead position is not altered by anything but |\titlehead| (for example it is +% independant from the |\topmargin| value). +% +% \begin{macrocode} +\titlehead12\p@ +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\titletopheight} +% \begin{macro}{\titlemidheight} +% \begin{macro}{\titlebotheight} +% The title (letterhead or cover) field is divided into three strips, each one containing +% some material. For example, the first field could contain the sender's address, the second +% one the recipient's address and the third one the letter's date. Obviously the total +% letterhead height is the sum of these three values (|216pt| by default). +% +% \begin{macrocode} +\titletopheight72\p@ +\titlemidheight72\p@ +\titlebotheight72\p@ +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\titlemargin} +% \begin{macro}{\titlewidth} +% The horizontal position of the title is controlled by |\titlemargin| which is set to |0pt| +% by default. |\titlewidth| has already been set as |\textwidth + 36pt|. +% \end{macro} +% \end{macro} +% +% \begin{macro}{\addressmargin} +% \begin{macro}{\addresswidth} +% These values are to be computed on the fly by |\maketitle| depending on user input and +% actual |\titlewidth| value. If |\addressmargin| is defined by the user, then the formula +% |\titlewidth = \addressmargin + \addresswidth| will be applied to |\addresswidth|, otherwise +% it will be applied to |\addressmargin|. +% +% \begin{macrocode} +\addresswidth190\p@ +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \subsubsection{Page styles} +% +% The default page styles are here, but their layout differ from the standard classes. +% +% \begin{macrocode} +\def\ps@plain% +{\let\@oddhead\@empty + \let\@evenhead\@empty + \def\@oddfoot{\footnotesize\hfil\pagename~\thepage} + \def\@evenfoot{\footnotesize\pagename~\thepage\hfil}} +% \end{macrocode} +% \begin{macrocode} +\def\ps@firstpage% +{\let\@oddhead\@empty + \let\@evenhead\@empty + \def\@oddfoot{\footnotesize\leftmark\hfil\rightmark} + \def\@evenfoot{\footnotesize\rightmark\hfil\leftmark}} +% \end{macrocode} +% \begin{macrocode} +\def\ps@headings% +{\def\@oddhead{\footnotesize\headtoname~\toname\hfil\pagename~\thepage} + \def\@evenhead{\footnotesize\pagename~\thepage\hfil} + \def\@oddfoot{\footnotesize\leftmark\hfil\rightmark} + \def\@evenfoot{\footnotesize\rightmark\hfil\leftmark}} +% \end{macrocode} +% \begin{macrocode} +\def\ps@myheadings% +{\def\@oddhead{\footnotesize\leftmark\hfil\rightmark} + \def\@evenhead{\footnotesize\rightmark\hfil\leftmark} + \def\@oddfoot{\footnotesize\hfil\pagename~\thepage} + \def\@evenfoot{\footnotesize\pagename~\thepage\hfil}} +% \end{macrocode} +% +% \subsection{Document markup} +% +% These user commands are common to all usual letter classes. +% +% \subsubsection{Global declarations} +% +% \begin{macro}{\name} +% \begin{macro}{\signature} +% \begin{macro}{\address} +% \begin{macro}{\location} +% \begin{macro}{\telephone} +% \begin{macro}{\return} +% These macros work exactly the same way as with the standard \textsf{letter} class. They +% don't output anything, but just define an associated word containing their argument. The +% layout of |\telephonenum| (small text) and |\returnaddress| (underlined small text) is +% specific to this class and somewhat tricky, intended to manage the best possible appearance. +% Please note that the default contents of the associated words will be defined later. +% +% \begin{macrocode} +\long\def\name#1{\def\fromname{#1}} +\long\def\signature#1{\def\fromsig{#1}} +\long\def\location#1{\def\fromlocation{#1}} +\long\def\address#1{\def\fromaddress{#1}} +\long\def\telephone#1{\def\telephonenum{\vtop{\footnotesize#1}}} +\long\def\return#1{\def\returnaddress{\underbar{\textsuperscript{#1}}}} +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\makelabels} +% \begin{macro}{\startlabels} +% The |\makelabels| command defines a |\startlabels| macro, which causes cover pages to be +% added at the end of each letter. See next page for more information. +% +% \begin{macrocode} +\def\makelabels% +{\def\startlabels% + {\let\titletopmatter\@empty + \let\titlebotmatter\@empty + \let\foldmark\@empty}} +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\maketitle} +% This artful piece of code actually outputs the letterhead stuff. |\maketitle| is always +% called at the opening of the |letter| environment, and at its closing if the |\startlabels| +% flag is not |\@null|. It outputs the content of |\titletopmatter|, |\titlemidmatter|, +% |\titlebotmatter| in three horizontal strips stacked vertically. These strips have respective +% heights of |\titletopheight|, |\titlemidheight|, |\titlebotheight| and are always placed on +% a new odd page at an absolute position given by |\titlehead| and |\titlemargin|. The width of +% the strips is given by |\titlewidth|. |\longindentation| and |\indentedwidth| are computed +% here, so are |\addressmargin| and |\addresswidth| which are used by |\splitfield|. Some +% dedicated mecanism deals with the |\twoside| and |\twocolumns| cases (the letterhead is +% always issued on a clear odd page), executing the |\@maketitle| auxiliary macro. The +% |\foldmark| macro is called at the end of the letterhead. +% +% \begin{macrocode} +\def\maketitle% +{\ifdim\addressmargin=\z@ + \addressmargin\titlewidth + \advance\addressmargin-\addresswidth + \else + \addresswidth\titlewidth + \advance\addresswidth-\addressmargin\fi + \longindentation\titlemargin + \advance\longindentation-\oddsidemargin + \clearpage + \if@twoside\ifodd\c@page + \else\thispagestyle{empty}\hb@xt@\z@{}\clearpage\fi\fi + \if@twocolumn\twocolumn[\@maketitle\leavevmode\vskip-\topskip] + \else\vbox{\@parboxrestore\@maketitle}\vskip-\parskip\fi + \advance\longindentation\addressmargin + \indentedwidth\textwidth + \advance\indentedwidth-\longindentation} +% \end{macrocode} +% \begin{macrocode} +\def\@maketitle% +{\vskip-\topmargin\vskip-\baselineskip + \vskip\titlehead\vskip-\headheight\vskip-\headsep + \leftskip\longindentation\rightskip\textwidth + \advance\rightskip-\paperwidth + \advance\rightskip-\titlemargin + \parbox[t][\titletopheight]{\titlewidth} + {\hb@xt@\z@{}\titletopmatter\strut}\par + \parbox[t][\titlemidheight]{\titlewidth} + {\hb@xt@\z@{}\titlemidmatter\strut}\par + \parbox[t][\titlebotheight]{\titlewidth} + {\hb@xt@\z@{}\titlebotmatter\strut}\par + \leftskip-\oddsidemargin\advance\leftskip-1in + \parbox[b][\z@]{\paperwidth}{\foldmark}\par} +% \end{macrocode} +% \end{macro} +% +% \subsubsection{The \texttt{letter} environment} +% +% \begin{environment}{letter} +% The |letter| environment is the foremost part of a letter. It takes the recipient's address +% as mandatory argument and |[i]| (default is |[n]|) as optional argument to set the +% |\parindent| value within the group represented by the environment. The first part of the +% code manages these arguments. It is sturdier than the standard \LaTeX\ |\newenvironment| in +% the sense that, for example, the mandatory argument is not... mandatory! At its opening, +% the |letter| environment tokenizes its mandatory argument into two fields, |\toname| and +% |\toaddress| (token separator is the first encountered |\\|). If the argument is null +% (|\begin{letter}{}| or |\begin{letter}|), these values won't be modified and thus may be +% defined before the opening of the environment, hence the easy mail merging extension. Then +% |\maketitle| is called to output the letterhead (the first page of the letter is always +% issued on a clear odd page, leaving a blank page if necessary in two sided documents). The +% |\pagestyle| of the first letter page is set to |firstpage| and the |letter| counter is +% incremented, while the |page| and |footnote| counters are reset. +% +% \begin{macrocode} +\def\letter{\futurelet\@let@token\ch@let}\def\ch@let% +{\ifx\@let@token[\expandafter\@letter\else\expandafter\ch@lea\fi} +\long\def\ch@lea#1 {\@letter[n]{#1} } +% \end{macrocode} +% \begin{macrocode} +\long\def\@letter[#1]#2 +{\ifx#1n\parindent\z@\fi\ifx\@null#2\else\@processto#2\\@@@ + \ifx\@empty\toaddress\else\@processto#2@@@\fi\fi + \maketitle\thispagestyle{firstpage} + \global\c@page\@ne\global\c@footnote\z@\global\advance\c@letter\@ne} +% \end{macrocode} +% \begin{macrocode} +\long\def\@processto#1\\#2@@@{\def\toname{#1}\def\toaddress{#2}} +% \end{macrocode} +% +% At its closing, the |letter| environment removes the last skip, then checks for the +% definition of |\startlabels|. If undefined, nothing but a |\clearpage| happens. If defined, +% its contents is executed (usually a redefinition of |\titletopmatter|, |\titlemidmatter| and +% |\titlebotmatter|) and the |\maketitle| macro is called, taking the |\twoside| case in +% account (which may produce additional empty pages), then issuing a new page (intended to be +% a cover) followed by a |\clearpage|. +% +% \begin{macrocode} +\def\endletter{\removelastskip\ifx\startlabels\undefined\else% + \startlabels\maketitle\thispagestyle{empty}\fi\clearpage} +% \end{macrocode} +% \end{environment} +% +% \subsubsection{Page breaking control} +% +% \begin{macro}{\stopbreaks} +% \begin{macro}{\startbreaks} +% When the command |\stopbreaks| is issued no page breaks should occur until |\startbreaks| is +% called. These macros are used by the |\closing| command. +% +% \begin{macrocode} +\def\stopbreaks{\interlinepenalty\@M\def\par{\@@par\nobreak}} +\def\startbreaks{\interlinepenalty100\def\par{\@@par}} +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \subsubsection{The generic letter commands} +% +% \begin{macro}{\opening} +% Unlike the standard \textsf{letter} class, the |\opening| command doesn't generate the +% letterhead (this is done at the opening of the |letter| environment or by a direct call of +% |\maketitle|). The content of |\salutation| is either locally filled with the mandatory +% argument or recalled if the argument is null (either |\opening{}| or |\opening| without +% argument, look at the neat argument handling code), then output. The |\medskipamount| value +% controls the vertical spacing. +% +% \begin{macrocode} +\def\opening{\futurelet\@let@token\ch@ope}\def\ch@ope% +{\ifx\@let@token\bgroup\expandafter\ch@opa\else\expandafter\@opening\fi} +\def\ch@opa#1{\ifx\@null#1\else\def\salutation{#1}\fi\@opening} +% \end{macrocode} +% \begin{macrocode} +\def\@opening{\par\salutation\par\medskip} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\closing} +% The |\closing| command is to be called at the end of the letter body. It generates the +% valediction and the signature. Much like the |\opening| command, its argument either fills +% or retrieve a value, here |\valediction|. A |\medskip| is issued, page breaking is prevented +% and |\closingmatter| is added. |\closingmatter| is defined according to the class option +% |leftsig| and could be completely customized. +% +% \begin{macrocode} +\def\closing{\futurelet\@let@token\ch@clo}\def\ch@clo% +{\ifx\@let@token\bgroup\expandafter\ch@cla\else\expandafter\@closing\fi} +\def\ch@cla#1{\ifx\@null#1\else\def\valediction{#1}\fi\@closing} +% \end{macrocode} +% \begin{macrocode} +\def\@closing{\par\medskip\stopbreaks\valediction + \samepage\par\closingmatter\par\startbreaks} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\object} +% The |\object| macro outputs the content of |\@title|, either previously defined by a +% |\title| command or filled by a non empty argument (see |\opening| for an explanation of +% this behaviour). The |\bigskipamount| value controls the vertical spacing. Styling is left +% to user's preference, for example: |\object{\textbf{...}}|. +% +% \begin{macrocode} +\def\object{\futurelet\@let@token\ch@obj}\def\ch@obj% +{\ifx\@let@token\bgroup\expandafter\ch@oba\else\expandafter\@object\fi} +\def\ch@oba#1{\ifx\@null#1\else\title{#1}\fi\@object} +% \end{macrocode} +% \begin{macrocode} +\def\@object{\noindent\@title\par\bigskip} +% \end{macrocode} +% \end{macro} +% +% \begin{macro}{\ps} +% \begin{macro}{\cc} +% \begin{macro}{\encl} +% |\ps| is a shortcut for a simple \LaTeX\ list, with its first argument as item label and +% its second argument as a item contents. |\cc| and |\encl| are further shortcuts, using +% respectively |\ccname| and |\enclname| as label. There is a trick involved here: the list +% behaviour is altered after a |\closing| command (see |\closingmatter|); by these means the +% letter foot benefit from the powerful list feature while the lists defaults are kept at +% convenient values for use within the letter body.\medskip +% +% \begin{macrocode} +\long\def\ps#1#2{\begin{list}{}{}\item[#1]#2\end{list}} +\long\def\cc#1{\ps{\ccname}{#1}} +\long\def\encl#1{\ps{\enclname}{#1}} +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% +% \subsubsection{Sections and paragraphs} +% +% Some sectioning commands are defined, but they are merely formatting commands. So there is +% no section numbering nor index and table of contents generation. +% +% \begin{macrocode} +\long\def\subparagraph#1{\par\textbf{#1}\hskip\labelsep} +\long\def\paragraph#1{\par\noindent\textbf{#1}\hskip\labelsep} +\long\def\subsubsection#1{\par\noindent\textbf{#1}\par\nobreak} +\long\def\subsection#1{\smallskip\subsubsection{#1}} +\long\def\section#1{\medskip\subsubsection{#1}} +% \end{macrocode} +% +% \subsubsection{Environments} +% +% This code is borrowed from the standard classes. Please look at the \LaTeXe\ documentation +% for further explanation. Remember that all these environments are lists which will be +% formatted according following the general lists parameters. +% +% \begin{macrocode} +\def\description +{\list{} + {\labelwidth\z@ + \itemindent-\leftmargin + \let\makelabel\descriptionlabel}}\def\enddescription{\endlist} +% \end{macrocode} +% \begin{macrocode} +\def\descriptionlabel#1{\hskip\labelsep\textbf{#1}} +% \end{macrocode} +% \begin{macrocode} +\def\verse +{\let\\\@centercr + \list{} + {\itemsep\z@ + \itemindent-\parindent + \listparindent\itemindent + \rightmargin\leftmargin + \advance\leftmargin\parindent} + \item\relax}\def\endverse{\endlist} +% \end{macrocode} +% \begin{macrocode} +\def\quotation +{\list{} + {\listparindent\parindent + \itemindent\listparindent + \rightmargin\leftmargin} + \item\relax}\def\endquotation{\endlist} +% \end{macrocode} +% \begin{macrocode} +\def\quote +{\list{} + {\rightmargin\leftmargin} + \item\relax}\def\endquote{\endlist} +% \end{macrocode} +% +% \subsubsection{Lists} +% +% This code is borrowed from the standard classes. Please look at the \LaTeXe\ documentation +% for further explanation. Please also note that list nesting is limited to four levels +% (seems to be enough for a letter). +% +% \begin{macrocode} +\def\@listI{} +\let\@listi\@listI +\let\@listii\@listI +\let\@listiii\@listI +\let\@listiv\@listI +% \end{macrocode} +% \begin{macrocode} +\def\theenumi{\@arabic\c@enumi} +\def\theenumii{\@alph\c@enumii} +\def\theenumiii{\@roman\c@enumiii} +\def\theenumiv{\@Alph\c@enumiv} +% \end{macrocode} +% \begin{macrocode} +\def\labelenumi{\theenumi.} +\def\labelenumii{(\theenumii)} +\def\labelenumiii{\theenumiii.} +\def\labelenumiv{\theenumiv.} +% \end{macrocode} +% \begin{macrocode} +\def\p@enumii{\theenumi} +\def\p@enumiii{\theenumi(\theenumii)} +\def\p@enumiv{\p@enumiii\theenumiii} +% \end{macrocode} +% \begin{macrocode} +\def\labelitemi{\textbullet} +\def\labelitemii{\textbf{\textendash}} +\def\labelitemiii{\textasteriskcentered} +\def\labelitemiv{\textperiodcentered} +% \end{macrocode} +% +% \subsection{Default settings} +% +% As in other classes, some values are set here rather than at kernel level. The values used +% by the \textsf{chletter} class are as generic as possible. +% +% \subsubsection{Lists} +% +% \begin{macro}{\labelsep} +% \begin{macro}{\labelwith} +% \begin{macro}{\leftmargin} +% These default values are defined at document level and altered by |\closingmatter| +% (see next page) in the following manner: |\labelwidth3\labelsep| (usually |18pt|), +% |\leftmargin2\parindent| (|36pt| in an indented letter, |0pt| in a default letter). +% +% \begin{macrocode} +\labelsep6\p@\labelwidth12\p@\leftmargin18\p@ +% \end{macrocode} +% \begin{macrocode} +\topsep\z@\partopsep3\p@\itemsep\z@\parsep3\p@ +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% +% \subsubsection{Environments} +% +% Exactly as in the standard classes. +% \begin{macrocode} +\arraycolsep5\p@ +\tabcolsep6\p@ +\arrayrulewidth.4\p@ +\doublerulesep2\p@ +\tabbingsep\labelsep +\skip\@mpfootins=\skip\footins +\def\theequation{\@arabic\c@equation} +% \end{macrocode} +% +% \subsubsection{Framed boxes} +% +% \begin{macro}{\fboxsep} +% \begin{macro}{\fboxrule} +% Apart from their ordinary application, the values defined here are used by the default +% |\foldmark| macro defined by the |foldmark| class option. +% +% \begin{macrocode} +\fboxsep3\p@ +\fboxrule.4\p@ +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \subsubsection{Footnotes} +% +% Light is right! This definition is minimalist, at the same time sensible. +% \begin{macrocode} +\long\def\@makefntext#1{\noindent\hb@xt@\z@{\hss\@makefnmark}#1} +% \end{macrocode} +% +% \subsubsection{Letter} +% +% Some specific letter values are initialized here. +% +% \begin{macro}{\fromname} +% \begin{macro}{\fromsig} +% \begin{macro}{\fromaddress} +% \begin{macro}{\fromlocation} +% \begin{macro}{\telephonenum} +% \begin{macro}{\returnaddress} +% |\fromname| is not empty by default, so is |\fromsig|: they contain the |\@author| value, +% which is defined at kernel level to output nothing but a warning message (no author given). +% |\@author| will be modified by the \LaTeX\ |\author| command. |\fromlocation| and +% |\fromaddress| are somewhat redundant, but they may be used for special purpose. +% |\returnaddress| should also output nothing by default, but it has to leave an empty line, +% hence the |\null| trick (actually an empty |\hbox|). +% +% \begin{macrocode} +\def\fromname{\@author} +\def\fromsig{\@author} +\let\fromlocation\@empty +\let\fromaddress\@empty +\let\telephonenum\@empty +\def\returnaddress{\null} +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\toname} +% \begin{macro}{\toaddress} +% These values retrieved or adjusted at the opening of a |letter| environment. +% They are initialized here to prevent an error in certain condition. +% +% \begin{macrocode} +\let\toname\@empty +\let\toaddress\@empty +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\salutation} +% \begin{macro}{\valediction} +% These values are retrieved or adjusted respectively by the |\opening| and |\closing| +% commands. They are initialized here to prevent an error in certain condition. +% +% \begin{macrocode} +\let\salutation\@empty +\let\valediction\@empty +% \end{macrocode} +% \end{macro} +% \end{macro} +% \subsubsection{Words} +% +% \begin{macro}{\ccname} +% \begin{macro}{\enclname} +% \begin{macro}{\pagename} +% \begin{macro}{\headtoname} +% These words are common to the common \textsf{letter} classes. They will be adjusted by the +% linguistic packages (\textsf{babel} or \textsf{polyglossia}). |\ccname| and |\enclname| are +% used respectively by the |\cc| and |\encl| macros; while |\pagename| and |\headtoname| are +% used within |\pagestyle| layouts and some additional packages. +% +% \begin{macrocode} +\def\ccname{cc} +\def\enclname{encl} +\def\pagename{Page} +\def\headtoname{To} +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% \end{macro} +% +% \subsubsection{Date} +% +% \begin{macro}{\today} +% The |\@date| field, which appears in the letterhead, defaults to |\today|. The |\today| +% value will be adjusted by the linguistic packages (\textsf{babel} or \textsf{polyglossia}). +% +% \begin{macrocode} +\def\today +{\ifcase\month\or + January\or February\or March\or April\or May\or June\or + July\or August\or September\or October\or November\or December\fi + \space\number\day, \number\year} +% \end{macrocode} +% \end{macro} +% +% \subsubsection{Two column mode} +% +% \begin{macro}{\columnsep} +% This is tricky! The idea is to align the columns with the addresses. In a default +% (A4) letter, the second column will align with the recipient's address and the date. +% +% \begin{macrocode} +\columnsep36\p@ +% \end{macrocode} +% \end{macro} +% +% \subsubsection{The page style} +% +% We have |\pagetyle{plain}| pages in this document class (except the letterhead +% page which has |\thispagestyle{firspage}|). We use arabic page numbers. +% +% \begin{macrocode} +\pagestyle{plain} +\pagenumbering{arabic} +% \end{macrocode} +% +% \subsection{Later initializations} +% +% This code handles the class options |leftwin|, |leftsig|, |foldmark|, |footfill| and +% |twocolumn| (retrieved by the associated booleans). It defines the default layout of the +% letter and would be very interesting for those who wish to completely customize the letter +% appearance by redefining the relevant macros. +% +% \subsubsection{Letterhead layout} +% +% \begin{macro}{\titletopmatter} +% \begin{macro}{\titlemidmatter} +% \begin{macro}{\titlebotmatter} +% The default layout of the letterhead is defined here, taking in account the class option +% |leftwin|. |\titletopmatter|, |\titlemidmatter| and |\titlebotmatter| are three strips of +% |\titletopheight|, |\titlemidheight| and |\titlebotheight| respective heights. Please note +% the usage of |\splitfield{...}{...}| which cuts a strip in two columns of |\adressmargin| +% and |\addresswidth| respective widths. +% +% \begin{macrocode} +\if@leftwin + \def\titletopmatter% + {\splitfield + {}{\fromlocation\par\fromname\par\fromaddress\par\telephonenum}} + \def\titlemidmatter% + {\returnaddress\par\toname\par\toaddress} + \def\titlebotmatter% + {\splitfield + {}{\@date}} +% \end{macrocode} +% \begin{macrocode} +\else + \def\titletopmatter% + {\splitfield + {\fromlocation\par\fromname\par\fromaddress\par\telephonenum}{\@date}} + \def\titlemidmatter% + {\splitfield + {}{\returnaddress\par\toname\par\toaddress}} + \def\titlebotmatter% + {}\fi +% \end{macrocode} +% \end{macro} +% \end{macro} +% \end{macro} +% +% \begin{macro}{\splitfield} +% The letterhead is divided in three vertically stacked strips of |\titlewidth| width, named +% respectively |\titletopmatter|, |titlemidmatter| and |titlebotmatter| (see above). The +% purpose of this command is to divide a strip in two columns, the first one of |\addressmargin| +% width, the second one of |\addresswidth| width (computed on the fly by |\maketitle|, see +% above). The letterhead may contain graphics (a logo for example), so we have to cope with +% the relative vertical placement of text and imported pictures, hence the |\hbox| and |\strut| +% in the definitions of the parboxes. +% +% \begin{macrocode} +\long\def\splitfield#1#2% +{\parbox[b][\baselineskip][t]{\addressmargin}{\hb@xt@\z@{}{#1}\strut}% + \parbox[b][\baselineskip][t]{\addresswidth}{\hb@xt@\z@{}{#2}\strut}} +% \end{macrocode} +% \end{macro} +% +% \subsubsection{Signature layout} +% +% \begin{macro}{\closingmatter} +% |\closingmatter| is output by the |\closing| command and can contain any piece of text or +% code. |\fooftill| is an extra glue for better letter foot balancing (see below). Please +% note the crafty use of the |\ps| command. Also remember that |\leftmargin| and |\labelwidth| +% values are changed by this |\closingmatter|. +% +% \begin{macrocode} +\if@leftsig + \def\closingmatter% + {\leftmargin2\parindent + \vskip4\bigskipamount + \ps{}{\fromsig} + \vskip2\bigskipamount plus\footfill + \labelwidth3\labelwidth + \advance\labelwidth-\labelsep} +% \end{macrocode} +% \begin{macrocode} +\else + \def\closingmatter% + {\leftmargin\longindentation + \vskip4\bigskipamount + \ps{}{\fromsig} + \vskip2\bigskipamount plus\footfill + \leftmargin2\parindent + \labelwidth3\labelwidth + \advance\labelwidth-\labelsep}\fi +% \end{macrocode} +% \end{macro} +% +% \subsubsection{Fold mark} +% +% \begin{macro}{\foldmark} +% The |foldmark| class option alters the |\foldmark| macro, which causes a line to be added +% between the letterhead and the main text. Default is |\@empty|. +% +% \begin{macrocode} +\if@foldmark\def\foldmark{\hrule\@width6\fboxsep\@height\fboxrule} +\else\let\foldmark\@empty\fi +% \end{macrocode} +% \end{macro} +% +% \subsubsection{Letter footer} +% +% \begin{macro}{\footfill} +% A conditionnal definition of |\footfill| will alter the layout of |\closingmatter| +% (see above), adding an extra vertical glue after the signature. Default is |\@empty|. +% +% \begin{macrocode} +\if@footfill\def\footfill{1fill} +\else\let\footfill\z@\fi +% \end{macrocode} +% \end{macro} +% +% \subsubsection{Two column mode} +% +% The column separator (|\columnsep|) is initialized earlier in the class code. +% Please note that in one column mode we reverse the position of the margin paragraphs. +% +% \begin{macrocode} +\if@twocolumn\twocolumn\sloppy +\else\onecolumn\reversemarginpar\fi +% \end{macrocode} +% +% \subsection{Legacy} +% +% Unfortunately some widely spread packages still relie on this! +% +% \begin{macrocode} +\DeclareOldFontCommand{\rm}{\normalfont\rmfamily}{\mathrm} +\DeclareOldFontCommand{\sf}{\normalfont\sffamily}{\mathsf} +\DeclareOldFontCommand{\tt}{\normalfont\ttfamily}{\mathtt} +\DeclareOldFontCommand{\bf}{\normalfont\bfseries}{\mathbf} +\DeclareOldFontCommand{\it}{\normalfont\itshape}{\mathit} +\DeclareOldFontCommand{\sl}{\normalfont\slshape}{\relax} +\DeclareOldFontCommand{\sc}{\normalfont\scshape}{\relax} +% \end{macrocode} +% +% \begin{macrocode} +% +% \end{macrocode} +% +% \pagebreak +% +% \section{Letter template} +% +% \setcounter{CodelineNo}{0} +% +% The following \LaTeX\ document is intended to be used as a template. It will also +% compile with the standard \textsf{letter} class and the older version of the +% \textsf{chletter} class.\bigskip +% +% Please note that the \textsf{chextras} companion package will simplify the preparation of +% Swiss documents by setting up linguistic packages, font encoding and document layout. +% Look at \textsf{chextras} documentation for further information. +% +% \begin{macrocode} +%<*chlettmp.tex> +% \end{macrocode} +% +% \begin{macrocode} +\documentclass{chletter} + +%%\usepackage[english,black]{chextras} + +\author{My name} +\address{My address\\My City} +\telephone{My phone\\My email} +\date{My location, \today} + +\begin{document} +\begin{letter}{Name\\Address\\City} + +\opening{Dear \toname,} + +Body text. + +\closing{Yours truly,} + +\encl{Enclosures} +\cc{Other recipients} + +\end{letter} +\end{document} +% \end{macrocode} +% \begin{macrocode} +% +% \end{macrocode} +% +% \pagebreak +% +% \Finale +% \PrintIndex +\endinput + + diff --git a/macros/latex/contrib/chletter/chletter.ins b/macros/latex/contrib/chletter/chletter.ins new file mode 100644 index 0000000000..5bf5aad406 --- /dev/null +++ b/macros/latex/contrib/chletter/chletter.ins @@ -0,0 +1,62 @@ +%% +%% Copyright 2008, 2009, 2010 by Boris Oriet +%% +%% This file may be distributed and/or modified under the conditions of +%% the LaTeX Project Public License, either version 1.3c of this license +%% or (at your option) any later version. The latest version of this +%% license is in: +%% +%% http://www.latex-project.org/lppl.txt +%% +%% and version 1.3c or later is part of all distributions of LaTeX version +%% 2008/05/04 or later. +%% +%% This file has the LPPL maintenance status "author-maintained". +%% +\input docstrip +\keepsilent + +\preamble + +Copyright 2008, 2009, 2010 by Boris Oriet + +This file may be distributed and/or modified under the conditions of +the LaTeX Project Public License, either version 1.3c of this license +or (at your option) any later version. The latest version of this +license is in: + + http://www.latex-project.org/lppl.txt + +and version 1.3c or later is part of all distributions of LaTeX version +2008/05/04 or later. + +This file has the LPPL maintenance status "author-maintained". + +\endpreamble + +\generate{\file{chletter.cls}{\from{chletter.dtx}{chletter.cls}}} + +\nopreamble +\nopostamble + +\generate{\file{chlettmp.tex}{\from{chletter.dtx}{chlettmp.tex}}} + + +\obeyspaces +\Msg{*************************************************************} +\Msg{* *} +\Msg{* To finish the installation you have to move the following *} +\Msg{* file into a directory searched by TeX: *} +\Msg{* *} +\Msg{* chletter.cls *} +\Msg{* *} +\Msg{* The chlettemp.tex file can be used as a letter template. *} +\Msg{* *} +\Msg{* To produce the documentation run the file chletter.dtx *} +\Msg{* through LaTeX. *} +\Msg{* *} +\Msg{* Happy TeXing! *} +\Msg{* *} +\Msg{*************************************************************} + +\endbatchfile diff --git a/macros/latex/contrib/chletter/chletter.pdf b/macros/latex/contrib/chletter/chletter.pdf new file mode 100644 index 0000000000..dac6a0ae61 Binary files /dev/null and b/macros/latex/contrib/chletter/chletter.pdf differ -- cgit v1.2.3