summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/biblatex-contrib/biblatex-chem/biblatex-chem.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/biblatex-contrib/biblatex-chem/biblatex-chem.tex')
-rw-r--r--macros/latex/contrib/biblatex-contrib/biblatex-chem/biblatex-chem.tex273
1 files changed, 273 insertions, 0 deletions
diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-chem/biblatex-chem.tex b/macros/latex/contrib/biblatex-contrib/biblatex-chem/biblatex-chem.tex
new file mode 100644
index 0000000000..8c9690f39a
--- /dev/null
+++ b/macros/latex/contrib/biblatex-contrib/biblatex-chem/biblatex-chem.tex
@@ -0,0 +1,273 @@
+%% ---------------------------------------------------------------
+%% 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.1x, last revised 2019/08/24.}}
+\date{Released 2019/08/24}
+
+\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}
+\changes{v1.1x}{2019-08-24}{Better formatting when article titles are included}
+
+\PrintChanges
+
+\end{document}
+
+%%
+%% Copyright (C) 2010-2014,2016-2019 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'.