summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem.tex')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem.tex224
1 files changed, 224 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem.tex b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem.tex
new file mode 100644
index 00000000000..3abe326b167
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem.tex
@@ -0,0 +1,224 @@
+\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.9b, released 2010/03/30}}
+\author{Joseph Wright%
+ \thanks{E-mail: joseph.wright@morningstar2.co.uk}}
+\date{Released 2010/03/30}
+\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.
+
+\printbibliography
+
+\end{document}