doc/chicago.sty

   1 % -*- LaTeX -*-
   2 %%% ====================================================================
   3 %%%  @LaTeX-style-file{
   4 %%%     author          = "Glenn Paulley",
   5 %%%     version         = "4",
   6 %%%     date            = "31 August 1992",
   7 %%%     time            = "09:42:44 199",
   8 %%%     filename        = "chicago.sty",
   9 %%%     address         = "Data Structuring Group
  10 %%%                        Department of Computer Science
  11 %%%                        University of Waterloo
  12 %%%                        Waterloo, Ontario, Canada
  13 %%%                        N2L 3G1",
  14 %%%     telephone       = "(519) 885-1211",
  15 %%%     FAX             = "(519) 885-1208",
  16 %%%     checksum        = "44674 264 1050 10394",
  17 %%%     email           = "gnpaulle@bluebox.uwaterloo.ca",
  18 %%%     codetable       = "ISO/ASCII",
  19 %%%     keywords        = "",
  20 %%%     supported       = "yes",
  21 %%%     abstract        = "Contains the LaTeX style command definitions
  22 %%%                        for the Chicago BibTeX styles chicago.bst and
  23 %%%                        chicagoa.bst. For details, see below.",
  24 %%%     docstring       = "The checksum field above contains a CRC-16
  25 %%%                        checksum as the first value, followed by the
  26 %%%                        equivalent of the standard UNIX wc (word
  27 %%%                        count) utility output of lines, words, and
  28 %%%                        characters.  This is produced by Robert
  29 %%%                        Solovay's checksum utility.",
  30 %%%  }
  31 %%% ====================================================================
  32 %
  33 % chicago.sty: Style file for use with bibtex style chicago.bst, for
  34 % bibliographies formatted according to the 13th Edition of the Chicago
  35 % Manual of Style.
  36 %
  37 % 'newapa.bst' was made from 'plain.bst', 'named.bst', and 'apalike.bst',
  38 % with lots of tweaking to make it look like APA style, along with tips
  39 % from Young Ryu and Brian Reiser's modifications of 'apalike.bst'.
  40 % newapa.sty formed the basis of this style, chicago.sty. Author-date
  41 % references in newapa.bst formed the basis for chicago.bst. Chicagoa.bst
  42 % supports annotations.
  43 %
  44 % Version 4 (August, 1992):
  45 % - fixed chicago.bst and chicagoa.bst to handle long author lists in
  46 %   sorting
  47 % - fixed chicago.bst and chicagoa.bst so that missing page numbers in
  48 %   ``article'' entries are handled correctly
  49 % - modified chicago.sty to format entries with 2nd and subsequent lines
  50 %   indented.
  51 %
  52 %   Citation format: (author-last-name year)
  53 %             (author-last-name and author-last-name year)
  54 %             (author-last-name et al. year)
  55 %             (author-last-name)
  56 %             author-last-name
  57 %             author-last-name (year)
  58 %             (author-last-name and author-last-name)
  59 %             (author-last-name et al.)
  60 %             (year) or (year,year)
  61 %             year or year,year
  62 %
  63 %   Reference list ordering: alphabetical by author or whatever passes
  64 %    for author in the absence of one.
  65 %
  66 % This BibTeX style has support for abbreviated author lists and for
  67 %    year-only citations.  This is done by having the citations
  68 %    actually look like
  69 %
  70 %    \citeauthoryear{full-author-info}{abbrev-author-info}{year}
  71 %
  72 % The LaTeX style has to have the following (or similar)
  73 %
  74 %     \let\@internalcite\cite
  75 %     \def\fullcite{\def\citeauthoryear##1##2##3{##1, ##3}\@internalcite}
  76 %     \def\fullciteA{\def\citeauthoryear##1##2##3{##1}\@internalcite}
  77 %     \def\shortcite{\def\citeauthoryear##1##2##3{##2, ##3}\@internalcite}
  78 %     \def\shortciteA{\def\citeauthoryear##1##2##3{##2}\@internalcite}
  79 %     \def\citeyear{\def\citeauthoryear##1##2##3{##3}\@internalcite}
  80 %
  81 % -------------------------------------------------------------------------
  82 % This file implements citations for the ``chicago'' bibliography style.
  83 %  Place it in a file called chicago.sty in the TeX search path.
  84 %(Placing it in the same directory as the LaTeX document should also work.)
  85 %
  86 %    This file is a modification of the ``newapa'' LaTeX style,
  87 %    originally adapted by Steven Spencer from the ``apalike'' LaTeX style.
  88 %    It was originally modified by Stephen N. Spencer, with further
  89 %    modifications by Young U. Ryu.
  90 %
  91 % The ``chicago'' BibTeX bibliography style creates citations with labels:
  92 %       \citeauthoryear{author-info}{abbrev. author-info}{year}
  93 %
  94 % These labels are processed by the following LaTeX commands:
  95 %
  96 %  \cite{key}
  97 %    which produces citations with full author list and year.
  98 %    eg. (Brown 1978; Jarke, Turner, Stohl, et al. 1985)
  99 %  \citeNP{key}
 100 %    which produces citations with full author list and year, but without
 101 %    enclosing parentheses:
 102 %    eg. Brown 1978; Jarke, Turner and Stohl 1985
 103 %  \citeA{key}
 104 %    which produces citations with only the full author list.
 105 %    eg. (Brown; Jarke, Turner and Stohl)
 106 %  \citeANP{key}
 107 %    which produces citations with only the full author list, without
 108 %    parentheses eg. Brown; Jarke, Turner and Stohl
 109 %  \citeN{key}
 110 %    which produces citations with the full author list and year, but
 111 %    can be used as nouns in a sentence; no parentheses appear around
 112 %    the author names, but only around the year.
 113 %      eg. Shneiderman (1978) states that......
 114 %    \citeN should only be used for a single citation.
 115 %  \shortcite{key}
 116 %    which produces citations with abbreviated author list and year.
 117 %  \shortciteNP{key}
 118 %    which produces citations with abbreviated author list and year.
 119 %  \shortciteA{key}
 120 %    which produces only the abbreviated author list.
 121 %  \shortciteANP{key}
 122 %    which produces only the abbreviated author list.
 123 %  \shortciteN{key}
 124 %    which produces the abbreviated author list and year, with only the
 125 %    year in parentheses. Use with only one citation.
 126 %  \citeyear{key}
 127 %    which produces the year information only, within parentheses.
 128 %  \citeyearNP{key}
 129 %    which produces the year information only.
 130 %
 131 % Abbreviated author lists use the ``et al.'' construct.
 132 %
 133 % `NP' means `no parentheses'.
 134 %
 135 % This LaTeX style file must be used with the ``chicago'' or ``chicagoa''
 136 % (annotated chicago style) BibTeX styles.
 137 %
 138 \typeout{Using Chicago Manual of Style bibliography: 31 August 1992}
 139 %
 140 % -------------------------------------------------------------------------
 141 %
 142 % Citation macros.
 143 %
 144 \def\chicagoand/{ and }
 145 \def\chicagoetal/{ et~al.}
 146 %
 147 \let\@internalcite\cite
 148 %
 149 \def\cite{\def\@citeseppen{-1000}%
 150     \def\@cite##1##2{(##1\if@tempswa , ##2\fi)}%
 151     \def\citeauthortitleyear##1##2##3##4{##1\ ##4}\@internalcite}
 152 \def\citeNP{\def\@citeseppen{-1000}%
 153     \def\@cite##1##2{##1\if@tempswa , ##2\fi}%
 154     \def\citeauthortitleyear##1##2##3##4{##1\ ##4}\@internalcite}
 155 \def\citetitleN{\def\@citeseppen{-1000}%
 156     \def\@cite##1##2{##1\if@tempswa , ##2)\else{)}\fi}%
 157     \def\citeauthortitleyear##1##2##3##4{##3\ (##1; ##4}\@citedata}
 158 \def\citeN{\def\@citeseppen{-1000}%
 159     \def\@cite##1##2{##1\if@tempswa , ##2)\else{)}\fi}%
 160     \def\citeauthortitleyear##1##2##3##4{##1\ (##4}\@citedata}
 161 \def\citeA{\def\@citeseppen{-1000}%
 162     \def\@cite##1##2{(##1\if@tempswa , ##2\fi)}%
 163     \def\citeauthortitleyear##1##2##3##4{##1}\@internalcite}
 164 \def\citeANP{\def\@citeseppen{-1000}%
 165     \def\@cite##1##2{##1\if@tempswa , ##2\fi}%
 166     \def\citeauthortitleyear##1##2##3##4{##1}\@internalcite}
 167 %
 168 \def\shortcite{\def\@citeseppen{-1000}%
 169     \def\@cite##1##2{(##1\if@tempswa , ##2\fi)}%
 170     \def\citeauthortitleyear##1##2##3##4{##2\ ##4}\@internalcite}
 171 \def\shortciteNP{\def\@citeseppen{-1000}%
 172     \def\@cite##1##2{##1\if@tempswa , ##2\fi}%
 173     \def\citeauthortitleyear##1##2##3##4{##2\ ##4}\@internalcite}
 174 \def\shortciteN{\def\@citeseppen{-1000}%
 175     \def\@cite##1##2{##1\if@tempswa , ##2)\else{)}\fi}%
 176     \def\citeauthortitleyear##1##2##3##4{##2\ (##4}\@citedata}
 177 \def\shortciteA{\def\@citeseppen{-1000}%
 178     \def\@cite##1##2{(##1\if@tempswa , ##2\fi)}%
 179     \def\citeauthortitleyear##1##2##3##4{##2}\@internalcite}
 180 \def\shortciteANP{\def\@citeseppen{-1000}%
 181     \def\@cite##1##2{##1\if@tempswa , ##2\fi}%
 182     \def\citeauthortitleyear##1##2##3##4{##2}\@internalcite}
 183 %
 184 \def\citeyear{\def\@citeseppen{-1000}%
 185     \def\@cite##1##2{(##1\if@tempswa , ##2\fi)}%
 186     \def\citeauthortitleyear##1##2##3##4{##4}\@citedata}
 187 \def\citeyearNP{\def\@citeseppen{-1000}%
 188     \def\@cite##1##2{##1\if@tempswa , ##2\fi}%
 189     \def\citeauthortitleyear##1##2##3##4{##4}\@citedata}
 190
 191 %
 192 % \@citedata and \@citedatax:
 193 %
 194 % Place commas in-between citations in the same \citeyear, \citeyearNP,
 195 % \citeN, or \shortciteN command.
 196 % Use something like \citeN{ref1,ref2,ref3} and \citeN{ref4} for a list.
 197 %
 198 \def\@citedata{%
 199         \@ifnextchar [{\@tempswatrue\@citedatax}%
 200                                   {\@tempswafalse\@citedatax[]}%
 201 }
 202
 203 \def\@citedatax[#1]#2{%
 204 \if@filesw\immediate\write\@auxout{\string\citation{#2}}\fi%
 205   \def\@citea{}\@cite{\@for\@citeb:=#2\do%
 206     {\@citea\def\@citea{), }\@ifundefined% by Young
 207        {b@\@citeb}{{\bf ?}%
 208        \@warning{Citation `\@citeb' on page \thepage \space undefined}}%
 209 {\csname b@\@citeb\endcsname}}}{#1}}%
 210
 211 \@ifpackageloaded{hyperref}{%
 212   \let\BRorg@citedatax\@citedatax
 213   \def\@citedatax[#1]#2{%
 214     \BRorg@citedatax[#1]{#2}%
 215     \Hy@backout{#2}%
 216   }%
 217 }{}
 218 \@ifpackageloaded{hyperref}{%
 219 \def\hyperemph#1{{\em\hyperpage{#1}}}%
 220 \def\bold#1{{\bf\hyperpage{#1}}}%
 221 }{%
 222 \def\hyperemph#1{{\em #1}}%
 223 \def\bold#1{{\bf #1}}%
 224 }
 225
 226 \def\BR@@lbibitem[#1]#2#3\par{%
 227   \BRorg@bibitem[#1]{#2}#3\hfill\penalty100\hbox{}
 228   \newblock
 229   \backref\hfill[{\csname br@#2\endcsname}%
 230   ]\parskip=-10pt\penalty-10000\hbox{}\nobreak\par
 231 }%
 232 \def\BR@@bibitem#1#2\par{%
 233   \BRorg@bibitem{#1}#2
 234   \newblock
 235   \backref\penalty-100\hbox{}\nobreak\hfill[\hbox{\csname br@#2\endcsname}%
 236   ]\par
 237 }
 238 \def\thepageorcolor{\thepage}
 239 \def\Hy@backout#1{%
 240   \@bsphack
 241   \ifx\@empty\@currentlabel
 242     \protected@write\@auxout{}{%
 243       \string\@writefile{brf}{%
 244         \string\backcite{#1}{{\thepageorcolor}{(document)}{Doc-Start}}%
 245       }%
 246     }%
 247   \else
 248    \protected@write\@auxout{}{%
 249      \string\@writefile{brf}{%
 250        \string\backcite{#1}{{\thepageorcolor}{\@currentlabel}{\@currentHref}}%
 251      }%
 252    }%
 253   \fi
 254   \@esphack
 255 }
 256
 257 % don't box citations, separate with ; and a space
 258 % also, make the penalty between citations negative: a good place to break.
 259 %
 260 \def\@citex[#1]#2{%
 261 \if@filesw\immediate\write\@auxout{\string\citation{#2}}\fi%
 262   \def\@citea{}\@cite{\@for\@citeb:=#2\do%
 263     {\@citea\def\@citea{; }\@ifundefined% by Young
 264        {b@\@citeb}{{\bf ?}%
 265        \@warning{Citation `\@citeb' on page \thepage \space undefined}}%
 266 {\csname b@\@citeb\endcsname}}}{#1}}%
 267
 268 % (from apalike.sty)
 269 % No labels in the bibliography.
 270 %
 271 \def\@biblabel#1{}
 272
 273 % (from apalike.sty)
 274 % Set length of hanging indentation for bibliography entries.
 275 %
 276 \newlength{\bibhang}
 277 \setlength{\bibhang}{2em}
 278
 279 % Indent second and subsequent lines of bibliographic entries. Stolen
 280 % from openbib.sty: \newblock is set to {}.
 281
 282 \newdimen\bibindent
 283 \bibindent=1.5em
 284 \@ifundefined{refname}%
 285    {\@ifundefined{chapter}%
 286      {\newcommand{\refname}{References}}%
 287      {\newcommand{\refname}{Bibliography}}%
 288    }%
 289    {}%
 290 \@ifundefined{chapter}%
 291  {\def\thebibliography#1{\section*{\refname\@mkboth
 292    {\uppercase{\refname}}{\uppercase{\refname}}}
 293    \addcontentsline{toc}{section}{References}
 294    \list
 295    {[\arabic{enumi}]}{\settowidth\labelwidth{[#1]}
 296    \leftmargin\labelwidth
 297    \advance\leftmargin\labelsep
 298    \advance\leftmargin\bibindent
 299    \itemindent -\bibindent
 300    \listparindent \itemindent
 301    \parsep \z@
 302    \usecounter{enumi}}
 303    \def\newblock{}
 304    \sloppy
 305    \sfcode`\.=1000\relax}}
 306  {\def\thebibliography#1{\chapter*{\refname\@mkboth
 307    {\refname}{\refname}}
 308    \addcontentsline{toc}{chapter}{References}
 309    \list
 310    {[\arabic{enumi}]}{\settowidth\labelwidth{[#1]}
 311    \leftmargin\labelwidth
 312    \advance\leftmargin\labelsep
 313    \advance\leftmargin\bibindent
 314    \itemindent -\bibindent
 315    \listparindent \itemindent
 316    \parsep \z@
 317    \usecounter{enumi}}
 318    \def\newblock{}
 319    \sloppy
 320    \sfcode`\.=1000\relax}}