From 007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 9 Jan 2006 00:49:07 +0000 Subject: doc/latex git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/leaflet/README | 15 + .../doc/latex/leaflet/leaflet-manual.pdf | Bin 0 -> 102148 bytes .../doc/latex/leaflet/leaflet-manual.tex | 330 +++++++++++++++++++++ Master/texmf-dist/doc/latex/leaflet/leaflet.pdf | Bin 0 -> 152621 bytes 4 files changed, 345 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/leaflet/README create mode 100644 Master/texmf-dist/doc/latex/leaflet/leaflet-manual.pdf create mode 100644 Master/texmf-dist/doc/latex/leaflet/leaflet-manual.tex create mode 100644 Master/texmf-dist/doc/latex/leaflet/leaflet.pdf (limited to 'Master/texmf-dist/doc/latex/leaflet') diff --git a/Master/texmf-dist/doc/latex/leaflet/README b/Master/texmf-dist/doc/latex/leaflet/README new file mode 100644 index 00000000000..a39c7699590 --- /dev/null +++ b/Master/texmf-dist/doc/latex/leaflet/README @@ -0,0 +1,15 @@ +The leaflet class + +A document class to create small hand-outs (flyers) that fit on a single sheet +of paper which is then folded twice. Pages are rearranged by LaTeX so that they +print correctly on a single sheet -- no external script is necessary. (Works +with PostScript and PDF.) + +Recommended TDS locations: + + leaflet.cls: tex/latex/leaflet + leaflet.pdf,leaflet-manual.pdf: doc/latex/leaflet + +For general installation advice, see +http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages + diff --git a/Master/texmf-dist/doc/latex/leaflet/leaflet-manual.pdf b/Master/texmf-dist/doc/latex/leaflet/leaflet-manual.pdf new file mode 100644 index 00000000000..492cd461c63 Binary files /dev/null and b/Master/texmf-dist/doc/latex/leaflet/leaflet-manual.pdf differ diff --git a/Master/texmf-dist/doc/latex/leaflet/leaflet-manual.tex b/Master/texmf-dist/doc/latex/leaflet/leaflet-manual.tex new file mode 100644 index 00000000000..5102048031d --- /dev/null +++ b/Master/texmf-dist/doc/latex/leaflet/leaflet-manual.tex @@ -0,0 +1,330 @@ +%% +%% This is file `leaflet-manual.tex', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% leaflet.dtx (with options: `manual') +%% +%% Copyright (C) 2003, 2004 +%% Rolf Niepraschk, Rolf.Niepraschk@ptb.de +%% Hubert Gaesslein, HubertJG@open.mind.de +%% +%% This work may be distributed and/or modified under the +%% conditions of the LaTeX Project Public License, either version 1.3 +%% 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.3 or later is part of all distributions of LaTeX +%% version 2003/12/01 or later. +%% +%% This work has the LPPL maintenance status "author-maintained". +%% +\def\filename{leaflet-manual.tex} +\def\fileversion{v1.0c} % change this when leaflet-manual changed, too. +\def\filedate{2004/12/22} +\def\docdate {2004/08/12} % change this when leaflet-manual changed, too. +\listfiles +\errorcontextlines=99 +\documentclass[ +%%notumble, +%%nofoldmark, +%%dvipdfm, +%%portrait, +%%titlepage, +%%nocombine, +%%a3paper, +%%debug, +%%nospecialtricks, +%%draft, +]{leaflet} + + +\renewcommand*\foldmarkrule{.3mm} +\renewcommand*\foldmarklength{5mm} + +\usepackage[T1]{fontenc} +\usepackage{textcomp} +\usepackage{mathptmx} +\usepackage[scaled=0.9]{helvet} +\makeatletter +\def\ptmTeX{T\kern-.1667em\lower.5ex\hbox{E}\kern-.075emX\@} +\DeclareRobustCommand{\ptmLaTeX}{L\kern-.3em + {\setbox0\hbox{T}% + %\vb@xt@ % :-) + \vbox to\ht0{\hbox{% + \csname S@\f@size\endcsname + \fontsize\sf@size\z@ + \math@fontsfalse\selectfont + A}% + \vss}% + }% + \kern-.12em + \ptmTeX} +\makeatother +\let\TeX=\ptmTeX +\let\LaTeX=\ptmLaTeX +\usepackage{shortvrb} +\MakeShortVerb{\|} +\usepackage{url} +\usepackage{graphicx} +\usepackage[dvipsnames,usenames]{color} +\definecolor{LIGHTGRAY}{gray}{.9} + +%%%%\renewcommand{\descfont}{\normalfont} +\newcommand\Lpack[1]{\textsf{#1}} +\newcommand\Lclass[1]{\textsf{#1}} +\newcommand\Lopt[1]{\texttt{#1}} +\newcommand\Lprog[1]{\textit{#1}} + +\newcommand*\defaultmarker{\textsuperscript\textasteriskcentered} + +\title{The document class \Lclass{leaflet}} +\author{% + Rolf Niepraschk\\ + Walter Schmidt\\ + Hubert G\"a\ss lein} +\date{Last updated~\docdate\\printed \today} + +\CutLine*{1}% Dotted line without scissors +\CutLine{6}% Dotted line with scissors + +\AddToBackground{5}{% Background of a small page + \put(0,0){\textcolor{Cerulean}{\rule{\paperwidth}{\paperheight}}}} + +\AddToBackground*{2}{% Background of a large page + \put(\LenToUnit{.5\paperwidth},\LenToUnit{.5\paperheight}){% + \makebox(0,0)[c]{% + \resizebox{.9\paperwidth}{!}{\rotatebox{35.26}{% + \textsf{\textbf{\textcolor{LIGHTGRAY}{BACKGROUND}}}}}}}} + +\begin{document} + +\maketitle +\thispagestyle{empty} + +%%\LARGE + +%%\tableofcontents + +\section{Overview} + +The document class \Lclass{leaflet} creates a document of (up to) six +small pages in portrait orientation, arranged physically on two +``normal-size'' pages. The target page sizes supported by the standard +\LaTeX{} \Lclass{article} are available, plus |a3paper|. Printing these +to both sides of a sheet and folding appropriately will yield a six-page +leaflet. + +%% TEST: These commands are no longer disabled! +\iffalse +\reversemarginpar +\marginpar[XXX]{YYY} +\fi +%% TEST: These commands are disabled! +\onecolumn +\twocolumn[WWW] +%% end of TEST + +\section{Requirements} + +Using the \Lclass{leaflet} class requires that the final +document is created in PostScript or PDF format, using +\begin{itemize} + \item \TeX{} and \Lprog{dvips}, or + \item pdf\TeX{}, or + \item V\TeX{} in PS or PDF mode. +\end{itemize} +(Some other drivers supported by standard \LaTeX{} work as well.) + +The non-standard macro package \Lpack{everyshi} \cite{cit:everyshi} is +used by the \Lclass{leaflet} class. + +\section{Features} + +Basically the \Lclass{leaflet} class provides the same features as the +standard \Lclass{article} class. There are, however, a number of +differences and restrictions, as well as some additional facilities and +peculiarities: + +\begin{itemize} + +\item +The sectioning level |\part| is not available. +The other sectioning levels are not numbered by default. + +\item +References to the page where floating objects are located may come out +wrong (this includes |\pageref| as well as |\listof...| commends). + +\item +Section headers are typeset in a smaller font size than in the +standard classes. + +\item +You may use list-like environments just as in the standard classes. +The left margins have been adjusted to work well with the +\Lopt{a4paper} and \Lopt{letterpaper} class options. +With other target page sizes, you'll have to adjust them. + +Here's a small demo: +\begin{description} +\item[Uncle Meat] First entry in a description environment. +\item[King Kong] Second entry. + \begin{itemize} + \item First entry in an itemize environment. + \begin{enumerate} + \item First entry in an enumerate environment. + \item Second entry. + \begin{enumerate} + \item First entry in an enumerate environment. + \begin{enumerate} + \item First entry in an enumerate environment. + \item Second entry. + \end{enumerate} + \item Second entry. + \begin{itemize} + \item First entry in an itemize environment. + \item Second entry. + \end{itemize} + \item Another entry. + \end{enumerate} + \item Another entry. + \end{enumerate} + \item Second entry. + \item Another entry. + \end{itemize} +\item[Frunobulax] Another entry. +\end{description} + +\item +Marginal notes are pointless on the given page size and +are disabled. + +\item +Two-column typesetting is not supported for the same reason. + +\item +By default, there are no page headers, page footers or page numbers, +nor is there any space reserved for these. + +However, you can restore them, if you like. +To do so, use |\pagestyle| as with the standard classes, +and |\setlength| to adjust the corresponding parameters (like +|\headheight|). +At last, you have to call the new macro \par +| \setmargins{top}{bottom}{left}{right}|. + +\item +Paragraphs are separated by vertical space; the first line +of a paragraph is not indented by default. + +\item +By default, all paragraphs are typeset as if you had +specified |\sloppy| in the document preamble. + +\item +A small folding mark is created between the second and the +third page. + +\item +The macro |\CutLine| draws a vertical dotted line with +scissor symbols between the page indicated by its argument and the +preceding one. +The starred version omits the scissors symbols. + +\item +In case the text does not fit on six pages, a warning (or error, +depending on some class option, see below) will be issued. + +\item +To add some background picture to individual pages, you can use +|\AddToBackground| commands. Its first argument specifies the page, +the second one the picture commands. +The starred version puts the picture on the combined pages. + +\end{itemize} + +\section{Customization} + +The typeface to be used for the section headings is given by the macro +|\sectfont|, and the typeface to be used for the labels of the +|description| environment is given by |\descfont|. +Both macros default to |\bfseries| and can be changed using +|\renewcommand*|. + +The horizontal and vertical and margins of the (small) pages +default to 8\,mm and 11\,mm, respectively, and can be changed +using |\setmargins|, as explained above. +This may be useful, if the printing engine exhibits larger unprintable +margins. + +The macros |\foldmarkrule| and |\foldmarklength| determine the stroke +width and the length of the fold mark, which is printed between the +second and the third page. +They default to 0.4\,pt and 2\,mm, respectively, and can be changed +using |\renewcommand*| (\emph{not} |\setlength|!). +See also the class options \Lopt{foldmark} and \Lopt{nofoldmark}. + +\section{Class options} + +Default options are marked with an asterisk: +\begin{description} +\item[\Lopt{tumble}{\defaultmarker}, \Lopt{notumble}] + By default, the contents of the back side of the final sheet is + printed upside down. + The option \Lopt{notumble} suppresses that. + Doing so may be necessary to suit the behavior of certain printing + engines. + Specifying \Lopt[notumble] may also be useful during the writing of + a document, to enable proof-reading on the screen. +\item[\Lopt{frontside}, \Lopt{backside}, \Lopt{bothsides}{\defaultmarker}] + These options control whether only the front page, the back page or + both pages of the final sheet are to be be created. + Thus, you can create separate files for the front an back side of + the sheet. +\item[\Lopt{foldmark}{\defaultmarker}, \Lopt{nofoldmark}] + These options specifiy whether or not a fold mark is to be printed. +\item[\Lopt{combine}{\defaultmarker}, \Lopt{nocombine}] + These options specify whether the (small) pages should be output + combined on a (large) target page (\Lopt{combine}) or as individual + pages (\Lopt{nocombine}). + + At the same time, the determine behaviour in case the text does not + fit on six (small) pages. + By default (\Lopt{combine}), an error is raised---and the surplus pages + will be gobbled. + Otherwise (\Lopt{nocombine}), just a warning will be issued; + shortening the text appropriately is left to the user. +\end{description} + +Other options are passed to the \Lclass{article} class. + +\section{Changes over version 0.3} + +The present release of the \Lclass{leaflet} class differs basically +from its predecessor, version~0.3, which had been developed originally +by J\"urgen Schlegelmilch. + +The main change is, that no more post-processing is required to +arrange the pages on the sheet. +Furthermore, the overall layout has been changed slightly to suit the +small page size better. +In general, documents that were written for version~0.3 will exhibit +different line and page breaks when typeset using the new version of +this document class. + +\begin{thebibliography}{000} +\bibitem{cit:latex-man} + \textsc{L.\,Lamport}: \LaTeX. A Document Preparation System. + \textit{User's Guide And Reference Manual.} Second Edition. 1994. +\bibitem{cit:everyshi} + \textsc{M.\,Schr\"oder}: The \Lpack{everyshi} package. 2001. + CTAN: \url{macros/latex/contrib/ms/everyshi.dtx} +\end{thebibliography} + +\loggingall +\end{document} +\endinput +%% +%% End of file `leaflet-manual.tex'. diff --git a/Master/texmf-dist/doc/latex/leaflet/leaflet.pdf b/Master/texmf-dist/doc/latex/leaflet/leaflet.pdf new file mode 100644 index 00000000000..f490d458012 Binary files /dev/null and b/Master/texmf-dist/doc/latex/leaflet/leaflet.pdf differ -- cgit v1.2.3