summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/notoccite
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/notoccite
Initial commit
Diffstat (limited to 'macros/latex/contrib/notoccite')
-rw-r--r--macros/latex/contrib/notoccite/notoccite.pdfbin0 -> 232896 bytes
-rw-r--r--macros/latex/contrib/notoccite/notoccite.sty43
-rw-r--r--macros/latex/contrib/notoccite/notoccite.tex58
3 files changed, 101 insertions, 0 deletions
diff --git a/macros/latex/contrib/notoccite/notoccite.pdf b/macros/latex/contrib/notoccite/notoccite.pdf
new file mode 100644
index 0000000000..0c7dc63f9d
--- /dev/null
+++ b/macros/latex/contrib/notoccite/notoccite.pdf
Binary files differ
diff --git a/macros/latex/contrib/notoccite/notoccite.sty b/macros/latex/contrib/notoccite/notoccite.sty
new file mode 100644
index 0000000000..af4ec3bd04
--- /dev/null
+++ b/macros/latex/contrib/notoccite/notoccite.sty
@@ -0,0 +1,43 @@
+% notoccite.sty no t.o.c. cite Jul 20, 2000
+% Donald Arseneau asnd@triumf.ca TRIUMF, Vancouver, Canada,
+% This is unrestricted software contributed to the public domain.
+%
+% Ordinarily, cites used in titles or figure captions also appear in
+% the table of contents and list of figures. If you then run bibtex
+% using the unsrt (unsorted) style, they get numbered starting from 1,
+% not the number they should have in the main text.
+%
+% A good option is to avoid cites in titles, and to specify optional
+% caption text without cites:
+% \caption [Picture of a bird.]{Picture of a bird \cite{audobon}.}
+%
+% If you must use moving cites, you could manage them by deleting toc
+% and lof files, then running latex once, then bibtex. However, the
+% following definition fixes the problem so you don't need to worry
+% about that.
+%
+% *NOTE* This definition works for the ordinary LaTeX definitions
+% for \cite and others (\addtocontents, \label) but it may well
+% fail when used with various packages for citations or cross
+% references.
+%
+% It works by locally setting \@fileswfalse, which is something like
+% \nofiles, but \@fileswfalse does not affect \label or \addtocontents.
+% \nofiles does most of its work by redefining \protected@write, and
+% neither \addtocontents nor \label check for \if@filesw. \cite *does*
+% check \if@filesw.
+
+\ProvidesPackage{notoccite}[2000/07/20]
+\def\@starttoc#1{%
+ \begingroup
+ \@fileswfalse
+ \makeatletter
+ \@input{\jobname.#1}%
+ \endgroup
+ \if@filesw
+ \expandafter\newwrite\csname tf@#1\endcsname
+ \immediate\openout \csname tf@#1\endcsname \jobname.#1\relax
+ \fi
+ \@nobreakfalse
+}
+
diff --git a/macros/latex/contrib/notoccite/notoccite.tex b/macros/latex/contrib/notoccite/notoccite.tex
new file mode 100644
index 0000000000..1f7298fe4a
--- /dev/null
+++ b/macros/latex/contrib/notoccite/notoccite.tex
@@ -0,0 +1,58 @@
+\documentclass[pagesize=auto, parskip=half, fontsize=12pt, DIV=9]{scrartcl}
+
+\usepackage{fixltx2e}
+\usepackage{etex}
+\usepackage{xspace}
+\usepackage{lmodern}
+\usepackage[T1]{fontenc}
+\usepackage{textcomp}
+\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
+
+\addtokomafont{title}{\rmfamily}
+
+\title{The \pkg{notoccite} package}
+\author{Donald Arseneau\thanks{\mail{asnd@triumf.ca}; TRIUMF, Vancouver, Canada}}
+\date{Jul 20, 2000}
+
+
+\begin{document}
+
+\maketitle
+
+\noindent
+Ordinarily, cites used in titles or figure captions also appear in
+the table of contents and list of figures. If you then run \texttt{bibtex}
+using the \pkg{unsrt} (unsorted) style, they get numbered starting from 1,
+not the number they should have in the main text.
+
+A good option is to avoid cites in titles, and to specify optional
+caption text without cites:\\[0.4ex]
+\small
+\verb+\caption [Picture of a bird.]{Picture of a bird \cite{audobon}.}+
+\normalsize
+
+If you must use moving cites, you could manage them by deleting \textsc{toc}
+and \textsc{lof} files, then running \texttt{latex} once, then \texttt{bibtex}\@. However, the
+following definition fixes the problem so you don't need to worry
+about that.
+
+\emph{NOTE:} This definition works for the ordinary \LaTeX\ definitions
+for \cmd{\cite} and others (\cmd{\addtocontents}, \cmd{\label}) but it may well
+fail when used with various packages for citations or cross
+references.
+
+It works by locally setting \cmd{\@fileswfalse}, which is something like
+\cmd{\nofiles}, but \cmd{\@fileswfalse} does not affect \cmd{\label} or \cmd{\addtocontents}.
+\cmd{\nofiles} does most of its work by redefining \cmd{\protected@write}, and
+neither \cmd{\addtocontents} nor \cmd{\label} check for \cs{if@filesw}. \cmd{\cite} \emph{does}
+check \cs{if@filesw}.
+
+\end{document}