[Tex/LaTex] Customizing biblatex styles using \usebibmacro

biblatex

I am currently trying to adapt a biblatex style to my needs. I was able to do most tweaks by reading all the answers to similar demands here (such as Suppress "In:" biblatex or Guidelines for customizing biblatex styles).

However, despite all my efforts, I have not been successful in my attempts to work with \usebibmacro.

I had started with the authoryear style, and I want to arrive at the citation style for the Cambridge Review of International Affairs.

I have been able to change everything, except for the @incollection entries.

This is their example:

Cottier, Thomas (2001) 'Risk management experience in WTO dispute
settlement' in David Robertson and Aynsley J Kellow (eds)
Globalization and the environment: risk assessment and the WTO (Cheltenham, United Kingdom: Edward Elgar Publishing), 41-62

And this is what I've got so far:

Cottier, Thomas (2001) ‘Risk management experience in WTO dispute
settlement’. In: ed. by David Robertson and Aynsley J Kellow.
Globalization and the environment: risk assessment and the WTO.
Cheltenham, United Kingdom: Edward Elgar Publishing, 41–62.

So the differences I have not been able to address are:

Remove the punctuation after the title, the editors and the collection title.
Remove capital letter from "In:" as well as the ':'.
Move the 'ed. by' and change it to '(eds)'.
Put the publisher in brackets.

Actually, I prefer the punctuation at the end of each bibliography ending, but just in case: how to remove it?

I know that the key to this lies in the \renewcommand and \usebibmacro, but I just cannot make it work. How can I change these parameters per reference type?

Thank you very much in advance for showing me where I have to move from here.

PS: I just realized that I have to change some dots to commas as well in for other reference types, but I guess that won't be a problem once I understood how to make these changes here.

EDIT: attempt at MWE

paper.tex:

\documentclass[a4paper,oneside,12pt,notitlepage]{article}
\usepackage{geometry}
\usepackage[utf8]{inputenc}
\usepackage[style=authoryear-comp,maxnames=2,maxbibnames=4,bibstyle=mybibstyle,autocite=inline,useprefix=true,backend=bibtex]{biblatex}
\DeclareFieldFormat{postnote}{#1}
\DeclareFieldFormat{pages}{#1}
\bibliography{lit} 

\begin{document}

This is just a test sentence to show you how I cite within my text. \autocite[]{cottier2001}

\newpage

%%%%%%%%%%%%%% BIBLIOGRAPHY
\renewcommand*{\bibfont}{\small}
\printbibliography[title=Bibliography]

\end{document}

lit.bib:

@incollection{cottier2001,
  title={Risk management experience in WTO dispute settlement},
  author={Cottier, Thomas},
  booktitle={Globalization and the environment: risk assessment and
the WTO},
  pages={41--62},
  year={2001},
  publisher={Cheltenham, United Kingdom: Edward Elgar Publishing},
  editor={Robertson, David and Kellow, Aynsley J}
}

mybibstyle.bbx (adapted from the above-mentioned thread):

\ProvidesFile{mybibstyle.bbx}
\RequireBibliographyStyle{standard}
\RequireBibliographyStyle{authoryear-comp} 
\DeclareFieldFormat[article,incollection,unpublished]{title}{ `#1'}%
\DeclareBibliographyDriver{incollection}{%
  \usebibmacro{bibindex}%
  \usebibmacro{begentry}%
  \usebibmacro{author/translator+others}%
  \newblock
  \usebibmacro{title}%
  \newunit
  \printlist{language}%
  \newunit\newblock
  \usebibmacro{byauthor}%
  \newunit\newblock
  \usebibmacro{in:}%
  \usebibmacro{byeditor+others}%
  \newunit\newblock 
 \usebibmacro{maintitle+booktitle}%
  \newunit\newblock
   \printfield{edition}%
  \newunit
  \iffieldundef{maintitle}
    {\printfield{volume}%
     \printfield{part}}
    {}%
  \newunit
  \printfield{volumes}%
  \newunit\newblock
  \usebibmacro{series+number}%
  \newunit\newblock
  \printfield{note}%
  \newunit\newblock
  \usebibmacro{publisher+location+date}%
  \newunit\newblock
  \usebibmacro{chapter+pages}%
  \newunit\newblock
  \iftoggle{bbx:isbn}
    {\printfield{isbn}}
    {}%
  \newunit\newblock
  \usebibmacro{doi+eprint+url}%
  \newunit\newblock
  \usebibmacro{addendum+pubstate}%
  \setunit{\bibpagerefpunct}\newblock
  \usebibmacro{pageref}%
  \newunit\newblock
  \usebibmacro{related}%
  \usebibmacro{finentry}}

I don't have anything left from my tinkering with \usebibmacro 😉

Best Answer

Typically a driver contains the instructions about the order of the elements in a bibliography entry. The instructions for how to print the various elements are encoded in \usebibmacro commands. To change the content of a \usebibmacro{<name> you can use the command \renewbibmacro{<name>}{<instructions>}. In your case you have to modify in:, publisher+location+date and byeditor+other. For the last you have to modify how the editor field is rendered. The rendering of names can be modified using \DeclareNameFormat{<name>}. The changes for the style you want to achieve can be done by something like:

\renewbibmacro{in:}{\printtext{in}}

\DeclareNameFormat{editor}{%
  \ifblank{#3}{}{#3\space}%
  \ifblank{#5}{}{#5\space}#1%
  \ifthenelse{\value{listcount}<\value{liststop}}
    {\addcomma\space}%
    {\space\ifthenelse{\value{listcount}>1}
      {(\bibstring{editors})}
      {(\bibstring{editor})}}%
}
\renewbibmacro{byeditor+others}{
  \ifnameundef{editor}
    {}
    {\printnames{editor}}
}

\renewbibmacro{publisher+location+date}{
  \iflistundef{publisher}
    {}
    {\printtext{(}%
     \printlist{publisher}%
      \iflistundef{location}
        {}
        {\printlist{location}}%
        \printtext{)}%
    }
}

To change the period at the end of the various element use

\renewcommand{\newunitpunct}{\addspace}

By the way it is better to use \addbibresource{lit.bib} instead of \bibliography{lit}

Introduction

As newer versions of biblatex were released, customizations that formerly required redefining internal macros (or at least changing settings mid-document) have become package options settable in the preamble. Here's how to do some often-requested tweaks:

giveninits=true will render all first and middle names as initials. (Introduced in v0.8, renamed in v3.3, is called firstinits in pre-3.3 versions)
isbn=false will suppress any isbn fields included in your .bib file. (It works the same way for url, doi and eprint.) (Introduced in v0.9)
dashed=false (available for the authoryear, authortitle, and verbose bibliography styles) will print recurring author/editor names instead of replacing them by a dash. (Introduced in v0.9)
maxbibnames=99 will print complete name lists for multi-author/editor works in the bibliography while truncating those lists for in-text citations. (Introduced in v1.1)

Now, where to put actual customization macros? As you don't want to create a full-fledged custom style, I recommend to use the configuration file biblatex.cfg. This file, if available, is read by biblatex immediately after a style has been loaded. The (empty) original is located at /tex/latex/biblatex in your TeX distribution directory; put a copy in the analogous location of your local TEXMF tree (and update your file database) and fill it with the redefinitions I'm (finally!) going to talk about.

Addendum: You may also specify preamble options (but not bibliography/citation styles or compatibility modules) via the configuration file. Put the following into biblatex.cfg:

\ExecuteBibliographyOptions{<preamble options>}

Suppressing of specific BibTeX fields

For isbn & friends, see the introduction. Generally, biblatex differentiates between name lists, literal lists, and other fields, and different macros have to be applied to suppress those field categories. Should you, e.g., want to remove the translator, publisher, and pagetotal fields from the bibliography, add the following to your local copy of biblatex.cfg:

\AtEveryBibitem{%
  \clearname{translator}%
  \clearlist{publisher}%
  \clearfield{pagetotal}%
}

See sections 2.2.1 and 2.2.2 of the biblatex manual for a complete list of fields and the categories they belong to. To suppress specific fields for in-text-citations (e.g., when using the verbose style), use \AtEveryCitekey instead of \AtEveryBibitem.

Formatting of fields (and of citation postnotes)

As a general rule, inspect the "Field Formats" section of the file biblatex.def (location: see above). With regard to the example given in your question, look for the following:

\DeclareFieldFormat
  [article,inbook,incollection,inproceedings,patent,thesis,unpublished]
  {title}{\mkbibquote{#1\isdot}}

This means that for @article (and a bunch of other entry types), the title field is put inside quotation marks. (#1 stands for the value of the field, \isdot prevents double punctuation.) In your local biblatex.cfg, change the last part from {\mkbibquote{#1\isdot}} to {#1\isdot}, and you're set with regard to the bibliography. In case your "parent" style prints titles as part of in-text-citations, you'll have to modify the citetitle field in the same way.

For the formatting of citation postnotes, the same principles as above apply, so I'll just post the solution to your actual question. ;-)

\DeclareFieldFormat{postnote}{#1}% no postnote prefix in "normal" citation commands
\DeclareFieldFormat{multipostnote}{#1}% no postnote prefix in "multicite" commands
\DeclareFieldFormat{pages}{#1}% no prefix for the `pages` field in the bibliography

Bibliography – spacing and punctuation

Section 3.10.1 "Generic [Formatting] Commands and Hooks" of the manual provides the basics, the "Formatting Commands" section of biblatex.def contains the actual macros. With regard to your example question (How to replace unit-separator periods with commas?),

\newcommand*{\newunitpunct}{\addperiod\space}

needs to be redefined (using \renewcommand!) as

\renewcommand*{\newunitpunct}{\addcomma\space}

Bibliography – order of first names and last names

The standard styles shipped with biblatex use two different name formats for the bibliography: default (used by numeric and alphabetic) and sortname (used by authoryear, authortitle, and verbose). (In-text-citations are the domain of a third name format, labelname.) These name formats in turn utilize auxiliary macros such as

family-given/given-family: lead author of multi-author works is printed as "last name – first name", follow-up authors are printed as "first name – last name";
family-given: all authors are printed as "last name – first name";
given-family: you guessed it.

To change the name format for, say, the authortitle bibliography style (by default family-given/given-family) to, say, family-given, apply the following:

\DeclareNameAlias{sortname}{family-given}

These name formats were renamed in version 3.3, see Biblatex 3.3 name formatting, before version 3.3 family was last, and given was first in the above. The old names continue to work, but generate warnings; the new names should be used.

Bibliography – order of certain fields

Let's delve into the files standard.bbx and <myparentstyle>.bbx, both of them located in the /bbx subdirectory of your biblatex folder. As per your question, you want to swap the location and publisher fields. Suppose you encounter the following code snippet in standard.bbx:

\DeclareBibliographyDriver{book}{%
  \printnames{author}%
  \newunit\newblock
  \printfield{title}%
  \newunit\newblock
  \printlist{publisher}%
  \newunit
  \printlist{location}%
  \newunit
  \printfield{year}%
  \finentry}

Copy-pasting this definition to your local copy of biblatex.cfg and swapping the respective code lines should be a piece of cake, right? Wrong! While the "bibliography driver" shown above is functional (the example is taken from section 4.2.3 of the manual), the actual drivers are much more complex. They regularly use macros to print specific name lists, literal lists, or fields, and the macro definitions of standard.bbx may be modified by <myparentstyle>.bbx. Assuming your parent style is authortitle, tracing the drivers and macros will bring forth the following definition:

\newbibmacro*{publisher+location+date}{%
  \printlist{location}%
  \iflistundef{publisher}
    {\setunit*{\addcomma\space}}
    {\setunit*{\addcolon\space}}%
  \printlist{publisher}%
  \setunit*{\addcomma\space}%
  \usebibmacro{date}%
  \newunit}

Note the \iflistundef macro which will print either a comma or a colon, depending on whether the publisher list is defined. (The \setunit* macro will only print its argument if the last printing command did actually print anything.) A possible redefinition – and the answer to your question – would be

\renewbibmacro*{publisher+location+date}{%
  \printlist{publisher}%
  \setunit*{\addcomma\space}%
  \printlist{location}%
  \setunit*{\addcomma\space}%
  \usebibmacro{date}%
  \newunit}

By the way, redefining publisher+location+date will (and for the sake of consistency should) affect other entry types besides @book.

Language-specific terms

To change these, you need to modify the "localization keys" listed in section 4.9.2 of the manual. With regard to your example question, the following code does the trick:

\DefineBibliographyStrings{english}{%
  references = {Works Cited},
}

(Actually, a long and a short form is assigned to every localization key. However, with biblatex.cfg it is not possible to separately override these two expressions.)

Afterword

TeX.sx features a lot of questions/answers about customizing biblatex, with the solutions spanning everything from cute and simple macro redefinitions to venturous hacking of biblatex internals. Some notable ones (no claim to be complete):

Suppress "In:" for articles (by Herbert);
Put thin spaces between initials (by Will Robertson) (obsolete with v1.3);
Remove the parentheses around the year for authoryear styles (one answer by Alan Munn, another one inspired by egreg);
Reverse reference numbering (by Audrey).

Finally, here's a real-world example of tinkering with bibliography drivers.

[Tex/LaTex] biblatex: multiple styles

Perusing the feature requests at SourceForge.net:biblatex, I found Switching citation/bibliography styles in the document from 2008-11-13:

User request:

I think it would make sense to be able to set bibliographic/citation styles more flexibly than once in the preamble. At least on a per bibliography/refsection basis. If two bibliographies exist in a document, logically, they could have different styles.

The author of biblatex, Philipp Lehman, marked this request as "Closed - Wont fix" at 2009-07-09.

Maybe (!) Philipp Lehman has changed his mind since then and is working to implement such a feature in version 2 of biblatex. (Other new features like different sorting schemes for multiple bibliographies are forthcoming.)