[Tex/LaTex] How to cite a UN treaty (BibTex entry)

bibliographiesbibtex

I need to add to my bibliography (in LaTeX, using Bibtex) an entry for the Paris Agreement (2015):
https://treaties.un.org/pages/ViewDetails.aspx?src=TREATY&mtdsg_no=XXVII-7-d&chapter=27&clang=_en

However, I have been unable to find any BibTeX-style (or, for that matter, any citation format) for how to cite such a UN treaty. What would be the right format?

Best Answer

Short answer: there is nothing exactly on point ready to hand. It can be approximated quickly, though.

Slightly longer answer:

Depends on what information you need to pass on to your reader.

What will come into play is choosing from a combination of already existing biblatex styles and the entry types they support.

For example, for general purposes:

The oxnotes biblatex style has a @legal bib entry type, and piltreaty subentrytype, which handles the legally relevant dates. URLs are not really part of that picture (yet).

\RequirePackage{filecontents}
\begin{filecontents}{\jobname.bib}

@legal{paris,
entrysubtype = {piltreaty},
title = {Paris Agreement},
shorthand = {Paris Agreement},
execution = {adopted=2015-12-12 and inforce=2016-11-04},
pagination = {article},
journaltitle = {United Nations Treaty Collection, Chapter XXVII 7. d},
url = {https://treaties.un.org/pages/ViewDetails.aspx?src=TREATY&mtdsg_no=XXVII-7-d&chapter=27&clang=_en},
urldate = {2019-03-28}
}

\end{filecontents}

\documentclass[12pt]{article}

\usepackage[english]{babel}
\usepackage[autostyle]{csquotes}
\usepackage[style=oxnotes,
        isourls=true,
        ]{biblatex}
\addbibresource{\jobname.bib}

\begin{document}

\section{Oxnotes Style, @legal entry type}
As stated in the \citetitle[Article 4, paragraph 2]{paris}: ``Parties shall pursue domestic mitigation measures, ...''

\printbibliography

\end{document}

Result:

oxnotes treaty

The apa style, by contrast, has a @data entry type which looks promising: it does a nice url, but its dates are limited (more publication-related), and there is not a cascade of them.

\RequirePackage{filecontents}
\begin{filecontents}{\jobname.bib}


@data{paris,
title = {Paris Agreement},
type = {UN Treaty},
entrysubtype = {Treaty No. XXVII-7-d},
%shorthand = {Paris Agreement},
day = {12},
month  = {12},
year = {2015},
organization = {United Nations},
 url ={https://treaties.un.org/pages/ViewDetails.aspx?src=TREATY&mtdsg_no=XXVII-7-d&chapter=27&clang=_en},
  urlday = {28},
  urlmonth = {3},
  urlyear = {2019},
  author = {},
}

\end{filecontents}

\documentclass[12pt]{article}

\usepackage[english]{babel}
\usepackage[autostyle]{csquotes}
\usepackage[style=apa]{biblatex}
\addbibresource{\jobname.bib}

\begin{document}

\section{APA Style, @data entry type}
As stated in the \citetitle[Article 4, paragraph 2]{paris}: ``Parties shall pursue domestic mitigation measures, ...''

\printbibliography

\end{document}

Result:

apa treaty

To get an idea of the effort needed to adapt a style, adding a url to the oxnotes legal entry turns out to be a one-line change, since all the heavy lifting and pre-work (field definition, assignment and allocation; date parsing and processing; options processing; string constant definition) has already been done.

We just get the already-formatted and packaged url+urldate and "bung it in" at the end (literally) of the bit that prints the formatted legal entry item in the bibliography (code from the foundational oxref.dbx file and copied into our document tex file's preamble:

\DeclareBibliographyDriver{legal}{%
  \usebibmacro{bibindex}%
  \usebibmacro{begentry}%
  \iffieldequals{entrysubtype}{\explanatorynote}{%
    \printfield[default]{title}%
    \setunit{\addspace}\newblock
  }{%
    \iffieldequals{entrysubtype}{\parliamentarytype}{%
      \usebibmacro{legal:parliamentary}%
    }{%
      \usebibmacro{treatycitation}}}%
  \setunit{\addcomma\space}\newblock
  \printfield[default]{note}
  \setunit{\addspace}\newblock
  \setunit{\bibpagerefpunct}%
  \usebibmacro{pageref}%
  \usebibmacro{url+urldate}%=========== this line
  \usebibmacro{finentry}}

MWE:

\RequirePackage{filecontents}
\begin{filecontents}{\jobname.bib}

@legal{paris,
entrysubtype = {piltreaty},
title = {Paris Agreement},
shorthand = {Paris Agreement},
execution = {adopted=2015-12-12 and inforce=2016-11-04},
pagination = {article},
journaltitle = {United Nations Treaty Collection, Chapter XXVII 7. d},
url = {https://treaties.un.org/pages/ViewDetails.aspx?src=TREATY&mtdsg_no=XXVII-7-d&chapter=27&clang=_en},
urldate = {2019-03-28}
}

\end{filecontents}

\documentclass[12pt]{article}


%=============================
\usepackage[english]{babel}
\usepackage[autostyle]{csquotes}
\usepackage[style=oxnotes,
        isourls=true,
        ]{biblatex}
\addbibresource{\jobname.bib}



%=============================
\DeclareBibliographyDriver{legal}{%
  \usebibmacro{bibindex}%
  \usebibmacro{begentry}%
  \iffieldequals{entrysubtype}{\explanatorynote}{%
    \printfield[default]{title}%
    \setunit{\addspace}\newblock
  }{%
    \iffieldequals{entrysubtype}{\parliamentarytype}{%
      \usebibmacro{legal:parliamentary}%
    }{%
      \usebibmacro{treatycitation}}}%
  \setunit{\addcomma\space}\newblock
  \printfield[default]{note}
  \setunit{\addspace}\newblock
  \setunit{\bibpagerefpunct}%
  \usebibmacro{pageref}%
  \usebibmacro{url+urldate}%=========== this line
  \usebibmacro{finentry}}




\begin{document}

\section{Oxnotes Style, @legal entry type (mod)}
As stated in the \citetitle[Article 4, paragraph 2]{paris}: ``Parties shall pursue domestic mitigation measures, ...''

\printbibliography

\end{document}

Result:

oxnotes legal with url

To change the apa style to be able to handle the dates is TML (too many lines) - for me, anyway :) . Doable, certainly. But not a five-minute job. Although, thinking about it for a moment, the dates could go in as extra, individual fields, and then get formatted, and with bibstrings added. So, six minutes, then.