1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290
|
\documentclass[pagesize=auto]{scrartcl}
\usepackage{fixltx2e}
\usepackage{etex}
\usepackage{lmodern}
\usepackage[T1]{fontenc}
\usepackage{textcomp}
\usepackage[utf8]{inputenc}
\usepackage{microtype}
\usepackage{hyperref}
\newcommand*{\mail}[1]{\href{mailto:#1}{\texttt{#1}}}
\newcommand*{\pkg}[1]{\textsf{#1}}
\newcommand*{\cs}[1]{\texttt{\textbackslash#1}}
\makeatletter
\newcommand*{\cmd}[1]{\cs{\expandafter\@gobble\string#1}}
\makeatother
\newcommand*{\env}[1]{\texttt{#1}}
\newcommand*{\meta}[1]{\textlangle\textsl{#1}\textrangle}
\newcommand*{\marg}[1]{\texttt{\{}\meta{#1}\texttt{\}}}
\newcommand*{\oarg}[1]{\texttt{[}\meta{#1}\texttt{]}}
\addtokomafont{title}{\rmfamily}
\title{The \pkg{endnotes} package}
\author{John Lavagnino\thanks{Centre for Computing in the Humanities, King's College London}~~(\mail{John.Lavagnino@kcl.ac.uk})}
\date{15 January 2003}
\begin{document}
\maketitle
\noindent
Based on the \textsc{footnotes} section of
\texttt{LATEX.TEX} (version~2.09 -- release of 19 April 1986), with
``\texttt{footnote}'' changed to ``\texttt{endnote}'' and ``\texttt{fn}'' changed to ``\texttt{en}'' (where
appropriate), with all the \env{minipage} stuff pulled out, and with
some small changes for the different operation of endnotes.
Subsequently updated to follow the code for
\LaTeXe\ \textlangle 2000/06/01\textrangle.
Uses an extra external file, with \texttt{.ent} extension, to hold the
text of the endnotes. This may be deleted after the run; a new
version is generated each time---it doesn't require information
collected from the previous run.
This code does not obey \cmd{\nofiles}. Perhaps it should.
\bigskip
To turn all the footnotes in your documents into endnotes, say
%
\begin{verbatim}
\let\footnote=\endnote
\end{verbatim}
%
in your preamble, and then add something like
%
\begin{verbatim}
\newpage
\begingroup
\parindent 0pt
\parskip 2ex
\def\enotesize{\normalsize}
\theendnotes
\endgroup
\end{verbatim}
%
as the last thing in your document. (But \cmd{\theendnotes} all
by itself will work.)
\section{Change log}
\renewcommand*{\labelenumi}{\theenumi)}
\begin{labeling}[~--]{DW}
\item[JL] Modified to include \cmd{\addtoendnotes}. JL, 10/22/89.
\item[JK] Modification by Jörg Knappen 25.\,2.\,1991:
Introduced \cmd{\notesname} in the spirit of international \LaTeX.
\cmd{\notesname} is set per default to be \verb+{Notes}+, but can easily
be redifined, e.\,g.\ for german language\\
\verb+\renewcommand{\notesname}{Anmerkungen}+
\item[DW] Modification by Dominik Wujastyk, London, 19 September 1991:
Moved the line\\
\verb+\edef\@currentlabel{\csname p@endnote\endcsname\@theenmark}+\\
out of the definition of \cmd{\@endnotetext} and into the definition
of \cmd{\@doanenote} so that \cmd{\label} and \cmd{\ref} commands work correctly in
endnotes. Otherwise, the \cmd{\label} just pointed to the last section
heading (or whatever) preceding the \cmd{\theendnotes} command.
\item[JL] Revised documentation and macros. 24 Sept 1991.
\item[\null]
\begingroup
\setlength{\leftmarginii}{25mm}%
\begin{enumerate}
\item[\rlap{\hspace{-\labelwidth}modified by \texttt{-\null-bg} (B.\,Gaulle) 09/14/94 for:}]
\item replace \verb+»+ (why a 8bit char here?) by \verb+^+ as a default.
\item force \cmd{\catcode} of \verb+>+ to be 12 (implied by \cmd{\@doanenote}).
\item[\rlap{\hspace{-\labelwidth}\phantom{modified} by \texttt{-\null-bg} again 03/22/95 for:}]
\item reseting appropriate \texttt{catcode} of \verb+>+ in case it were
used as an active char before \cmd{\@endanenote} (was
pointed by Ch.\ Pallier).
\end{enumerate}
\endgroup
\item[JL] John Lavagnino, 12 January 2003: a number of small updates:
Incorporate change suggested by Frank Mittelbach to
\cmd{\enoteheading}, so that first note has paragraph indentation.
Frank's note:
%
\begin{quote}
the idea of this code is to fix the problem that without it
the first endnote after the heading will not be indented thus looking
somewhat strange. Problem however is that since there is no
indentation \verb+\leavemode\par+ will make an absolutely empty pargraph so
that no baseline calculation is done. therefore \verb+\vskip-\baselineskip+
will put the first endnote directly below the heading without the
usual spaccing. using \cmd{\mbox} insead will cure this defect.
\end{quote}
Also incorporated Frank's suggestion to define
\cmd{\makeenmark} and \cmd{\theenmark}, so that users can change more of the
layout without using \cmd{\makeatletter}. \cmd{\makeenmark} defaults to
\cmd{\@makeenmark}, so old code is still supported; and \cmd{\theenmark} is
just syntactic sugar for \cmd{\@theenmark}, which is still the real
value (and shouldn't be directly modified by user code).
Definition of \cmd{\ETC}.\ also dropped: surely nobody is still
using \TeX~2.992. (If you are, you need to upgrade it or
endnotes longer than 1000~characters will be truncated.)
Update much of the code to track the current \LaTeXe\ code more
closely. Clean up \cmd{\theendnotes}.
\item[JL] John Lavagnino, 15 January 2003: fix my garbled version of
Frank's updates.
\end{labeling}
\section{Endnote commands}
\addtokomafont{labelinglabel}{\small}
\begin{labeling}[~:]{\cmd{\endnotetext}\oarg{num}\marg{text}}
\item[\cmd{\endnote}\marg{note}] User command to insert a endnote.
\item[\cmd{\endnote}\oarg{num}\marg{note}] User command to insert a endnote numbered
\meta{num}, where \meta{num} is a number -- 1, 2,
etc. For example, if endnotes are numbered
*, **, etc. within pages, then \verb+\endnote[2]{...}+
produces endnote `**'. This command does not
step the endnote counter.
\item[\cmd{\endnotemark}\oarg{num}] Command to produce just the endnote mark in
the text, but no endnote. With no argument,
it steps the endnote counter before generating
the mark.
\item[\cmd{\endnotetext}\oarg{num}\marg{text}] Command to produce the endnote but no
mark. \cmd{\endnote} is equivalent to
\cmd{\endnotemark}\cmd{\endnotetext}.
\item[\cmd{\addtoendnotes}\marg{text}] Command to add text or commands to current
endnotes file: for inserting headings,
pagebreaks, and the like into endnotes
sections. \meta{text} a moving argument:
\cmd{\protect} required for fragile commands.
\end{labeling}
\section{Endnote user commands}
Endnotes use the following parameters, similar to those relating
to footnotes:
%
\begin{labeling}[~:]{\cmd{\@makeentext}\marg{note}}
\item[\cmd{\enotesize}] Size-changing command for endnotes.
\item[\cmd{\theendnote}] In usual \LaTeX\ style, produces the endnote number.
\item[\cmd{\theenmark}] Holds the current endnote's mark---e.\,g., \dag\ or `1' or `a'.
(You don't want to set this yourself, as it comes
either from the autonumbering of notes or from
the optional argument to \cmd{\endnote}. But you'll need
to use it if you define your own \cmd{\makeenmark}.)
\item[\cmd{\makeenmark}] A macro to generate the endnote marker from \cmd{\theenmark}.
The default definition is \verb+\hbox{$^\theenmark$}+.
\item[\cmd{\@makeentext}\marg{note}]
Must produce the actual endnote, using \cmd{\theenmark} as the mark
of the endnote and \meta{note} as the text. It is called when effectively
inside a \cmd{\parbox}, with $\cmd{\hsize} = \cmd{\columnwidth}$. For example, it might
be as simple as
\verb*+$^{\theenmark}$ +\meta{note}
\end{labeling}
\pagebreak[2]
\section{Endnote pseudocode}
\begin{verbatim}
\endnote{NOTE} ==
BEGIN
\stepcounter{endnote}
\@theenmark :=G eval (\theendnote)
\@endnotemark
\@endnotetext{NOTE}
END
\endnote[NUM]{NOTE} ==
BEGIN
begingroup
counter endnote :=L NUM
\@theenmark :=G eval (\theendnote)
endgroup
\@endnotemark
\@endnotetext{NOTE}
END
\@endnotetext{NOTE} ==
BEGIN
write to \@enotes file: "\@doanenote{ENDNOTE MARK}"
begingroup
\next := NOTE
set \newlinechar for \write to \space
write to \@enotes file: \meaning\next
(that is, "macro:->NOTE)
endgroup
END
\addtoendnotes{TEXT} ==
BEGIN
open endnotes file if not already open
begingroup
let \protect to \string
set \newlinechar for \write to \space
write TEXT to \@enotes file
endgroup
END
\endnotemark ==
BEGIN \stepcounter{endnote}
\@theenmark :=G eval(\theendnote)
\@endnotemark
END
\endnotemark[NUM] ==
BEGIN
begingroup
endnote counter :=L NUM
\@theenmark :=G eval(\theendnote)
endgroup
\@endnotemark
END
\@endnotemark ==
BEGIN
\leavevmode
IF hmode THEN \@x@sf := \the\spacefactor FI
\makeenmark % put number in main text
IF hmode THEN \spacefactor := \@x@sf FI
END
\endnotetext ==
BEGIN \@theenmark :=G eval (\theendnote)
\@endnotetext
END
\endnotetext[NUM] ==
BEGIN begingroup counter endnote :=L NUM
\@theenmark :=G eval (\theendnote)
endgroup
\@endnotetext
END
\end{verbatim}
\end{document}
|