cours0708/G53/ArchComplexes/fncychap/fncychap.tex

394 lines
17 KiB
TeX
Raw Normal View History

2008-06-04 10:03:04 +00:00
\documentclass{report}
\setlength{\textheight}{23 cm}
\setlength{\voffset}{-0.54cm}
\setlength{\hoffset}{-0.54cm}
\setlength{\oddsidemargin}{0.5 cm}
\setlength{\evensidemargin}{0.5 cm}
\setlength{\textwidth}{16 cm}
\setlength{\marginparwidth}{2.5 cm}
\setlength{\topmargin}{0.5 cm}
\setlength{\headheight}{0.5 cm}
\setlength{\headsep}{0.5 cm}
% \setlength{\voffset}{-5cm}
\usepackage[T1]{fontenc}
\usepackage{graphicx}
\usepackage[Lenny]{fncychap}
\usepackage{ydrop}
\newcommand{\sk}{\vspace{0.2 cm}}
\newcommand{\A}[1]{{$\backslash${\tt #1}}}
\newcommand{\nsp}{\mbox{\hspace{-1 cm}}}
\title{FncyChap V1.34}
\author{Ulf A. Lindgren}
\date{}
\begin{document}
\maketitle
\tableofcontents
\setlength{\dropcapsheight}{24pt}
\chapter{Package description}
\drop{T}he package \textsl{fncychap} has been written such that
chapter level headings can be altered fast and for me to learn more
about \LaTeX{} and \TeX{}. I have no idea if this package is
written in a good way. Thus, if anyone reads and tries {\em
FncyChap} I would appreciate any feedback. This will help me gain
insight in writing macros.
In any publication it is important to remember that consistency
plays an important role. That is, with this package one can change
the appearance of each chapter in the publication. However, this is
not desirable so don't forget modesty and consistency.
\section{Basic use and requirements}
The package is invoked by writing the following in the preamble of
your document\sk\\
\nsp\fbox{\A{usepackage}[{\em style}]\{{\em fncychap}\}}\sk\\
If the option, {\em style}, is omitted then the default definition
of chapter is used. Originally, there were six predefined chapter styles,
namely {\em Sonny, Lenny, Glenn, Conny, Rejne} and {\em Bjarne}.
The names corresponds to Swedish given names, almost surely (a.s.)
like
IKEA\footnote{reg. trademark of Ingvar Kamprad Emtaryd
Agunnaryd}. Each such style has a default configuration and if
that configuration is sufficient, then this is all that is needed.
In the present release of \textsl{fncychap} two additional chapter
definitions have been included. The first of these is named {\em
PetersLenny}, after the author Peter Osborn. This chapter
definition is based on {\em Lenny}, Peter has carefully tweaked
the measures of the lines, individually, for each chapter number (up to 20)
and each appendix (up to Z). The second chapter head is a new one
defined by Jean-Marc Francois and he named it \textsl{Bjornstrup}.
Originally, \textsl{fncychap} did not rely on any other package. However, for the
style {\tt Lenny} a postscript font is default, but this font can
easily be changed. I encourage the use of the default postscript
font since it is scalable in a truly huge manner, which makes
{\em Lenny} nice. In the current release and with the use of
Jean-Marcs \textsl{Bjornstrup} the color package from the base
distribution will be invoked.
\chapter{Commands provided}
\drop{A} part from the chapter styles, some additional commands are
provided in order to create user defined chapter heads. The commands
will in the sequel be described. Each command is boxed and placed on
a separate line. Lets begin the descriptions of the commands.\sk\\
\nsp\fbox{\A{mghrulefill}\{{\em width}\}}\sk\\
The above command is a more general version of the command
\A{hrulefill} in the sense that the width of the ruler can be
specified. This command is provided in order to decorate the chapter
headers. The chapter heading are divided into two parts. The first
part defines the so called \A{chapapp} and \A{thechapter} which
holds information of the text ``Chapter'' and the current chapter number
respectively. The second part is the chapter title provided by the
user. From now one, the \A{chapapp} and \A{thechapter} will be
referred to as chapter name and chapter number respectively. The
user defined title is referred to as the chapter title.
\section{Toward customization of the chapter head}
\label{sec:TW}
The chapter name, number and title can be changed easy, first lets
introduce the following two commands\sk\\
\nsp\fbox{\A{ChNameUpperCase}}\sk\\
and\sk\\
\nsp\fbox{\A{ChNameLowerCase}}\sk\\
these commands will change the chapter name into either upper or
lower case. One additional case command is provided for the
chapter name, namely\sk\\
\nsp\fbox{\A{ChNameAsIs}}\sk\\
which result in the default case. Three similar commands for the
chapter title are defined by the commands\sk\\
\nsp\fbox{\A{ChTitleUpperCase}, \A{ChTitleLowerCase} and
\A{ChNameAsIs}}\sk\\
The rule width of the predefined chapter styles can be controlled
by the command\sk\\
\nsp\fbox{\A{ChRuleWidth}\{{\em width}\}}\sk\\
just remember that the {\em width} must have a unit, for instance
{\em pt, mm, etc}. The font related matters such as size, type and
face can be sent using the commands\sk\\
\nsp\fbox{\A{ChNameVar}\{{\em stuff}\}, \A{ChNumVar}\{{\em stuff}\} and
\A{ChTitleVar}\{{\em stuff}\}}\sk\\
related to the chapter name number and title respectively.
The argument, {\em stuff}, to these functions can be for example
\mbox{\A{ChNameVar}\{\A{huge}\A{rm}\A{centering}\}}.
\enlargethispage{1cm}
\chapter{An overview of the chapter styles}
\setlength{\dropcapsheight}{28pt}
\drop{T}he chapter styles have default settings for all of the functions
described in section~\ref{sec:TW}. However, it can be changed
using the commands. Note that if \A{centering}, etc is used to
format the text part of the chapter style then the result can be
ugly. The chapter style {\em Bjarne} contains one additional
command\sk\\
\nsp\fbox{\A{TheAlphaChapter}}\sk\\
This command will write the chapter number using the corresponding
word. \A{TheAlphaChapter} have a capability of writing the words
{\em ZERO} to {NINETYNINE}.
In the following sections the pre-defined styles are shown along
with the default settings. Both the \A{chapter} and \A{chapter*}
are given.
\section{The chapter Sonny}
The following settings have been used as default parameters
{\small\begin{verbatim}
\ChNameVar{\Large\sf} \ChNumVar{\Huge} \ChTitleVar{\Large\sf}
\ChRuleWidth{0.5pt} \ChNameUpperCase
\end{verbatim}}
\begin{figure}[h]
\begin{minipage}{7 cm}
\label{fig:Sonnys}
\centerline{\includegraphics[height=6cm]{Sonnys.eps}}
\caption{The stared chapter style sonny}
\end{minipage}\hfill
\begin{minipage}{7 cm}
\label{fig:Sonny}
\centerline{\includegraphics[height=6cm]{Sonny.eps}}
\caption{The chapter style Sonny}
\end{minipage}\hfill
\end{figure}
% \clearpage
\section{The chapter Lenny}
The following settings have been used as default parameters
{\small\begin{verbatim}
\ChNameVar{\fontsize{14}{16}\usefont{OT1}{phv}{m}{n}\selectfont}
\ChNumVar{\fontsize{60}{62}\usefont{OT1}{ptm}{m}{n}\selectfont}
\ChTitleVar{\Huge\bfseries\rm}, \ChRuleWidth{1pt}
\end{verbatim}}
\begin{figure}[h]
\begin{minipage}{7 cm}
\centerline{\includegraphics[height=6cm]{Lennys.eps}}
\caption{The stared chapter style Lenny}
\end{minipage}\hfill
\begin{minipage}{7 cm}
\centerline{\includegraphics[height=6cm]{Lenny.eps}}
\caption{The chapter style Lenny}
\end{minipage}\hfill
\end{figure}
\textbf{Note:} An alternative version of this chapter head exist
entitled \textsl{PetersLenny}.
%\enlargethispage{2cm}
\section{The chapter Glenn}
The following settings have been used as default parameters
{\small\begin{verbatim}
\ChNameVar{\bfseries\Large\sf}, \ChNumVar{\Huge}, \ChTitleVar{\bfseries\Large\rm},
\ChRuleWidth{1pt}, \ChNameUpperCase, \ChTitleUpperCase
\end{verbatim}}
\begin{figure}[h]
\begin{minipage}{7 cm}
\centerline{\includegraphics[height=6cm]{Glenns.eps}}
\caption{The stared chapter style Glenn}
\end{minipage}\hfill
\begin{minipage}{7 cm}
\centerline{\includegraphics[height=6cm]{Glenn.eps}}
\caption{The chapter style Glenn}
\end{minipage}\hfill
\end{figure}
\section{The chapter Conny}
The following settings have been used as default parameters
{\small\begin{verbatim}
\ChNameUpperCase \ChTitleUpperCase \ChNameVar{\centering\Huge\rm\bfseries}
\ChNumVar{\Huge} \ChRuleWidth{2pt} \ChTitleVar{\centering\Huge\rm}
\end{verbatim}}
\begin{figure}[h]
\begin{minipage}{7 cm}
\centerline{\includegraphics[height=6cm]{Connys.eps}}
\caption{The stared chapter style Conny}
\end{minipage}\hfill
\begin{minipage}{7 cm}
\centerline{\includegraphics[height=6cm]{Conny.eps}}
\caption{The chapter style Conny}
\end{minipage}\hfill
\end{figure}
\section{The chapter Rejne}
The following settings have been used as default parameters\\
{\small\begin{verbatim}
\ChNameVar{\centering\Huge\rm\bfseries}, \ChNumVar{\Huge}, \ChTitleVar{\centering\Huge\rm}
\ChNameUpperCase, \ChTitleUpperCase, \ChRuleWidth{1pt}
\end{verbatim}}
\begin{figure}[h]
\begin{minipage}{7 cm}
\centerline{\includegraphics[height=6cm]{Rejnes.eps}}
\caption{The stared chapter style Rejne}
\end{minipage}\hfill
\begin{minipage}{7 cm}
\centerline{\includegraphics[height=6cm]{Rejne.eps}}
\caption{The chapter style Rejne}
\end{minipage}\hfill
\end{figure}
\section{The chapter Bjarne}
The following settings have been used as default parameters\\
{\small\begin{verbatim}
\ChNameUpperCase \ChNameVar{\raggedleft\normalsize\rm} \ChRuleWidth{1pt}
\ChTitleUpperCase \ChNumVar{\raggedleft \bfseries\Large} \ChTitleVar{\raggedleft \Large\rm}
\end{verbatim}}
\begin{figure}[h]
\begin{minipage}{7 cm}
\centerline{\includegraphics[height=6cm]{Bjarnes.eps}}
\caption{The stared chapter style Bjarne}
\end{minipage}\hfill
\begin{minipage}{7 cm}
\centerline{\includegraphics[height=6cm]{Bjarne.eps}}
\caption{The chapter style Bjarne}
\end{minipage}\hfill
\end{figure}
\section{The chapter Bjornstrup}
The following settings have been used as default parameters\\
{\small\begin{verbatim}
\ChNumVar{\fontsize{76}{80}\usefont{OT1}{pzc}{m}{n}\selectfont}
\ChTitleVar{\raggedleft\Large\sffamily\bfseries}
\end{verbatim}}
\begin{figure}[h]
\begin{minipage}{7 cm}
\centerline{\includegraphics[height=6cm]{BjornstrupS.eps}}
\caption{The stared chapter style Bjornstrup}
\end{minipage}\hfill
\begin{minipage}{7 cm}
\centerline{\includegraphics[height=6cm]{Bjornstrup.eps}}
\caption{The chapter style Bjornstrup}
\end{minipage}\hfill
\end{figure}
\textbf{Note:} It appears as if the rendering in YAP (dvi previewer in
MikTeX) differs from dvips in that the gray box become
foreground. Thus, the chapter number is partly hidden.
\enlargethispage{2cm}
\chapter{A simple example}
\drop{I}f the pre defined styles does not fulfill your needs then you can
modify the formating routines. The formatting is controlled by
three commands. One might as well redefine the original
chapter definitions using the \A{secdef} and \A{renewcommand}, see
The \LaTeX{} companion. However, at the time of creating this
package I decided that this was easier. The command\sk\\
\nsp\fbox{\A{DOCH}}\sk\\
formats the chapter name and number. The commands\sk\\
\nsp\fbox{\A{DOTI}\{{\#1}\}}\sk\\
and\sk\\
\nsp\fbox{\A{DOTIS}\{{\#1}\}}\sk\\
formats the chapter title for \A{chapter} and \A{chapter*} respectively.
In order to modify these you will have to use the preamble along
with the commands \A{makeatletter} and \A{makeatother}. The in
addition some predefined parameters can be used. The predefined
length variables are\sk\\
\nsp\fbox{\A{mylen}, \A{myhi}, \A{px}, \A{py}, \A{pxx}, \A{pyy}
and \A{RW}}\sk\\
note that \A{RW} is special, since it is set by \A{ChRuleWidth}.
The formatting controlled by \A{ChNameVar}, \A{ChNumVar} and
\A{ChTitleVar} store their values in \A{CNV}, \A{CNoV} and \A{CTV}
respectively. Finally, The functions \A{FmN}\{ \} and \A{FmTi}\{
\} acts accordingly to \A{Ch***AsIs}, \A{Ch***UpperCase} and
\A{Ch***LowerCase}. Note that the stars indicate appropriate
substitution of text, see section~\ref{sec:TW}.
To illustrate this lets define a new chapter style in which the
Chapter name and number in a \A{fbox} and the chapter title
centered. The \A{fboxrule} is linked to the predefined length
\A{RW} so that it can be controlled by the command
\A{ChRuleWidth}. Try this example at a computer near you.
\begin{verbatim}
\makeatletter
\ChNameVar{\Large\rm} % sets the style for name
\ChNumVar{\Huge} % sets the style for digit
\ChTitleVar{\Large\rm\centering} % sets the style for title
\ChRuleWidth{4pt} % Set RW=4pt
\ChNameUpperCase % Make name uppercase
\renewcommand{\DOCH}{%
\setlength{\fboxrule}{\RW} % Let fbox lines be controlled by
% \ChRuleWidth
\fbox{\CNV\FmN{\@chapapp}\space \CNoV\thechapter}\par\nobreak
\vskip 40\p@}
\renewcommand{\DOTI}[1]{%
\CTV\FmTi{#1}\par\nobreak
\vskip 40\p@}
\renewcommand{\DOTIS}[1]{%
\CTV\FmTi{#1}\par\nobreak
\vskip 40\p@}
\makeatother
\end{verbatim}
That is all there is to it. Note that the commands \A{DOTI} and
\A{DOTIS} can be redefined anywhere in the document, but that is
not a good idea. Suppose that you want to use the
\A{TheAlphaChapter}. This can be done by initially chose the style
{\em Bjarne}\/ and then redefine \A{DOCH}, \A{DOTI} and \A{DOTIS}.
\chapter{Revision details}
\drop{T}his is version 1.34, some minor problems have been
addressed and two new predefined chapter heads have been
incorporated. The upper case and lower case handling have been
corrected. A bad behavior in changes between \verb+\frontmatter+,
\verb+\mainmatter+ and \verb+\backmatter+, have been fixed.
In version 1.33 Rejne definition streched text caused ugly gaps
in the vrule aligned with the title text. A compatibility problem
with the KOMA class 'scrbook.cls' the remedy is a redefinition of
'\@schapter' in line with that used in KOMA. This might not be
good since it differs from the base definition. A spell error was
corrected.
In version 1.3, a problem with appendices in the Bjarne style was
corrected. Wrong behavior, for the commands
\verb+\frontmatter+, \verb+\mainmatter+ and \verb+\backmatter+
was dealt with.
In the release 1.11 of the current package. A bug
fix of the Lenny option was included. The problem, reported
by Diab Jerius, occurred (underfull vbox) when the option Lenny
was used in conjunction with \A{section}-command such that the
section is typeset at the next page. This caused one line to be
misplaced. The remedy was to box the chapter title.
In the release (1.1) of the current package. A
modification was made such that it will work with the book
class. The problem occurred when the fncychap styles Conny,
Rejne, Bjarne or Glenn were used in conjunction with the
\LaTeX{} command \A{tabelofcontents}. The exact reason for the
error is not yet found. The problem was reported by Olivier Guibe.
In the prior release there were no major improvements of the
package. However, the package name was changed in order to
conform with the (DOS) requirement of eight characters. I also
received some feedback, informing me that the \LaTeX{} base have
to be post 1994/12/01. This information has been included in
the package such that if an old base is used a warning will be
written into the {\tt
log}.\\
Release history:
\begin{description}
\item[Release 1] 1996/12/13 FancyChapters 1.0b
\item[Release 2] 1997/01/08 FncyChap 1.0 (Name change, base
date option)
\item[Release 3] 1997/01/22 FncyChap 1.1 (Bug fix)
\item[Release 4] 1997/04/06 FncyChap 1.11 (Bug fix)
\item[Release 5] 2004/09/20 FncyChap 1.3 (Bug fix)
\item[Release 6] 2005/08/09 FncyChap 1.33 (Bug fix)
\item[Release 7] 2007/07/31 FncyChap 1.34 (Bug fix)
\end{description}
\end{document}
%%% Local Variables:
%%% mode: latex
%%% TeX-master: t
%%% End: