diff options
author | Karl Berry <karl@freefriends.org> | 2018-03-05 22:20:02 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2018-03-05 22:20:02 +0000 |
commit | c4d413f7fd5020baebc166f24b7f39ba8f8aaacd (patch) | |
tree | 02c2fce0d73bbbf408b4f87cc64b9500179cc941 /Master/texmf-dist/doc/latex/biblatex-oxref | |
parent | cf3bfced31aa1039d850d531c69ee993e99430de (diff) |
biblatex-oxref (4mar18)
git-svn-id: svn://tug.org/texlive/trunk@46852 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-oxref')
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-oxref/Makefile | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-oxref/oxalph-doc.pdf | bin | 403316 -> 439285 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-oxref/oxalph-doc.tex | 642 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-oxref/oxnotes-doc.pdf | bin | 410530 -> 444826 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-oxref/oxnotes-doc.tex | 626 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-oxref/oxnum-doc.pdf | bin | 405607 -> 439576 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-oxref/oxnum-doc.tex | 616 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-oxref/oxref.bib | 160 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-oxref/oxref.pdf | bin | 483310 -> 520545 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-oxref/oxyear-doc.pdf | bin | 406889 -> 442924 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-oxref/oxyear-doc.tex | 652 |
11 files changed, 2349 insertions, 349 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-oxref/Makefile b/Master/texmf-dist/doc/latex/biblatex-oxref/Makefile index b93f5db01e4..4c468d7f97a 100644 --- a/Master/texmf-dist/doc/latex/biblatex-oxref/Makefile +++ b/Master/texmf-dist/doc/latex/biblatex-oxref/Makefile @@ -14,7 +14,7 @@ UTREE = $(shell kpsewhich --var-value TEXMFHOME) .PHONY: source clean distclean inst uninst install uninstall zip ctan -all: $(NAME).pdf $(STY1)-doc.pdf $(STY2)-doc.pdf $(STY3)-doc.pdf $(STY4)-doc.pdf clean +all: $(NAME).pdf $(STY1)-doc.pdf $(STY2)-doc.pdf $(STY3)-doc.pdf $(STY4)-doc.pdf @exit 0 source $(NAME).bbx american-$(NAME).lbx british-$(NAME).lbx english-$(NAME).lbx $(STY1)-doc.tex $(STY1).bbx $(STY1).cbx $(STY1).dbx $(STY2)-doc.tex $(STY2).bbx $(STY2).cbx $(STY2).dbx $(STY3)-doc.tex $(STY3).bbx $(STY3).cbx $(STY3).dbx $(STY4)-doc.tex $(STY4).bbx $(STY4).cbx $(STY4).dbx: $(NAME).dtx diff --git a/Master/texmf-dist/doc/latex/biblatex-oxref/oxalph-doc.pdf b/Master/texmf-dist/doc/latex/biblatex-oxref/oxalph-doc.pdf Binary files differindex 979f914bcd1..b50c5a7054a 100644 --- a/Master/texmf-dist/doc/latex/biblatex-oxref/oxalph-doc.pdf +++ b/Master/texmf-dist/doc/latex/biblatex-oxref/oxalph-doc.pdf diff --git a/Master/texmf-dist/doc/latex/biblatex-oxref/oxalph-doc.tex b/Master/texmf-dist/doc/latex/biblatex-oxref/oxalph-doc.tex index dfe2e6e7415..4921a90cfb8 100644 --- a/Master/texmf-dist/doc/latex/biblatex-oxref/oxalph-doc.tex +++ b/Master/texmf-dist/doc/latex/biblatex-oxref/oxalph-doc.tex @@ -13,7 +13,7 @@ %% See: http://www.latex-project.org/lppl.txt %% ---------------------------------------------------------------- %% -\def\Version{2018/02/09 v0.11.3} +\def\Version{2018/03/03 v0.12} \ProvidesFile{oxalph-doc.tex} [\Version\space Alphabetic biblatex style inspired by the Oxford Guide to Style] \PassOptionsToPackage{style=oxalph,varissuedate,anon}{biblatex} @@ -137,6 +137,8 @@ \DeclareSourcemap{% \maps[datatype=bibtex]{% \map[overwrite=true]{% + \pertype{legislation} + \pertype{legal} \step[fieldset=shorthand, null=true] }% }% @@ -265,25 +267,25 @@ The style is self-contained, so you can load it with \pkg{biblatex}: The style has some options additional to the regular \pkg{biblatex} ones: -\begin{docKey}{altthesis}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} - Puts the thesis type inside, rather than outside, the parenthetical publication block. -\end{docKey} - \begin{docKey}{anon}{=\val{literal}|\val{long}|\val{short}}{default \val{short}, initially \val{literal}} Affects what happens if the author name matches the value of \cs{oxrefanon}. - By default, this is ‘Anonymous’, but you could change it a different word (such as ‘Anonimo’) instead. + By default, this is \enquote{Anonymous}, but you could change it a different word (such as \enquote{Anonimo}) instead. \begin{itemize} \item\docValue{literal} means no special handling is used. \item\docValue{long} - will print the unabbreviated localization string \code{anon} (‘Anonymous’) instead of the author name + will print the unabbreviated localization string \code{anon} (\enquote{Anonymous}) instead of the author name in the bibliography. \item\docValue{short} - will print the abbreviated localization string \code{anon} (‘Anon.\@’) instead of the author name + will print the abbreviated localization string \code{anon} (\enquote{Anon.\@}) instead of the author name in the bibliography. \end{itemize} \end{docKey} +\begin{docKey}{bookseries}{=\val{in}|\val{out}}{default \val{in}, initially \val{in}} + Puts the series information for a book \docValue{in}side or \docValue{out}side the parenthetical publication block. +\end{docKey} + \begin{docKey}{court-plain}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} Prints courts of decision without parentheses. \end{docKey} @@ -308,32 +310,42 @@ The style has some options additional to the regular \pkg{biblatex} ones: Surrounds URLs with angle brackets. \end{docKey} +\begin{docKey}{issuedate-plain}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} + Removes the parentheses around the date of a periodical without a volume number. + This can also be set on a per-type and per-entry basis. + (This option was previously called \key{varissuedate}.) +\end{docKey} + \begin{docKey}{issuestyle}{=\val{slash}|\val{colon}|\val{comma}|\val{parens}}{default \val{slash}, initially \val{slash}} Affects how journal volumes and numbers are printed. \begin{itemize} \item\docValue{slash} - separates the two with a solidus, e.g. ‘23/2’. + separates the two with a solidus, e.g. \enquote{23/2}. \item\docValue{colon} - separates the two with a colon and space, e.g. ‘23: 2’. + separates the two with a colon and space, e.g. \enquote{23: 2}. It is intended for use with \textsf{oxnotes}\slash\textsf{oxnum} and not recommended for this style. \item\docValue{comma} - separates the two with a comma and space, e.g. ‘23, 2’. + separates the two with a comma and space, e.g. \enquote{23, 2}. \item\docValue{parens} - sets off the issue number in parentheses, e.g. ‘23 (2)’. + sets off the issue number in parentheses, e.g. \enquote{23 (2)}. \end{itemize} \end{docKey} \begin{docKey}{mergedate}{=\val{maximum}|\val{compact}|\val{basic}|\val{minimum}|\val{year}|\val{false}}{default \val{year}, initially \val{year}} - Affects how the date at the start of the references relates to the date in the ‘normal’ position. + Affects how the date at the start of the references relates to the date in the \enquote{normal} position. The default value of \val{year} is intended for use with the default setting of \key{labeldate}\texttt{=}\val{year}. - If you set \key{labeldate} to something else, you will probably want to set this option to \val{compact} or \val{maximum}. + If you set \key{labeldate} to something else, you will probably want to set this option to \val{compact} or \val{maximum}. It can also be set on a per-type basis. \end{docKey} \begin{docKey}{nolocation}{}{no value, initially unset} - Replaces missing locations with ‘n.p.’ or the localized equivalent in books, collections, reference works, proceedings, and similar entry types. Once set, this option cannot be overridden. + Replaces missing locations with \enquote{n.p.} or the localized equivalent in books, collections, reference works, proceedings, and similar entry types. Once set, this option cannot be overridden. Alternatively, it may be set on a per-entry basis. \end{docKey} +\begin{docKey}{nonodate}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} + Suppresses the printing of the \code{nodate} localization string when an entry is missing a recognizable date. It can also be set on a per-type and per-entry basis. It is automatically set to \val{true} for entries with a \code{sortyear}, on the assumption that the date has been given in a non-date field (e.g.\@ the number of a standard). +\end{docKey} + \begin{docKey}{nopublisher}{}{no value, initially unset} Removes publisher name from all entries. Once set, this option cannot be overridden. \end{docKey} @@ -347,6 +359,11 @@ The style has some options additional to the regular \pkg{biblatex} ones: \end{docKey} +\begin{docKey}{thesis}{=\val{in}|\val{out}|\val{plain}}{default \val{out}, initially \val{out}} + Puts the thesis type \docValue{in}side or \docValue{out}side the parenthetical publication block, + while \docValue{plain} removes the parentheses entirely. +\end{docKey} + \begin{docKey}{timefirst}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} Prints the time (if provided) before the date instead of after it. This can also be set on a per-type and per-entry basis. @@ -358,11 +375,6 @@ The style has some options additional to the regular \pkg{biblatex} ones: This can also be set on a per-type and per-entry basis. \end{docKey} -\begin{docKey}{varissuedate}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} - Removes the parentheses around the date of a periodical without a volume number. - This can also be set on a per-type and per-entry basis. -\end{docKey} - \pkg[biblatex]{Oxref} makes use of Biber-specific techniques to solve some of the challenges presented by Oxford style. It will not stop you from using Bib\TeX\ instead but, if you do, only simple and standard entries will work. In particular, manuscripts, legal references and anything involving related entries will be adversely affected. @@ -399,7 +411,7 @@ Examples that follow standard \textsf{biblatex} semantics, and are therefore Code used in bibliography file. \end{tcolorbox} -Examples that have been ‘hacked’ in some way, and are therefore not portable +Examples that have been \enquote{hacked} in some way, and are therefore not portable to other styles, are in amber: \begin{tcolorbox}% @@ -471,35 +483,17 @@ but by no means all of them will be supported. For information on installing the styles, and for the documented source code, see the separate documentation file \href{./oxref.pdf}{\texttt{oxref.pdf}} -\section{To do} +\section{Stability} The \pkg[biblatex]{oxref} family of styles is currently at \fileversion. -As mentioned above, what the styles \emph{should} be doing is open to some -interpretation, so at the moment I am open to the idea of changing how the -styles handle cases not covered by the two style manuals. Please leave your -thoughts on the GitHub issue tracker.\footnote{\url{https://github.com/alex-ball/biblatex-oxref/issues}} -At some point version 1.0 will be released, after which the default (expected) -behaviour of the styles will be fixed, though alternative behaviour may be added. - -I do not have any examples to work from for the following entry types, so they -are currently untested. If you have strong feelings about how they should be -rendered in Oxford style and can provide me with a sample reference or several, -I would be most glad to hear from you: - -\begin{multicols}{3} - \begin{itemize}\firmlist - \item suppbook - \item booklet - \item suppcollection - \item patent - \item suppperiodical - \item artwork - \item commentary - \item letter - \item performance - \item standard - \end{itemize} -\end{multicols} +I have no further features planned, so unless there is popular demand otherwise, +it should be bug-fix releases only between now and the release of version 1.0. +When that happens, the default (expected) behaviour of the styles will be frozen, +meaning I will do my best to avoid backwards-incompatible changes, though +alternative behaviour may be added. If you spot any aspects of the styles that +could be improved before then, especially for the cases not covered by the two +style manuals, please leave your thoughts on the GitHub issue tracker.% +\footnote{\url{https://github.com/alex-ball/biblatex-oxref/issues}} You are of course encouraged to report any bugs you discover on the \href{https://github.com/alex-ball/biblatex-oxref/issues}{GitHub issue tracker} @@ -514,17 +508,18 @@ and indeed loads a tweaked version of a standard \textsf{biblatex} one. Both the \emph{Oxford Guide to Style} and \emph{New Hart's Rules} describe a system that uses simple numbers as citation labels, almost as if they were endnotes. This system does not support page references, unlike the citation labels familiar to \LaTeX\ users. In the absence of a better idea, therefore, this style treats citation labels rather like author–year parenthetical citations and adopts the conventions from \textsf{oxyear}. Pages are set off with a colon, and multiple works are separated with a semicolon. -\begin{egcite}{} +\begin{egcite}% +{Test [\citefield{hankinson1988mmm}{labelalpha}: 93, 96; \citefield{hankinson1989gba}{labelalpha}: 72]} Test \parencites% [93, 96]{hankinson1988mmm}% [72]{hankinson1989gba} \end{egcite} -\section{Missing and inferred attribution} +\section{Missing or inferred attribution} \subsection{Missing attribution} -\tip{\pkg[biblatex]{Oxref} will not automatically generate anonymous labels for you, but if you use the \key{anon} option (see \cref{sec:loading}), you can transform an author name of ‘Anonymous’ (or whatever \cs{oxrefanon} is set to) in your .bib file to either the long or short localization string \code{anon}. +\tip{\pkg[biblatex]{Oxref} will not automatically generate anonymous labels for you, but if you use the \key{anon} option (see \cref{sec:loading}), you can transform an author name of \enquote{Anonymous} (or whatever \cs{oxrefanon} is set to) in your .bib file to either the long or short localization string \code{anon}. } \begin{bibexbox} @@ -566,7 +561,7 @@ Anon.\@ (1956), \emph{Liber usualis} (Tournai: Desclée). \subsection{Pseudepigraphy} Some older works are known to have been written pseudepigraphically, that is, falsely attributed to a more famous author. The way of indicating this in Oxford style, if desired, is -to put ‘(Ps.-)’ after the name in the bibliography. +to put \enquote{(Ps.-)} after the name in the bibliography. \tip{With \pkg[biblatex]{oxref}, you can achieve this by annotating the name with the keyword \code{pseudo}. } @@ -620,7 +615,7 @@ Oxford style is to give the attribution in square brackets. \tip{You can also use the syntax from \textsf{biblatex-realauthor}. If you do not specify the \code{author}, then \code{realauthor} is treated as an alias for \code{author} annotated with the keyword \code{inferred}. The equivalent is true for \code{realeditor}. - Note, however, that \pkg[biblatex]{oxref} does not recognize the \code{userealauthor} and \code{userealeditor} options.} + Note, however, that \pkg[biblatex]{oxref} does not recognize the \key{userealauthor} and \key{userealeditor} options.} \subsection{Pseudonyms} @@ -736,7 +731,7 @@ Kühner, R., rev. Blass, F. (1890-2), \emph{Ausführliche grammatik der griech \end{Verbatim} \end{bibexbox} -\tip{Annotate \emph{either} the \code{editor} \emph{or} \code{translator} field with the keyword \code{jointauthor} to promote the name to the joint author position (you cannot do it for both). Note that you have to supply a suitable \code{shortauthor} value yourself; \pkg[biblatex]{oxref} does not calculate it for you.} +\tip{Annotate \emph{either} the \code{editor} \emph{or} \code{translator} field with the keyword \code{jointauthor} to promote the name to the joint author position (you cannot do it for both). Internally, what this does is move the names to the \pkg[biblatex]{oxref}-specific \code{jointauthor} field; you can use this and \code{jointauthortype} directly if you like, at the cost of portability to other styles. Note that you have to supply a suitable \code{shortauthor} value yourself; \pkg[biblatex]{oxref} does not calculate it for you.} \section{Titular prefixes}\label{sec:nametitles} @@ -878,10 +873,10 @@ Milne, A. A. (1938), \emph{Pu der Bär} [Ger. trans. of \emph{Winnie the Pooh}] For periodicals, grey literature, audiovisual and online material, the lack of a place of publication is not surprising; indeed it may be expected. For books, however, it may be remarkable and deserve marking in the bibliography with \enquote{n.p.\@} (for \enquote{no place}). -\tip{To have \pkg[biblatex]{oxref} automatically insert \enquote{n.p.\@} or the localized equivalent for books, collections, reference works, proceedings and similar entry types, use the \code{nolocation} bibliography option.} +\tip{To have \pkg[biblatex]{oxref} automatically insert \enquote{n.p.\@} or the localized equivalent for books, collections, reference works, proceedings and similar entry types, use the \key{nolocation} bibliography option.} -\tip{To have \pkg[biblatex]{oxref} automatically insert \enquote{n.p.\@} or the localized equivalent for only a specific entry, use the \code{nolocation} entry option instead. - This has the feature of hiding the \enquote{n.p.\@} from other styles that do not follow the same convention.} +\tip{To have \pkg[biblatex]{oxref} automatically insert \enquote{n.p.\@} or the localized equivalent for only a specific entry, use the \key{nolocation} entry option instead. + The advantage of doing this over simply giving \enquote{n.p.\@} as the publisher is that it hides it from other styles that do not follow the same convention.} \begin{bibexbox} <NHR \S18.2.9\textdagger> @@ -898,12 +893,31 @@ Marchetto of Padua (1961), \emph{Pomerium}, ed. G. Vecchi (n.p.). \end{Verbatim} \end{bibexbox} +\section{Missing or inferred date of publication} + +If the date is missing from a work, you can sometimes make an educated guess +what it should be. It is usual practice to enclose such guesses in square +brackets. + +\tip{With \pkg[biblatex]{oxref}, you can achieve this by annotating the + \code{date}, \code{origdate}, or \code{eventdate} field with the keyword + \code{inferred}.} + +\begin{tcblisting}{listing only} + date+an = {=inferred}, +\end{tcblisting} + +Otherwise, if you don't supply a suitable date, it will be replaced with the +localization string \code{nodate}. If you don't want this behaviour, you can +suppress it with the \key{nonodate} option, which can be set globally or on a +per-type or per-entry basis. + \chapter{Articles and periodicals}\label{sec:article} \chapterprecis{article, periodical, suppperiodical, review} \section{Articles in periodicals with volumes/numbers} -The \emph{Oxford Guide to Style} consistently prefers volume and part numbers to be written like \enquote{23/2}, but also discusses formats such as \enquote{23: 2} and \enquote{23 (2)}. \emph{New Hart's Rules} adds \enquote{23, 2} as a further possibility. The latter two are better suited to \textsf{oxyear} which uses a colon to demarcate the page numbers. These variations are implemented as the option \textsf{issuestyle}; see \autoref{sec:loading} for details. +The \emph{Oxford Guide to Style} consistently prefers volume and part numbers to be written like \enquote{23/2}, but also discusses formats such as \enquote{23: 2} and \enquote{23 (2)}. \emph{New Hart's Rules} adds \enquote{23, 2} as a further possibility. The latter two are better suited to \textsf{oxalph}\slash\textsf{oxyear} which use a colon to demarcate the page numbers. These variations are implemented as the option \key{issuestyle}; see \autoref{sec:loading} for details. \spec{Author (Year), \enquote{Title}, \emph{JournalTitle}, Vol/Number: Pages.} @@ -976,7 +990,9 @@ Druin, A. (2002), \enquote{The Role of Children in the Design of New Technology} \end{bibexbox} \begin{bibexbox}(hacked) +<NHR \S18.8.5*\textdagger> {li.etal2013flh} +Li, S. et al. (2013), \enquote{Forever Love: The Hitherto Earliest Record of Copulating Insects from the Middle Jurassic of China}, \emph{PLoS ONE}, 8/11, e78188. doi: \path{10.1371/journal.pone.0078188} \tcblower \begin{Verbatim} @article{li.etal2013flh, @@ -1186,7 +1202,7 @@ Zhentao, X., Yau, K. K. C., and Stephenson, F. R. (1989) \enquote{Astronomical R \end{Verbatim} \end{bibexbox} -\tip{Use \code{bookpagination} to force the display of ‘pp.’ (since the number format is odd), and \cs{DeclareNumChars*}\brackets{S} to ensure that \code{S61} is recognized as a number.}% +\tip{Use \code{bookpagination} to force the display of \enquote{pp.} (since the number format is odd), and \cs{DeclareNumChars*}\brackets{S} to ensure that \code{S61} is recognized as a number.}% \section{Articles that span multiple issues} @@ -1235,11 +1251,53 @@ Stookey, R. W. (1974), \enquote{Social Structure and Politics in the Yemen Arab \end{Verbatim} \end{bibexbox} +\section{Editorials and other regular features} + +Strictly speaking, when a work is headed \enquote{Editorial} or \enquote{Letter to the Editor} +in a periodical, this is a descriptor rather than a title. + +\tip{If a piece has a true title, the descriptor goes in the \code{note} field. + If it doesn't, the descriptor goes in the \code{title} field; annotate the field with the keyword \code{descriptor} to remove the quote marks. + Alternatively, use the (non-standard) \code{descriptor} field for the descriptor in all cases, and \pkg[biblatex]{oxref} will take care of this for you.} + +\begin{bibexbox} +{ball2015ed} +(not in book) +\tcblower +\begin{Verbatim} +@suppperiodical{ball2015ed, + author = {Alexander Ball}, + title = {Editorial}, + title+an = {=descriptor}, + date = {2015}, + journaltitle = {International Journal of Digital Curation}, + volume = {10}, + number = {1}, + pages = {i-v}, + doi = {10.2218/ijdc.v10i1.376}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{jccm2006ed} +(not in book) +\tcblower +\begin{Verbatim} +@suppperiodical{jccm2006ed, + title = {\enquote{What a Disaster} and Why Does This Question Matter?}, + date = {2006}, + note = {Editorial}, + journaltitle = {Journal of Contingencies and Crisis Management}, + volume = {14}, + pages = {1-2}} +\end{Verbatim} +\end{bibexbox} + \section{Reviews} \spec{Author (Year), \enquote{Title}, \lit{review of} ReviewedWork, \lit{in} \emph{JournalTitle}, Vol/Number: Pages.} -\tip{To get this format, use a separate entry for the reviewed item, reference it in the ‘related’ field, and use the key ‘reviewof’ as the ‘relatedtype’.} +\tip{To get this format, use a separate entry for the reviewed item, reference it in the \enquote{related} field, and use the key \enquote{reviewof} as the \enquote{relatedtype}.} \begin{bibexbox} <OGS \S15.4.4\textdagger> @@ -1407,7 +1465,7 @@ Hankinson, R. J. (1988) (ed.), \emph{Method, Medicine, and Metaphysics} (Edmonto Biblatex uses \code{reference} for encyclopaedias and dictionaries, which are typically made up of many small contributions by distinct authors and compiled by an editorial board whose membership might change between successive editions. From a database perspective, reference works are like collections in that they have no single author (a reference work written by a single author should use the \code{book} entry type instead). -\tip{The \emph{Oxford Guide to Style} considers the titles of reference works to be more important and memorable than those of the editor, and so lists the title first, but \emph{New Hart's Rules} doesn't. \pkg[biblatex]{Oxref} takes the former approach, but you can switch to the latter by setting the \texttt{useeditor} option back to true for this type.} +\tip{The \emph{Oxford Guide to Style} considers the titles of reference works to be more important and memorable than those of the editor, and so lists the title first, but \emph{New Hart's Rules} doesn't. \pkg[biblatex]{Oxref} takes the former approach, but you can switch to the latter by setting the \key{useeditor} option back to true for this type.} \begin{tcblisting}{listing only} \ExecuteBibliographyOptions[reference,mvreference]{useeditor=true} @@ -1765,7 +1823,7 @@ Bettelheim, B. (1976), \emph{The Uses of Enchantment: The Meaning and Importance \subsection{Reprints} -\spec{Author (Year/Year), \emph{Title} (Location: Publisher; \lit{repr.} Location: Publisher).} +\spec{Author (Year–Year), \emph{Title} (Location: Publisher; \lit{repr.} Location: Publisher).} \tip{Use localization key \code{reprint} as the edition. For a revised reprint, use \code{revisedreprint}.} @@ -1805,7 +1863,7 @@ Southern, R. W. (1991), \emph{Saint Anselm: A Portrait in a Landscape} (rev. rep \end{Verbatim} \end{bibexbox} -\spec{Author (Year/Year), \emph{Title} (Location: Publisher; \lit{facs. edn.}, Location: Publisher).} +\spec{Author (Year–Year), \emph{Title} (Location: Publisher; \lit{facs. edn.}, Location: Publisher).} \tip{Use localization key \code{facsimile} as the edition.} @@ -2187,6 +2245,13 @@ Dahlhaus, C. (1971), \enquote{Miszellen zur Musiktheorie des 15.\@ Jahrhunderts} \section{Supplementary works in books and collections} +If the work is headed \enquote{Introduction}, \enquote{Foreword}, \enquote{Afterword}, or similar, +this is technically a descriptor rather than a title. + +\tip{If the work has a true title, the descriptor goes in the \code{note} field. + If it doesn't, the descriptor goes in the \code{title} field; annotate the field with the keyword \code{descriptor} to correct the formatting. + Alternatively, use the (non-standard) \code{descriptor} field for the descriptor in all cases, and \pkg[biblatex]{oxref} will take care of this for you.} + \begin{bibexbox} <NHR \S18.2.6*\textdagger> {gill1987intro} @@ -2196,6 +2261,7 @@ Gill, R. (1987), introduction in \emph{The Complete Works of Christopher Marlow} @suppbook{gill1987intro, author = {Roma Gill}, title = {introduction}, + title+an = {=descriptor}, booktitle = {The Complete Works of Christopher Marlow}, volume = {1}, origlocation = {Oxford}, @@ -2205,6 +2271,34 @@ Gill, R. (1987), introduction in \emph{The Complete Works of Christopher Marlow} \end{Verbatim} \end{bibexbox} +\begin{bibexbox} +{atwan2000fw} +(not in book) +\tcblower +\begin{Verbatim} +@suppcollection{atwan2000fw, + author = {Robert Atwan}, + title = {foreword}, + title+an = {=descriptor}, + address = {Boston}, + booktitle = {The Best American Essays of the Century}, + date = {2000}, + editor = {Joyce Carol Oates and Robert Atwan}, + publisher = {Houghton}, + pages = {x-xvi}} +\end{Verbatim} +\end{bibexbox} + +It is quite rare for such items to have a true title in addition, so previous +versions of \pkg[biblatex]{oxref} treated all titles of \texttt{suppbook} +entries as descriptors. + +\tip{To restore the previous behaviour, include the following code:} + +\begin{tcblisting}{listing only} +\DeclareFieldFormat[suppbook]{title}{#1} +\end{tcblisting} + \chapter{Works presented at meetings}\label{sec:proceedings} \chapterprecis{proceedings, mvproceedings, inproceedings, unpublished} @@ -2500,7 +2594,13 @@ CNNR/GMH (Comisión Nacional de Reparación y Reconciliación y Grupo de Memoria \section{Reports with a type or series} -\spec{Author (Year), \emph{Title}, Series, Number (Location: Institution).} +\tip{The number of a report will only be printed if you also supply a type or + series, or both. The difference between the two is that the series will be + separated from the (type and) number by a comma, while only a space + separates the type and number. In addition, if you supply a series but no + type, the number will be prefixed by `No.\@' or the localized equivalent.} + +\spec{Author (Year), \emph{Title}, Series, Type Number (Location: Institution).} \begin{bibexbox}<OGS \S15.19.2> {opcs1979amt} @@ -2518,8 +2618,6 @@ Office of Population Censuses and Surveys (1979a), \emph{Area Mortality Tables: \end{Verbatim} \end{bibexbox} -\spec{Author (Year), \emph{Title}, Type Number (Location: Institution).} - \begin{bibexbox}<OGS \S15.19.2> {opcs1979pnc} Office of Population Censuses and Surveys (1979b), \emph{Projections of the New Commonwealth and Pakistani Population}, OPCS Monitor PP2 79/1 (London) @@ -2553,6 +2651,25 @@ Rosenblatt, J., et al. (1988), \emph{The Common Agricultural Policy of the Europ \end{bibexbox} +\section{Jointly published reports} + +It is more common with reports than with books for a work to be branded +jointly by several issuing organizations. Neither the \emph{Oxford Guide to +Style} nor \emph{New Hart's Rules} give explicit guidance on this, but I +suggest handling it by giving corresponding lists as the \code{location} +and \code{institution}: + +\begin{tcblisting}{listing only} + location = {Place 1 and Place 2 and Place 3}, + institution = {Organization 1 and Organization 2 and Organization 3}, +\end{tcblisting} + +This will be printed as follows: + +\begin{tcolorbox} +(Place 1: Organization 1, Place 2: Organization 2, and Place 3: Organization 3) +\end{tcolorbox} + \section{Theses} \spec{Author (Year), \enquote{Title}, Type (Institution).} @@ -2572,12 +2689,192 @@ Blackburn, B. J. (1970), \enquote{The Lupus Problem}, Ph.D. diss. (University of \end{Verbatim} \end{bibexbox} -The following form is also supported: to use it, pass the \texttt{altthesis} option. +The following forms are also supported; to use them, pass the \key{thesis} option: + +\begin{itemize} + \item \key{thesis}\texttt{=}\val{in}\par +\spec{Author (Year), \enquote{Title} (Type, Institution).} + \item \key{thesis}\texttt{=}\val{plain}\par +\spec{Author (Year), \enquote{Title}, Type, Institution.} +\end{itemize} + +\section{Booklets, leaflets, and other formal but unpublished texts} + +There are no obvious examples of this kind of material in the \emph{Oxford Guide +to Style} or \emph{New Hart's Rules}. I welcome suggestions for how to make the +generated references more Oxford-like. + +\begin{bibexbox} +{msbh1921fvd} +(not in book) +\tcblower +\begin{Verbatim} +@booklet{msbh1921fvd, + title = {The Facts about Venereal Diseases}, + date = {1921}, + howpublished = {distributed by the Missouri State Board of Health, Division of Venereal Diseases}, + location = {Jefferson City, MO}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{lloyds2015m} +(not in book) +\tcblower +\begin{Verbatim} +@booklet{lloyds2015m, + author = {{Lloyds TSB Bank plc}}, + title = {Mortgages}, + date = {2015}, + howpublished = {obtained in Paisley branch}} +\end{Verbatim} +\end{bibexbox} + +\section{Patents} + +There are no examples of patents in the \emph{Oxford Guide to Style} or +\emph{New Hart's Rules}. I welcome suggestions for how to make the +generated references more Oxford-like. + +Following the conventions from \pkg{biblatex-chicago}, use \texttt{origdate} for +the date the patent was filed (or the application was published), and +\texttt{date} for the date the patent was finally issued or published. + +\tip{You can override the default date descriptions with the (non-standard) +\code{origdatetype} and \code{datetype} fields.} + +\begin{bibexbox} +{petroff.stapelbroek1980bib} +(not in book) +\tcblower +\begin{Verbatim} +@patent{petroff.stapelbroek1980bib, + author = {Petroff, M.~D. and Stapelbroek, M.~G.}, + title = {Blocked impurity band detectors}, + date = {1986-02-04}, + origdate = {1980-10-23}, + type = {patentus}, + number = {4,586,960}, + location = {Washington, DC}, + publisher = {U.S. Patent and Trademark Office}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{arduengo.etal2001pmi} +(not in book) +\tcblower +\begin{Verbatim} +@patent{arduengo.etal2001pmi, + author = {Arduengo, III, Anthony J. and Gentry, Jr., Frederick P. + and Taverkere, Prakash~K. and Simmons, III, Howard E.}, + title = {Process for manufacture of imidazoles}, + year = {2001}, + type = {patentus}, + holder = {{E.~I. DuPont}}, + number = {6177575}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{pm1981opa} +(not in book) +\tcblower +\begin{Verbatim} +@patent{pm1981opa, + author = {{Phillipp Morris Inc.}}, + title = {Optical perforating apparatus and system}, + origdate = {1981-01-07}, + date = {1985-05-15}, + type = {patenteu}, + number = {EP0021165}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{hideki1992qmc} +(not in book) +\tcblower +\begin{Verbatim} +@patent{hideki1992qmc, + author = {U. Hideki}, + title = {Quadrature Modulation Circuit}, + type = {patentjp}, + number = {152932/92}, + date = {1992-05-20}} +\end{Verbatim} +\end{bibexbox} + +\section{Standards} + +There are no examples of technical standards in the \emph{Oxford Guide +to Style} or \emph{New Hart's Rules}. I welcome suggestions for how to make the +generated references more Oxford-like. + +The particular quirk with standards entries is that the number is promoted to +the head of the reference if an author is not specified (or \key{useauthor} is +\val{false}). If this happens, the number is copied to \code{sortkey} so the +entry appears in the right place in the reference list, unless you get there +first with your own value of \code{sortkey}. You may want to do this if, for +example, you want \enquote{ISO 1000} to come after \enquote{ISO 999}. + +\tip{You are encouraged to put the standards body in \code{organization}, but + you can use \code{publisher} instead.} -\spec{Author (Year), \enquote{Title}, (Type, Institution).} +\tip{The examples don't demonstrate it, but you can use the \code{version} field + for the version of the standard.} + +\begin{bibexbox} +{bs5605:1990} +(not in book) +\tcblower +\begin{Verbatim} +@standard{bs5605:1990, + sortyear = {1990}, + title = {Recommendations for citing and referencing published material}, + number = {BS~5605:1990}, + shorthand = {BS5605}, + organization = {British Standards Institute}} +\end{Verbatim} +\end{bibexbox} + + +\begin{bibexbox} +{w3c2017html5.2} +(not in book) +\tcblower +\begin{Verbatim} +@standard{w3c2017html5.2, + title = {{HTML} 5.2}, + editor = {Steve Faulkner and Arron Eicholz and Travis Leithead and + Alex Danilo and Sangwhan Moon}, + date = {2017-12-14}, + type = {W3C Recommendation}, + organization = {World Wide Web Consortium}, + url = {https://www.w3.org/TR/html52/}, + urldate = {2018-02-17}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{ietf.rfc1155} +(not in book) +\tcblower +\begin{Verbatim} +@standard{ietf.rfc1155, + author = {M. T. Rose and K. McCloghrie}, + title = {Structure and identification of management information for {TCP/IP}-based internets}, + date = {1990-05}, + organization = {Internet Engineering Task Force}, + series = {Request for Comments}, + type = {Internet Standard}, + number = {RFC~1155/STD~16}, + doi = {10.17487/RFC1155}} +\end{Verbatim} +\end{bibexbox} \chapter{Audiovisual materials}\label{sec:audiovideo} -\chapterprecis{audio, inaudio, image, movie, music, inmusic, video} +\chapterprecis{artwork, audio, inaudio, image, movie, music, inmusic, performance, video} There are typically many contributors to an audiovisual work, and the priority given to each role is fluid. \pkg[biblatex]{Oxref} uses \code{author} for contributors that should go at the head of the reference, and \code{editor} for others. As well as the normal ones you can use the author\slash editor types \code{performer}, \code{conductor}, \code{director} and \code{reader}. @@ -2874,7 +3171,7 @@ Chaplin, C. (1936) (dir.), \emph{Modern Times} (United Artists). \tip{You can place up to four credits in the editor position, more if any of them correspond to the built-in editor types like \texttt{commentator} or \texttt{translator}. If you do supply a lot of credits, the \emph{Oxford Guide to Style} recommends you shift them to the end of the reference. - You can do this with the \texttt{endeditor} option.} + You can do this with the \key{endeditor} option.} \begin{bibexbox} <OGS \S15.14.2\textdagger> @@ -2957,7 +3254,7 @@ The \emph{Oxford Guide to Style} prints all information about the transmission, \spec{\enquote{EpisodeTitle} (Year), \emph{SeriesTitle}, \lit{Episode} EpisodeNumber, Channel, Day Month.} -\tip{If the episode has a true title, the episide descriptor (e.g. ‘Episode 1’) goes in the \code{note} field. +\tip{If the episode has a true title, the episide descriptor (e.g. \enquote{Episode 1}) goes in the \code{note} field. If it doesn't, the episode descriptor goes in the \code{title} field; annotate the field with the keyword \code{descriptor} to remove the quote marks. Alternatively, use the (non-standard) \code{descriptor} field for the episode descriptor in all cases, and \pkg[biblatex]{oxref} will take care of this for you.} @@ -3065,9 +3362,14 @@ Yousafzai, M. (2013), \enquote{Making a Wish for Action on Global Education: Mal \end{Verbatim} \end{bibexbox} -\section{Images} +\section{Images and works of art} + +\tip{If you need the type of image or arrtwork to appear in square brackets, + put it in \code{titleaddon}. Otherwise, put it in \code{type}.} -\tip{If desired, use \code{titleaddon} to specify the type of image.} +\tip{Use \code{institution} (a list) or \code{venue} (a literal) for the + organization, museum, gallery or building physically hosting the image, and + \code{location} for where it is.} \begin{bibexbox} <NHR \S18.8.5\textdagger> @@ -3079,12 +3381,14 @@ Clarke, M. (n.d.), \enquote{Exports of Coal to the IFS} [poster], Manchester Art author = {M. Clarke}, title = {Exports of Coal to the IFS}, titleaddon = {poster}, - organization = {Manchester Art Gallery}, + institution = {Manchester Art Gallery}, url = {http://www.machestergalleries.org/the-collections/search-the-collection/display.php?EMUSESSID=70bd7f1a388d79a82f52ea9aae713ef2&irn=4128}, urldate = {2013-11-05}} \end{Verbatim} \end{bibexbox} +\tip{Use \code{organization} for the website or online location of the image.} + \begin{bibexbox} <NHR \S18.8.5\textdagger> {ibwNDcgs} @@ -3093,18 +3397,130 @@ Clarke, M. (n.d.), \enquote{Exports of Coal to the IFS} [poster], Manchester Art \begin{Verbatim} @image{ibwNDcgs, title = {Christ the Good Shepherd}, - note = {stained glass window, Church of St Erfyl, Llanerfyl, Powys}, + type = {stained glass window}, + venue = {Church of St Erfyl}, + location = {Llanerfyl, Powys}, organization = {Imaging the Bible in Wales Database}, url = {http://imagingthebible.llgc.org.uk/object/1884}, urldate = {2013-11-10}} \end{Verbatim} \end{bibexbox} +\begin{bibexbox} +{davinci1480mr} +(not in book) +\tcblower +\begin{Verbatim} +@artwork{davinci1480mr, + author = {given=Leonardo, family=da Vinci}, + title = {Madonna of the Rocks}, + type = {oil on canvas}, + note = {78 x 48.5 in\adddot}, + year = {1480s}, + date+an = {=inferred}, + institution = {Louvre}, + location = {Paris}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{gormley1998an} +(not in book) +\tcblower +\begin{Verbatim} +@artwork{gormley1998an, + author = {Anthony Gormley}, + title = {Angel of the {North}}, + date = {1998}, + type = {sculpture}, + location = {Low Fell, Gateshead}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{rodin1882k} +(not in book) +\tcblower +\begin{Verbatim} +@artwork{rodin1882k, + author = {Auguste Rodin}, + title = {The Kiss}, + date = {1882}, + type = {marble}, + institution = {Musée Rodin}, + location = {Paris}} +\end{Verbatim} +\end{bibexbox} + +\section{Performances} + +\tip{Use \code{origdate} for the date when the play, ballet, opera, or whatever + was written or premièred, and \code{date} for the date of the performance you + are referencing. You can specify what these dates signify with the + (non-standard) \code{origdatetype} and \code{datetype} fields. You can also + use \code{eventdate} in place of \code{date}, but then you won't be able to + specify the type.} + +\tip{As for recordings, you can use the \code{author} and \code{editor} fields + to provide various credits. As for artworks, use \code{venue} and + \code{location} for where the performance occurred, and \code{organization} + for a website or organization hosting a recording of the performance online.} + +\begin{bibexbox} +{ashton1937wb} +(not in book) +\tcblower +\begin{Verbatim} +@performance{ashton1937wb, + author = {Frederick Ashton}, + origdate = {1937}, + title = {A Wedding Bouquet}, + venue = {Royal Opera House}, + location = {London}, + date = {2004-10-22}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{lord2007dc} +(not in book) +\tcblower +\begin{Verbatim} +@performance{lord2007dc, + author = {Jon Lord}, + date = {2007-10-20}, + title = {Durham Concerto}, + editor = {{Liverpool Philharmonic Orchestra}}, + editortype = {performer}, + editora = {Mischa Damev}, + editoratype = {conductor}, + venue = {Durham Cathedral}, + location = {Durham}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{judge1995mnd} +(not in book) +\tcblower +\begin{Verbatim} +@performance{judge1995mnd, + options = {useauthor=false,useeditor=false}, + author = {William Shakespeare}, + title = {A Midsummer Night's Dream}, + editor = {Ian Judge}, + editortype = {director}, + date = {1995-02-26}, + venue = {Theatre Royal}, + location = {Newcastle upon Tyne}} +\end{Verbatim} +\end{bibexbox} + \chapter{Digital media}\label{sec:electronic} \chapterprecis{online, software, dataset} In Section 18.8.5 of \emph{New Hart's Rules}, some publication dates are printed in parentheses and some are left bare. -In theory, the difference should be that parentheses indicate ‘proper’ publication (bare dates are when the resource was created or issued). In practice, it seems to be random. I have therefore decided to ignore the variation and leave all such dates in parentheses. +In theory, the difference should be that parentheses indicate \enquote{proper} publication (bare dates are when the resource was created or issued). In practice, it seems to be random. I have therefore decided to ignore the variation and leave all such dates in parentheses. \section{Website articles} @@ -3216,14 +3632,14 @@ McEwen, S. (2013), \enquote{Tan Twan Eng Interview: \enquote{I Have No Alternati \end{Verbatim} \end{bibexbox} +\tip{Unlike standard \textsf{biblatex}, \pkg[biblatex]{oxref} supports \code{maintitle} for online entries and prints the result in italics. For more portability, you could either hard-code the italics into the \code{organization} field or use the \code{article} entry type.} + \info{It is not made explicit why \emph{Encyclopaedia Britannica} is in italics and \emph{Wikipedia} is not. It might be historical or customary, because \emph{Encyclopaedia Britannica} was established as a print publication and \emph{Wikipedia} has only been online; it might be because \emph{Encyclopaedia Britannica} is a Latin title; it might reflect an opinion on the two resources; or it may just be illustrative of variant practice.} -\tip{Unlike standard \textsf{biblatex}, \pkg[biblatex]{oxref} supports \code{maintitle} for online entries and prints the result in italics. For more portability, you could either hard-code the italics into the \code{organization} field or use the \code{article} entry type.} - \begin{bibexbox} <NHR \S18.8.5\textdagger> {wp2013oup} @@ -3293,7 +3709,7 @@ Shakespeare's Globe (2013), \enquote{On this day in 1611 first production of The \end{Verbatim} \end{bibexbox} -\tip{If it feels odd putting the entire content of a tweet in your reference, \emph{New Hart's Rules} suggests using a descriptor like ‘Twitter post’ instead of the title. As described in \cref{sec:broadcasts}, you can do this either by annotating the title field with the keyword \code{descriptor} or by using the (non-standard) \code{descriptor} field in place of \code{title}.} +\tip{If it feels odd putting the entire content of a tweet in your reference, \emph{New Hart's Rules} suggests using a descriptor like \enquote{Twitter post} instead of the title. As described in \cref{sec:broadcasts}, you can do this either by annotating the title field with the keyword \code{descriptor} or by using the (non-standard) \code{descriptor} field in place of \code{title}.} \begin{bibexbox} {oup2015tweet} @@ -3414,7 +3830,7 @@ Use the \code{jurisdiction} entry type for citing cases. \tip{Several additional pagination types are defined for use with legal citations: \val{article}, \val{clause}, \val{regulation}, and \val{rule} all work as normal. - The default is a bare number (\val{none}), indicating a page reference, though EU and ECHR cases default to using the ‘para’ (\val{paragraph}) prefix. + The default is a bare number (\val{none}), indicating a page reference, though EU and ECHR cases default to using the \enquote{para} (\val{paragraph}) prefix. There is also an alternative pagination type for paragraphs, \val{[]}, which prints the number in square brackets instead of giving it a prefix. } @@ -3504,6 +3920,7 @@ Use the \code{jurisdiction} entry type for citing cases. \textcite[13]{rvg2004} \end{egcite} + \tip{If a report is published a long time after the decision, you can put the decision date in \code{origdate} to clarify the situation.} \begin{bibexbox} @@ -3627,7 +4044,7 @@ Both the \emph{Oxford Guide to Style} and \emph{New Hart's Rules} are inconsiste The \key{ecli} option determines under what circumstances the identifier is printed.} \tip{European cases still get sorted by title, even if the entry begins with the case number. - Use \code{sorttitle} if you would rather they were sorted under ‘Case’ or ‘Joined Cases’.} + Use \code{sorttitle} if you would rather they were sorted under \enquote{Case} or \enquote{Joined Cases}.} \begin{bibexbox} <OGS \S13.4.4> @@ -3647,7 +4064,7 @@ Case C–118/07 \emph{Commission of the European Communities v Finland} [2002] E \end{Verbatim} \end{bibexbox} -\tip{Indicate Commission Decisions by putting \code{commission} in the \code{institution} field. If a decision has a formal decision number, put this in the \code{number} field. Put the case number (including the word ‘Case’ if needed) in either the \code{titleaddon}, \code{parvolume}, or \code{userb} field.} +\tip{Indicate Commission Decisions by putting \code{commission} in the \code{institution} field. If a decision has a formal decision number, put this in the \code{number} field. Put the case number (including the word \enquote{Case} if needed) in either the \code{titleaddon}, \code{parvolume}, or \code{userb} field.} \tip{An unfortunate side effect of this is that is not possible to use either the parallel or neutral citation idiom to get a reference to look like the following. In such cases, use the \code{note} field to provide the second citation.} @@ -3885,7 +4302,6 @@ Convention Relating to the Status of Refugees (adopted 28 July 1951, entered int @legal{refugees, entrysubtype = {piltreaty}, title = {Convention Relating to the Status of Refugees}, - shorthand = {Refugee Convention}, execution = {adopted=1951-07-28 and inforce=1954-04-22}, pagination = {article}, volume = {189}, @@ -3968,7 +4384,7 @@ Law Commission (2009), \emph{Intoxication and Criminal Liability} (Law Comm No 3 it provides the \code{commentary} entry type simply as an alias for \code{book}. \chapter{Specialist materials}\label{sec:special} -\chapterprecis{misc, unpublished, letter} +\chapterprecis{misc, unpublished, letter, manuscript} \section{Poems}\label{sec:poem} @@ -4082,7 +4498,7 @@ Play titles, like those of epic poems, are set in italics rather than quoted. \section{Manuscripts}\label{sec:ms} -\spec{Author, Title/Descriptor, Date, Archive, Location, Collection Series, Shelfmark, Folios.} +\spec{Author (Year), \enquote{Title}/Descriptor, Date, Archive, Location, Collection Series, Shelfmark, Folios.} With \pkg[biblatex]{oxref}, you can enter manuscripts in either of two ways. The first uses the \code{unpublished} entry type. @@ -4101,7 +4517,7 @@ With \pkg[biblatex]{oxref}, you can enter manuscripts in either of two ways. The \begin{bibexbox} <NHR 18.6.3*\textdagger> {smithMS23116} -Smith, F. [1912–7], travel diaries, British Library, Add. MS 23116. +Smith, F. (1912–7), travel diaries, British Library, Add. MS 23116. \tcblower \begin{Verbatim} @unpublished{smithMS23116, @@ -4136,7 +4552,7 @@ The second uses the dedicated \code{manuscript} entry type from \textsf{biblatex \begin{bibexbox} <NHR 18.6.2\textdagger> {chaundlerMS288} -Chaundler, T. [n.d.], \enquote{Collocutiones}, Balliol College, Oxford, MS288. +Chaundler, T. (n.d.), \enquote{Collocutiones}, Balliol College, Oxford, MS288. \tcblower \begin{Verbatim} @manuscript{chaundlerMS288, @@ -4151,7 +4567,7 @@ Chaundler, T. [n.d.], \enquote{Collocutiones}, Balliol College, Oxford, MS288. \begin{bibexbox} <NHR 18.6.2\textdagger> {exchequerE311} -exchequer accounts [1798], Dec., Cheshire Record Office, E311. +exchequer accounts (1798), Dec., Cheshire Record Office, E311. \tcblower \begin{Verbatim} @manuscript{exchequerE311, @@ -4165,7 +4581,7 @@ exchequer accounts [1798], Dec., Cheshire Record Office, E311. \begin{bibexbox} <NHR 18.6.3\textdagger> {blcBOX19d} -Bearsden Ladies' Club minutes [1949], 12 June, Bearsden and Milngavie District Libraries, box 19/d. +Bearsden Ladies' Club minutes (1949), 12 June, Bearsden and Milngavie District Libraries, box 19/d. \tcblower \begin{Verbatim} @manuscript{blcBOX19d, @@ -4180,7 +4596,7 @@ Bearsden Ladies' Club minutes [1949], 12 June, Bearsden and Milngavie District L \begin{bibexbox} <NHR 18.6.5\textdagger> {bodMSrawl-d520} -Bodleian Library [n.d.], Oxford, MS Rawlinson D. 520, fo. 7. +Bodleian Library (n.d.), Oxford, MS Rawlinson D. 520, fo. 7. \tcblower \begin{Verbatim} @manuscript{bodMSrawl-d520, @@ -4214,6 +4630,52 @@ Bodleian Library [n.d.], Oxford, MS Rawlinson D. 520, fo. 7. \end{bibexbox} +\section{Letters} + +These examples relate to letters held personally or online. For letters that +form part of archival collections, see the section on manuscripts above. + +Note that it is usually acceptable to exclude personal communications from +the reference section, and simply cite them in the text (in which case you may +not need the \pkg{biblatex} machinery). + +\spec{Author (Year), \enquote{Title}/Descriptor, Date.} + +\begin{bibexbox} +<OGS \S15.11.1*\textdagger> +{anon2001pl} +Personal letter to the author (2001), 2 May. +\tcblower +\begin{Verbatim} +@letter{anon2001pl, + title = {Personal letter to the author}, + title+an = {=descriptor}, + date = {2001-05-02}} +\end{Verbatim} +\end{bibexbox} + +In the absence of any explicit rationale governing whether the date is +parenthetical, in \pkg[biblatex]{oxref} the presence of a URL +will trigger the use of parentheses. + +\spec{Author (Year), \enquote{Title}/Descriptor [HowPublished], (Date), OnlineAccess.} + +\begin{bibexbox} +<OGS \S15.15.3*\textdagger> +{ritter2001rp}% +Ritter, R. M. (2001), \enquote{Revised proofs} [email to H. E. Cox], (1 Aug.\@), \url{ogs@ritter.org.uk}, accessed 3 Aug.\@ 2001. +\tcblower +\begin{Verbatim} +@letter{ritter2001rp, + author = {R. M. Ritter}, + title = {Revised proofs}, + howpublished = {email to H. E. Cox}, + date = {2001-08-01}, + url = {ogs@ritter.org.uk}, + urldate = {2001-08-03}} +\end{Verbatim} +\end{bibexbox} + \printbibliography[notcategory=hidden] \end{document} %% diff --git a/Master/texmf-dist/doc/latex/biblatex-oxref/oxnotes-doc.pdf b/Master/texmf-dist/doc/latex/biblatex-oxref/oxnotes-doc.pdf Binary files differindex 94396bbf435..a130b052a5d 100644 --- a/Master/texmf-dist/doc/latex/biblatex-oxref/oxnotes-doc.pdf +++ b/Master/texmf-dist/doc/latex/biblatex-oxref/oxnotes-doc.pdf diff --git a/Master/texmf-dist/doc/latex/biblatex-oxref/oxnotes-doc.tex b/Master/texmf-dist/doc/latex/biblatex-oxref/oxnotes-doc.tex index ac593a5e19a..f9fef8febd8 100644 --- a/Master/texmf-dist/doc/latex/biblatex-oxref/oxnotes-doc.tex +++ b/Master/texmf-dist/doc/latex/biblatex-oxref/oxnotes-doc.tex @@ -13,7 +13,7 @@ %% See: http://www.latex-project.org/lppl.txt %% ---------------------------------------------------------------- %% -\def\Version{2018/02/09 v0.11.3} +\def\Version{2018/03/03 v0.12} \ProvidesFile{oxnotes-doc.tex} [\Version\space Footnote-based biblatex style inspired by the Oxford Guide to Style] \PassOptionsToPackage{style=oxnotes,scnames,varissuedate,anon}{biblatex} @@ -134,6 +134,15 @@ {\multicitedelim} {\usebibmacro{postnote}\finentrypunct} \makeatother +\DeclareSourcemap{% + \maps[datatype=bibtex]{% + \map[overwrite=true]{% + \pernottype{legslation} + \pernottype{legal} + \step[fieldset=shorthand, null=true] + }% + }% +} \hypersetup{pdfborder={0 0 0},pdfencoding=auto} \usepackage[noabbrev,capitalize,nameinlink]{cleveref} @@ -258,25 +267,25 @@ The style is self-contained, so you can load it with \pkg{biblatex}: The style has some options additional to the regular \pkg{biblatex} ones: -\begin{docKey}{altthesis}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} - Puts the thesis type inside, rather than outside, the parenthetical publication block. -\end{docKey} - \begin{docKey}{anon}{=\val{literal}|\val{long}|\val{short}}{default \val{short}, initially \val{literal}} Affects what happens if the author name matches the value of \cs{oxrefanon}. - By default, this is ‘Anonymous’, but you could change it a different word (such as ‘Anonimo’) instead. + By default, this is \enquote{Anonymous}, but you could change it a different word (such as \enquote{Anonimo}) instead. \begin{itemize} \item\docValue{literal} means no special handling is used. \item\docValue{long} - will print the unabbreviated localization string \code{anon} (‘Anonymous’) instead of the author name + will print the unabbreviated localization string \code{anon} (\enquote{Anonymous}) instead of the author name in the bibliography, but neither are printed in citations. \item\docValue{short} - will print the abbreviated localization string \code{anon} (‘Anon.\@’) instead of the author name + will print the abbreviated localization string \code{anon} (\enquote{Anon.\@}) instead of the author name in the bibliography, but neither are printed in citations. \end{itemize} \end{docKey} +\begin{docKey}{bookseries}{=\val{in}|\val{out}}{default \val{in}, initially \val{in}} + Puts the series information for a book \docValue{in}side or \docValue{out}side the parenthetical publication block. +\end{docKey} + \begin{docKey}{court-plain}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} Prints courts of decision without parentheses. \end{docKey} @@ -301,27 +310,34 @@ The style has some options additional to the regular \pkg{biblatex} ones: Surrounds URLs with angle brackets. \end{docKey} +\begin{docKey}{issuedate-plain}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} + Removes the parentheses around the date of a periodical without a volume number. + This can also be set on a per-type and per-entry basis. + (This option was previously called \key{varissuedate}.) +\end{docKey} + \begin{docKey}{issuestyle}{=\val{slash}|\val{colon}|\val{comma}|\val{parens}}{default \val{slash}, initially \val{slash}} Affects how journal volumes and numbers are printed. \begin{itemize} \item\docValue{slash} - separates the two with a solidus, e.g. ‘23/2’. + separates the two with a solidus, e.g. \enquote{23/2}. \item\docValue{colon} - separates the two with a colon and space, e.g. ‘23: 2’. + separates the two with a colon and space, e.g. \enquote{23: 2}. \item\docValue{comma} - separates the two with a comma and space, e.g. ‘23, 2’. + separates the two with a comma and space, e.g. \enquote{23, 2}. \item\docValue{parens} - sets off the issue number in parentheses, e.g. ‘23 (2)’. + sets off the issue number in parentheses, e.g. \enquote{23 (2)}. It is intended for use with \textsf{oxalph}\slash\textsf{oxyear} and not recommended for this style. \end{itemize} \end{docKey} \begin{docKey}{nolocation}{}{no value, initially unset} - Replaces missing locations with ‘n.p.’ or the localized equivalent in books, collections, reference works, proceedings, and similar entry types. Once set, this option cannot be overridden. + Replaces missing locations with \enquote{n.p.} or the localized equivalent in books, collections, reference works, proceedings, and similar entry types. Once set, this option cannot be overridden. Alternatively, it may be set on a per-entry basis. \end{docKey} + \begin{docKey}{nopublisher}{}{no value, initially unset} Removes publisher name from all entries. Once set, this option cannot be overridden. \end{docKey} @@ -338,6 +354,11 @@ The style has some options additional to the regular \pkg{biblatex} ones: Prints initial author or editor names in bibliography entries in small capitals. \end{docKey} +\begin{docKey}{thesis}{=\val{in}|\val{out}|\val{plain}}{default \val{out}, initially \val{out}} + Puts the thesis type \docValue{in}side or \docValue{out}side the parenthetical publication block, + while \docValue{plain} removes the parentheses entirely. +\end{docKey} + \begin{docKey}{timefirst}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} Prints the time (if provided) before the date instead of after it. This can also be set on a per-type and per-entry basis. @@ -349,11 +370,6 @@ The style has some options additional to the regular \pkg{biblatex} ones: This can also be set on a per-type and per-entry basis. \end{docKey} -\begin{docKey}{varissuedate}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} - Removes the parentheses around the date of a periodical without a volume number. - This can also be set on a per-type and per-entry basis. -\end{docKey} - \pkg[biblatex]{Oxref} makes use of Biber-specific techniques to solve some of the challenges presented by Oxford style. It will not stop you from using Bib\TeX\ instead but, if you do, only simple and standard entries will work. In particular, manuscripts, legal references and anything involving related entries will be adversely affected. @@ -390,7 +406,7 @@ Examples that follow standard \textsf{biblatex} semantics, and are therefore Code used in bibliography file. \end{tcolorbox} -Examples that have been ‘hacked’ in some way, and are therefore not portable +Examples that have been \enquote{hacked} in some way, and are therefore not portable to other styles, are in amber: \begin{tcolorbox}% @@ -459,35 +475,17 @@ but by no means all of them will be supported. For information on installing the styles, and for the documented source code, see the separate documentation file \href{./oxref.pdf}{\texttt{oxref.pdf}} -\section{To do} +\section{Stability} The \pkg[biblatex]{oxref} family of styles is currently at \fileversion. -As mentioned above, what the styles \emph{should} be doing is open to some -interpretation, so at the moment I am open to the idea of changing how the -styles handle cases not covered by the two style manuals. Please leave your -thoughts on the GitHub issue tracker.\footnote{\url{https://github.com/alex-ball/biblatex-oxref/issues}} -At some point version 1.0 will be released, after which the default (expected) -behaviour of the styles will be fixed, though alternative behaviour may be added. - -I do not have any examples to work from for the following entry types, so they -are currently untested. If you have strong feelings about how they should be -rendered in Oxford style and can provide me with a sample reference or several, -I would be most glad to hear from you: - -\begin{multicols}{3} - \begin{itemize}\firmlist - \item suppbook - \item booklet - \item suppcollection - \item patent - \item suppperiodical - \item artwork - \item commentary - \item letter - \item performance - \item standard - \end{itemize} -\end{multicols} +I have no further features planned, so unless there is popular demand otherwise, +it should be bug-fix releases only between now and the release of version 1.0. +When that happens, the default (expected) behaviour of the styles will be frozen, +meaning I will do my best to avoid backwards-incompatible changes, though +alternative behaviour may be added. If you spot any aspects of the styles that +could be improved before then, especially for the cases not covered by the two +style manuals, please leave your thoughts on the GitHub issue tracker.% +\footnote{\url{https://github.com/alex-ball/biblatex-oxref/issues}} You are of course encouraged to report any bugs you discover on the \href{https://github.com/alex-ball/biblatex-oxref/issues}{GitHub issue tracker} @@ -516,19 +514,19 @@ Test\footcite[49-50]{faith1997epg} \end{egcite} \addtocategory{hidden}{cobban} -Both the \emph{Oxford Guide to Style} and \emph{New Hart's Rules} describe an alternative system that uses the abbreviations ‘ibid.\@’, ‘op.\@ cit.\@’, ‘loc.\@ cit.\@’, and ‘id.\@’ and friends, though with underwhelming enthusiasm. If you would like to use these abbreviations, load the \textsf{verbose-trad1} citation scheme instead (and remember to use the \code{gender} field): +Both the \emph{Oxford Guide to Style} and \emph{New Hart's Rules} describe an alternative system that uses the abbreviations \enquote{ibid.\@}, \enquote{op.\@ cit.\@}, \enquote{loc.\@ cit.\@}, and \enquote{id.\@} and friends, though with underwhelming enthusiasm. If you would like to use these abbreviations, load the \textsf{verbose-trad1} citation scheme instead (and remember to use the \code{gender} field): \begin{tcblisting}{listing only} \usepackage[bibstyle=oxnotes,citestyle=verbose-trad1]{biblatex} \end{tcblisting} -\section{Missing and inferred attribution} +\section{Missing or inferred attribution} \subsection{Missing attribution} -Where works have no attribution, both the \emph{Oxford Guide to Style} and \emph{New Hart's Rules} suggest printing them without further adornment in notes, but listing them under ‘Anonymous’ (or ‘Anon.\@’ in the latter case) in the bibliography. +Where works have no attribution, both the \emph{Oxford Guide to Style} and \emph{New Hart's Rules} suggest printing them without further adornment in notes, but listing them under \enquote{Anonymous} (or \enquote{Anon.\@} in the latter case) in the bibliography. -\tip{\pkg[biblatex]{Oxref} will not automatically generate anonymous labels for you, but if you use the \key{anon} option (see \cref{sec:loading}), you can transform an author name of ‘Anonymous’ (or whatever \cs{oxrefanon} is set to) in your .bib file to either the long or short localization string \code{anon}. +\tip{\pkg[biblatex]{Oxref} will not automatically generate anonymous labels for you, but if you use the \key{anon} option (see \cref{sec:loading}), you can transform an author name of \enquote{Anonymous} (or whatever \cs{oxrefanon} is set to) in your .bib file to either the long or short localization string \code{anon}. Doing this will automatically suppress the printing of the anonymous author in notes. } @@ -572,8 +570,8 @@ Where works have no attribution, both the \emph{Oxford Guide to Style} and \emph \subsection{Pseudepigraphy} Some older works are known to have been written pseudepigraphically, that is, falsely attributed to a more famous author. The way of indicating this in Oxford style, if desired, is -to add the prefix ‘Pseudo-’ before the name in notes, and -to put ‘(Ps.-)’ after the name in the bibliography. +to add the prefix \enquote{Pseudo-} before the name in notes, and +to put \enquote{(Ps.-)} after the name in the bibliography. \tip{With \pkg[biblatex]{oxref}, you can achieve this by annotating the name with the keyword \code{pseudo}. Since this mechanism is aimed at ancient texts, it has only been designed to work with single-part names @@ -629,7 +627,7 @@ Oxford style is to give the attribution in square brackets. \tip{You can also use the syntax from \textsf{biblatex-realauthor}. If you do not specify the \code{author}, then \code{realauthor} is treated as an alias for \code{author} annotated with the keyword \code{inferred}. The equivalent is true for \code{realeditor}. - Note, however, that \pkg[biblatex]{oxref} does not recognize the \code{userealauthor} and \code{userealeditor} options.} + Note, however, that \pkg[biblatex]{oxref} does not recognize the \key{userealauthor} and \key{userealeditor} options.} \subsection{Pseudonyms} @@ -746,7 +744,7 @@ If the contribution of the translators or revisers is so great they could be joi \end{Verbatim} \end{bibexbox} -\tip{Annotate \emph{either} the \code{editor} \emph{or} \code{translator} field with the keyword \code{jointauthor} to promote the name to the joint author position (you cannot do it for both). Note that you have to supply a suitable \code{shortauthor} value yourself; \pkg[biblatex]{oxref} does not calculate it for you.} +\tip{Annotate \emph{either} the \code{editor} \emph{or} \code{translator} field with the keyword \code{jointauthor} to promote the name to the joint author position (you cannot do it for both). Internally, what this does is move the names to the \pkg[biblatex]{oxref}-specific \code{jointauthor} field; you can use this and \code{jointauthortype} directly if you like, at the cost of portability to other styles. Note that you have to supply a suitable \code{shortauthor} value yourself; \pkg[biblatex]{oxref} does not calculate it for you.} \section{Titular prefixes}\label{sec:nametitles} @@ -888,10 +886,10 @@ A. A. Milne, \emph{Pu der Bär} [Ger. trans. of \emph{Winnie the Pooh}] (Potsdam For periodicals, grey literature, audiovisual and online material, the lack of a place of publication is not surprising; indeed it may be expected. For books, however, it may be remarkable and deserve marking in the bibliography with \enquote{n.p.\@} (for \enquote{no place}). -\tip{To have \pkg[biblatex]{oxref} automatically insert \enquote{n.p.\@} or the localized equivalent for books, collections, reference works, proceedings and similar entry types, use the \code{nolocation} bibliography option.} +\tip{To have \pkg[biblatex]{oxref} automatically insert \enquote{n.p.\@} or the localized equivalent for books, collections, reference works, proceedings and similar entry types, use the \key{nolocation} bibliography option.} -\tip{To have \pkg[biblatex]{oxref} automatically insert \enquote{n.p.\@} or the localized equivalent for only a specific entry, use the \code{nolocation} entry option instead. - This has the feature of hiding the \enquote{n.p.\@} from other styles that do not follow the same convention.} +\tip{To have \pkg[biblatex]{oxref} automatically insert \enquote{n.p.\@} or the localized equivalent for only a specific entry, use the \key{nolocation} entry option instead. + The advantage of doing this over simply giving \enquote{n.p.\@} as the publisher is that it hides it from other styles that do not follow the same convention.} \begin{bibexbox} <NHR \S18.2.9> @@ -908,12 +906,26 @@ Marchetto of Padua, \emph{Pomerium}, ed. Guiseppe Vecchi (n.p., 1961). \end{Verbatim} \end{bibexbox} +\section{Missing or inferred date of publication} + +If the date is missing from a work, you can sometimes make an educated guess +what it should be. It is usual practice to enclose such guesses in square +brackets. + +\tip{With \pkg[biblatex]{oxref}, you can achieve this by annotating the + \code{date}, \code{origdate}, or \code{eventdate} field with the keyword + \code{inferred}.} + +\begin{tcblisting}{listing only} + date+an = {=inferred}, +\end{tcblisting} + \chapter{Articles and periodicals}\label{sec:article} \chapterprecis{article, periodical, suppperiodical, review} \section{Articles in periodicals with volumes/numbers} -The \emph{Oxford Guide to Style} consistently prefers volume and part numbers to be written like \enquote{23/2}, but also discusses formats such as \enquote{23: 2} and \enquote{23 (2)}. \emph{New Hart's Rules} adds \enquote{23, 2} as a further possibility. The latter two are better suited to \textsf{oxyear} which uses a colon to demarcate the page numbers. These variations are implemented as the option \textsf{issuestyle}; see \autoref{sec:loading} for details. +The \emph{Oxford Guide to Style} consistently prefers volume and part numbers to be written like \enquote{23/2}, but also discusses formats such as \enquote{23: 2} and \enquote{23 (2)}. \emph{New Hart's Rules} adds \enquote{23, 2} as a further possibility. The latter two are better suited to \textsf{oxalph}\slash\textsf{oxyear} which use a colon to demarcate the page numbers. These variations are implemented as the option \key{issuestyle}; see \autoref{sec:loading} for details. \spec{Author, \enquote{Title}, \emph{JournalTitle}, Vol/Number (Year), Pages.} @@ -1207,7 +1219,7 @@ X. Zhentao, K. K. C. Yau, and F. R. Stephenson, \enquote{Astronomical Records on \end{Verbatim} \end{bibexbox} -\tip{Use \code{bookpagination} to force the display of ‘pp.’ (since the number format is odd), and \cs{DeclareNumChars*}\brackets{S} to ensure that \code{S61} is recognized as a number.}% +\tip{Use \code{bookpagination} to force the display of \enquote{pp.} (since the number format is odd), and \cs{DeclareNumChars*}\brackets{S} to ensure that \code{S61} is recognized as a number.}% \section{Articles that span multiple issues} @@ -1233,11 +1245,53 @@ X. Zhentao, K. K. C. Yau, and F. R. Stephenson, \enquote{Astronomical Records on \end{Verbatim} \end{bibexbox} +\section{Editorials and other regular features} + +Strictly speaking, when a work is headed \enquote{Editorial} or \enquote{Letter to the Editor} +in a periodical, this is a descriptor rather than a title. + +\tip{If a piece has a true title, the descriptor goes in the \code{note} field. + If it doesn't, the descriptor goes in the \code{title} field; annotate the field with the keyword \code{descriptor} to remove the quote marks. + Alternatively, use the (non-standard) \code{descriptor} field for the descriptor in all cases, and \pkg[biblatex]{oxref} will take care of this for you.} + +\begin{bibexbox} +{ball2015ed} +(not in book) +\tcblower +\begin{Verbatim} +@suppperiodical{ball2015ed, + author = {Alexander Ball}, + title = {Editorial}, + title+an = {=descriptor}, + date = {2015}, + journaltitle = {International Journal of Digital Curation}, + volume = {10}, + number = {1}, + pages = {i-v}, + doi = {10.2218/ijdc.v10i1.376}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{jccm2006ed} +(not in book) +\tcblower +\begin{Verbatim} +@suppperiodical{jccm2006ed, + title = {\enquote{What a Disaster} and Why Does This Question Matter?}, + date = {2006}, + note = {Editorial}, + journaltitle = {Journal of Contingencies and Crisis Management}, + volume = {14}, + pages = {1-2}} +\end{Verbatim} +\end{bibexbox} + \section{Reviews} \spec{Author, \enquote{Title}, \lit{review of} ReviewedWork, \lit{in} \emph{JournalTitle}, Vol/Number (Year), Pages.} -\tip{To get this format, use a separate entry for the reviewed item, reference it in the ‘related’ field, and use the key ‘reviewof’ as the ‘relatedtype’.} +\tip{To get this format, use a separate entry for the reviewed item, reference it in the \enquote{related} field, and use the key \enquote{reviewof} as the \enquote{relatedtype}.} \begin{bibexbox} <OGS \S15.4.4> @@ -1402,7 +1456,7 @@ Rosemary Stewart et al. (eds.), \emph{Managing in Britain} (London, 1994). Biblatex uses \code{reference} for encyclopaedias and dictionaries, which are typically made up of many small contributions by distinct authors and compiled by an editorial board whose membership might change between successive editions. From a database perspective, reference works are like collections in that they have no single author (a reference work written by a single author should use the \code{book} entry type instead). -\tip{The \emph{Oxford Guide to Style} considers the titles of reference works to be more important and memorable than those of the editor, and so lists the title first, but \emph{New Hart's Rules} doesn't. \pkg[biblatex]{Oxref} takes the former approach, but you can switch to the latter by setting the \texttt{useeditor} option back to true for this type.} +\tip{The \emph{Oxford Guide to Style} considers the titles of reference works to be more important and memorable than those of the editor, and so lists the title first, but \emph{New Hart's Rules} doesn't. \pkg[biblatex]{Oxref} takes the former approach, but you can switch to the latter by setting the \key{useeditor} option back to true for this type.} \begin{tcblisting}{listing only} \ExecuteBibliographyOptions[reference,mvreference]{useeditor=true} @@ -1764,7 +1818,7 @@ J. D. Denniston, \emph{The Greek Particles} (1934; 2nd edn., Oxford, 1954). \end{Verbatim} \end{bibexbox} -\tip{Use the localization key \code{revised} as the edition to get ‘revised edition’. Use the localization key \code{revisedenlarged} as the edition to get ‘revised and enlarged edition’} +\tip{Use the localization key \code{revised} as the edition to get \enquote{revised edition}. Use the localization key \code{revisedenlarged} as the edition to get \enquote{revised and enlarged edition}} \begin{bibexbox}<OGS \S15.2.1*> {gibbon1686dfs} @@ -1783,7 +1837,7 @@ J. D. Denniston, \emph{The Greek Particles} (1934; 2nd edn., Oxford, 1954). \end{Verbatim} \end{bibexbox} -\info{In the \emph{Oxford Guide to Style}, there is no comma after ‘rev. edn.’ in the above reference; this may be an error.} +\info{In the \emph{Oxford Guide to Style}, there is no comma after \enquote{rev. edn.} in the above reference; this may be an error.} \subsection{Republications} @@ -1795,7 +1849,7 @@ rather than within the publication block% \spec{Author, \emph{Title} (Location: Publisher, Year) (\lit{originally pub.} Year).} \tip{This format is triggered if you specify an original date but do not specify the original publisher or location, nor the edition of the later publication.} -\info{In the following example, you will see the style uses ‘originally published’ instead of ‘first published’. This is because ‘originally’ is more common among the available examples.} +\info{In the following example, you will see the style uses \enquote{originally published} instead of \enquote{first published}. This is because \enquote{originally} is more common among the available examples.} \begin{bibexbox} <OGS \S15.2.3> @@ -2241,6 +2295,13 @@ Carl Dahlhaus, \enquote{Miszellen zur Musiktheorie des 15.\@ Jahrhunderts}, \emp \section{Supplementary works in books and collections} +If the work is headed \enquote{Introduction}, \enquote{Foreword}, \enquote{Afterword}, or similar, +this is technically a descriptor rather than a title. + +\tip{If the work has a true title, the descriptor goes in the \code{note} field. + If it doesn't, the descriptor goes in the \code{title} field; annotate the field with the keyword \code{descriptor} to correct the formatting. + Alternatively, use the (non-standard) \code{descriptor} field for the descriptor in all cases, and \pkg[biblatex]{oxref} will take care of this for you.} + \begin{bibexbox} <NHR \S18.2.6*> {gill1987intro} @@ -2250,6 +2311,7 @@ Roma Gill, introduction in \emph{The Complete Works of Christopher Marlow}, i (O @suppbook{gill1987intro, author = {Roma Gill}, title = {introduction}, + title+an = {=descriptor}, booktitle = {The Complete Works of Christopher Marlow}, volume = {1}, origlocation = {Oxford}, @@ -2259,6 +2321,34 @@ Roma Gill, introduction in \emph{The Complete Works of Christopher Marlow}, i (O \end{Verbatim} \end{bibexbox} +\begin{bibexbox} +{atwan2000fw} +(not in book) +\tcblower +\begin{Verbatim} +@suppcollection{atwan2000fw, + author = {Robert Atwan}, + title = {foreword}, + title+an = {=descriptor}, + address = {Boston}, + booktitle = {The Best American Essays of the Century}, + date = {2000}, + editor = {Joyce Carol Oates and Robert Atwan}, + publisher = {Houghton}, + pages = {x-xvi}} +\end{Verbatim} +\end{bibexbox} + +It is quite rare for such items to have a true title in addition, so previous +versions of \pkg[biblatex]{oxref} treated all titles of \texttt{suppbook} +entries as descriptors. + +\tip{To restore the previous behaviour, include the following code:} + +\begin{tcblisting}{listing only} +\DeclareFieldFormat[suppbook]{title}{#1} +\end{tcblisting} + \chapter{Works presented at meetings}\label{sec:proceedings} \chapterprecis{proceedings, mvproceedings, inproceedings, unpublished} @@ -2542,8 +2632,33 @@ UNESCO, \emph{The United Nations World Water Development Report 4}, vol. 1: \emp \section{Reports with a type or series} -\spec{Author, \emph{Title}, Series, Number (Location: Institution, Year).} +\tip{The number of a report will only be printed if you also supply a type or + series, or both. The difference between the two is that the series will be + separated from the (type and) number by a comma, while only a space + separates the type and number. In addition, if you supply a series but no + type, the number will be prefixed by `No.\@' or the localized equivalent.} + +\spec{Author, \emph{Title}, Series, Type Number (Location: Institution, Year).} + + +\section{Jointly published reports} +It is more common with reports than with books for a work to be branded +jointly by several issuing organizations. Neither the \emph{Oxford Guide to +Style} nor \emph{New Hart's Rules} give explicit guidance on this, but I +suggest handling it by giving corresponding lists as the \code{location} +and \code{institution}: + +\begin{tcblisting}{listing only} + location = {Place 1 and Place 2 and Place 3}, + institution = {Organization 1 and Organization 2 and Organization 3}, +\end{tcblisting} + +This will be printed as follows: + +\begin{tcolorbox} +(Place 1: Organization 1, Place 2: Organization 2, and Place 3: Organization 3) +\end{tcolorbox} \section{Theses} @@ -2564,12 +2679,191 @@ Bonnie J. Blackburn, \enquote{The Lupus Problem}, Ph.D. diss. (University of Chi \end{Verbatim} \end{bibexbox} -The following form is also supported: to use it, pass the \texttt{altthesis} option. +The following forms are also supported; to use them, pass the \key{thesis} option: + +\begin{itemize} + \item \key{thesis}\texttt{=}\val{in}\par +\spec{Author, \enquote{Title} (Type, Institution, Year).} + \item \key{thesis}\texttt{=}\val{plain}\par +\spec{Author, \enquote{Title}, Type, Institution, Year.} +\end{itemize} + +\section{Booklets, leaflets, and other formal but unpublished texts} + +There are no obvious examples of this kind of material in the \emph{Oxford Guide +to Style} or \emph{New Hart's Rules}. I welcome suggestions for how to make the +generated references more Oxford-like. + +\begin{bibexbox} +{msbh1921fvd} +(not in book) +\tcblower +\begin{Verbatim} +@booklet{msbh1921fvd, + title = {The Facts about Venereal Diseases}, + date = {1921}, + howpublished = {distributed by the Missouri State Board of Health, Division of Venereal Diseases}, + location = {Jefferson City, MO}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{lloyds2015m} +(not in book) +\tcblower +\begin{Verbatim} +@booklet{lloyds2015m, + author = {{Lloyds TSB Bank plc}}, + title = {Mortgages}, + date = {2015}, + howpublished = {obtained in Paisley branch}} +\end{Verbatim} +\end{bibexbox} + +\section{Patents} + +There are no examples of patents in the \emph{Oxford Guide to Style} or +\emph{New Hart's Rules}. I welcome suggestions for how to make the +generated references more Oxford-like. + +Following the conventions from \pkg{biblatex-chicago}, use \texttt{origdate} for +the date the patent was filed (or the application was published), and +\texttt{date} for the date the patent was finally issued or published. + +\tip{You can override the default date descriptions with the (non-standard) +\code{origdatetype} and \code{datetype} fields.} + +\begin{bibexbox} +{petroff.stapelbroek1980bib} +(not in book) +\tcblower +\begin{Verbatim} +@patent{petroff.stapelbroek1980bib, + author = {Petroff, M.~D. and Stapelbroek, M.~G.}, + title = {Blocked impurity band detectors}, + date = {1986-02-04}, + origdate = {1980-10-23}, + type = {patentus}, + number = {4,586,960}, + location = {Washington, DC}, + publisher = {U.S. Patent and Trademark Office}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{arduengo.etal2001pmi} +(not in book) +\tcblower +\begin{Verbatim} +@patent{arduengo.etal2001pmi, + author = {Arduengo, III, Anthony J. and Gentry, Jr., Frederick P. + and Taverkere, Prakash~K. and Simmons, III, Howard E.}, + title = {Process for manufacture of imidazoles}, + year = {2001}, + type = {patentus}, + holder = {{E.~I. DuPont}}, + number = {6177575}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{pm1981opa} +(not in book) +\tcblower +\begin{Verbatim} +@patent{pm1981opa, + author = {{Phillipp Morris Inc.}}, + title = {Optical perforating apparatus and system}, + origdate = {1981-01-07}, + date = {1985-05-15}, + type = {patenteu}, + number = {EP0021165}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{hideki1992qmc} +(not in book) +\tcblower +\begin{Verbatim} +@patent{hideki1992qmc, + author = {U. Hideki}, + title = {Quadrature Modulation Circuit}, + type = {patentjp}, + number = {152932/92}, + date = {1992-05-20}} +\end{Verbatim} +\end{bibexbox} + +\section{Standards} + +There are no examples of technical standards in the \emph{Oxford Guide +to Style} or \emph{New Hart's Rules}. I welcome suggestions for how to make the +generated references more Oxford-like. + +The particular quirk with standards entries is that the number is promoted to +the head of the reference if an author is not specified (or \key{useauthor} is +\val{false}). If this happens, the number is copied to \code{sortkey} so the +entry appears in the right place in the reference list, unless you get there +first with your own value of \code{sortkey}. You may want to do this if, for +example, you want \enquote{ISO 1000} to come after \enquote{ISO 999}. + +\tip{You are encouraged to put the standards body in \code{organization}, but + you can use \code{publisher} instead.} + +\tip{The examples don't demonstrate it, but you can use the \code{version} field + for the version of the standard.} + +\begin{bibexbox} +{bs5605:1990} +(not in book) +\tcblower +\begin{Verbatim} +@standard{bs5605:1990, + sortyear = {1990}, + title = {Recommendations for citing and referencing published material}, + number = {BS~5605:1990}, + organization = {British Standards Institute}} +\end{Verbatim} +\end{bibexbox} + + +\begin{bibexbox} +{w3c2017html5.2} +(not in book) +\tcblower +\begin{Verbatim} +@standard{w3c2017html5.2, + title = {{HTML} 5.2}, + editor = {Steve Faulkner and Arron Eicholz and Travis Leithead and + Alex Danilo and Sangwhan Moon}, + date = {2017-12-14}, + type = {W3C Recommendation}, + organization = {World Wide Web Consortium}, + url = {https://www.w3.org/TR/html52/}, + urldate = {2018-02-17}} +\end{Verbatim} +\end{bibexbox} -\spec{Author, \enquote{Title}, (Type, Institution, Year).} +\begin{bibexbox} +{ietf.rfc1155} +(not in book) +\tcblower +\begin{Verbatim} +@standard{ietf.rfc1155, + author = {M. T. Rose and K. McCloghrie}, + title = {Structure and identification of management information for {TCP/IP}-based internets}, + date = {1990-05}, + organization = {Internet Engineering Task Force}, + series = {Request for Comments}, + type = {Internet Standard}, + number = {RFC~1155/STD~16}, + doi = {10.17487/RFC1155}} +\end{Verbatim} +\end{bibexbox} \chapter{Audiovisual materials}\label{sec:audiovideo} -\chapterprecis{audio, inaudio, image, movie, music, inmusic, video} +\chapterprecis{artwork, audio, inaudio, image, movie, music, inmusic, performance, video} There are typically many contributors to an audiovisual work, and the priority given to each role is fluid. \pkg[biblatex]{Oxref} uses \code{author} for contributors that should go at the head of the reference, and \code{editor} for others. As well as the normal ones you can use the author\slash editor types \code{performer}, \code{conductor}, \code{director} and \code{reader}. @@ -2866,7 +3160,7 @@ Charles Chaplin (dir.), \emph{Modern Times} (United Artists, 1936). \tip{You can place up to four credits in the editor position, more if any of them correspond to the built-in editor types like \texttt{commentator} or \texttt{translator}. If you do supply a lot of credits, the \emph{Oxford Guide to Style} recommends you shift them to the end of the reference. - You can do this with the \texttt{endeditor} option.} + You can do this with the \key{endeditor} option.} \begin{bibexbox} <OGS \S15.14.2> @@ -2949,7 +3243,7 @@ The \emph{Oxford Guide to Style} prints all information about the transmission, \spec{\enquote{EpisodeTitle}, \emph{SeriesTitle}, \lit{Episode} EpisodeNumber, Channel, Date.} -\tip{If the episode has a true title, the episide descriptor (e.g. ‘Episode 1’) goes in the \code{note} field. +\tip{If the episode has a true title, the episide descriptor (e.g. \enquote{Episode 1}) goes in the \code{note} field. If it doesn't, the episode descriptor goes in the \code{title} field; annotate the field with the keyword \code{descriptor} to remove the quote marks. Alternatively, use the (non-standard) \code{descriptor} field for the episode descriptor in all cases, and \pkg[biblatex]{oxref} will take care of this for you.} @@ -3057,9 +3351,14 @@ Malala Yousafzai, \enquote{Making a Wish for Action on Global Education: Malala \end{Verbatim} \end{bibexbox} -\section{Images} +\section{Images and works of art} -\tip{If desired, use \code{titleaddon} to specify the type of image.} +\tip{If you need the type of image or arrtwork to appear in square brackets, + put it in \code{titleaddon}. Otherwise, put it in \code{type}.} + +\tip{Use \code{institution} (a list) or \code{venue} (a literal) for the + organization, museum, gallery or building physically hosting the image, and + \code{location} for where it is.} \begin{bibexbox} <NHR \S18.8.5> @@ -3071,12 +3370,14 @@ M. Clarke, \enquote{Exports of Coal to the IFS} [poster], Manchester Art Gallery author = {M. Clarke}, title = {Exports of Coal to the IFS}, titleaddon = {poster}, - organization = {Manchester Art Gallery}, + institution = {Manchester Art Gallery}, url = {http://www.machestergalleries.org/the-collections/search-the-collection/display.php?EMUSESSID=70bd7f1a388d79a82f52ea9aae713ef2&irn=4128}, urldate = {2013-11-05}} \end{Verbatim} \end{bibexbox} +\tip{Use \code{organization} for the website or online location of the image.} + \begin{bibexbox} <NHR \S18.8.5> {ibwNDcgs} @@ -3085,18 +3386,130 @@ M. Clarke, \enquote{Exports of Coal to the IFS} [poster], Manchester Art Gallery \begin{Verbatim} @image{ibwNDcgs, title = {Christ the Good Shepherd}, - note = {stained glass window, Church of St Erfyl, Llanerfyl, Powys}, + type = {stained glass window}, + venue = {Church of St Erfyl}, + location = {Llanerfyl, Powys}, organization = {Imaging the Bible in Wales Database}, url = {http://imagingthebible.llgc.org.uk/object/1884}, urldate = {2013-11-10}} \end{Verbatim} \end{bibexbox} +\begin{bibexbox} +{davinci1480mr} +(not in book) +\tcblower +\begin{Verbatim} +@artwork{davinci1480mr, + author = {given=Leonardo, family=da Vinci}, + title = {Madonna of the Rocks}, + type = {oil on canvas}, + note = {78 x 48.5 in\adddot}, + year = {1480s}, + date+an = {=inferred}, + institution = {Louvre}, + location = {Paris}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{gormley1998an} +(not in book) +\tcblower +\begin{Verbatim} +@artwork{gormley1998an, + author = {Anthony Gormley}, + title = {Angel of the {North}}, + date = {1998}, + type = {sculpture}, + location = {Low Fell, Gateshead}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{rodin1882k} +(not in book) +\tcblower +\begin{Verbatim} +@artwork{rodin1882k, + author = {Auguste Rodin}, + title = {The Kiss}, + date = {1882}, + type = {marble}, + institution = {Musée Rodin}, + location = {Paris}} +\end{Verbatim} +\end{bibexbox} + +\section{Performances} + +\tip{Use \code{origdate} for the date when the play, ballet, opera, or whatever + was written or premièred, and \code{date} for the date of the performance you + are referencing. You can specify what these dates signify with the + (non-standard) \code{origdatetype} and \code{datetype} fields. You can also + use \code{eventdate} in place of \code{date}, but then you won't be able to + specify the type.} + +\tip{As for recordings, you can use the \code{author} and \code{editor} fields + to provide various credits. As for artworks, use \code{venue} and + \code{location} for where the performance occurred, and \code{organization} + for a website or organization hosting a recording of the performance online.} + +\begin{bibexbox} +{ashton1937wb} +(not in book) +\tcblower +\begin{Verbatim} +@performance{ashton1937wb, + author = {Frederick Ashton}, + origdate = {1937}, + title = {A Wedding Bouquet}, + venue = {Royal Opera House}, + location = {London}, + date = {2004-10-22}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{lord2007dc} +(not in book) +\tcblower +\begin{Verbatim} +@performance{lord2007dc, + author = {Jon Lord}, + date = {2007-10-20}, + title = {Durham Concerto}, + editor = {{Liverpool Philharmonic Orchestra}}, + editortype = {performer}, + editora = {Mischa Damev}, + editoratype = {conductor}, + venue = {Durham Cathedral}, + location = {Durham}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{judge1995mnd} +(not in book) +\tcblower +\begin{Verbatim} +@performance{judge1995mnd, + options = {useauthor=false,useeditor=false}, + author = {William Shakespeare}, + title = {A Midsummer Night's Dream}, + editor = {Ian Judge}, + editortype = {director}, + date = {1995-02-26}, + venue = {Theatre Royal}, + location = {Newcastle upon Tyne}} +\end{Verbatim} +\end{bibexbox} + \chapter{Digital media}\label{sec:electronic} \chapterprecis{online, software, dataset} In Section 18.8.5 of \emph{New Hart's Rules}, some publication dates are printed in parentheses and some are left bare. -In theory, the difference should be that parentheses indicate ‘proper’ publication (bare dates are when the resource was created or issued). In practice, it seems to be random. I have therefore decided to ignore the variation and leave all such dates in parentheses. +In theory, the difference should be that parentheses indicate \enquote{proper} publication (bare dates are when the resource was created or issued). In practice, it seems to be random. I have therefore decided to ignore the variation and leave all such dates in parentheses. \section{Website articles} @@ -3208,14 +3621,14 @@ Stephen McEwen, \enquote{Tan Twan Eng Interview: \enquote{I Have No Alternative \end{Verbatim} \end{bibexbox} +\tip{Unlike standard \textsf{biblatex}, \pkg[biblatex]{oxref} supports \code{maintitle} for online entries and prints the result in italics. For more portability, you could either hard-code the italics into the \code{organization} field or use the \code{article} entry type.} + \info{It is not made explicit why \emph{Encyclopaedia Britannica} is in italics and \emph{Wikipedia} is not. It might be historical or customary, because \emph{Encyclopaedia Britannica} was established as a print publication and \emph{Wikipedia} has only been online; it might be because \emph{Encyclopaedia Britannica} is a Latin title; it might reflect an opinion on the two resources; or it may just be illustrative of variant practice.} -\tip{Unlike standard \textsf{biblatex}, \pkg[biblatex]{oxref} supports \code{maintitle} for online entries and prints the result in italics. For more portability, you could either hard-code the italics into the \code{organization} field or use the \code{article} entry type.} - \begin{bibexbox} <NHR \S18.8.5> {wp2013oup} @@ -3285,7 +3698,7 @@ Shakespeare's Globe, \enquote{On this day in 1611 first production of The Tempes \end{Verbatim} \end{bibexbox} -\tip{If it feels odd putting the entire content of a tweet in your reference, \emph{New Hart's Rules} suggests using a descriptor like ‘Twitter post’ instead of the title. As described in \cref{sec:broadcasts}, you can do this either by annotating the title field with the keyword \code{descriptor} or by using the (non-standard) \code{descriptor} field in place of \code{title}.} +\tip{If it feels odd putting the entire content of a tweet in your reference, \emph{New Hart's Rules} suggests using a descriptor like \enquote{Twitter post} instead of the title. As described in \cref{sec:broadcasts}, you can do this either by annotating the title field with the keyword \code{descriptor} or by using the (non-standard) \code{descriptor} field in place of \code{title}.} \begin{bibexbox} {oup2015tweet} @@ -3406,7 +3819,7 @@ Use the \code{jurisdiction} entry type for citing cases. \tip{Several additional pagination types are defined for use with legal citations: \val{article}, \val{clause}, \val{regulation}, and \val{rule} all work as normal. - The default is a bare number (\val{none}), indicating a page reference, though EU and ECHR cases default to using the ‘para’ (\val{paragraph}) prefix. + The default is a bare number (\val{none}), indicating a page reference, though EU and ECHR cases default to using the \enquote{para} (\val{paragraph}) prefix. There is also an alternative pagination type for paragraphs, \val{[]}, which prints the number in square brackets instead of giving it a prefix. } @@ -3496,6 +3909,7 @@ Use the \code{jurisdiction} entry type for citing cases. Test\footcite[13]{rvg2004} \end{egcite} + \tip{If a report is published a long time after the decision, you can put the decision date in \code{origdate} to clarify the situation.} \begin{bibexbox} @@ -3619,7 +4033,7 @@ Both the \emph{Oxford Guide to Style} and \emph{New Hart's Rules} are inconsiste The \key{ecli} option determines under what circumstances the identifier is printed.} \tip{European cases still get sorted by title, even if the entry begins with the case number. - Use \code{sorttitle} if you would rather they were sorted under ‘Case’ or ‘Joined Cases’.} + Use \code{sorttitle} if you would rather they were sorted under \enquote{Case} or \enquote{Joined Cases}.} \begin{bibexbox} <OGS \S13.4.4> @@ -3639,7 +4053,7 @@ Case C–118/07 \emph{Commission of the European Communities v Finland} [2002] E \end{Verbatim} \end{bibexbox} -\tip{Indicate Commission Decisions by putting \code{commission} in the \code{institution} field. If a decision has a formal decision number, put this in the \code{number} field. Put the case number (including the word ‘Case’ if needed) in either the \code{titleaddon}, \code{parvolume}, or \code{userb} field.} +\tip{Indicate Commission Decisions by putting \code{commission} in the \code{institution} field. If a decision has a formal decision number, put this in the \code{number} field. Put the case number (including the word \enquote{Case} if needed) in either the \code{titleaddon}, \code{parvolume}, or \code{userb} field.} \tip{An unfortunate side effect of this is that is not possible to use either the parallel or neutral citation idiom to get a reference to look like the following. In such cases, use the \code{note} field to provide the second citation.} @@ -3961,7 +4375,7 @@ Law Commission, \emph{Intoxication and Criminal Liability} (Law Comm No 314, Cm it provides the \code{commentary} entry type simply as an alias for \code{book}. \chapter{Specialist materials}\label{sec:special} -\chapterprecis{misc, unpublished, letter} +\chapterprecis{misc, unpublished, letter, manuscript} \section{Poems}\label{sec:poem} @@ -4075,7 +4489,7 @@ Play titles, like those of epic poems, are set in italics rather than quoted. \section{Manuscripts}\label{sec:ms} -\spec{Author, Title/Descriptor, Date, Archive, Location, Collection Series, Shelfmark, Folios.} +\spec{Author, \enquote{Title}/Descriptor, Date, Archive, Location, Collection Series, Shelfmark, Folios.} With \pkg[biblatex]{oxref}, you can enter manuscripts in either of two ways. The first uses the \code{unpublished} entry type. @@ -4207,6 +4621,52 @@ Bodleian Library, Oxford, MS Rawlinson D. 520, fo. 7. \end{bibexbox} +\section{Letters} + +These examples relate to letters held personally or online. For letters that +form part of archival collections, see the section on manuscripts above. + +Note that it is usually acceptable to exclude personal communications from +the reference section, and simply cite them in the text (in which case you may +not need the \pkg{biblatex} machinery). + +\spec{Author, \enquote{Title}/Descriptor, Date.} + +\begin{bibexbox} +<OGS \S15.11.1*> +{anon2001pl} +Personal letter to the author, 2 May 2001. +\tcblower +\begin{Verbatim} +@letter{anon2001pl, + title = {Personal letter to the author}, + title+an = {=descriptor}, + date = {2001-05-02}} +\end{Verbatim} +\end{bibexbox} + +In the absence of any explicit rationale governing whether the date is +parenthetical, in \pkg[biblatex]{oxref} the presence of a URL +will trigger the use of parentheses. + +\spec{Author, \enquote{Title}/Descriptor [HowPublished], (Date), OnlineAccess.} + +\begin{bibexbox} +<OGS \S15.15.3*> +{ritter2001rp}% +R. M. Ritter, \enquote{Revised proofs} [email to H. E. Cox], (1 Aug.\@ 2001), \url{ogs@ritter.org.uk}, accessed 3 Aug.\@ 2001. +\tcblower +\begin{Verbatim} +@letter{ritter2001rp, + author = {R. M. Ritter}, + title = {Revised proofs}, + howpublished = {email to H. E. Cox}, + date = {2001-08-01}, + url = {ogs@ritter.org.uk}, + urldate = {2001-08-03}} +\end{Verbatim} +\end{bibexbox} + \printbibliography[notcategory=hidden] \end{document} %% diff --git a/Master/texmf-dist/doc/latex/biblatex-oxref/oxnum-doc.pdf b/Master/texmf-dist/doc/latex/biblatex-oxref/oxnum-doc.pdf Binary files differindex efbe8ed1412..e2b72ae9c7d 100644 --- a/Master/texmf-dist/doc/latex/biblatex-oxref/oxnum-doc.pdf +++ b/Master/texmf-dist/doc/latex/biblatex-oxref/oxnum-doc.pdf diff --git a/Master/texmf-dist/doc/latex/biblatex-oxref/oxnum-doc.tex b/Master/texmf-dist/doc/latex/biblatex-oxref/oxnum-doc.tex index e91ad8319f9..88008082e76 100644 --- a/Master/texmf-dist/doc/latex/biblatex-oxref/oxnum-doc.tex +++ b/Master/texmf-dist/doc/latex/biblatex-oxref/oxnum-doc.tex @@ -13,7 +13,7 @@ %% See: http://www.latex-project.org/lppl.txt %% ---------------------------------------------------------------- %% -\def\Version{2018/02/09 v0.11.3} +\def\Version{2018/03/03 v0.12} \ProvidesFile{oxnum-doc.tex} [\Version\space Numeric biblatex style inspired by the Oxford Guide to Style] \PassOptionsToPackage{style=oxnum,scnames,varissuedate,anon}{biblatex} @@ -265,25 +265,25 @@ The style is self-contained, so you can load it with \pkg{biblatex}: The style has some options additional to the regular \pkg{biblatex} ones: -\begin{docKey}{altthesis}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} - Puts the thesis type inside, rather than outside, the parenthetical publication block. -\end{docKey} - \begin{docKey}{anon}{=\val{literal}|\val{long}|\val{short}}{default \val{short}, initially \val{literal}} Affects what happens if the author name matches the value of \cs{oxrefanon}. - By default, this is ‘Anonymous’, but you could change it a different word (such as ‘Anonimo’) instead. + By default, this is \enquote{Anonymous}, but you could change it a different word (such as \enquote{Anonimo}) instead. \begin{itemize} \item\docValue{literal} means no special handling is used. \item\docValue{long} - will print the unabbreviated localization string \code{anon} (‘Anonymous’) instead of the author name + will print the unabbreviated localization string \code{anon} (\enquote{Anonymous}) instead of the author name in the bibliography. \item\docValue{short} - will print the abbreviated localization string \code{anon} (‘Anon.\@’) instead of the author name + will print the abbreviated localization string \code{anon} (\enquote{Anon.\@}) instead of the author name in the bibliography. \end{itemize} \end{docKey} +\begin{docKey}{bookseries}{=\val{in}|\val{out}}{default \val{in}, initially \val{in}} + Puts the series information for a book \docValue{in}side or \docValue{out}side the parenthetical publication block. +\end{docKey} + \begin{docKey}{court-plain}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} Prints courts of decision without parentheses. \end{docKey} @@ -308,27 +308,34 @@ The style has some options additional to the regular \pkg{biblatex} ones: Surrounds URLs with angle brackets. \end{docKey} +\begin{docKey}{issuedate-plain}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} + Removes the parentheses around the date of a periodical without a volume number. + This can also be set on a per-type and per-entry basis. + (This option was previously called \key{varissuedate}.) +\end{docKey} + \begin{docKey}{issuestyle}{=\val{slash}|\val{colon}|\val{comma}|\val{parens}}{default \val{slash}, initially \val{slash}} Affects how journal volumes and numbers are printed. \begin{itemize} \item\docValue{slash} - separates the two with a solidus, e.g. ‘23/2’. + separates the two with a solidus, e.g. \enquote{23/2}. \item\docValue{colon} - separates the two with a colon and space, e.g. ‘23: 2’. + separates the two with a colon and space, e.g. \enquote{23: 2}. \item\docValue{comma} - separates the two with a comma and space, e.g. ‘23, 2’. + separates the two with a comma and space, e.g. \enquote{23, 2}. \item\docValue{parens} - sets off the issue number in parentheses, e.g. ‘23 (2)’. + sets off the issue number in parentheses, e.g. \enquote{23 (2)}. It is intended for use with \textsf{oxalph}\slash\textsf{oxyear} and not recommended for this style. \end{itemize} \end{docKey} \begin{docKey}{nolocation}{}{no value, initially unset} - Replaces missing locations with ‘n.p.’ or the localized equivalent in books, collections, reference works, proceedings, and similar entry types. Once set, this option cannot be overridden. + Replaces missing locations with \enquote{n.p.} or the localized equivalent in books, collections, reference works, proceedings, and similar entry types. Once set, this option cannot be overridden. Alternatively, it may be set on a per-entry basis. \end{docKey} + \begin{docKey}{nopublisher}{}{no value, initially unset} Removes publisher name from all entries. Once set, this option cannot be overridden. \end{docKey} @@ -345,6 +352,11 @@ The style has some options additional to the regular \pkg{biblatex} ones: Prints initial author or editor names in bibliography entries in small capitals. \end{docKey} +\begin{docKey}{thesis}{=\val{in}|\val{out}|\val{plain}}{default \val{out}, initially \val{out}} + Puts the thesis type \docValue{in}side or \docValue{out}side the parenthetical publication block, + while \docValue{plain} removes the parentheses entirely. +\end{docKey} + \begin{docKey}{timefirst}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} Prints the time (if provided) before the date instead of after it. This can also be set on a per-type and per-entry basis. @@ -356,11 +368,6 @@ The style has some options additional to the regular \pkg{biblatex} ones: This can also be set on a per-type and per-entry basis. \end{docKey} -\begin{docKey}{varissuedate}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} - Removes the parentheses around the date of a periodical without a volume number. - This can also be set on a per-type and per-entry basis. -\end{docKey} - \pkg[biblatex]{Oxref} makes use of Biber-specific techniques to solve some of the challenges presented by Oxford style. It will not stop you from using Bib\TeX\ instead but, if you do, only simple and standard entries will work. In particular, manuscripts, legal references and anything involving related entries will be adversely affected. @@ -397,7 +404,7 @@ Examples that follow standard \textsf{biblatex} semantics, and are therefore Code used in bibliography file. \end{tcolorbox} -Examples that have been ‘hacked’ in some way, and are therefore not portable +Examples that have been \enquote{hacked} in some way, and are therefore not portable to other styles, are in amber: \begin{tcolorbox}% @@ -466,35 +473,17 @@ but by no means all of them will be supported. For information on installing the styles, and for the documented source code, see the separate documentation file \href{./oxref.pdf}{\texttt{oxref.pdf}} -\section{To do} +\section{Stability} The \pkg[biblatex]{oxref} family of styles is currently at \fileversion. -As mentioned above, what the styles \emph{should} be doing is open to some -interpretation, so at the moment I am open to the idea of changing how the -styles handle cases not covered by the two style manuals. Please leave your -thoughts on the GitHub issue tracker.\footnote{\url{https://github.com/alex-ball/biblatex-oxref/issues}} -At some point version 1.0 will be released, after which the default (expected) -behaviour of the styles will be fixed, though alternative behaviour may be added. - -I do not have any examples to work from for the following entry types, so they -are currently untested. If you have strong feelings about how they should be -rendered in Oxford style and can provide me with a sample reference or several, -I would be most glad to hear from you: - -\begin{multicols}{3} - \begin{itemize}\firmlist - \item suppbook - \item booklet - \item suppcollection - \item patent - \item suppperiodical - \item artwork - \item commentary - \item letter - \item performance - \item standard - \end{itemize} -\end{multicols} +I have no further features planned, so unless there is popular demand otherwise, +it should be bug-fix releases only between now and the release of version 1.0. +When that happens, the default (expected) behaviour of the styles will be frozen, +meaning I will do my best to avoid backwards-incompatible changes, though +alternative behaviour may be added. If you spot any aspects of the styles that +could be improved before then, especially for the cases not covered by the two +style manuals, please leave your thoughts on the GitHub issue tracker.% +\footnote{\url{https://github.com/alex-ball/biblatex-oxref/issues}} You are of course encouraged to report any bugs you discover on the \href{https://github.com/alex-ball/biblatex-oxref/issues}{GitHub issue tracker} @@ -509,17 +498,18 @@ and indeed loads a tweaked version of a standard \textsf{biblatex} one. Both the \emph{Oxford Guide to Style} and \emph{New Hart's Rules} describe a system that uses simple numbers as citation labels, almost as if they were endnotes. This system does not support page references, unlike the citation labels familiar to \LaTeX\ users. In the absence of a better idea, therefore, this style treats citation labels rather like author–year parenthetical citations and adopts the conventions from \textsf{oxyear}. Pages are set off with a colon, and multiple works are separated with a semicolon. -\begin{egcite}{} +\begin{egcite}% +{Test [\citefield{hankinson1988mmm}{labelnumber}: 93, 96; \citefield{hankinson1989gba}{labelnumber}: 72]} Test \parencites% [93, 96]{hankinson1988mmm}% [72]{hankinson1989gba} \end{egcite} -\section{Missing and inferred attribution} +\section{Missing or inferred attribution} \subsection{Missing attribution} -\tip{\pkg[biblatex]{Oxref} will not automatically generate anonymous labels for you, but if you use the \key{anon} option (see \cref{sec:loading}), you can transform an author name of ‘Anonymous’ (or whatever \cs{oxrefanon} is set to) in your .bib file to either the long or short localization string \code{anon}. +\tip{\pkg[biblatex]{Oxref} will not automatically generate anonymous labels for you, but if you use the \key{anon} option (see \cref{sec:loading}), you can transform an author name of \enquote{Anonymous} (or whatever \cs{oxrefanon} is set to) in your .bib file to either the long or short localization string \code{anon}. } \begin{bibexbox} @@ -561,7 +551,7 @@ Test \parencites% \subsection{Pseudepigraphy} Some older works are known to have been written pseudepigraphically, that is, falsely attributed to a more famous author. The way of indicating this in Oxford style, if desired, is -to put ‘(Ps.-)’ after the name in the bibliography. +to put \enquote{(Ps.-)} after the name in the bibliography. \tip{With \pkg[biblatex]{oxref}, you can achieve this by annotating the name with the keyword \code{pseudo}. } @@ -615,7 +605,7 @@ Oxford style is to give the attribution in square brackets. \tip{You can also use the syntax from \textsf{biblatex-realauthor}. If you do not specify the \code{author}, then \code{realauthor} is treated as an alias for \code{author} annotated with the keyword \code{inferred}. The equivalent is true for \code{realeditor}. - Note, however, that \pkg[biblatex]{oxref} does not recognize the \code{userealauthor} and \code{userealeditor} options.} + Note, however, that \pkg[biblatex]{oxref} does not recognize the \key{userealauthor} and \key{userealeditor} options.} \subsection{Pseudonyms} @@ -731,7 +721,7 @@ If the contribution of the translators or revisers is so great they could be joi \end{Verbatim} \end{bibexbox} -\tip{Annotate \emph{either} the \code{editor} \emph{or} \code{translator} field with the keyword \code{jointauthor} to promote the name to the joint author position (you cannot do it for both). Note that you have to supply a suitable \code{shortauthor} value yourself; \pkg[biblatex]{oxref} does not calculate it for you.} +\tip{Annotate \emph{either} the \code{editor} \emph{or} \code{translator} field with the keyword \code{jointauthor} to promote the name to the joint author position (you cannot do it for both). Internally, what this does is move the names to the \pkg[biblatex]{oxref}-specific \code{jointauthor} field; you can use this and \code{jointauthortype} directly if you like, at the cost of portability to other styles. Note that you have to supply a suitable \code{shortauthor} value yourself; \pkg[biblatex]{oxref} does not calculate it for you.} \section{Titular prefixes}\label{sec:nametitles} @@ -873,10 +863,10 @@ A. A. Milne, \emph{Pu der Bär} [Ger. trans. of \emph{Winnie the Pooh}] (Potsdam For periodicals, grey literature, audiovisual and online material, the lack of a place of publication is not surprising; indeed it may be expected. For books, however, it may be remarkable and deserve marking in the bibliography with \enquote{n.p.\@} (for \enquote{no place}). -\tip{To have \pkg[biblatex]{oxref} automatically insert \enquote{n.p.\@} or the localized equivalent for books, collections, reference works, proceedings and similar entry types, use the \code{nolocation} bibliography option.} +\tip{To have \pkg[biblatex]{oxref} automatically insert \enquote{n.p.\@} or the localized equivalent for books, collections, reference works, proceedings and similar entry types, use the \key{nolocation} bibliography option.} -\tip{To have \pkg[biblatex]{oxref} automatically insert \enquote{n.p.\@} or the localized equivalent for only a specific entry, use the \code{nolocation} entry option instead. - This has the feature of hiding the \enquote{n.p.\@} from other styles that do not follow the same convention.} +\tip{To have \pkg[biblatex]{oxref} automatically insert \enquote{n.p.\@} or the localized equivalent for only a specific entry, use the \key{nolocation} entry option instead. + The advantage of doing this over simply giving \enquote{n.p.\@} as the publisher is that it hides it from other styles that do not follow the same convention.} \begin{bibexbox} <NHR \S18.2.9> @@ -893,12 +883,26 @@ Marchetto of Padua, \emph{Pomerium}, ed. Guiseppe Vecchi (n.p., 1961). \end{Verbatim} \end{bibexbox} +\section{Missing or inferred date of publication} + +If the date is missing from a work, you can sometimes make an educated guess +what it should be. It is usual practice to enclose such guesses in square +brackets. + +\tip{With \pkg[biblatex]{oxref}, you can achieve this by annotating the + \code{date}, \code{origdate}, or \code{eventdate} field with the keyword + \code{inferred}.} + +\begin{tcblisting}{listing only} + date+an = {=inferred}, +\end{tcblisting} + \chapter{Articles and periodicals}\label{sec:article} \chapterprecis{article, periodical, suppperiodical, review} \section{Articles in periodicals with volumes/numbers} -The \emph{Oxford Guide to Style} consistently prefers volume and part numbers to be written like \enquote{23/2}, but also discusses formats such as \enquote{23: 2} and \enquote{23 (2)}. \emph{New Hart's Rules} adds \enquote{23, 2} as a further possibility. The latter two are better suited to \textsf{oxyear} which uses a colon to demarcate the page numbers. These variations are implemented as the option \textsf{issuestyle}; see \autoref{sec:loading} for details. +The \emph{Oxford Guide to Style} consistently prefers volume and part numbers to be written like \enquote{23/2}, but also discusses formats such as \enquote{23: 2} and \enquote{23 (2)}. \emph{New Hart's Rules} adds \enquote{23, 2} as a further possibility. The latter two are better suited to \textsf{oxalph}\slash\textsf{oxyear} which use a colon to demarcate the page numbers. These variations are implemented as the option \key{issuestyle}; see \autoref{sec:loading} for details. \spec{Author, \enquote{Title}, \emph{JournalTitle}, Vol/Number (Year), Pages.} @@ -971,7 +975,9 @@ A. Druin, \enquote{The Role of Children in the Design of New Technology}, \emph{ \end{bibexbox} \begin{bibexbox}(hacked) +<NHR \S18.8.5*> {li.etal2013flh} +Shu Li et al., \enquote{Forever Love: The Hitherto Earliest Record of Copulating Insects from the Middle Jurassic of China}, \emph{PLoS ONE}, 8/11 (2013), e78188. doi: \path{10.1371/journal.pone.0078188} \tcblower \begin{Verbatim} @article{li.etal2013flh, @@ -1190,7 +1196,7 @@ X. Zhentao, K. K. C. Yau, and F. R. Stephenson, \enquote{Astronomical Records on \end{Verbatim} \end{bibexbox} -\tip{Use \code{bookpagination} to force the display of ‘pp.’ (since the number format is odd), and \cs{DeclareNumChars*}\brackets{S} to ensure that \code{S61} is recognized as a number.}% +\tip{Use \code{bookpagination} to force the display of \enquote{pp.} (since the number format is odd), and \cs{DeclareNumChars*}\brackets{S} to ensure that \code{S61} is recognized as a number.}% \section{Articles that span multiple issues} @@ -1216,11 +1222,53 @@ X. Zhentao, K. K. C. Yau, and F. R. Stephenson, \enquote{Astronomical Records on \end{Verbatim} \end{bibexbox} +\section{Editorials and other regular features} + +Strictly speaking, when a work is headed \enquote{Editorial} or \enquote{Letter to the Editor} +in a periodical, this is a descriptor rather than a title. + +\tip{If a piece has a true title, the descriptor goes in the \code{note} field. + If it doesn't, the descriptor goes in the \code{title} field; annotate the field with the keyword \code{descriptor} to remove the quote marks. + Alternatively, use the (non-standard) \code{descriptor} field for the descriptor in all cases, and \pkg[biblatex]{oxref} will take care of this for you.} + +\begin{bibexbox} +{ball2015ed} +(not in book) +\tcblower +\begin{Verbatim} +@suppperiodical{ball2015ed, + author = {Alexander Ball}, + title = {Editorial}, + title+an = {=descriptor}, + date = {2015}, + journaltitle = {International Journal of Digital Curation}, + volume = {10}, + number = {1}, + pages = {i-v}, + doi = {10.2218/ijdc.v10i1.376}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{jccm2006ed} +(not in book) +\tcblower +\begin{Verbatim} +@suppperiodical{jccm2006ed, + title = {\enquote{What a Disaster} and Why Does This Question Matter?}, + date = {2006}, + note = {Editorial}, + journaltitle = {Journal of Contingencies and Crisis Management}, + volume = {14}, + pages = {1-2}} +\end{Verbatim} +\end{bibexbox} + \section{Reviews} \spec{Author, \enquote{Title}, \lit{review of} ReviewedWork, \lit{in} \emph{JournalTitle}, Vol/Number (Year), Pages.} -\tip{To get this format, use a separate entry for the reviewed item, reference it in the ‘related’ field, and use the key ‘reviewof’ as the ‘relatedtype’.} +\tip{To get this format, use a separate entry for the reviewed item, reference it in the \enquote{related} field, and use the key \enquote{reviewof} as the \enquote{relatedtype}.} \begin{bibexbox} <OGS \S15.4.4> @@ -1385,7 +1433,7 @@ Rosemary Stewart et al. (eds.), \emph{Managing in Britain} (London, 1994). Biblatex uses \code{reference} for encyclopaedias and dictionaries, which are typically made up of many small contributions by distinct authors and compiled by an editorial board whose membership might change between successive editions. From a database perspective, reference works are like collections in that they have no single author (a reference work written by a single author should use the \code{book} entry type instead). -\tip{The \emph{Oxford Guide to Style} considers the titles of reference works to be more important and memorable than those of the editor, and so lists the title first, but \emph{New Hart's Rules} doesn't. \pkg[biblatex]{Oxref} takes the former approach, but you can switch to the latter by setting the \texttt{useeditor} option back to true for this type.} +\tip{The \emph{Oxford Guide to Style} considers the titles of reference works to be more important and memorable than those of the editor, and so lists the title first, but \emph{New Hart's Rules} doesn't. \pkg[biblatex]{Oxref} takes the former approach, but you can switch to the latter by setting the \key{useeditor} option back to true for this type.} \begin{tcblisting}{listing only} \ExecuteBibliographyOptions[reference,mvreference]{useeditor=true} @@ -1745,7 +1793,7 @@ J. D. Denniston, \emph{The Greek Particles} (1934; 2nd edn., Oxford, 1954). \end{Verbatim} \end{bibexbox} -\tip{Use the localization key \code{revised} as the edition to get ‘revised edition’. Use the localization key \code{revisedenlarged} as the edition to get ‘revised and enlarged edition’} +\tip{Use the localization key \code{revised} as the edition to get \enquote{revised edition}. Use the localization key \code{revisedenlarged} as the edition to get \enquote{revised and enlarged edition}} \begin{bibexbox}<OGS \S15.2.1*> {gibbon1686dfs} @@ -1764,7 +1812,7 @@ J. D. Denniston, \emph{The Greek Particles} (1934; 2nd edn., Oxford, 1954). \end{Verbatim} \end{bibexbox} -\info{In the \emph{Oxford Guide to Style}, there is no comma after ‘rev. edn.’ in the above reference; this may be an error.} +\info{In the \emph{Oxford Guide to Style}, there is no comma after \enquote{rev. edn.} in the above reference; this may be an error.} \subsection{Republications} @@ -1776,7 +1824,7 @@ rather than within the publication block% \spec{Author, \emph{Title} (Location: Publisher, Year) (\lit{originally pub.} Year).} \tip{This format is triggered if you specify an original date but do not specify the original publisher or location, nor the edition of the later publication.} -\info{In the following example, you will see the style uses ‘originally published’ instead of ‘first published’. This is because ‘originally’ is more common among the available examples.} +\info{In the following example, you will see the style uses \enquote{originally published} instead of \enquote{first published}. This is because \enquote{originally} is more common among the available examples.} \begin{bibexbox} <OGS \S15.2.3> @@ -2193,6 +2241,13 @@ Carl Dahlhaus, \enquote{Miszellen zur Musiktheorie des 15.\@ Jahrhunderts}, \emp \section{Supplementary works in books and collections} +If the work is headed \enquote{Introduction}, \enquote{Foreword}, \enquote{Afterword}, or similar, +this is technically a descriptor rather than a title. + +\tip{If the work has a true title, the descriptor goes in the \code{note} field. + If it doesn't, the descriptor goes in the \code{title} field; annotate the field with the keyword \code{descriptor} to correct the formatting. + Alternatively, use the (non-standard) \code{descriptor} field for the descriptor in all cases, and \pkg[biblatex]{oxref} will take care of this for you.} + \begin{bibexbox} <NHR \S18.2.6*> {gill1987intro} @@ -2202,6 +2257,7 @@ Roma Gill, introduction in \emph{The Complete Works of Christopher Marlow}, i (O @suppbook{gill1987intro, author = {Roma Gill}, title = {introduction}, + title+an = {=descriptor}, booktitle = {The Complete Works of Christopher Marlow}, volume = {1}, origlocation = {Oxford}, @@ -2211,6 +2267,34 @@ Roma Gill, introduction in \emph{The Complete Works of Christopher Marlow}, i (O \end{Verbatim} \end{bibexbox} +\begin{bibexbox} +{atwan2000fw} +(not in book) +\tcblower +\begin{Verbatim} +@suppcollection{atwan2000fw, + author = {Robert Atwan}, + title = {foreword}, + title+an = {=descriptor}, + address = {Boston}, + booktitle = {The Best American Essays of the Century}, + date = {2000}, + editor = {Joyce Carol Oates and Robert Atwan}, + publisher = {Houghton}, + pages = {x-xvi}} +\end{Verbatim} +\end{bibexbox} + +It is quite rare for such items to have a true title in addition, so previous +versions of \pkg[biblatex]{oxref} treated all titles of \texttt{suppbook} +entries as descriptors. + +\tip{To restore the previous behaviour, include the following code:} + +\begin{tcblisting}{listing only} +\DeclareFieldFormat[suppbook]{title}{#1} +\end{tcblisting} + \chapter{Works presented at meetings}\label{sec:proceedings} \chapterprecis{proceedings, mvproceedings, inproceedings, unpublished} @@ -2494,8 +2578,33 @@ UNESCO, \emph{The United Nations World Water Development Report 4}, vol. 1: \emp \section{Reports with a type or series} -\spec{Author, \emph{Title}, Series, Number (Location: Institution, Year).} +\tip{The number of a report will only be printed if you also supply a type or + series, or both. The difference between the two is that the series will be + separated from the (type and) number by a comma, while only a space + separates the type and number. In addition, if you supply a series but no + type, the number will be prefixed by `No.\@' or the localized equivalent.} + +\spec{Author, \emph{Title}, Series, Type Number (Location: Institution, Year).} + + +\section{Jointly published reports} +It is more common with reports than with books for a work to be branded +jointly by several issuing organizations. Neither the \emph{Oxford Guide to +Style} nor \emph{New Hart's Rules} give explicit guidance on this, but I +suggest handling it by giving corresponding lists as the \code{location} +and \code{institution}: + +\begin{tcblisting}{listing only} + location = {Place 1 and Place 2 and Place 3}, + institution = {Organization 1 and Organization 2 and Organization 3}, +\end{tcblisting} + +This will be printed as follows: + +\begin{tcolorbox} +(Place 1: Organization 1, Place 2: Organization 2, and Place 3: Organization 3) +\end{tcolorbox} \section{Theses} @@ -2516,12 +2625,191 @@ Bonnie J. Blackburn, \enquote{The Lupus Problem}, Ph.D. diss. (University of Chi \end{Verbatim} \end{bibexbox} -The following form is also supported: to use it, pass the \texttt{altthesis} option. +The following forms are also supported; to use them, pass the \key{thesis} option: + +\begin{itemize} + \item \key{thesis}\texttt{=}\val{in}\par +\spec{Author, \enquote{Title} (Type, Institution, Year).} + \item \key{thesis}\texttt{=}\val{plain}\par +\spec{Author, \enquote{Title}, Type, Institution, Year.} +\end{itemize} + +\section{Booklets, leaflets, and other formal but unpublished texts} + +There are no obvious examples of this kind of material in the \emph{Oxford Guide +to Style} or \emph{New Hart's Rules}. I welcome suggestions for how to make the +generated references more Oxford-like. + +\begin{bibexbox} +{msbh1921fvd} +(not in book) +\tcblower +\begin{Verbatim} +@booklet{msbh1921fvd, + title = {The Facts about Venereal Diseases}, + date = {1921}, + howpublished = {distributed by the Missouri State Board of Health, Division of Venereal Diseases}, + location = {Jefferson City, MO}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{lloyds2015m} +(not in book) +\tcblower +\begin{Verbatim} +@booklet{lloyds2015m, + author = {{Lloyds TSB Bank plc}}, + title = {Mortgages}, + date = {2015}, + howpublished = {obtained in Paisley branch}} +\end{Verbatim} +\end{bibexbox} + +\section{Patents} + +There are no examples of patents in the \emph{Oxford Guide to Style} or +\emph{New Hart's Rules}. I welcome suggestions for how to make the +generated references more Oxford-like. + +Following the conventions from \pkg{biblatex-chicago}, use \texttt{origdate} for +the date the patent was filed (or the application was published), and +\texttt{date} for the date the patent was finally issued or published. + +\tip{You can override the default date descriptions with the (non-standard) +\code{origdatetype} and \code{datetype} fields.} + +\begin{bibexbox} +{petroff.stapelbroek1980bib} +(not in book) +\tcblower +\begin{Verbatim} +@patent{petroff.stapelbroek1980bib, + author = {Petroff, M.~D. and Stapelbroek, M.~G.}, + title = {Blocked impurity band detectors}, + date = {1986-02-04}, + origdate = {1980-10-23}, + type = {patentus}, + number = {4,586,960}, + location = {Washington, DC}, + publisher = {U.S. Patent and Trademark Office}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{arduengo.etal2001pmi} +(not in book) +\tcblower +\begin{Verbatim} +@patent{arduengo.etal2001pmi, + author = {Arduengo, III, Anthony J. and Gentry, Jr., Frederick P. + and Taverkere, Prakash~K. and Simmons, III, Howard E.}, + title = {Process for manufacture of imidazoles}, + year = {2001}, + type = {patentus}, + holder = {{E.~I. DuPont}}, + number = {6177575}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{pm1981opa} +(not in book) +\tcblower +\begin{Verbatim} +@patent{pm1981opa, + author = {{Phillipp Morris Inc.}}, + title = {Optical perforating apparatus and system}, + origdate = {1981-01-07}, + date = {1985-05-15}, + type = {patenteu}, + number = {EP0021165}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{hideki1992qmc} +(not in book) +\tcblower +\begin{Verbatim} +@patent{hideki1992qmc, + author = {U. Hideki}, + title = {Quadrature Modulation Circuit}, + type = {patentjp}, + number = {152932/92}, + date = {1992-05-20}} +\end{Verbatim} +\end{bibexbox} + +\section{Standards} + +There are no examples of technical standards in the \emph{Oxford Guide +to Style} or \emph{New Hart's Rules}. I welcome suggestions for how to make the +generated references more Oxford-like. + +The particular quirk with standards entries is that the number is promoted to +the head of the reference if an author is not specified (or \key{useauthor} is +\val{false}). If this happens, the number is copied to \code{sortkey} so the +entry appears in the right place in the reference list, unless you get there +first with your own value of \code{sortkey}. You may want to do this if, for +example, you want \enquote{ISO 1000} to come after \enquote{ISO 999}. + +\tip{You are encouraged to put the standards body in \code{organization}, but + you can use \code{publisher} instead.} + +\tip{The examples don't demonstrate it, but you can use the \code{version} field + for the version of the standard.} + +\begin{bibexbox} +{bs5605:1990} +(not in book) +\tcblower +\begin{Verbatim} +@standard{bs5605:1990, + sortyear = {1990}, + title = {Recommendations for citing and referencing published material}, + number = {BS~5605:1990}, + organization = {British Standards Institute}} +\end{Verbatim} +\end{bibexbox} + + +\begin{bibexbox} +{w3c2017html5.2} +(not in book) +\tcblower +\begin{Verbatim} +@standard{w3c2017html5.2, + title = {{HTML} 5.2}, + editor = {Steve Faulkner and Arron Eicholz and Travis Leithead and + Alex Danilo and Sangwhan Moon}, + date = {2017-12-14}, + type = {W3C Recommendation}, + organization = {World Wide Web Consortium}, + url = {https://www.w3.org/TR/html52/}, + urldate = {2018-02-17}} +\end{Verbatim} +\end{bibexbox} -\spec{Author, \enquote{Title}, (Type, Institution, Year).} +\begin{bibexbox} +{ietf.rfc1155} +(not in book) +\tcblower +\begin{Verbatim} +@standard{ietf.rfc1155, + author = {M. T. Rose and K. McCloghrie}, + title = {Structure and identification of management information for {TCP/IP}-based internets}, + date = {1990-05}, + organization = {Internet Engineering Task Force}, + series = {Request for Comments}, + type = {Internet Standard}, + number = {RFC~1155/STD~16}, + doi = {10.17487/RFC1155}} +\end{Verbatim} +\end{bibexbox} \chapter{Audiovisual materials}\label{sec:audiovideo} -\chapterprecis{audio, inaudio, image, movie, music, inmusic, video} +\chapterprecis{artwork, audio, inaudio, image, movie, music, inmusic, performance, video} There are typically many contributors to an audiovisual work, and the priority given to each role is fluid. \pkg[biblatex]{Oxref} uses \code{author} for contributors that should go at the head of the reference, and \code{editor} for others. As well as the normal ones you can use the author\slash editor types \code{performer}, \code{conductor}, \code{director} and \code{reader}. @@ -2818,7 +3106,7 @@ Charles Chaplin (dir.), \emph{Modern Times} (United Artists, 1936). \tip{You can place up to four credits in the editor position, more if any of them correspond to the built-in editor types like \texttt{commentator} or \texttt{translator}. If you do supply a lot of credits, the \emph{Oxford Guide to Style} recommends you shift them to the end of the reference. - You can do this with the \texttt{endeditor} option.} + You can do this with the \key{endeditor} option.} \begin{bibexbox} <OGS \S15.14.2> @@ -2901,7 +3189,7 @@ The \emph{Oxford Guide to Style} prints all information about the transmission, \spec{\enquote{EpisodeTitle}, \emph{SeriesTitle}, \lit{Episode} EpisodeNumber, Channel, Date.} -\tip{If the episode has a true title, the episide descriptor (e.g. ‘Episode 1’) goes in the \code{note} field. +\tip{If the episode has a true title, the episide descriptor (e.g. \enquote{Episode 1}) goes in the \code{note} field. If it doesn't, the episode descriptor goes in the \code{title} field; annotate the field with the keyword \code{descriptor} to remove the quote marks. Alternatively, use the (non-standard) \code{descriptor} field for the episode descriptor in all cases, and \pkg[biblatex]{oxref} will take care of this for you.} @@ -3009,9 +3297,14 @@ Malala Yousafzai, \enquote{Making a Wish for Action on Global Education: Malala \end{Verbatim} \end{bibexbox} -\section{Images} +\section{Images and works of art} -\tip{If desired, use \code{titleaddon} to specify the type of image.} +\tip{If you need the type of image or arrtwork to appear in square brackets, + put it in \code{titleaddon}. Otherwise, put it in \code{type}.} + +\tip{Use \code{institution} (a list) or \code{venue} (a literal) for the + organization, museum, gallery or building physically hosting the image, and + \code{location} for where it is.} \begin{bibexbox} <NHR \S18.8.5> @@ -3023,12 +3316,14 @@ M. Clarke, \enquote{Exports of Coal to the IFS} [poster], Manchester Art Gallery author = {M. Clarke}, title = {Exports of Coal to the IFS}, titleaddon = {poster}, - organization = {Manchester Art Gallery}, + institution = {Manchester Art Gallery}, url = {http://www.machestergalleries.org/the-collections/search-the-collection/display.php?EMUSESSID=70bd7f1a388d79a82f52ea9aae713ef2&irn=4128}, urldate = {2013-11-05}} \end{Verbatim} \end{bibexbox} +\tip{Use \code{organization} for the website or online location of the image.} + \begin{bibexbox} <NHR \S18.8.5> {ibwNDcgs} @@ -3037,18 +3332,130 @@ M. Clarke, \enquote{Exports of Coal to the IFS} [poster], Manchester Art Gallery \begin{Verbatim} @image{ibwNDcgs, title = {Christ the Good Shepherd}, - note = {stained glass window, Church of St Erfyl, Llanerfyl, Powys}, + type = {stained glass window}, + venue = {Church of St Erfyl}, + location = {Llanerfyl, Powys}, organization = {Imaging the Bible in Wales Database}, url = {http://imagingthebible.llgc.org.uk/object/1884}, urldate = {2013-11-10}} \end{Verbatim} \end{bibexbox} +\begin{bibexbox} +{davinci1480mr} +(not in book) +\tcblower +\begin{Verbatim} +@artwork{davinci1480mr, + author = {given=Leonardo, family=da Vinci}, + title = {Madonna of the Rocks}, + type = {oil on canvas}, + note = {78 x 48.5 in\adddot}, + year = {1480s}, + date+an = {=inferred}, + institution = {Louvre}, + location = {Paris}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{gormley1998an} +(not in book) +\tcblower +\begin{Verbatim} +@artwork{gormley1998an, + author = {Anthony Gormley}, + title = {Angel of the {North}}, + date = {1998}, + type = {sculpture}, + location = {Low Fell, Gateshead}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{rodin1882k} +(not in book) +\tcblower +\begin{Verbatim} +@artwork{rodin1882k, + author = {Auguste Rodin}, + title = {The Kiss}, + date = {1882}, + type = {marble}, + institution = {Musée Rodin}, + location = {Paris}} +\end{Verbatim} +\end{bibexbox} + +\section{Performances} + +\tip{Use \code{origdate} for the date when the play, ballet, opera, or whatever + was written or premièred, and \code{date} for the date of the performance you + are referencing. You can specify what these dates signify with the + (non-standard) \code{origdatetype} and \code{datetype} fields. You can also + use \code{eventdate} in place of \code{date}, but then you won't be able to + specify the type.} + +\tip{As for recordings, you can use the \code{author} and \code{editor} fields + to provide various credits. As for artworks, use \code{venue} and + \code{location} for where the performance occurred, and \code{organization} + for a website or organization hosting a recording of the performance online.} + +\begin{bibexbox} +{ashton1937wb} +(not in book) +\tcblower +\begin{Verbatim} +@performance{ashton1937wb, + author = {Frederick Ashton}, + origdate = {1937}, + title = {A Wedding Bouquet}, + venue = {Royal Opera House}, + location = {London}, + date = {2004-10-22}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{lord2007dc} +(not in book) +\tcblower +\begin{Verbatim} +@performance{lord2007dc, + author = {Jon Lord}, + date = {2007-10-20}, + title = {Durham Concerto}, + editor = {{Liverpool Philharmonic Orchestra}}, + editortype = {performer}, + editora = {Mischa Damev}, + editoratype = {conductor}, + venue = {Durham Cathedral}, + location = {Durham}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{judge1995mnd} +(not in book) +\tcblower +\begin{Verbatim} +@performance{judge1995mnd, + options = {useauthor=false,useeditor=false}, + author = {William Shakespeare}, + title = {A Midsummer Night's Dream}, + editor = {Ian Judge}, + editortype = {director}, + date = {1995-02-26}, + venue = {Theatre Royal}, + location = {Newcastle upon Tyne}} +\end{Verbatim} +\end{bibexbox} + \chapter{Digital media}\label{sec:electronic} \chapterprecis{online, software, dataset} In Section 18.8.5 of \emph{New Hart's Rules}, some publication dates are printed in parentheses and some are left bare. -In theory, the difference should be that parentheses indicate ‘proper’ publication (bare dates are when the resource was created or issued). In practice, it seems to be random. I have therefore decided to ignore the variation and leave all such dates in parentheses. +In theory, the difference should be that parentheses indicate \enquote{proper} publication (bare dates are when the resource was created or issued). In practice, it seems to be random. I have therefore decided to ignore the variation and leave all such dates in parentheses. \section{Website articles} @@ -3160,14 +3567,14 @@ Stephen McEwen, \enquote{Tan Twan Eng Interview: \enquote{I Have No Alternative \end{Verbatim} \end{bibexbox} +\tip{Unlike standard \textsf{biblatex}, \pkg[biblatex]{oxref} supports \code{maintitle} for online entries and prints the result in italics. For more portability, you could either hard-code the italics into the \code{organization} field or use the \code{article} entry type.} + \info{It is not made explicit why \emph{Encyclopaedia Britannica} is in italics and \emph{Wikipedia} is not. It might be historical or customary, because \emph{Encyclopaedia Britannica} was established as a print publication and \emph{Wikipedia} has only been online; it might be because \emph{Encyclopaedia Britannica} is a Latin title; it might reflect an opinion on the two resources; or it may just be illustrative of variant practice.} -\tip{Unlike standard \textsf{biblatex}, \pkg[biblatex]{oxref} supports \code{maintitle} for online entries and prints the result in italics. For more portability, you could either hard-code the italics into the \code{organization} field or use the \code{article} entry type.} - \begin{bibexbox} <NHR \S18.8.5> {wp2013oup} @@ -3237,7 +3644,7 @@ Shakespeare's Globe, \enquote{On this day in 1611 first production of The Tempes \end{Verbatim} \end{bibexbox} -\tip{If it feels odd putting the entire content of a tweet in your reference, \emph{New Hart's Rules} suggests using a descriptor like ‘Twitter post’ instead of the title. As described in \cref{sec:broadcasts}, you can do this either by annotating the title field with the keyword \code{descriptor} or by using the (non-standard) \code{descriptor} field in place of \code{title}.} +\tip{If it feels odd putting the entire content of a tweet in your reference, \emph{New Hart's Rules} suggests using a descriptor like \enquote{Twitter post} instead of the title. As described in \cref{sec:broadcasts}, you can do this either by annotating the title field with the keyword \code{descriptor} or by using the (non-standard) \code{descriptor} field in place of \code{title}.} \begin{bibexbox} {oup2015tweet} @@ -3358,7 +3765,7 @@ Use the \code{jurisdiction} entry type for citing cases. \tip{Several additional pagination types are defined for use with legal citations: \val{article}, \val{clause}, \val{regulation}, and \val{rule} all work as normal. - The default is a bare number (\val{none}), indicating a page reference, though EU and ECHR cases default to using the ‘para’ (\val{paragraph}) prefix. + The default is a bare number (\val{none}), indicating a page reference, though EU and ECHR cases default to using the \enquote{para} (\val{paragraph}) prefix. There is also an alternative pagination type for paragraphs, \val{[]}, which prints the number in square brackets instead of giving it a prefix. } @@ -3448,6 +3855,7 @@ Use the \code{jurisdiction} entry type for citing cases. \textcite[13]{rvg2004} \end{egcite} + \tip{If a report is published a long time after the decision, you can put the decision date in \code{origdate} to clarify the situation.} \begin{bibexbox} @@ -3571,7 +3979,7 @@ Both the \emph{Oxford Guide to Style} and \emph{New Hart's Rules} are inconsiste The \key{ecli} option determines under what circumstances the identifier is printed.} \tip{European cases still get sorted by title, even if the entry begins with the case number. - Use \code{sorttitle} if you would rather they were sorted under ‘Case’ or ‘Joined Cases’.} + Use \code{sorttitle} if you would rather they were sorted under \enquote{Case} or \enquote{Joined Cases}.} \begin{bibexbox} <OGS \S13.4.4> @@ -3591,7 +3999,7 @@ Case C–118/07 \emph{Commission of the European Communities v Finland} [2002] E \end{Verbatim} \end{bibexbox} -\tip{Indicate Commission Decisions by putting \code{commission} in the \code{institution} field. If a decision has a formal decision number, put this in the \code{number} field. Put the case number (including the word ‘Case’ if needed) in either the \code{titleaddon}, \code{parvolume}, or \code{userb} field.} +\tip{Indicate Commission Decisions by putting \code{commission} in the \code{institution} field. If a decision has a formal decision number, put this in the \code{number} field. Put the case number (including the word \enquote{Case} if needed) in either the \code{titleaddon}, \code{parvolume}, or \code{userb} field.} \tip{An unfortunate side effect of this is that is not possible to use either the parallel or neutral citation idiom to get a reference to look like the following. In such cases, use the \code{note} field to provide the second citation.} @@ -3909,7 +4317,7 @@ Law Commission, \emph{Intoxication and Criminal Liability} (Law Comm No 314, Cm it provides the \code{commentary} entry type simply as an alias for \code{book}. \chapter{Specialist materials}\label{sec:special} -\chapterprecis{misc, unpublished, letter} +\chapterprecis{misc, unpublished, letter, manuscript} \section{Poems}\label{sec:poem} @@ -4023,7 +4431,7 @@ Play titles, like those of epic poems, are set in italics rather than quoted. \section{Manuscripts}\label{sec:ms} -\spec{Author, Title/Descriptor, Date, Archive, Location, Collection Series, Shelfmark, Folios.} +\spec{Author, \enquote{Title}/Descriptor, Date, Archive, Location, Collection Series, Shelfmark, Folios.} With \pkg[biblatex]{oxref}, you can enter manuscripts in either of two ways. The first uses the \code{unpublished} entry type. @@ -4155,6 +4563,52 @@ Bodleian Library, Oxford, MS Rawlinson D. 520, fo. 7. \end{bibexbox} +\section{Letters} + +These examples relate to letters held personally or online. For letters that +form part of archival collections, see the section on manuscripts above. + +Note that it is usually acceptable to exclude personal communications from +the reference section, and simply cite them in the text (in which case you may +not need the \pkg{biblatex} machinery). + +\spec{Author, \enquote{Title}/Descriptor, Date.} + +\begin{bibexbox} +<OGS \S15.11.1*> +{anon2001pl} +Personal letter to the author, 2 May 2001. +\tcblower +\begin{Verbatim} +@letter{anon2001pl, + title = {Personal letter to the author}, + title+an = {=descriptor}, + date = {2001-05-02}} +\end{Verbatim} +\end{bibexbox} + +In the absence of any explicit rationale governing whether the date is +parenthetical, in \pkg[biblatex]{oxref} the presence of a URL +will trigger the use of parentheses. + +\spec{Author, \enquote{Title}/Descriptor [HowPublished], (Date), OnlineAccess.} + +\begin{bibexbox} +<OGS \S15.15.3*> +{ritter2001rp}% +R. M. Ritter, \enquote{Revised proofs} [email to H. E. Cox], (1 Aug.\@ 2001), \url{ogs@ritter.org.uk}, accessed 3 Aug.\@ 2001. +\tcblower +\begin{Verbatim} +@letter{ritter2001rp, + author = {R. M. Ritter}, + title = {Revised proofs}, + howpublished = {email to H. E. Cox}, + date = {2001-08-01}, + url = {ogs@ritter.org.uk}, + urldate = {2001-08-03}} +\end{Verbatim} +\end{bibexbox} + \printbibliography[notcategory=hidden] \end{document} %% diff --git a/Master/texmf-dist/doc/latex/biblatex-oxref/oxref.bib b/Master/texmf-dist/doc/latex/biblatex-oxref/oxref.bib index a76916475a9..89772f4eb0c 100644 --- a/Master/texmf-dist/doc/latex/biblatex-oxref/oxref.bib +++ b/Master/texmf-dist/doc/latex/biblatex-oxref/oxref.bib @@ -1,5 +1,6 @@ @reference{ritter2002ogs, - author = {R. M. Ritter}, + editor = {R. M. Ritter}, + editortype= {editorcm}, title = {The {Oxford} Guide to Style}, date = {2002}, publisher = {Oxford University Press}, @@ -344,6 +345,23 @@ journaltitle = {Philosophy and Phenomenological Research}, url = {http://cogprints.org/5780/1/ECSRAP.F07.pdf}, pubstate = {inpress}} +@suppperiodical{ball2015ed, + author = {Alexander Ball}, + title = {Editorial}, + title+an = {=descriptor}, + date = {2015}, + journaltitle = {International Journal of Digital Curation}, + volume = {10}, + number = {1}, + pages = {i-v}, + doi = {10.2218/ijdc.v10i1.376}} +@suppperiodical{jccm2006ed, + title = {\enquote{What a Disaster} and Why Does This Question Matter?}, + date = {2006}, + note = {Editorial}, + journaltitle = {Journal of Contingencies and Crisis Management}, + volume = {14}, + pages = {1-2}} @review{dean1995rpb, author = {J. Dean}, related = {basiron1994mel}, @@ -816,12 +834,23 @@ @suppbook{gill1987intro, author = {Roma Gill}, title = {introduction}, + title+an = {=descriptor}, booktitle = {The Complete Works of Christopher Marlow}, volume = {1}, origlocation = {Oxford}, origdate = {1987}, edition = {reprint}, date = {2001}} +@suppcollection{atwan2000fw, + author = {Robert Atwan}, + title = {foreword}, + title+an = {=descriptor}, + address = {Boston}, + booktitle = {The Best American Essays of the Century}, + date = {2000}, + editor = {Joyce Carol Oates and Robert Atwan}, + publisher = {Houghton}, + pages = {x-xvi}} @proceedings{icp1975pic, title = {Proceedings of the {XIV} {International} {Congress} of {Papyrologists}}, subtitle = {{Oxford}, 24--31 {July} 1974}, @@ -989,6 +1018,70 @@ type = {Ph.D. diss.}, institution = {University of Chicago}, date = {1970}} +@booklet{msbh1921fvd, + title = {The Facts about Venereal Diseases}, + date = {1921}, + howpublished = {distributed by the Missouri State Board of Health, Division of Venereal Diseases}, + location = {Jefferson City, MO}} +@booklet{lloyds2015m, + author = {{Lloyds TSB Bank plc}}, + title = {Mortgages}, + date = {2015}, + howpublished = {obtained in Paisley branch}} +@patent{petroff.stapelbroek1980bib, + author = {Petroff, M.~D. and Stapelbroek, M.~G.}, + title = {Blocked impurity band detectors}, + date = {1986-02-04}, + origdate = {1980-10-23}, + type = {patentus}, + number = {4,586,960}, + location = {Washington, DC}, + publisher = {U.S. Patent and Trademark Office}} +@patent{arduengo.etal2001pmi, + author = {Arduengo, III, Anthony J. and Gentry, Jr., Frederick P. + and Taverkere, Prakash~K. and Simmons, III, Howard E.}, + title = {Process for manufacture of imidazoles}, + year = {2001}, + type = {patentus}, + holder = {{E.~I. DuPont}}, + number = {6177575}} +@patent{pm1981opa, + author = {{Phillipp Morris Inc.}}, + title = {Optical perforating apparatus and system}, + origdate = {1981-01-07}, + date = {1985-05-15}, + type = {patenteu}, + number = {EP0021165}} +@patent{hideki1992qmc, + author = {U. Hideki}, + title = {Quadrature Modulation Circuit}, + type = {patentjp}, + number = {152932/92}, + date = {1992-05-20}} +@standard{bs5605:1990, + sortyear = {1990}, + title = {Recommendations for citing and referencing published material}, + number = {BS~5605:1990}, + shorthand = {BS5605}, + organization = {British Standards Institute}} +@standard{w3c2017html5.2, + title = {{HTML} 5.2}, + editor = {Steve Faulkner and Arron Eicholz and Travis Leithead and + Alex Danilo and Sangwhan Moon}, + date = {2017-12-14}, + type = {W3C Recommendation}, + organization = {World Wide Web Consortium}, + url = {https://www.w3.org/TR/html52/}, + urldate = {2018-02-17}} +@standard{ietf.rfc1155, + author = {M. T. Rose and K. McCloghrie}, + title = {Structure and identification of management information for {TCP/IP}-based internets}, + date = {1990-05}, + organization = {Internet Engineering Task Force}, + series = {Request for Comments}, + type = {Internet Standard}, + number = {RFC~1155/STD~16}, + doi = {10.17487/RFC1155}} @music{carter1991fsq, author = {Elliott Carter}, title = {The Four String Quartets}, @@ -1171,15 +1264,65 @@ author = {M. Clarke}, title = {Exports of Coal to the IFS}, titleaddon = {poster}, - organization = {Manchester Art Gallery}, + institution = {Manchester Art Gallery}, url = {http://www.machestergalleries.org/the-collections/search-the-collection/display.php?EMUSESSID=70bd7f1a388d79a82f52ea9aae713ef2&irn=4128}, urldate = {2013-11-05}} @image{ibwNDcgs, title = {Christ the Good Shepherd}, - note = {stained glass window, Church of St Erfyl, Llanerfyl, Powys}, + type = {stained glass window}, + venue = {Church of St Erfyl}, + location = {Llanerfyl, Powys}, organization = {Imaging the Bible in Wales Database}, url = {http://imagingthebible.llgc.org.uk/object/1884}, urldate = {2013-11-10}} +@artwork{davinci1480mr, + author = {given=Leonardo, family=da Vinci}, + title = {Madonna of the Rocks}, + type = {oil on canvas}, + note = {78 x 48.5 in\adddot}, + year = {1480s}, + date+an = {=inferred}, + institution = {Louvre}, + location = {Paris}} +@artwork{gormley1998an, + author = {Anthony Gormley}, + title = {Angel of the {North}}, + date = {1998}, + type = {sculpture}, + location = {Low Fell, Gateshead}} +@artwork{rodin1882k, + author = {Auguste Rodin}, + title = {The Kiss}, + date = {1882}, + type = {marble}, + institution = {Musée Rodin}, + location = {Paris}} +@performance{ashton1937wb, + author = {Frederick Ashton}, + origdate = {1937}, + title = {A Wedding Bouquet}, + venue = {Royal Opera House}, + location = {London}, + date = {2004-10-22}} +@performance{lord2007dc, + author = {Jon Lord}, + date = {2007-10-20}, + title = {Durham Concerto}, + editor = {{Liverpool Philharmonic Orchestra}}, + editortype = {performer}, + editora = {Mischa Damev}, + editoratype = {conductor}, + venue = {Durham Cathedral}, + location = {Durham}} +@performance{judge1995mnd, + options = {useauthor=false,useeditor=false}, + author = {William Shakespeare}, + title = {A Midsummer Night's Dream}, + editor = {Ian Judge}, + editortype = {director}, + date = {1995-02-26}, + venue = {Theatre Royal}, + location = {Newcastle upon Tyne}} @online{bbc2013cgh, author = {{BBC News}}, title = {Colchester General Hospital}, @@ -1577,3 +1720,14 @@ pages = {11\recto-11\verso}, layer = {inf}, bookpagination = {folio}} +@letter{anon2001pl, + title = {Personal letter to the author}, + title+an = {=descriptor}, + date = {2001-05-02}} +@letter{ritter2001rp, + author = {R. M. Ritter}, + title = {Revised proofs}, + howpublished = {email to H. E. Cox}, + date = {2001-08-01}, + url = {ogs@ritter.org.uk}, + urldate = {2001-08-03}} diff --git a/Master/texmf-dist/doc/latex/biblatex-oxref/oxref.pdf b/Master/texmf-dist/doc/latex/biblatex-oxref/oxref.pdf Binary files differindex 29a73c62ca3..0d91cf83917 100644 --- a/Master/texmf-dist/doc/latex/biblatex-oxref/oxref.pdf +++ b/Master/texmf-dist/doc/latex/biblatex-oxref/oxref.pdf diff --git a/Master/texmf-dist/doc/latex/biblatex-oxref/oxyear-doc.pdf b/Master/texmf-dist/doc/latex/biblatex-oxref/oxyear-doc.pdf Binary files differindex 0a4b5f8deac..b703cd87a44 100644 --- a/Master/texmf-dist/doc/latex/biblatex-oxref/oxyear-doc.pdf +++ b/Master/texmf-dist/doc/latex/biblatex-oxref/oxyear-doc.pdf diff --git a/Master/texmf-dist/doc/latex/biblatex-oxref/oxyear-doc.tex b/Master/texmf-dist/doc/latex/biblatex-oxref/oxyear-doc.tex index b8b75106a52..636deda5ea9 100644 --- a/Master/texmf-dist/doc/latex/biblatex-oxref/oxyear-doc.tex +++ b/Master/texmf-dist/doc/latex/biblatex-oxref/oxyear-doc.tex @@ -13,7 +13,7 @@ %% See: http://www.latex-project.org/lppl.txt %% ---------------------------------------------------------------- %% -\def\Version{2018/02/09 v0.11.3} +\def\Version{2018/03/03 v0.12} \ProvidesFile{oxyear-doc.tex} [\Version\space Author-year biblatex style inspired by the Oxford Guide to Style] \PassOptionsToPackage{style=oxyear,varissuedate,anon}{biblatex} @@ -134,6 +134,15 @@ {\multicitedelim} {\usebibmacro{postnote}\finentrypunct} \makeatother +\DeclareSourcemap{% + \maps[datatype=bibtex]{% + \map[overwrite=true]{% + \pernottype{legslation} + \pernottype{legal} + \step[fieldset=shorthand, null=true] + }% + }% +} \hypersetup{pdfborder={0 0 0},pdfencoding=auto} \usepackage[noabbrev,capitalize,nameinlink]{cleveref} @@ -258,25 +267,25 @@ The style is self-contained, so you can load it with \pkg{biblatex}: The style has some options additional to the regular \pkg{biblatex} ones: -\begin{docKey}{altthesis}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} - Puts the thesis type inside, rather than outside, the parenthetical publication block. -\end{docKey} - \begin{docKey}{anon}{=\val{literal}|\val{long}|\val{short}}{default \val{short}, initially \val{literal}} Affects what happens if the author name matches the value of \cs{oxrefanon}. - By default, this is ‘Anonymous’, but you could change it a different word (such as ‘Anonimo’) instead. + By default, this is \enquote{Anonymous}, but you could change it a different word (such as \enquote{Anonimo}) instead. \begin{itemize} \item\docValue{literal} means no special handling is used. \item\docValue{long} - will print the unabbreviated localization string \code{anon} (‘Anonymous’) instead of the author name + will print the unabbreviated localization string \code{anon} (\enquote{Anonymous}) instead of the author name in citations and the bibliography. \item\docValue{short} - will print the abbreviated localization string \code{anon} (‘Anon.\@’) instead of the author name + will print the abbreviated localization string \code{anon} (\enquote{Anon.\@}) instead of the author name in citations and the bibliography. \end{itemize} \end{docKey} +\begin{docKey}{bookseries}{=\val{in}|\val{out}}{default \val{in}, initially \val{in}} + Puts the series information for a book \docValue{in}side or \docValue{out}side the parenthetical publication block. +\end{docKey} + \begin{docKey}{court-plain}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} Prints courts of decision without parentheses. \end{docKey} @@ -301,32 +310,42 @@ The style has some options additional to the regular \pkg{biblatex} ones: Surrounds URLs with angle brackets. \end{docKey} +\begin{docKey}{issuedate-plain}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} + Removes the parentheses around the date of a periodical without a volume number. + This can also be set on a per-type and per-entry basis. + (This option was previously called \key{varissuedate}.) +\end{docKey} + \begin{docKey}{issuestyle}{=\val{slash}|\val{colon}|\val{comma}|\val{parens}}{default \val{slash}, initially \val{slash}} Affects how journal volumes and numbers are printed. \begin{itemize} \item\docValue{slash} - separates the two with a solidus, e.g. ‘23/2’. + separates the two with a solidus, e.g. \enquote{23/2}. \item\docValue{colon} - separates the two with a colon and space, e.g. ‘23: 2’. + separates the two with a colon and space, e.g. \enquote{23: 2}. It is intended for use with \textsf{oxnotes}\slash\textsf{oxnum} and not recommended for this style. \item\docValue{comma} - separates the two with a comma and space, e.g. ‘23, 2’. + separates the two with a comma and space, e.g. \enquote{23, 2}. \item\docValue{parens} - sets off the issue number in parentheses, e.g. ‘23 (2)’. + sets off the issue number in parentheses, e.g. \enquote{23 (2)}. \end{itemize} \end{docKey} \begin{docKey}{mergedate}{=\val{maximum}|\val{compact}|\val{basic}|\val{minimum}|\val{year}|\val{false}}{default \val{year}, initially \val{year}} - Affects how the date at the start of the references relates to the date in the ‘normal’ position. + Affects how the date at the start of the references relates to the date in the \enquote{normal} position. The default value of \val{year} is intended for use with the default setting of \key{labeldate}\texttt{=}\val{year}. - If you set \key{labeldate} to something else, you will probably want to set this option to \val{compact} or \val{maximum}. + If you set \key{labeldate} to something else, you will probably want to set this option to \val{compact} or \val{maximum}. It can also be set on a per-type basis. \end{docKey} \begin{docKey}{nolocation}{}{no value, initially unset} - Replaces missing locations with ‘n.p.’ or the localized equivalent in books, collections, reference works, proceedings, and similar entry types. Once set, this option cannot be overridden. + Replaces missing locations with \enquote{n.p.} or the localized equivalent in books, collections, reference works, proceedings, and similar entry types. Once set, this option cannot be overridden. Alternatively, it may be set on a per-entry basis. \end{docKey} +\begin{docKey}{nonodate}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} + Suppresses the printing of the \code{nodate} localization string when an entry is missing a recognizable date. It can also be set on a per-type and per-entry basis. It is automatically set to \val{true} for entries with a \code{sortyear}, on the assumption that the date has been given in a non-date field (e.g.\@ the number of a standard). +\end{docKey} + \begin{docKey}{nopublisher}{}{no value, initially unset} Removes publisher name from all entries. Once set, this option cannot be overridden. \end{docKey} @@ -340,6 +359,11 @@ The style has some options additional to the regular \pkg{biblatex} ones: \end{docKey} +\begin{docKey}{thesis}{=\val{in}|\val{out}|\val{plain}}{default \val{out}, initially \val{out}} + Puts the thesis type \docValue{in}side or \docValue{out}side the parenthetical publication block, + while \docValue{plain} removes the parentheses entirely. +\end{docKey} + \begin{docKey}{timefirst}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} Prints the time (if provided) before the date instead of after it. This can also be set on a per-type and per-entry basis. @@ -351,11 +375,6 @@ The style has some options additional to the regular \pkg{biblatex} ones: This can also be set on a per-type and per-entry basis. \end{docKey} -\begin{docKey}{varissuedate}{=\val{true}|\val{false}}{default \val{true}, initially \val{false}} - Removes the parentheses around the date of a periodical without a volume number. - This can also be set on a per-type and per-entry basis. -\end{docKey} - \pkg[biblatex]{Oxref} makes use of Biber-specific techniques to solve some of the challenges presented by Oxford style. It will not stop you from using Bib\TeX\ instead but, if you do, only simple and standard entries will work. In particular, manuscripts, legal references and anything involving related entries will be adversely affected. @@ -392,7 +411,7 @@ Examples that follow standard \textsf{biblatex} semantics, and are therefore Code used in bibliography file. \end{tcolorbox} -Examples that have been ‘hacked’ in some way, and are therefore not portable +Examples that have been \enquote{hacked} in some way, and are therefore not portable to other styles, are in amber: \begin{tcolorbox}% @@ -464,35 +483,17 @@ but by no means all of them will be supported. For information on installing the styles, and for the documented source code, see the separate documentation file \href{./oxref.pdf}{\texttt{oxref.pdf}} -\section{To do} +\section{Stability} The \pkg[biblatex]{oxref} family of styles is currently at \fileversion. -As mentioned above, what the styles \emph{should} be doing is open to some -interpretation, so at the moment I am open to the idea of changing how the -styles handle cases not covered by the two style manuals. Please leave your -thoughts on the GitHub issue tracker.\footnote{\url{https://github.com/alex-ball/biblatex-oxref/issues}} -At some point version 1.0 will be released, after which the default (expected) -behaviour of the styles will be fixed, though alternative behaviour may be added. - -I do not have any examples to work from for the following entry types, so they -are currently untested. If you have strong feelings about how they should be -rendered in Oxford style and can provide me with a sample reference or several, -I would be most glad to hear from you: - -\begin{multicols}{3} - \begin{itemize}\firmlist - \item suppbook - \item booklet - \item suppcollection - \item patent - \item suppperiodical - \item artwork - \item commentary - \item letter - \item performance - \item standard - \end{itemize} -\end{multicols} +I have no further features planned, so unless there is popular demand otherwise, +it should be bug-fix releases only between now and the release of version 1.0. +When that happens, the default (expected) behaviour of the styles will be frozen, +meaning I will do my best to avoid backwards-incompatible changes, though +alternative behaviour may be added. If you spot any aspects of the styles that +could be improved before then, especially for the cases not covered by the two +style manuals, please leave your thoughts on the GitHub issue tracker.% +\footnote{\url{https://github.com/alex-ball/biblatex-oxref/issues}} You are of course encouraged to report any bugs you discover on the \href{https://github.com/alex-ball/biblatex-oxref/issues}{GitHub issue tracker} @@ -522,7 +523,7 @@ Pages are set off with a colon, and multiple works are separated with a semicolo [72]{hankinson1989gba} \end{egcite} -Up to two author names are given, after which ‘et al.’ is used. +Up to two author names are given, after which \enquote{et al.} is used. \begin{egcite}{(Barnes and Griffin 1989; Brady et al. 1994)} \parencite{barnes.griffin1989pte,% @@ -544,12 +545,12 @@ If a short author label is provided, it is used in place of the full author. \emph{New Hart's Rules} is mostly consistent with this, but has some variations where the author and date are separated by a comma, and where multiple references are also separated by commas. -\section{Missing and inferred attribution} +\section{Missing or inferred attribution} \subsection{Missing attribution} -The \emph{Oxford Guide to Style} prefers anonymous works to have ‘Anonymous’ in place of the author name, while \emph{New Hart's Rules} suggests using ‘Anon.\@’ or a short title. +The \emph{Oxford Guide to Style} prefers anonymous works to have \enquote{Anonymous} in place of the author name, while \emph{New Hart's Rules} suggests using \enquote{Anon.\@} or a short title. -\tip{\pkg[biblatex]{Oxref} will not automatically generate anonymous labels for you, but if you use the \key{anon} option (see \cref{sec:loading}), you can transform an author name of ‘Anonymous’ (or whatever \cs{oxrefanon} is set to) in your .bib file to either the long or short localization string \code{anon}. +\tip{\pkg[biblatex]{Oxref} will not automatically generate anonymous labels for you, but if you use the \key{anon} option (see \cref{sec:loading}), you can transform an author name of \enquote{Anonymous} (or whatever \cs{oxrefanon} is set to) in your .bib file to either the long or short localization string \code{anon}. } \begin{bibexbox} @@ -592,7 +593,7 @@ Anon.\@ (1956), \emph{Liber usualis} (Tournai: Desclée). \subsection{Pseudepigraphy} Some older works are known to have been written pseudepigraphically, that is, falsely attributed to a more famous author. The way of indicating this in Oxford style, if desired, is -to put ‘(Ps.-)’ after the name in the bibliography. +to put \enquote{(Ps.-)} after the name in the bibliography. \tip{With \pkg[biblatex]{oxref}, you can achieve this by annotating the name with the keyword \code{pseudo}. } @@ -646,7 +647,7 @@ Oxford style is to give the attribution in square brackets. \tip{You can also use the syntax from \textsf{biblatex-realauthor}. If you do not specify the \code{author}, then \code{realauthor} is treated as an alias for \code{author} annotated with the keyword \code{inferred}. The equivalent is true for \code{realeditor}. - Note, however, that \pkg[biblatex]{oxref} does not recognize the \code{userealauthor} and \code{userealeditor} options.} + Note, however, that \pkg[biblatex]{oxref} does not recognize the \key{userealauthor} and \key{userealeditor} options.} \subsection{Pseudonyms} @@ -762,7 +763,7 @@ Kühner, R., rev. Blass, F. (1890-2), \emph{Ausführliche grammatik der griech \end{Verbatim} \end{bibexbox} -\tip{Annotate \emph{either} the \code{editor} \emph{or} \code{translator} field with the keyword \code{jointauthor} to promote the name to the joint author position (you cannot do it for both). Note that you have to supply a suitable \code{shortauthor} value yourself; \pkg[biblatex]{oxref} does not calculate it for you.} +\tip{Annotate \emph{either} the \code{editor} \emph{or} \code{translator} field with the keyword \code{jointauthor} to promote the name to the joint author position (you cannot do it for both). Internally, what this does is move the names to the \pkg[biblatex]{oxref}-specific \code{jointauthor} field; you can use this and \code{jointauthortype} directly if you like, at the cost of portability to other styles. Note that you have to supply a suitable \code{shortauthor} value yourself; \pkg[biblatex]{oxref} does not calculate it for you.} \section{Titular prefixes}\label{sec:nametitles} @@ -904,10 +905,10 @@ Milne, A. A. (1938), \emph{Pu der Bär} [Ger. trans. of \emph{Winnie the Pooh}] For periodicals, grey literature, audiovisual and online material, the lack of a place of publication is not surprising; indeed it may be expected. For books, however, it may be remarkable and deserve marking in the bibliography with \enquote{n.p.\@} (for \enquote{no place}). -\tip{To have \pkg[biblatex]{oxref} automatically insert \enquote{n.p.\@} or the localized equivalent for books, collections, reference works, proceedings and similar entry types, use the \code{nolocation} bibliography option.} +\tip{To have \pkg[biblatex]{oxref} automatically insert \enquote{n.p.\@} or the localized equivalent for books, collections, reference works, proceedings and similar entry types, use the \key{nolocation} bibliography option.} -\tip{To have \pkg[biblatex]{oxref} automatically insert \enquote{n.p.\@} or the localized equivalent for only a specific entry, use the \code{nolocation} entry option instead. - This has the feature of hiding the \enquote{n.p.\@} from other styles that do not follow the same convention.} +\tip{To have \pkg[biblatex]{oxref} automatically insert \enquote{n.p.\@} or the localized equivalent for only a specific entry, use the \key{nolocation} entry option instead. + The advantage of doing this over simply giving \enquote{n.p.\@} as the publisher is that it hides it from other styles that do not follow the same convention.} \begin{bibexbox} <NHR \S18.2.9\textdagger> @@ -924,12 +925,31 @@ Marchetto of Padua (1961), \emph{Pomerium}, ed. G. Vecchi (n.p.). \end{Verbatim} \end{bibexbox} +\section{Missing or inferred date of publication} + +If the date is missing from a work, you can sometimes make an educated guess +what it should be. It is usual practice to enclose such guesses in square +brackets. + +\tip{With \pkg[biblatex]{oxref}, you can achieve this by annotating the + \code{date}, \code{origdate}, or \code{eventdate} field with the keyword + \code{inferred}.} + +\begin{tcblisting}{listing only} + date+an = {=inferred}, +\end{tcblisting} + +Otherwise, if you don't supply a suitable date, it will be replaced with the +localization string \code{nodate}. If you don't want this behaviour, you can +suppress it with the \key{nonodate} option, which can be set globally or on a +per-type or per-entry basis. + \chapter{Articles and periodicals}\label{sec:article} \chapterprecis{article, periodical, suppperiodical, review} \section{Articles in periodicals with volumes/numbers} -The \emph{Oxford Guide to Style} consistently prefers volume and part numbers to be written like \enquote{23/2}, but also discusses formats such as \enquote{23: 2} and \enquote{23 (2)}. \emph{New Hart's Rules} adds \enquote{23, 2} as a further possibility. The latter two are better suited to \textsf{oxyear} which uses a colon to demarcate the page numbers. These variations are implemented as the option \textsf{issuestyle}; see \autoref{sec:loading} for details. +The \emph{Oxford Guide to Style} consistently prefers volume and part numbers to be written like \enquote{23/2}, but also discusses formats such as \enquote{23: 2} and \enquote{23 (2)}. \emph{New Hart's Rules} adds \enquote{23, 2} as a further possibility. The latter two are better suited to \textsf{oxalph}\slash\textsf{oxyear} which use a colon to demarcate the page numbers. These variations are implemented as the option \key{issuestyle}; see \autoref{sec:loading} for details. \spec{Author (Year), \enquote{Title}, \emph{JournalTitle}, Vol/Number: Pages.} @@ -1214,7 +1234,7 @@ Zhentao, X., Yau, K. K. C., and Stephenson, F. R. (1989) \enquote{Astronomical R \end{Verbatim} \end{bibexbox} -\tip{Use \code{bookpagination} to force the display of ‘pp.’ (since the number format is odd), and \cs{DeclareNumChars*}\brackets{S} to ensure that \code{S61} is recognized as a number.}% +\tip{Use \code{bookpagination} to force the display of \enquote{pp.} (since the number format is odd), and \cs{DeclareNumChars*}\brackets{S} to ensure that \code{S61} is recognized as a number.}% \section{Articles that span multiple issues} @@ -1263,11 +1283,53 @@ Stookey, R. W. (1974), \enquote{Social Structure and Politics in the Yemen Arab \end{Verbatim} \end{bibexbox} +\section{Editorials and other regular features} + +Strictly speaking, when a work is headed \enquote{Editorial} or \enquote{Letter to the Editor} +in a periodical, this is a descriptor rather than a title. + +\tip{If a piece has a true title, the descriptor goes in the \code{note} field. + If it doesn't, the descriptor goes in the \code{title} field; annotate the field with the keyword \code{descriptor} to remove the quote marks. + Alternatively, use the (non-standard) \code{descriptor} field for the descriptor in all cases, and \pkg[biblatex]{oxref} will take care of this for you.} + +\begin{bibexbox} +{ball2015ed} +(not in book) +\tcblower +\begin{Verbatim} +@suppperiodical{ball2015ed, + author = {Alexander Ball}, + title = {Editorial}, + title+an = {=descriptor}, + date = {2015}, + journaltitle = {International Journal of Digital Curation}, + volume = {10}, + number = {1}, + pages = {i-v}, + doi = {10.2218/ijdc.v10i1.376}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{jccm2006ed} +(not in book) +\tcblower +\begin{Verbatim} +@suppperiodical{jccm2006ed, + title = {\enquote{What a Disaster} and Why Does This Question Matter?}, + date = {2006}, + note = {Editorial}, + journaltitle = {Journal of Contingencies and Crisis Management}, + volume = {14}, + pages = {1-2}} +\end{Verbatim} +\end{bibexbox} + \section{Reviews} \spec{Author (Year), \enquote{Title}, \lit{review of} ReviewedWork, \lit{in} \emph{JournalTitle}, Vol/Number: Pages.} -\tip{To get this format, use a separate entry for the reviewed item, reference it in the ‘related’ field, and use the key ‘reviewof’ as the ‘relatedtype’.} +\tip{To get this format, use a separate entry for the reviewed item, reference it in the \enquote{related} field, and use the key \enquote{reviewof} as the \enquote{relatedtype}.} \begin{bibexbox} <OGS \S15.4.4\textdagger> @@ -1435,7 +1497,7 @@ Hankinson, R. J. (1988) (ed.), \emph{Method, Medicine, and Metaphysics} (Edmonto Biblatex uses \code{reference} for encyclopaedias and dictionaries, which are typically made up of many small contributions by distinct authors and compiled by an editorial board whose membership might change between successive editions. From a database perspective, reference works are like collections in that they have no single author (a reference work written by a single author should use the \code{book} entry type instead). -\tip{The \emph{Oxford Guide to Style} considers the titles of reference works to be more important and memorable than those of the editor, and so lists the title first, but \emph{New Hart's Rules} doesn't. \pkg[biblatex]{Oxref} takes the former approach, but you can switch to the latter by setting the \texttt{useeditor} option back to true for this type.} +\tip{The \emph{Oxford Guide to Style} considers the titles of reference works to be more important and memorable than those of the editor, and so lists the title first, but \emph{New Hart's Rules} doesn't. \pkg[biblatex]{Oxref} takes the former approach, but you can switch to the latter by setting the \key{useeditor} option back to true for this type.} \begin{tcblisting}{listing only} \ExecuteBibliographyOptions[reference,mvreference]{useeditor=true} @@ -1793,7 +1855,7 @@ Bettelheim, B. (1976), \emph{The Uses of Enchantment: The Meaning and Importance \subsection{Reprints} -\spec{Author (Year/Year), \emph{Title} (Location: Publisher; \lit{repr.} Location: Publisher).} +\spec{Author (Year–Year), \emph{Title} (Location: Publisher; \lit{repr.} Location: Publisher).} \tip{Use localization key \code{reprint} as the edition. For a revised reprint, use \code{revisedreprint}.} @@ -1833,7 +1895,7 @@ Southern, R. W. (1991), \emph{Saint Anselm: A Portrait in a Landscape} (rev. rep \end{Verbatim} \end{bibexbox} -\spec{Author (Year/Year), \emph{Title} (Location: Publisher; \lit{facs. edn.}, Location: Publisher).} +\spec{Author (Year–Year), \emph{Title} (Location: Publisher; \lit{facs. edn.}, Location: Publisher).} \tip{Use localization key \code{facsimile} as the edition.} @@ -2217,6 +2279,13 @@ Dahlhaus, C. (1971), \enquote{Miszellen zur Musiktheorie des 15.\@ Jahrhunderts} \section{Supplementary works in books and collections} +If the work is headed \enquote{Introduction}, \enquote{Foreword}, \enquote{Afterword}, or similar, +this is technically a descriptor rather than a title. + +\tip{If the work has a true title, the descriptor goes in the \code{note} field. + If it doesn't, the descriptor goes in the \code{title} field; annotate the field with the keyword \code{descriptor} to correct the formatting. + Alternatively, use the (non-standard) \code{descriptor} field for the descriptor in all cases, and \pkg[biblatex]{oxref} will take care of this for you.} + \begin{bibexbox} <NHR \S18.2.6*\textdagger> {gill1987intro} @@ -2226,6 +2295,7 @@ Gill, R. (1987), introduction in \emph{The Complete Works of Christopher Marlow} @suppbook{gill1987intro, author = {Roma Gill}, title = {introduction}, + title+an = {=descriptor}, booktitle = {The Complete Works of Christopher Marlow}, volume = {1}, origlocation = {Oxford}, @@ -2235,6 +2305,34 @@ Gill, R. (1987), introduction in \emph{The Complete Works of Christopher Marlow} \end{Verbatim} \end{bibexbox} +\begin{bibexbox} +{atwan2000fw} +(not in book) +\tcblower +\begin{Verbatim} +@suppcollection{atwan2000fw, + author = {Robert Atwan}, + title = {foreword}, + title+an = {=descriptor}, + address = {Boston}, + booktitle = {The Best American Essays of the Century}, + date = {2000}, + editor = {Joyce Carol Oates and Robert Atwan}, + publisher = {Houghton}, + pages = {x-xvi}} +\end{Verbatim} +\end{bibexbox} + +It is quite rare for such items to have a true title in addition, so previous +versions of \pkg[biblatex]{oxref} treated all titles of \texttt{suppbook} +entries as descriptors. + +\tip{To restore the previous behaviour, include the following code:} + +\begin{tcblisting}{listing only} +\DeclareFieldFormat[suppbook]{title}{#1} +\end{tcblisting} + \chapter{Works presented at meetings}\label{sec:proceedings} \chapterprecis{proceedings, mvproceedings, inproceedings, unpublished} @@ -2530,7 +2628,13 @@ CNNR/GMH (Comisión Nacional de Reparación y Reconciliación y Grupo de Memoria \section{Reports with a type or series} -\spec{Author (Year), \emph{Title}, Series, Number (Location: Institution).} +\tip{The number of a report will only be printed if you also supply a type or + series, or both. The difference between the two is that the series will be + separated from the (type and) number by a comma, while only a space + separates the type and number. In addition, if you supply a series but no + type, the number will be prefixed by `No.\@' or the localized equivalent.} + +\spec{Author (Year), \emph{Title}, Series, Type Number (Location: Institution).} \begin{bibexbox}<OGS \S15.19.2> {opcs1979amt} @@ -2548,8 +2652,6 @@ Office of Population Censuses and Surveys (1979a), \emph{Area Mortality Tables: \end{Verbatim} \end{bibexbox} -\spec{Author (Year), \emph{Title}, Type Number (Location: Institution).} - \begin{bibexbox}<OGS \S15.19.2> {opcs1979pnc} Office of Population Censuses and Surveys (1979b), \emph{Projections of the New Commonwealth and Pakistani Population}, OPCS Monitor PP2 79/1 (London) @@ -2583,6 +2685,25 @@ Rosenblatt, J., et al. (1988), \emph{The Common Agricultural Policy of the Europ \end{bibexbox} +\section{Jointly published reports} + +It is more common with reports than with books for a work to be branded +jointly by several issuing organizations. Neither the \emph{Oxford Guide to +Style} nor \emph{New Hart's Rules} give explicit guidance on this, but I +suggest handling it by giving corresponding lists as the \code{location} +and \code{institution}: + +\begin{tcblisting}{listing only} + location = {Place 1 and Place 2 and Place 3}, + institution = {Organization 1 and Organization 2 and Organization 3}, +\end{tcblisting} + +This will be printed as follows: + +\begin{tcolorbox} +(Place 1: Organization 1, Place 2: Organization 2, and Place 3: Organization 3) +\end{tcolorbox} + \section{Theses} \spec{Author (Year), \enquote{Title}, Type (Institution).} @@ -2602,12 +2723,194 @@ Blackburn, B. J. (1970), \enquote{The Lupus Problem}, Ph.D. diss. (University of \end{Verbatim} \end{bibexbox} -The following form is also supported: to use it, pass the \texttt{altthesis} option. +The following forms are also supported; to use them, pass the \key{thesis} option: + +\begin{itemize} + \item \key{thesis}\texttt{=}\val{in}\par +\spec{Author (Year), \enquote{Title} (Type, Institution).} + \item \key{thesis}\texttt{=}\val{plain}\par +\spec{Author (Year), \enquote{Title}, Type, Institution.} +\end{itemize} + +\section{Booklets, leaflets, and other formal but unpublished texts} + +There are no obvious examples of this kind of material in the \emph{Oxford Guide +to Style} or \emph{New Hart's Rules}. I welcome suggestions for how to make the +generated references more Oxford-like. + +\begin{bibexbox} +{msbh1921fvd} +(not in book) +\tcblower +\begin{Verbatim} +@booklet{msbh1921fvd, + title = {The Facts about Venereal Diseases}, + date = {1921}, + howpublished = {distributed by the Missouri State Board of Health, Division of Venereal Diseases}, + location = {Jefferson City, MO}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{lloyds2015m} +(not in book) +\tcblower +\begin{Verbatim} +@booklet{lloyds2015m, + author = {{Lloyds TSB Bank plc}}, + title = {Mortgages}, + date = {2015}, + howpublished = {obtained in Paisley branch}} +\end{Verbatim} +\end{bibexbox} + +\section{Patents} + +There are no examples of patents in the \emph{Oxford Guide to Style} or +\emph{New Hart's Rules}. I welcome suggestions for how to make the +generated references more Oxford-like. + +Following the conventions from \pkg{biblatex-chicago}, use \texttt{origdate} for +the date the patent was filed (or the application was published), and +\texttt{date} for the date the patent was finally issued or published. + +\tip{You can override the default date descriptions with the (non-standard) +\code{origdatetype} and \code{datetype} fields.} + +\begin{bibexbox} +{petroff.stapelbroek1980bib} +(not in book) +\tcblower +\begin{Verbatim} +@patent{petroff.stapelbroek1980bib, + author = {Petroff, M.~D. and Stapelbroek, M.~G.}, + title = {Blocked impurity band detectors}, + date = {1986-02-04}, + origdate = {1980-10-23}, + type = {patentus}, + number = {4,586,960}, + location = {Washington, DC}, + publisher = {U.S. Patent and Trademark Office}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{arduengo.etal2001pmi} +(not in book) +\tcblower +\begin{Verbatim} +@patent{arduengo.etal2001pmi, + author = {Arduengo, III, Anthony J. and Gentry, Jr., Frederick P. + and Taverkere, Prakash~K. and Simmons, III, Howard E.}, + title = {Process for manufacture of imidazoles}, + year = {2001}, + type = {patentus}, + holder = {{E.~I. DuPont}}, + number = {6177575}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{pm1981opa} +(not in book) +\tcblower +\begin{Verbatim} +@patent{pm1981opa, + author = {{Phillipp Morris Inc.}}, + title = {Optical perforating apparatus and system}, + origdate = {1981-01-07}, + date = {1985-05-15}, + type = {patenteu}, + number = {EP0021165}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{hideki1992qmc} +(not in book) +\tcblower +\begin{Verbatim} +@patent{hideki1992qmc, + author = {U. Hideki}, + title = {Quadrature Modulation Circuit}, + type = {patentjp}, + number = {152932/92}, + date = {1992-05-20}} +\end{Verbatim} +\end{bibexbox} + +\section{Standards} + +There are no examples of technical standards in the \emph{Oxford Guide +to Style} or \emph{New Hart's Rules}. I welcome suggestions for how to make the +generated references more Oxford-like. -\spec{Author (Year), \enquote{Title}, (Type, Institution).} +The particular quirk with standards entries is that the number is promoted to +the head of the reference if an author is not specified (or \key{useauthor} is +\val{false}). If this happens, the number is copied to \code{sortkey} so the +entry appears in the right place in the reference list, unless you get there +first with your own value of \code{sortkey}. You may want to do this if, for +example, you want \enquote{ISO 1000} to come after \enquote{ISO 999}. + +\tip{You are encouraged to put the standards body in \code{organization}, but + you can use \code{publisher} instead.} + +\tip{The examples don't demonstrate it, but you can use the \code{version} field + for the version of the standard.} + +\begin{bibexbox} +{bs5605:1990} +(not in book) +\tcblower +\begin{Verbatim} +@standard{bs5605:1990, + sortyear = {1990}, + title = {Recommendations for citing and referencing published material}, + number = {BS~5605:1990}, + organization = {British Standards Institute}} +\end{Verbatim} +\end{bibexbox} + +\begin{egcite}{} +\cite{bs5605:1990} +\end{egcite} + +\begin{bibexbox} +{w3c2017html5.2} +(not in book) +\tcblower +\begin{Verbatim} +@standard{w3c2017html5.2, + title = {{HTML} 5.2}, + editor = {Steve Faulkner and Arron Eicholz and Travis Leithead and + Alex Danilo and Sangwhan Moon}, + date = {2017-12-14}, + type = {W3C Recommendation}, + organization = {World Wide Web Consortium}, + url = {https://www.w3.org/TR/html52/}, + urldate = {2018-02-17}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{ietf.rfc1155} +(not in book) +\tcblower +\begin{Verbatim} +@standard{ietf.rfc1155, + author = {M. T. Rose and K. McCloghrie}, + title = {Structure and identification of management information for {TCP/IP}-based internets}, + date = {1990-05}, + organization = {Internet Engineering Task Force}, + series = {Request for Comments}, + type = {Internet Standard}, + number = {RFC~1155/STD~16}, + doi = {10.17487/RFC1155}} +\end{Verbatim} +\end{bibexbox} \chapter{Audiovisual materials}\label{sec:audiovideo} -\chapterprecis{audio, inaudio, image, movie, music, inmusic, video} +\chapterprecis{artwork, audio, inaudio, image, movie, music, inmusic, performance, video} There are typically many contributors to an audiovisual work, and the priority given to each role is fluid. \pkg[biblatex]{Oxref} uses \code{author} for contributors that should go at the head of the reference, and \code{editor} for others. As well as the normal ones you can use the author\slash editor types \code{performer}, \code{conductor}, \code{director} and \code{reader}. @@ -2906,7 +3209,7 @@ Chaplin, C. (1936) (dir.), \emph{Modern Times} (United Artists). \tip{You can place up to four credits in the editor position, more if any of them correspond to the built-in editor types like \texttt{commentator} or \texttt{translator}. If you do supply a lot of credits, the \emph{Oxford Guide to Style} recommends you shift them to the end of the reference. - You can do this with the \texttt{endeditor} option.} + You can do this with the \key{endeditor} option.} \begin{bibexbox} <OGS \S15.14.2\textdagger> @@ -2989,7 +3292,7 @@ The \emph{Oxford Guide to Style} prints all information about the transmission, \spec{\enquote{EpisodeTitle} (Year), \emph{SeriesTitle}, \lit{Episode} EpisodeNumber, Channel, Day Month.} -\tip{If the episode has a true title, the episide descriptor (e.g. ‘Episode 1’) goes in the \code{note} field. +\tip{If the episode has a true title, the episide descriptor (e.g. \enquote{Episode 1}) goes in the \code{note} field. If it doesn't, the episode descriptor goes in the \code{title} field; annotate the field with the keyword \code{descriptor} to remove the quote marks. Alternatively, use the (non-standard) \code{descriptor} field for the episode descriptor in all cases, and \pkg[biblatex]{oxref} will take care of this for you.} @@ -3097,9 +3400,14 @@ Yousafzai, M. (2013), \enquote{Making a Wish for Action on Global Education: Mal \end{Verbatim} \end{bibexbox} -\section{Images} +\section{Images and works of art} -\tip{If desired, use \code{titleaddon} to specify the type of image.} +\tip{If you need the type of image or arrtwork to appear in square brackets, + put it in \code{titleaddon}. Otherwise, put it in \code{type}.} + +\tip{Use \code{institution} (a list) or \code{venue} (a literal) for the + organization, museum, gallery or building physically hosting the image, and + \code{location} for where it is.} \begin{bibexbox} <NHR \S18.8.5\textdagger> @@ -3111,12 +3419,14 @@ Clarke, M. (n.d.), \enquote{Exports of Coal to the IFS} [poster], Manchester Art author = {M. Clarke}, title = {Exports of Coal to the IFS}, titleaddon = {poster}, - organization = {Manchester Art Gallery}, + institution = {Manchester Art Gallery}, url = {http://www.machestergalleries.org/the-collections/search-the-collection/display.php?EMUSESSID=70bd7f1a388d79a82f52ea9aae713ef2&irn=4128}, urldate = {2013-11-05}} \end{Verbatim} \end{bibexbox} +\tip{Use \code{organization} for the website or online location of the image.} + \begin{bibexbox} <NHR \S18.8.5\textdagger> {ibwNDcgs} @@ -3125,18 +3435,130 @@ Clarke, M. (n.d.), \enquote{Exports of Coal to the IFS} [poster], Manchester Art \begin{Verbatim} @image{ibwNDcgs, title = {Christ the Good Shepherd}, - note = {stained glass window, Church of St Erfyl, Llanerfyl, Powys}, + type = {stained glass window}, + venue = {Church of St Erfyl}, + location = {Llanerfyl, Powys}, organization = {Imaging the Bible in Wales Database}, url = {http://imagingthebible.llgc.org.uk/object/1884}, urldate = {2013-11-10}} \end{Verbatim} \end{bibexbox} +\begin{bibexbox} +{davinci1480mr} +(not in book) +\tcblower +\begin{Verbatim} +@artwork{davinci1480mr, + author = {given=Leonardo, family=da Vinci}, + title = {Madonna of the Rocks}, + type = {oil on canvas}, + note = {78 x 48.5 in\adddot}, + year = {1480s}, + date+an = {=inferred}, + institution = {Louvre}, + location = {Paris}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{gormley1998an} +(not in book) +\tcblower +\begin{Verbatim} +@artwork{gormley1998an, + author = {Anthony Gormley}, + title = {Angel of the {North}}, + date = {1998}, + type = {sculpture}, + location = {Low Fell, Gateshead}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{rodin1882k} +(not in book) +\tcblower +\begin{Verbatim} +@artwork{rodin1882k, + author = {Auguste Rodin}, + title = {The Kiss}, + date = {1882}, + type = {marble}, + institution = {Musée Rodin}, + location = {Paris}} +\end{Verbatim} +\end{bibexbox} + +\section{Performances} + +\tip{Use \code{origdate} for the date when the play, ballet, opera, or whatever + was written or premièred, and \code{date} for the date of the performance you + are referencing. You can specify what these dates signify with the + (non-standard) \code{origdatetype} and \code{datetype} fields. You can also + use \code{eventdate} in place of \code{date}, but then you won't be able to + specify the type.} + +\tip{As for recordings, you can use the \code{author} and \code{editor} fields + to provide various credits. As for artworks, use \code{venue} and + \code{location} for where the performance occurred, and \code{organization} + for a website or organization hosting a recording of the performance online.} + +\begin{bibexbox} +{ashton1937wb} +(not in book) +\tcblower +\begin{Verbatim} +@performance{ashton1937wb, + author = {Frederick Ashton}, + origdate = {1937}, + title = {A Wedding Bouquet}, + venue = {Royal Opera House}, + location = {London}, + date = {2004-10-22}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{lord2007dc} +(not in book) +\tcblower +\begin{Verbatim} +@performance{lord2007dc, + author = {Jon Lord}, + date = {2007-10-20}, + title = {Durham Concerto}, + editor = {{Liverpool Philharmonic Orchestra}}, + editortype = {performer}, + editora = {Mischa Damev}, + editoratype = {conductor}, + venue = {Durham Cathedral}, + location = {Durham}} +\end{Verbatim} +\end{bibexbox} + +\begin{bibexbox} +{judge1995mnd} +(not in book) +\tcblower +\begin{Verbatim} +@performance{judge1995mnd, + options = {useauthor=false,useeditor=false}, + author = {William Shakespeare}, + title = {A Midsummer Night's Dream}, + editor = {Ian Judge}, + editortype = {director}, + date = {1995-02-26}, + venue = {Theatre Royal}, + location = {Newcastle upon Tyne}} +\end{Verbatim} +\end{bibexbox} + \chapter{Digital media}\label{sec:electronic} \chapterprecis{online, software, dataset} In Section 18.8.5 of \emph{New Hart's Rules}, some publication dates are printed in parentheses and some are left bare. -In theory, the difference should be that parentheses indicate ‘proper’ publication (bare dates are when the resource was created or issued). In practice, it seems to be random. I have therefore decided to ignore the variation and leave all such dates in parentheses. +In theory, the difference should be that parentheses indicate \enquote{proper} publication (bare dates are when the resource was created or issued). In practice, it seems to be random. I have therefore decided to ignore the variation and leave all such dates in parentheses. \section{Website articles} @@ -3248,14 +3670,14 @@ McEwen, S. (2013), \enquote{Tan Twan Eng Interview: \enquote{I Have No Alternati \end{Verbatim} \end{bibexbox} +\tip{Unlike standard \textsf{biblatex}, \pkg[biblatex]{oxref} supports \code{maintitle} for online entries and prints the result in italics. For more portability, you could either hard-code the italics into the \code{organization} field or use the \code{article} entry type.} + \info{It is not made explicit why \emph{Encyclopaedia Britannica} is in italics and \emph{Wikipedia} is not. It might be historical or customary, because \emph{Encyclopaedia Britannica} was established as a print publication and \emph{Wikipedia} has only been online; it might be because \emph{Encyclopaedia Britannica} is a Latin title; it might reflect an opinion on the two resources; or it may just be illustrative of variant practice.} -\tip{Unlike standard \textsf{biblatex}, \pkg[biblatex]{oxref} supports \code{maintitle} for online entries and prints the result in italics. For more portability, you could either hard-code the italics into the \code{organization} field or use the \code{article} entry type.} - \begin{bibexbox} <NHR \S18.8.5\textdagger> {wp2013oup} @@ -3325,7 +3747,7 @@ Shakespeare's Globe (2013), \enquote{On this day in 1611 first production of The \end{Verbatim} \end{bibexbox} -\tip{If it feels odd putting the entire content of a tweet in your reference, \emph{New Hart's Rules} suggests using a descriptor like ‘Twitter post’ instead of the title. As described in \cref{sec:broadcasts}, you can do this either by annotating the title field with the keyword \code{descriptor} or by using the (non-standard) \code{descriptor} field in place of \code{title}.} +\tip{If it feels odd putting the entire content of a tweet in your reference, \emph{New Hart's Rules} suggests using a descriptor like \enquote{Twitter post} instead of the title. As described in \cref{sec:broadcasts}, you can do this either by annotating the title field with the keyword \code{descriptor} or by using the (non-standard) \code{descriptor} field in place of \code{title}.} \begin{bibexbox} {oup2015tweet} @@ -3447,7 +3869,7 @@ Use the \code{jurisdiction} entry type for citing cases. \tip{Several additional pagination types are defined for use with legal citations: \val{article}, \val{clause}, \val{regulation}, and \val{rule} all work as normal. - The default is a bare number (\val{none}), indicating a page reference, though EU and ECHR cases default to using the ‘para’ (\val{paragraph}) prefix. + The default is a bare number (\val{none}), indicating a page reference, though EU and ECHR cases default to using the \enquote{para} (\val{paragraph}) prefix. There is also an alternative pagination type for paragraphs, \val{[]}, which prints the number in square brackets instead of giving it a prefix. } @@ -3537,6 +3959,8 @@ Use the \code{jurisdiction} entry type for citing cases. \parencite[13]{rvg2004} \end{egcite} +\hack{Note that in the cases above and below, the head of the reference won't match the citation, which may cause confusion. You may wish to hack the in-text citation to fix this.} + \tip{If a report is published a long time after the decision, you can put the decision date in \code{origdate} to clarify the situation.} \begin{bibexbox} @@ -3660,7 +4084,7 @@ Both the \emph{Oxford Guide to Style} and \emph{New Hart's Rules} are inconsiste The \key{ecli} option determines under what circumstances the identifier is printed.} \tip{European cases still get sorted by title, even if the entry begins with the case number. - Use \code{sorttitle} if you would rather they were sorted under ‘Case’ or ‘Joined Cases’.} + Use \code{sorttitle} if you would rather they were sorted under \enquote{Case} or \enquote{Joined Cases}.} \begin{bibexbox} <OGS \S13.4.4> @@ -3680,7 +4104,7 @@ Case C–118/07 \emph{Commission of the European Communities v Finland} [2002] E \end{Verbatim} \end{bibexbox} -\tip{Indicate Commission Decisions by putting \code{commission} in the \code{institution} field. If a decision has a formal decision number, put this in the \code{number} field. Put the case number (including the word ‘Case’ if needed) in either the \code{titleaddon}, \code{parvolume}, or \code{userb} field.} +\tip{Indicate Commission Decisions by putting \code{commission} in the \code{institution} field. If a decision has a formal decision number, put this in the \code{number} field. Put the case number (including the word \enquote{Case} if needed) in either the \code{titleaddon}, \code{parvolume}, or \code{userb} field.} \tip{An unfortunate side effect of this is that is not possible to use either the parallel or neutral citation idiom to get a reference to look like the following. In such cases, use the \code{note} field to provide the second citation.} @@ -3928,7 +4352,7 @@ Convention Relating to the Status of Refugees (adopted 28 July 1951, entered int \end{Verbatim} \end{bibexbox} -\tip{Since the lack of a \code{date} field may cause an inaccurate ‘n.d.’ label to be printed, use the \code{shorthand} field to provide a sensible citation label. You could use \cs{citetitle} the first time to ensure the reader can find it in the bibliography.} +\tip{Since the lack of a \code{date} field may cause an inaccurate \enquote{n.d.\@} label to be printed, use the \code{shorthand} field to provide a sensible citation label. You could use \cs{citetitle} the first time to ensure the reader can find it in the bibliography. You can also suppress the \enquote{n.d.\@} label by specifying \code{sortyear} or using the \key{nonodate} option.} \begin{egcite}{(Refugee Convention: art.\@ 24)} \parencite[24]{refugees} @@ -4008,7 +4432,7 @@ Law Commission (2009), \emph{Intoxication and Criminal Liability} (Law Comm No 3 it provides the \code{commentary} entry type simply as an alias for \code{book}. \chapter{Specialist materials}\label{sec:special} -\chapterprecis{misc, unpublished, letter} +\chapterprecis{misc, unpublished, letter, manuscript} \section{Poems}\label{sec:poem} @@ -4125,7 +4549,7 @@ Play titles, like those of epic poems, are set in italics rather than quoted. An author–date system like \textsf{oxyear} does not really lend itself to manuscript references, but support is provided anyway for the sake of completeness. -\spec{Author, Title/Descriptor, Date, Archive, Location, Collection Series, Shelfmark, Folios.} +\spec{Author (Year), \enquote{Title}/Descriptor, Date, Archive, Location, Collection Series, Shelfmark, Folios.} With \pkg[biblatex]{oxref}, you can enter manuscripts in either of two ways. The first uses the \code{unpublished} entry type. @@ -4144,7 +4568,7 @@ With \pkg[biblatex]{oxref}, you can enter manuscripts in either of two ways. The \begin{bibexbox} <NHR 18.6.3*\textdagger> {smithMS23116} -Smith, F. [1912–7], travel diaries, British Library, Add. MS 23116. +Smith, F. (1912–7), travel diaries, British Library, Add. MS 23116. \tcblower \begin{Verbatim} @unpublished{smithMS23116, @@ -4179,7 +4603,7 @@ The second uses the dedicated \code{manuscript} entry type from \textsf{biblatex \begin{bibexbox} <NHR 18.6.2\textdagger> {chaundlerMS288} -Chaundler, T. [n.d.], \enquote{Collocutiones}, Balliol College, Oxford, MS288. +Chaundler, T. (n.d.), \enquote{Collocutiones}, Balliol College, Oxford, MS288. \tcblower \begin{Verbatim} @manuscript{chaundlerMS288, @@ -4194,7 +4618,7 @@ Chaundler, T. [n.d.], \enquote{Collocutiones}, Balliol College, Oxford, MS288. \begin{bibexbox} <NHR 18.6.2\textdagger> {exchequerE311} -exchequer accounts [1798], Dec., Cheshire Record Office, E311. +exchequer accounts (1798), Dec., Cheshire Record Office, E311. \tcblower \begin{Verbatim} @manuscript{exchequerE311, @@ -4208,7 +4632,7 @@ exchequer accounts [1798], Dec., Cheshire Record Office, E311. \begin{bibexbox} <NHR 18.6.3\textdagger> {blcBOX19d} -Bearsden Ladies' Club minutes [1949], 12 June, Bearsden and Milngavie District Libraries, box 19/d. +Bearsden Ladies' Club minutes (1949), 12 June, Bearsden and Milngavie District Libraries, box 19/d. \tcblower \begin{Verbatim} @manuscript{blcBOX19d, @@ -4223,7 +4647,7 @@ Bearsden Ladies' Club minutes [1949], 12 June, Bearsden and Milngavie District L \begin{bibexbox} <NHR 18.6.5\textdagger> {bodMSrawl-d520} -Bodleian Library [n.d.], Oxford, MS Rawlinson D. 520, fo. 7. +Bodleian Library (n.d.), Oxford, MS Rawlinson D. 520, fo. 7. \tcblower \begin{Verbatim} @manuscript{bodMSrawl-d520, @@ -4262,6 +4686,52 @@ Bodleian Library [n.d.], Oxford, MS Rawlinson D. 520, fo. 7. bodMSrawl-d520} \end{egcite} +\section{Letters} + +These examples relate to letters held personally or online. For letters that +form part of archival collections, see the section on manuscripts above. + +Note that it is usually acceptable to exclude personal communications from +the reference section, and simply cite them in the text (in which case you may +not need the \pkg{biblatex} machinery). + +\spec{Author (Year), \enquote{Title}/Descriptor, Date.} + +\begin{bibexbox} +<OGS \S15.11.1*\textdagger> +{anon2001pl} +Personal letter to the author (2001), 2 May. +\tcblower +\begin{Verbatim} +@letter{anon2001pl, + title = {Personal letter to the author}, + title+an = {=descriptor}, + date = {2001-05-02}} +\end{Verbatim} +\end{bibexbox} + +In the absence of any explicit rationale governing whether the date is +parenthetical, in \pkg[biblatex]{oxref} the presence of a URL +will trigger the use of parentheses. + +\spec{Author (Year), \enquote{Title}/Descriptor [HowPublished], (Date), OnlineAccess.} + +\begin{bibexbox} +<OGS \S15.15.3*\textdagger> +{ritter2001rp}% +Ritter, R. M. (2001), \enquote{Revised proofs} [email to H. E. Cox], (1 Aug.\@), \url{ogs@ritter.org.uk}, accessed 3 Aug.\@ 2001. +\tcblower +\begin{Verbatim} +@letter{ritter2001rp, + author = {R. M. Ritter}, + title = {Revised proofs}, + howpublished = {email to H. E. Cox}, + date = {2001-08-01}, + url = {ogs@ritter.org.uk}, + urldate = {2001-08-03}} +\end{Verbatim} +\end{bibexbox} + \printbibliography[notcategory=hidden] \end{document} %% |