%% ---------------------------------------------------------------
%% biblatex-chem --- A set of biblatex implementations of
%%   chemistry-related bibliography styles
%% Maintained by Joseph Wright
%% E-mail: joseph.wright@morningstar2.co.uk
%% Released under the LaTeX Project Public License v1.3c or later
%% See http://www.latex-project.org/lppl.txt
%% ---------------------------------------------------------------
%%  

\documentclass[a4paper]{ltxdoc}
\usepackage{csquotes,lmodern}
\usepackage[T1]{fontenc}
\usepackage[final]{microtype}
\usepackage{hyperref}

\hypersetup{hidelinks}

\author{Joseph Wright\thanks{E-mail: 
  \href{mailto:joseph.wright@morningstar2.co.uk}
  {\texttt{joseph.wright@morningstar2.co.uk}}}}
\title{\pkg{biblatex-chem} -- A set of \pkg{biblatex} implementations of
  chemistry-related bibliography styles%
  \footnote{This file describes v1.1w, last revised 2018/10/18.}}
\date{Released 2018/10/18}

\providecommand*{\opt}[1]{\texttt{#1}}
\providecommand*{\pkg}[1]{\textsf{#1}}

\let\DescribeOption\DescribeEnv

\RecordChanges

\begin{document}

\maketitle

\begin{abstract}
  The \pkg{biblatex-chem} bundle is a set of styles for creating bibliographies
  using \pkg{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}

\section{Introduction}

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

In order to use \pkg{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}

The bundle currently contains four \pkg{biblatex} style files, each of
which has its own demonstration document:
\begin{itemize}
   \item The \href{file:biblatex-chem-acs.pdf}{\pkg{chem-acs}} style,
     which covers most American Chemistry Society journals.
   \item The \href{file:biblatex-chem-angew.pdf}{\pkg{chem-angew}} style,
     which covers \emph{Angewandte Chemie}
     \emph{Chemistry~--~A European Journal}.
   \item The \href{file:biblatex-chem-biochem.pdf}{\pkg{chem-biochem}}
     style, which covers \emph{Biochemistry} and a small number of other
     American Chemistry Society journals.
   \item The \href{file:biblatex-chem-rsc.pdf}{\pkg{chem-rsc}} style,
     which covers all Royal Society of Chemistry journals.
\end{itemize}

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 \pkg{biblatex} database requirements. This means
that a database designed for traditional \pkg{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 \pkg{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{doi}
\DescribeOption{eprint}
\DescribeOption{isbn}
\DescribeOption{url}
The standard style options \opt{doi}, \opt{eprint} \opt{isbn} and
\opt{eprint}, as described in the \pkg{biblatex} manual. However, these
options are turned off as standard by the styles in the \pkg{biblatex-chem}
bundle. This reflects the fact that these entries may be present in reference
databases but are not generally included in published bibliographies. Note
that \textsc{doi} values are printed for journal articles with no pages
given, even if the \opt{doi} option is \opt{false}

\DescribeOption{subentry}
In common with the standard \pkg{biblatex} numeric styles, all of the styles
in the bundle support the boolean \texttt{subentry} option. With this set
\opt{true}, entries of type \texttt{set} are given individual labels within
the bibliography.

\DescribeOption{articletitle}
The use of article titles varies between individual journals. The
boolean option \opt{articletitle} is available is control this behaviour.
The standard settings for the \pkg{chem-acs}, \pkg{chem-angew}
and \pkg{chem-rsc} styles have this option turned off, while the
\pkg{chem-biochem} sets this option \opt{true}.

\DescribeOption{biblabel}
The format of the numbers used in the bibliography (the \enquote{bibliography
label}) varies from journal to journal even if the same general style is used.
The \opt{biblabel} option allows the user to easily set the format used. This
option takes a value from the list: \opt{parens}, \opt{brackets}, \opt{plain}
and \opt{dot}.

\DescribeOption{chaptertitle}
The option boolean \opt{chaptertitle} option is provided to allow flexibility
for the inclusion of chapter titles for \texttt{inbook} and
\texttt{incollection} entries. The standard setting is \opt{false} for all
styles in the bundle.

\DescribeOption{pageranges}
The use of full page ranges varies between journals and indeed between
different papers in individual journals. The \opt{pageranges} boolean option
is available to turn on and off printing of full page ranges, thus allowing
printing of only the first page even when the database contains the full
page range. This option is set \opt{true} as standard.

\section{Related entries}

References to related literature can be handled automatically by the Biber
back-end. This is particularly useful for references to \emph{Angewandte
Chemie}, which should be given both to the German and English editions of
the journal. The example database shows this in action, with a paper in the
German version linked to one in the English edition (see the entry
\texttt{Dehnicke1981}).

\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 \pkg{biblatex} styles in one bundle. Others
working on chemistry styles for \pkg{biblatex} are welcome to send them to the
bundle maintainer so they can be incorporated here.

\section{Errors and omissions}

Suggestions for improvement and bug reports can be logged in the package issue
database, found at
\url{https://bitbucket.org/josephwright/biblatex-chem/issues}, or can
be sent by e-mail to 
\href{mailto:joseph.wright@morningstar2.co.uk}
  {\texttt{joseph.wright@morningstar2.co.uk}}.

\changes{v1.0}{2010/11/20}{First stable release}
\changes{v1.0a}{2010/12/22}{Format \enquote{\emph{et al.}}~in italics
  when using \texttt{chem-rsc} style}
\changes{v1.0b}{2011/01/10}{Require \pkg{biblatex} v1.1}
\changes{v1.0b}{2011/01/10}{Use new \opt{maxbibnames} option such
  that bibliographies print all authors but citations use truncated
  lists when necessary}
\changes{v1.0c}{2011/01/11}{Add version history for stable releases}
\changes{v1.0d}{2011/01/17}{Corrections for formatting of
  optionally-included article and chapter titles}
\changes{v1.0d}{2011/01/17}{Include additional punctuation tracker
  corrections for non-English bibliographies}
\changes{v1.1}{2011/08/15}{Styles revised to work with \pkg{biblatex} v1.6}
\changes{v1.1a}{2011/08/16}{Turn off standard \opt{url} option by default}
\changes{v1.1a}{2011/08/16}{Reintroduce \opt{chaptertitle} option for
  \pkg{chem-angew} and \pkg{chem-rsc} styles}
\changes{v1.1a}{2011/08/16}{Turn off standard \opt{eprint}
  and \opt{isbn} options by default}
\changes{v1.1b}{2011/08/16}{Further documentation improvements}
\changes{v1.1b}{2011/08/16}{Re-introduce the \opt{biblabel} option}
\changes{v1.1c}{2011/08/17}{Correct bug in entries with no date in
  \pkg{chem-acs} and \pkg{chem-acs} styles}
\changes{v1.1d}{2011/09/25}{Fix a few log warnings: no change to output}
\changes{v1.1e}{2011/10/14}{Print edition only once for \texttt{manual} entries
  in \pkg{chem-angew} and \pkg{chem-rsc} styles}
\changes{v1.1f}{2012/02/05}{Correct formatting of \texttt{report} entries in
  \pkg{chem-acs} style}
\changes{v1.1g}{2012/05/18}{Fix issue with \texttt{inbook} entries which
  lack distinct \texttt{author} and \texttt{bookauthor}}
\changes{v1.1h}{2012/08/16}{Fix appearance of author names in text when
  exactly two authors are given}
\changes{v1.1i}{2012/10/14}{Correct treatment of prefixes with \texttt{acs}
  style}
\changes{v1.1j}{2013/01/27}{Update styles to use \texttt{related} information
  if available}
\changes{v1.1k}{2013/02/11}{Fix error in name formatting with \texttt{biochem}
  style}
\changes{v1.1l}{2013/10/09}{Fix extraneous comma in author list with
  \texttt{rsc} style}
\changes{v1.1m}{2014/11/14}{Move position of edition for book records in
  \texttt{angew} style}
\changes{v1.1n}{2016/02/26}{Use \cs{mkbibitalic} not \cs{mkbibemph} in styles}
\changes{v1.1n}{2016/02/26}{Improved approach to removing commas from journal
  titles in \emph{Angew. Chem.} style}
\changes{v1.1o}{2016/03/09}{Track \pkg{biblatex} changes}
\changes{v1.1p}{2016/03/13}{Ensure style works with both backends}
\changes{v1.1q}{2016/09/14}{Print year only for date fields}
\changes{v1.1q}{2016/09/14}{Omit \texttt{language} field in bibliography}
\changes{v1.1r}{2016/12/26}{Track \pkg{biblatex} core changes}
\changes{v1.1s}{2017/02/01}{Remove a stray space}
\changes{v1.1t}{2017/08/09}{Improve formatting for \texttt{online} entries
  in \texttt{acs} and \texttt{biochem} styles}
\changes{v1.1t}{2017/08/09}{Update some internals}
\changes{v1.1u}{2018/01/24}{Update some aspects of name formatting}
\changes{v1.1v}{2018/09/06}{Documentation tweaks}
\changes{v1.1w}{2018/10/18}{Bring \texttt{related} support in line with
  \pkg{biblatex} core}

\PrintChanges

\end{document}

%% 
%% Copyright (C) 2010-2014,2016-2018 by
%%   Joseph Wright <joseph.wright@morningstar2.co.uk>
%% 
%% It may be distributed and/or modified under the conditions of
%% the LaTeX Project Public License (LPPL), either version 1.3c of
%% this license or (at your option) any later version.  The latest
%% version of this license is in the file:
%% 
%%    http://www.latex-project.org/lppl.txt
%% 
%% This work is "maintained" (as per LPPL maintenance status) by
%%   Joseph Wright.
%% 
%% This work consists of the files biblatex-chem.bib,
%%                                 biblatex-chem.tex,
%%                                 biblatex-chem-acs.tex,
%%                                 biblatex-chem-angew.tex,
%%                                 biblatex-chem-biochem.tex,
%%                                 biblatex-chem-rsc.tex,
%%                                 chem-acs.bbx,
%%                                 chem-acs.cbx,
%%                                 chem-angew.bbx,
%%                                 chem-angew.cbx,
%%                                 chem-biochem.bbx,
%%                                 chem-biochem.cbx,
%%                                 chem-rsc.bbx and
%%                                 chem-rsc.cbx,
%%           and the derived files biblatex-chem.pdf,
%%                                 biblatex-chem-acs.pdf,
%%                                 biblatex-chem-angew.pdf,
%%                                 biblatex-chem-biochem.pdf and
%%                                 biblatex-chem-rsc.pdf.
%% 
%%
%% End of file `biblatex-chem.tex'.
