% C I T E . S T Y
%
% version 3.6 (June 1996)
%
% Compressed, sorted lists of numerical citations: [11-16]
% see also OVERCITE.STY and DRFTCITE.STY
%
% Copyright (C) 1989-1996 by Donald Arseneau
% These macros may be freely transmitted, reproduced, or modified
% provided that this notice is left intact.
%
% Instructions follow \endinput.
% ------------------------------------
% Handle optional variations: [verbose,nospace,space,nosort],
% \citeform,\citeleft,\citeright,\citemid,\citepunct
%
% Set defaults:
% [ on the left.
\@ifundefined{citeleft}{\let\citeleft=[}{}
% ] on the right:
\@ifundefined{citeright}{\let\citeright=]}{}
% , (comma space) before note
\@ifundefined{citemid}{\def\citemid{,\penalty\@medpenalty\ }}{}
% , (comma thin-space) between entries; [nospace] eliminates the space
\@ifundefined{citepunct}{
\def\citepunct{,\penalty\@m\hskip.13emplus.1emminus.1em}%
}{}
% Each number left as-is:
\@ifundefined{citeform}{\def\citeform{}}{}
% Do not repeat warnings. [verbose] reverses
\let\oc@verbo\relax
\@ifundefined{DeclareOption}{}%
{ \toks@={\def\oc@verbo#1#2#3#4{}}
\DeclareOption{verbose}{\the\toks@}
\DeclareOption{nospace}{\def\citepunct{,\penalty\@m}}
\DeclareOption{space}{\def\citepunct{,\penalty\@highpenalty\ }}
\DeclareOption{nosort}{\def\@addto@cite@list
{\edef\@cite@list{\@cite@list \@celt{\@B@citeB}}}}
\DeclareOption{sort}{\let\@cite@list\relax}% default!
\ProvidesPackage{cite}[1996/05/23 \space v 3.6]
\ProcessOptions }
%----------------------
% \citen uses \nocite to ignore spaces after commas, and write the aux file
% \citation. \citen then loops over the citation tags, using \@make@cite@list
% to make a sorted list of numbers. Finally, \citen executes \@citelist to
% compress ranges of numbers and print the list. \citen can be used by itself
% to give citation numbers without the brackets and other formatting; e.g.,
% "See also ref.~\citen{junk}."
%
\edef\citen{\noexpand\protect \expandafter\noexpand\csname citen \endcsname}
\@namedef{citen }#1{%
\nocite{#1}% ignores spaces, writes to .aux file, returns #1 in \@tempa!!
\@tempcntb\m@ne % \@tempcntb tracks highest number
\let\@h@ld\relax % nothing held from list yet
\let\@citea\@empty % no punctuation preceding first
\let\@celt\delimiter % an unexpandable, but identifiable, token
\def\@cite@list{}% % empty list to start
\@for \@citeb:=\@tempa \do{\@make@cite@list}% make a sorted list of numbers
% After sorted citelist is made, execute it to compress citation ranges.
\@tempcnta\m@ne % no previous number
\let\@celt\@compress@cite \@cite@list % output number list with compression
\@h@ld}% output anything held over
% Aliases:
\let\citenum\citen
\let\citeonline\citen
% For each citation, check if it is defined and if it is a number.
% if a number: insert it in the sorted \@cite@list
% otherwise: output it immediately.
%
\begingroup \catcode`\_=8 % Just in case it was changed
\toks@={
\def\@make@cite@list{%
\expandafter\let \expandafter\@B@citeB
\csname b@\@citeb\@extra@b@citeb \endcsname
\ifx\@B@citeB\relax % undefined: output ? and warning
\@citea {\bf{?}}\let\@citea\citepunct \G@refundefinedtrue
\@warning {Citation `\@citeb' on page \thepage\space undefined}%
\oc@verbo \global\@namedef{b@\@citeb\@extra@b@citeb}{?}%
\else % defined % remove previous line to repeat warnings
\ifcat _\ifnum\z@<0\@B@citeB _\else A\fi % a positive number, put in list
\@addto@cite@list
\else % citation is not a number, output immediately
\@citea \citeform{\@B@citeB}%
\let\@citea\citepunct
\fi\fi}
}
\expandafter \endgroup \the\toks@ % restore _ catcode
% Regular definition for adding entry to cite list, with sorting
\@ifundefined{@addto@cite@list}{% sort option either declared or defaulted
\def\@addto@cite@list{\@tempcnta\@B@citeB \relax
\ifnum \@tempcnta>\@tempcntb % new highest, add to end (efficiently)
\edef\@cite@list{\@cite@list \@celt{\@B@citeB}}%
\@tempcntb\@tempcnta
\else % arbitrary number: insert appropriately
\edef\@cite@list{\expandafter\@sort@celt \@cite@list \@gobble @}%
\fi}
%
% \@sort@celt inserts number (\@tempcnta) into list of \@celt{num} (#1{#2})
% \@celt must not be expandable; list should end with two vanishing tokens.
%
\def\@sort@celt#1#2{\ifx \@celt #1% parameters are \@celt {num}
\ifnum #2<\@tempcnta % number goes later in list
\@celt{#2}%
\expandafter\expandafter\expandafter\@sort@celt % continue
\else % number goes here
\@celt{\number\@tempcnta}\@celt{#2}% stop comparing
\fi\fi}
}% end sort option definitions
{}% nosort definition is done in options processing
% Check if each number follows previous and can be put in a range
%
\def\@compress@cite#1{% % This is executed for each number
\advance\@tempcnta\@ne % Now \@tempcnta is one more than the previous number
\ifnum #1=\@tempcnta % Number follows previous--hold on to it
\ifx\@h@ld\relax % first pair of successives
\edef\@h@ld{\@citea \noexpand\citeform{#1}}%
\else % compressible list of successives
\def\@h@ld{\hbox{--}\penalty\@m \citeform{#1}}%
\fi % (using \hbox avoids easy \exhyphenpenalty breaks)
\else % non-successor -- dump what's held and do this one
\@h@ld \@citea \citeform{#1}\let\@h@ld\relax
\fi \@tempcnta#1\let\@citea\citepunct
}
\edef\cite{\noexpand\protect\expandafter\noexpand\csname cite \endcsname}
\@namedef{cite }{\@ifnextchar [{\@tempswatrue\@citex}{\@tempswafalse\@citex[]}}
% Make \@citex refer to \citen:
%
\def\@citex[#1]#2{\@cite{\citen{#2}}{#1}}%
% Replacement for \@cite which defines the formatting normally done
% around the citation list. Put a penalty before the citation. Also,
% adjust the spacing: if no space or if there is extra space due to some
% punctuation, then change to one inter-word space. Minor changes can
% be done by changing \citeleft, \citemid, and \citeright; but in other
% cases it might be necessary to redefine the whole macro.
%
\def\@cite#1#2{\leavevmode
\@tempskipa\lastskip \edef\@tempa{\the\@tempskipa}\unskip
\ifnum\lastpenalty=\z@ \penalty\@highpenalty \fi
\ifx\@tempa\@zero@skip \spacefactor1001 \fi % if no space before, set flag
\ifnum\spacefactor>\@m \ \else \hskip\@tempskipa \fi
\citeleft{#1\if@tempswa \citemid #2\fi
\spacefactor\@m % punctuation in note doesn't affect outside
}\citeright}
\edef\@zero@skip{\the\z@skip}
% \nocite: This is changed to ignore *ALL* spaces and be robust. The
% parameter list, with spaces removed, is `returned' in \@tempa, which
% is used by \citen.
%
\edef\nocite{\noexpand\protect\expandafter\noexpand\csname nocite \endcsname}
\@namedef{nocite }#1{%
\edef\@tempa{\@ignsp#1 \! }% remove *ALL* spaces from parameter list
\if@filesw \immediate \write \@auxout {\string \citation {\@tempa}}\fi}
% for ignoring *ALL* spaces in the input. This presumes there are no
% \outer tokens and no \if-\fi constructs in the parameter. Spaces inside
% braces are retained.
%
\def\@ignsp#1 {\ifx\!#1\@empty\else #1\expandafter\@ignsp\fi}
\let\nocitecount\relax % in case \nocitecount was used for drftcite
\@ifundefined{@extra@b@citeb}{\def\@extra@b@citeb{}}{}
% in case no fancy bib package (chapterbib) defines this
\@ifundefined{G@refundefinedtrue}{\let\G@refundefinedtrue\relax}{}
\endinput
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
CITE.STY
Modify LaTeX's normal citation mechanism to:
o Sort citation numbers into ascending order; print non-numbers before
numbers. Compress lists of three or more consecutive numbers to one
number range which can be split, with difficulty, after the dash.
All numbers should be greater than zero.
E.g., if you used to get [7,5,6,?,4,9,8,Einstein,6], then this style
will give you [?,Einstein,4-6,6-9].
o Allow, but strongly discourage, line breaks within a series of
citations. Each number is separated by a comma and a small space.
A break at the beginning of an optional note is discouraged also.
o Put a highpenalty before the citation (unless you specifically forbid it
with ~ ). Also, adjust the spacing: if there is no space or if there is
extra space due to some punctuation, then change to one inter-word space.
E.g., Something really stupid\cite{Larry,Curly,Moe}.
A space is inserted here ------^
o Define \citen to get just the numbers (and write to the aux file)
without the brackets and extra formatting (`\citen{x}' -> `12'). The
aliases \citenum and \citeonline are also defined the same as \citen
o `Citation...undefined' warnings are only given once per undefined
citation tag. In the text, missing numbers are represented with a
bold `?' at the first occurrence, and with a normal `?' thenceforth.
o Make \nocite, \cite, and \citen all ignore spaces in the input tags.
Line-breaks are allowed with extra-high penalties (1000) after dashes
and commas; these may have to be taken if TeX sees no other viable
break-points. If you think citations are being split unnecessarily,
try using \sloppy or a sloppypar environment.
Although each \cite command sorts its numbers, better compression
into ranges can usually be achieved by carefully selecting the order
of the \bibitem entries, or the order of initial citations when using
BibTeX. Having the entries pre-sorted will also save processing time,
especially for long lists of numbers.
Customization:
~~~~~~~~~~~~~~
There are several commands that you may redefine (using \renewcommand)
to change the formatting of citation lists:
command function default
---------- ----------------------- ----------------------------
\citeform reformats every entry nothing
\citepunct printed between numbers comma + penalty + thin space
\citeleft left delimiter of list [
\citeright right delimiter of list ]
\citemid printed before note comma + space
Under LaTeX2e, there are four options for \usepackage{cite}:
[verbose] causes warnings for undefined citations to be repeated each
time they are used.
[nospace] eliminates the spaces after commas in the number list.
[space] uses a full inter-word space with no penalty after the commas
[nosort] prevents sorting of the numbers (default is to sort).
Some examples:
\renewcommand\citemid{; } % semicolon+space before optional note
\renewcommand\citeleft{(} % parentheses around list
\renewcommand\citeright{)} % parentheses around list
\renewcommand\citepunct{,} % no space and no breaks at commas
\renewcommand\citeform[1]{\romannumeral 0#1}} % roman numerals [i,vi]
\renewcommand\citeform[1]{(#1)} % parenthesized numbers [(1)-(5)]
\renewcommand\citeform{\thechapter.} % by chapter: [2.18-2.21]
The appearance of the whole citation list is governed by \@cite, so for
more extensive changes to the formatting, redefine \@cite. Remember,
these formatting controls are part of this package; they are not part
of generic LaTeX.
Related Note: cite.sty does not affect the numbering format of the
bibliography; the "[12]" style is still the default. To change that
format (with or without cite.sty) you can redefine \@biblabel, including
\renewcommand\@biblabel[1]{#1.}
in your personal style file, or with, for example,
\makeatletter \renewcommand\@biblabel[1]{(#1)} \makeatother
directly in your document. If these do not work, your LaTeX and/or
document style are very outdated.
\@extra@b@citeb is a hook for other style files to further specify
citations; for example, to number by chapter (see chapterbib.sty).
See also overcite.sty and drftcite.sty for superscript and draft
(draught) mode citations.
ROBUST!
% Version 1989: Original.
% Version 1991: Ignore spaces after commas in the parameter list. Move most of
% \citen into \@cmpresscites for speed.
% Version 1992: Use \citepunct for commas so it is easier to change.
%
% Version 3.0 (1992): Rewrite, including sorting. Make entries like "4th"
% be treated properly as text.
% 3.1: Bug fixes (Joerg-Martin Schwarz also convinced me to use \ifcat)
% 3.2: Suppress repetitions of warning messages. Include \@extra@b@citeb hook.
% 3.3: Handle LaTeX2e options. Introduce various customization hooks.
% 3.4: Heuristics to avoid removing \hspace glue before the \cite. Make \nocite
% ignore spaces in list, simplify. Aliases for \citen. Compatability with
% amsmath (which defines \over).
% 3.6: Include \G@refundefinedtrue and nosort option.
%
% Send problem reports to asnd@Reg.triumf.ca
Test file integrity: ASCII 32-57, 58-126: !"#$%&'()*+,-./0123456789
:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~
|