diff options
author | Karl Berry <karl@freefriends.org> | 2011-08-20 14:54:32 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2011-08-20 14:54:32 +0000 |
commit | fd5003bc0c73a154ca4fc2b76847cbda78a2148e (patch) | |
tree | 4b8ea489ab8155f921c3df17a059e384357c425e /Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem.tex | |
parent | b413025d048f633cd317a6ebeb85a0c212e974c1 (diff) |
biblatex-chem (18aug11)
git-svn-id: svn://tug.org/texlive/trunk@23617 c570f23f-e606-0410-a88d-b1316a301751
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.tex | 150 |
1 files changed, 124 insertions, 26 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 index bb4fa789878..45646f48ff2 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem.tex +++ b/Master/texmf-dist/doc/latex/biblatex-chem/biblatex-chem.tex @@ -21,51 +21,143 @@ {\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.1a, last revised 2011/08/16.}} -\date{Released 2011/08/16} + \footnote{This file describes v1.1c, last revised 2011/08/17.}} +\date{Released 2011/08/17} \providecommand*\opt[1]{\texttt{#1}} \providecommand*\pkg[1]{\textsf{#1}} +\let\DescribeOption\DescribeEnv + \RecordChanges \begin{document} \maketitle -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. +\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 documentation: +which has its own demonstration document: \begin{itemize} - \item The \href{file:biblatex-chem-acs.pdf}{\texttt{chem-acs}} style, + \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}{\texttt{chem-angew}} style, + \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}{\texttt{chem-biochem}} + \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}{\texttt{chem-rsc}} style, + \item The \href{file:biblatex-chem-rsc.pdf}{\pkg{chem-rsc}} style, which covers all Royal Society of Chemistry journals. \end{itemize} -Suggestions for improvement and bug reports can be logged in the package -issue database, found at +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{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} @@ -75,7 +167,7 @@ be sent by e-mail to \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 \texttt{maxbibnames} option such +\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} @@ -86,7 +178,13 @@ be sent by e-mail to \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 - \texttt{chem-angew} and \texttt{chem-rsc} styles} + \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} \PrintChanges |