summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/biblatex-contrib/biblatex-phys/biblatex-phys.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/biblatex-contrib/biblatex-phys/biblatex-phys.tex
Initial commit
Diffstat (limited to 'macros/latex/contrib/biblatex-contrib/biblatex-phys/biblatex-phys.tex')
-rw-r--r--macros/latex/contrib/biblatex-contrib/biblatex-phys/biblatex-phys.tex229
1 files changed, 229 insertions, 0 deletions
diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-phys/biblatex-phys.tex b/macros/latex/contrib/biblatex-contrib/biblatex-phys/biblatex-phys.tex
new file mode 100644
index 0000000000..bd9d6793e5
--- /dev/null
+++ b/macros/latex/contrib/biblatex-contrib/biblatex-phys/biblatex-phys.tex
@@ -0,0 +1,229 @@
+%% ---------------------------------------------------------------
+%% biblatex-phys --- A biblatex implementation of the AIP and APS
+%% bibliography style
+%% 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{lmodern}
+\usepackage[final]{microtype}
+\usepackage[T1]{fontenc}
+\usepackage[backend=biber,style=phys]{biblatex}
+\usepackage{csquotes}
+\usepackage{hyperref}
+
+\hypersetup{hidelinks}
+
+\addbibresource{biblatex-phys.bib}
+
+\author{Joseph Wright\thanks{E-mail:
+ \href{mailto:joseph.wright@morningstar2.co.uk}
+ {\texttt{joseph.wright@morningstar2.co.uk}}}}
+\title{\pkg{biblatex-phys} -- A \pkg{biblatex} implementation of the
+ \textsc{aip} and \textsc{aps} bibliography style%
+ \footnote{This file describes v1.1, last revised 2018/10/19.}}
+\date{Released 2018/10/19}
+
+\providecommand*{\opt}[1]{\texttt{#1}}
+\providecommand*{\pkg}[1]{\textsf{#1}}
+
+\let\DescribeOption\DescribeEnv
+
+\RecordChanges
+
+\begin{document}
+
+\maketitle
+
+This package provides a style for \pkg{biblatex} which follows the
+guidelines of the \textsc{aip} and \textsc{aps}. The citation style is numeric
+and unsorted. The bibliography style follows the pattern of the official
+REV\TeX{} class (\url{http://ctan.org/pkg/revtex}). The style should be loaded
+in the usual way
+\begin{verbatim}
+ \usepackage[style=phys]{biblatex}
+\end{verbatim}
+Load-time options are provided to deal with the small number of variations
+between the \textsc{aip} and \textsc{aps} styles.
+The References section of this document demonstrates the format
+generated by the package using the \texttt{biblatex-phys.bib} database
+of example citations.
+
+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-phys.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 the \textsc{aip} and \textsc{aps} styles.
+
+\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 \pkg{phys} style. 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 the \textsc{aip} and \textsc{aps}
+styles. The boolean option \opt{articletitle} is available is control this
+behaviour. The standard settings is \opt{true}, which follows the guidelines of
+the \textsc{aip}: it should be set to \opt{false} to follow the \textsc{aps}
+style. (This option also applies to the titles of proceedings entries and
+patents, which are treated in the same way.)
+
+\DescribeOption{biblabel}
+The format of the numbers used in the bibliography (the \enquote{bibliography
+label}) varies. he \opt{biblabel} option allows the user to easily set the
+format used. This option takes a values \opt{superscript} (the standard
+setting) and \opt{brackets}.
+
+\DescribeOption{chaptertitle}
+Printing chapter titles for \texttt{incollection} entries is part of the
+\textsc{aip} style but is not part of the \textsc{aps} style. The
+\opt{chaptertitle} option can be used to control this.
+
+\DescribeOption{pageranges}
+The inclusion of the full page range of journal articles varies between the
+\textsc{aip} and \textsc{aps} styles. The boolean option \opt{pageranges} is
+available is control this behaviour. The standard settings is \opt{true},
+which follows the guidelines of the \textsc{aip} and prints the full range:
+it should be set to \opt{false} to follow the \textsc{aps} style, which will
+result in only the first page being printed.
+
+\subsection{\texttt{collaboration} field}
+
+To support large-scale collaborations, the style recognises the
+\texttt{collaboration} field. This is a simple text field which gives the
+name of the collaboration, and which is printed in parenthesis after the
+authors.
+
+\subsection{\textsc{aip} and \textsc{aps} styles}
+
+As detailed above, the standard settings follow the \textsc{aip} style.
+To obtain the \textsc{aps} style, use
+\begin{verbatim}
+ \usepackage[%
+ style=phys,%
+ articletitle=false,biblabel=brackets,%
+ chaptertitle=false,pageranges=false%
+ ]
+ {biblatex}
+\end{verbatim}
+
+\section{Title formatting}
+
+The style convert article titles to sentence case format. This can be
+suppressed using
+\begin{verbatim}
+\DeclareFieldFormat{titlecase}{#1}
+\end{verbatim}
+
+\section{\textsc{url} formatting}
+
+The style uses the \pkg{url} package to format hyperlinks. As such, the
+format of these is left to the document author to alter. The \cs{urlstyle}
+command may be used to alter this, either for the whole document or only
+for the bibliography, for example by using
+\begin{verbatim}
+\AtBeginBibliography{%
+ \urlstyle{rm}%
+}
+\end{verbatim}
+
+\section{Interaction with \pkg{babel}}
+
+In common with other \pkg{biblatex} styles, \pkg{biblatex-phys} uses the
+\pkg{csquotes} package mechanism to place article titles in quotation marks.
+This means that the formatting of these will depend on the \pkg{babel}
+language in use. Full details are covered in the manuals for \pkg{biblatex}
+and \pkg{csquotes}.
+
+\section{Errors and omissions}
+
+Suggestions for improvement and bug reports can be logged in the package issue
+database, found at
+\url{https://github.com/josephwright/biblatex-phys/issues}, or can
+be sent by e-mail to
+\href{mailto:joseph.wright@morningstar2.co.uk}
+ {\texttt{joseph.wright@morningstar2.co.uk}}.
+
+\nocite{*}
+
+\printbibliography
+
+\changes{v0.9a}{2012/07/13}{Detect and remove repeated information in
+ entry sets at any position in the set}
+\changes{v0.9b}{2013/01/04}{Enable use of \texttt{firstinits} option}
+\changes{v0.9b}{2013/01/04}{Fix handling of \texttt{doi} field for
+ \texttt{article} entries}
+\changes{v0.9b}{2013/01/04}{Print \texttt{doi} or \texttt{url} after year
+ for \texttt{article} entries, consistent with \texttt{online} behaviour}
+\changes{v0.9c}{2013/01/22}{Link article publication details using \textsc{doi},
+ \textsc{url} or arXiv \texttt{eprint}}
+\changes{v0.9c}{2013/01/22}{Titles in sentence case}
+\changes{v0.9d}{2013/01/23}{Update journal title printing so case is unchanged
+ by processing of article titles (introduced in v0.9c)}
+\changes{v0.9d}{2013/01/27}{Improve arXiv formatting}
+\changes{v0.9d}{2013/01/27}{Minor fix for book formatting}
+\changes{v0.9d}{2013/01/27}{Link book titles using \textsc{doi} or
+ \textsc{url}}
+\changes{v0.9d}{2013/01/27}{Correctly include \enquote{related} material
+ (Biber-only)}
+\changes{v0.9e}{2013/01/29}{Link \enquote{related} articles using \textsc{doi}
+ or \textsc{url}}
+\changes{v0.9f}{2014/05/14}{Allow for variation in \texttt{journaltitle}
+ formatting}
+\changes{v1.0}{2016/03/10}{First stable release}
+\changes{v1.0a}{2016/03/13}{Ensure style works with both backends}
+\changes{v1.0b}{2016/08/23}{Fix author list formatting issue}
+\changes{v1.0c}{2018/10/19}{Update DOI link structure}
+\changes{v1.0c}{2018/10/19}{Update internals to follow standard \pkg{biblatex}
+ style changes}
+\changes{v1.1}{2018/10/19}{Support for \texttt{collaboration} field}
+
+\PrintChanges
+
+\end{document}
+
+%%
+%% Copyright (C) 2012-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-phys.bib,
+%% biblatex-phys.tex,
+%% biblatex-phys.tex,
+%% phys.bbx and
+%% phys.cbx,
+%% and the derived file biblatex-phys.pdf.
+%%
+%% End of file `biblatex-phys.tex'.