diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-oxref/oxalph-doc.tex')
| -rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-oxref/oxalph-doc.tex | 642 |
1 files changed, 552 insertions, 90 deletions
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} %% |