summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/bibtex/iopart-num/iopart-num.tex
blob: 0e37c2bcf48b8c6ba7c43bbb5211f1880437ca61 (plain)
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
\documentclass[12pt]{iopart}

\bibliographystyle{iopart-num}
\usepackage{citesort}
%% \usepackage[square,sort&compress]{natbib}

\newcommand{\BibTeX}{Bib\TeX}
\newcommand{\REVTeX}{REV\TeX}

\sloppy 

\begin{document}
\nocite{*}

\title{The \texttt{iopart-num} \BibTeX{} style}

\noindent \qquad \\[-6pt] \qquad Version 2.1\\\qquad January 22, 2009

\author{M~A~Caprio}

\address{Department of Physics, University of Notre Dame,
Notre Dame, Indiana 46556-5670, USA}

\section{Introduction}

The \texttt{iopart-num} \BibTeX{} style is intended for use in
preparing manuscripts for Institute of Physics Publishing journals,
including Journal of Physics.  It provides numeric citation with
Harvard-like formatting, based upon the specification in ``How to
prepare and submit an article for publication in an IOP journal using
\LaTeXe'' by Graham Douglas (2005).

The \texttt{iopart-num} package is available on the Comprehensive
\TeX{} Archive Network (CTAN) as \texttt{/biblio/bibtex/contrib/iopart-num}.

\section{General instructions}

To use the \texttt{iopart-num} style, include the command
\verb+\bibliographystyle{iopart-num}+ in the
document preamble.  The reference section is then inserted into the
document with the command \verb+\bibliography{...}+, where the names
of the necessary \BibTeX{} database files should be listed between the
braces.  Further general instructions on using \BibTeX{} may be found
in the \BibTeX{} documentation.

The \texttt{iopart-num} style is compatible with, but does not
require, the \texttt{iopart} document class.
For documents prepared \textit{with}
the \texttt{natbib} package, 
\texttt{natbib} should be loaded with the options \verb+square+ and \verb+sort&compress+
to insure proper formatting of the references in the text.  If,
instead, 
documents are prepared using the \texttt{iopart} class but
\textit{without} \texttt{natbib}, the section header 
for the references must be manually inserted, with the command
\verb+\section*{References}+, and use of the \texttt{citesort} package
is recommended for proper formatting of the references in the text.

\section{Special bibliographic data fields}

\subsection{Journal sections}

Under IOP style conventions, journal names should be set in italic
type.  However, for journals with multiple lettered sections, the IOP
convention is that the journal section letter should appear in roman
type after the main journal name, \textit{e.g.}, ``\textit{J.\
Phys.\/} A''.  Most existing \BibTeX{} styles do not make special
provision for lettered sections.  Therefore, typically, the section
letter is either included as part of the journal name
\begin{verbatim}
  journal = "J. Phys. A",
  volume = "38",
\end{verbatim}
or as part of the volume number
\begin{verbatim}
  journal = "J. Phys.",
  volume = "A38",
\end{verbatim}
in the \BibTeX{} database entry.  The \texttt{iopart-num} style
instead introduces a new optional field \verb+section+ which can be
used to specify a journal section letter.  This section letter is set in
roman type.  Moreover, if the section letter already appears in
\textit{any} of the usual locations in the database entry (at the end
of the journal name, before the volume number, or after the volume
number),
\texttt{iopart-num} will recognize it and suppress its printing.
Therefore, when you are creating the
\BibTeX{} database entry for an article in a lettered journal section,
you can still include the section letter in the \verb+journal+ or
\verb+volume+ fields, for use with other \BibTeX{} styles, 
without adversely affecting the formatting for IOP journals.  For
example, the entry for ref.~\cite{caprio2005:coherent} can be
generated with
\begin{verbatim}
  journal = "J. Phys. A",
  section = "A",
  volume = "38",
\end{verbatim}
or
\begin{verbatim}
  journal = "J. Phys.",
  section = "A",
  volume = "A38",
\end{verbatim}
or simply
\begin{verbatim}
  journal = "J. Phys.",
  section = "A",
  volume = "38",
\end{verbatim}
in the \BibTeX{} database entry.  Note that section names longer than a
single letter are also supported (\textit{e.g.},
``\textit{Phys. Rev.\/} ST Accel. Beams'').

\subsection{Journal issue numbers}

Journal issue numbers are not customarily included in references to
journal articles under the IOP formatting conventions.
Therefore, the
\texttt{iopart-num} style ignores the
\verb+number+ field for articles.  
However, in some periodicals (such as popular magazines or certain
journal online supplements), pagination restarts from 1 with each
issue.  For such periodicals, the issue number is an essential part of
the bibliographic information needed to identify an article.  The
\texttt{iopart-num} style therefore supports an additional field
\verb+issue+ in the \BibTeX{} database entry, which can be used to 
enforce printing of the issue number.  If a value is specified for
\verb+issue+, this value is included included parenthetically after the volume
number in the reference, as in
ref.~\cite{zamfir2005:132te-beta-enam04}.

\subsection{Multivolume books}

The IOP guidelines distinguish between a volume
in a {\it series}
and a volume of a {\it  multivolume book} or {\it set}.  For a volume in
a series, the series title and volume number are given in parentheses
after the book title~\cite{ex8}.
For an individual volume in a multivolume book, the book title is
given first, followed by the volume number and volume title~\cite{ex9}.

The
\texttt{iopart-num} style supports an additional field
\verb+volumetitle+ in the \BibTeX{} database entry, which can be used to 
specify the title for an individual volume of a multivolume
book, as in refs.~\cite{ex9,bohr1998:v2}.  For example, the entry for
ref.~\cite{bohr1998:v2} is generated with
\begin{verbatim}
  title = "Nuclear Structure",
  volume = 2,
  volumetitle = "Nuclear Deformations",
\end{verbatim}
in the \BibTeX{} database entry.  In contrast, most existing \BibTeX{} styles 
allow you to reference a volume of a multivolume
book by specifying \verb+title+ and
\verb+volume+, as in
refs.~\cite{ex7,siegbahn1965:v1}, but do not provide for inclusion of
any specific title for the individual volume.  A volume in a
series~\cite{ex8,iachello2006:liealg} is indicated in
\texttt{iopart-num}, as in most other \BibTeX{}
styles, 
by specifying
\verb+title+, \verb+volume+, and
\verb+series+ in the \BibTeX{} database entry.  

\subsection{E-prints, collaborations, and other \REVTeX{} data fields}

The \texttt{iopart-num} style supports several additional data fields
(\verb+collaboration+, \verb+eid+, \verb+eprint+, 
\verb+numpages+, and \verb+url+) introduced in
\REVTeX{}~4.


\section{Examples}

The entries in the reference list below provide examples of the
formatting of various types of references, of varying complexity,
including journal articles, articles in proceedings or collections,
books (individual, multivolume, or in a series), theses, and
unpublished references.  The
\BibTeX{} database entries used to generate these examples can be
found in the file \texttt{iopart-num.bib}.
Refs.~\cite{ex1,ex2,ex3,ex4,ex5,ex6,ex7,ex8,ex9} are based upon example entries
from the IOP guidelines.

\section*{References}
\bibliography{iopart-num}

\end{document}