summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem.tex
blob: fc35c65c6866f89c3aedc43247b2a31d47634646 (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
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
\documentclass[a4paper]{article}
\usepackage{lmodern,mathpazo,courier,helvet,multicol}
\usepackage[style=chem-rsc,hyperref]{biblatex}
\usepackage[colorlinks]{hyperref}
\bibliography{biblatex-chem}
\reversemarginpar
\makeatletter
\newcommand*{\DescribeOption}[1]{%
  \leavevmode
  \@bsphack
  \marginpar{\texttt{#1}}%
  \@esphack
  \ignorespaces
}
\makeatother
\title{The \textsf{biblatex-chem} bundle --- 
  \textsf{biblatex} styles for chemistry%
  \thanks{Describes version v0.9d, released 2010/05/08}}
\author{Joseph Wright%
  \thanks{E-mail: joseph.wright@morningstar2.co.uk}}
\date{Released 2010/05/08}
\begin{document}
\maketitle
\begin{abstract}
The \textsf{biblatex-chem} bundle is a set of styles for 
creating bibliographies using \textsf{biblatex} in the style of
a number common chemistry journals.  The bundle comprises styles
based on the conventions of the Royal Society of Chemistry, 
American Chemical Society and 	\emph{Angewandte Chemie}. It
therefore covers the journal styles of, for example:
\begin{itemize}
  \item \emph{Angewandte Chemie}
  \item \emph{Biochemistry}
  \item \emph{Chemical Communications}
  \item \emph{Chemistry---A European Journal}
  \item \emph{Dalton Transactions}
  \item \emph{Journal of the American Chemical Society}
  \item \emph{Organic \& Biomolecular Chemistry}
\end{itemize}
amongst others.
\end{abstract}

\begin{multicols}{2}
  \tableofcontents
\end{multicols}

\section{Introduction}
The \textsf{biblatex} package introduces a completely new method
for controlling the creation of bibliographies using
\textsf{bibtex}. This makes a great deal of flexibility 
available when creating bibliographies, most of which is much 
more difficult with traditional \textsf{bibtex} styles.

In order to use \textsf{biblatex}, an entirely new set of 
appropriate supporting styles are needed. This bundle provides a
number of styles for chemistry, following the rules of some of 
the most important journals in the field. 

\section{The styles}

Currently, the bundle contains four \textsf{biblatex} styles:
\begin{itemize}
  \item \texttt{chem-acs}: American Chemical Society style
  \item \texttt{chem-angew}: \emph{Angewandte Chemie} style
  \item \texttt{chem-biochem}: \emph{Biochemistry} style
  \item \texttt{chem-rsc}: Royal Society of Chemistry style
\end{itemize}
These can all be loaded in the usual way:
\begin{verbatim}
\usepackage[style=chem-<name>]{biblatex}
\end{verbatim}

The four styles can be used to follow the current layout rules
of all of the journals currently published by the American 
Chemical Society and the Royal Society of Chemistry, plus 
the journals published by Wiley which use the \emph{Angewandte
Chemie} format.

The styles use the standard \textsf{biblatex} database 
requirements, although they are somewhat selective in which
fields are used (for example, \texttt{language} is never 
printed).  This means that a database designed for traditional
\textsf{biblatex} use may need some editing for optimal output.
The accompanying example database \texttt{biblatex-chem.bib} 
shows examples of all of the supported entry types with common
fields filled in.

\section{Style options}

All of the styles here add a small number of package options to 
the standard set provided by \textsf{biblatex}. This allows 
the styles to cover the variations seen between different 
journals without needing a very large number of files: the 
American Chemical Society in particular varies the exact details
between journals.

\DescribeOption{articletitle}
The \texttt{articletitle} option is a switch for including the 
title of journal articles in the output. For the styles 
\texttt{chem-acs}, \texttt{chem-angew} and \texttt{chem-rsc} this 
is turned off on loading, and you therefore need to use for 
example
\begin{verbatim}
\usepackage[
  style=chem-rsc,
  articletitle
  ]{biblatex}
\end{verbatim}
or
\begin{verbatim}
\usepackage[
  style=chem-rsc,
  articletitle=true
  ]{biblatex}
\end{verbatim}
to include titles.  In the case of the \texttt{chem-biochem} 
style, the titles are included as standard: this can be turned
off using
\begin{verbatim}
\usepackage[
  style=chem-biochem,
  articletitle=false
  ]{biblatex}.
\end{verbatim}

\DescribeOption{biblabel}
The format of the numbers used in the bibliography varies from
journal to journal even if the same general style is used.  The
\texttt{biblabel} option allows the user to easily set the 
format used.  This option takes a value from the list: 
\texttt{parens}, \texttt{brackets}, \texttt{plain} and 
\texttt{dot}.
For example
\begin{verbatim}
\usepackage[
  style=chem-angew,
  biblabel=plain
  ]{biblatex}
\end{verbatim}
would use the style of \emph{Angewandte Chemie} but with nothing
added to the numbers in the bibliography.

\DescribeOption{chaptertitle}
The inclusion of chapter titles in \texttt{inbook} and 
\texttt{incollection} entries is not consistent in chemistry 
journals; the \emph{ACS Style Guide} recommends their use, but
does not require it \autocite{Coghill2006}. As a result, the
styles here provide the \texttt{chaptertitle} option to allow
the inclusion of chapter titles if required.
\begin{verbatim}
\usepackage[
  style=chem-rsc,
  chaptertitle
  ]{biblatex}
\end{verbatim}

\DescribeOption{doi}
When a journal article has no pages but does have a DOI the later used
in the bibliography. Some journal styles require that the DOI is 
included in all cases. This behaviour can be turned on by setting the
\texttt{doi} option.
\begin{verbatim}
\usepackage[
  style=chem-angew,
  doi
  ]{biblatex}
\end{verbatim}

\DescribeOption{pageranges}
Some journals only allow the first page of a range to be used, even
if the data for the full range is available. The \texttt{pageranges}
option can be used to turn off printing of the range for these
journals.
\begin{verbatim}
\usepackage[
  style=chem-rsc,
  pageranges=false
  ]{biblatex}
\end{verbatim}

\DescribeOption{subentry}
In common with the standard \textsf{biblatex} numeric styles, 
all of the styles here support the \texttt{subentry} option. 
With this turned on, entries of type \texttt{set} are given 
individual labels within the bibliography.  
\begin{verbatim}
\usepackage[
  style=chem-acs,
  subentry
  ]{biblatex}
\end{verbatim}
The result is very similar to the behaviour of the 
\textsf{mciteplus} package.

Different ACS journals use varying combinations of bibliography
styles (\texttt{chem-acs} or \texttt{chem-biochem}), citations 
styles, bibliography labels and article title inclusion.  In 
general, the user will need to consult a recent issue of the 
journal concerned to check which options to use.

\section{New styles}

The current set of styles here is intended to form a strong base
for chemists.  However, there will be the need for other styles
to be created. The package author welcomes suggestions for other
styles for inclusion.  It would also be good to keep all 
chemistry-related \textsf{biblatex} styles in one bundle. Others
working on chemistry styles for \textsf{biblatex} are welcome to
send them to the bundle maintainer so they can be incorporated 
here.

\section{Errors and omissions}

Creating a \textsf{biblatex} style is a complex task, 
particularly as chemistry journals only give complete rules
for the layout of references to journal articles.  The 
examples and test database provided with this bundle should be
consulted to see how the formatting is intended to work.  
Feedback on errors an omissions in either the database or the 
styles is very welcome. Please report any bugs either 
by e-mail 
\href{mailto:joseph.wright@morningstar2.co.uk}%
{joseph.wright@morningstar2.co.uk} or by filing a bug
in the 
\href{http://bitbucket.org/josephwright/biblatex-chem/issues}%
{BibBucket database}

\printbibliography

\end{document}