plk/biblatex

biblatex is a sophisticated bibliography system for LaTeX users. It has considerably more features than traditional bibtex and supports UTF-8

Overview

This package provides advanced bibliographic facilities for use with LaTeX.

The package is a complete reimplementation of the bibliographic facilities provided by LaTeX. A custom backend Biber is used by default which processes BibTeX format data files and then performs all sorting, label generation (and a great deal more).

Biblatex does not use the backend to format the bibliography information as with traditional BibTeX: instead of being implemented in BibTeX style files, the formatting of the bibliography is entirely controlled by TeX macros.

This package supports subdivided bibliographies, multiple bibliographies within one document with different sorting, separate lists of bibliographic information such as abbreviations of various fields. Bibliographies may be subdivided into parts and / or segmented by topics.

Just like the bibliography styles, all citation commands may be freely defined.

With Biber as the backend, features such as customisable sorting, multiple bibliographies with different sorting, customisable labels, dynamic data modification and custom data models are available.

The package is completely localised and can interface with the Babel and Polyglossia packages. Read below for how to update and/or add translations.

Copyright and Licence

Authors

• Philipp Lehman
• Philip Kime, Joseph Wright, Audrey Boruvka (since 2011)

Copyright

• Copyright 2006 --- 2011 Philipp Lehman
• Copyright 2011 --- ... Philip Kime

Licence

This work may be distributed and/or modified under the conditions of the LaTeX Project Public License, either version 1.3 of this license or (at your option) any later version.

The latest version of the license is in https://www.latex-project.org/lppl.txt and version 1.3 or later is part of all distributions of LaTeX version 2003/06/01 or later.

This work has the LPPL maintenance status "maintained".

Installation

biblatex is bundled with TeXLive and its variants as well as MikTeX. Normally you can install and update biblatex through your TeX distribution.

biblatex starts life on Github where you can always find development releases:

https://github.com/plk/biblatex

From here, it is packaged for general consumption to SourceForge:

https://sourceforge.net/projects/biblatex

this is where users can download the current development version.

The latest official release is then put onto CTAN, which is where users can get the latest stable version:

https://ctan.org/pkg/biblatex

Installation from github

For this you'll need to be on a UNIX-like system (use https://www.cygwin.com on Windows) that has bash and perl.

You should only install from github if you want to check out the bleeding edge of development or if there is absolutely no way to obtain either the official historical releases from SourceForge or the current release from CTAN. Remember that you will need a matching Biber version (the binaries are distributed on SourceForge).

First clone the repo:

git clone https://github.com/plk/biblatex.git

Then from the clone root:

obuild/build.sh install <version> <texmf root>

for example, say the currently released version is 3.3 and you want to try the 3.4 development version. Suppose your personal texmf root is at ~/texmf:

obuild/build.sh install 3.4 ~/texmf

If this is the first time you are installing biblatex into ~/texmf, you will have to tell TeX that it can find the files in this new location with texhash or the equivalent command from your TeX distribution.

Note that the install script does not fetch and install the official biblatex release version corresponding to the version argument supplied. It just takes the files that are currently checked out, moves them and changes their version identifications so that they identify as the version given in the argument. If you want a specific version, you must check out the corresponding tag or obtain the corresponding sources otherwise before running the script.

Obviously, its is easier to get the TDS format package from the Sourceforge development folder and just unpack it into your ~/texmf but this might not be quite as recent as the git development branch (but is usually very close).

Translation

The language files (*.lbx) are located in tex/latex/biblatex/lbx. To add a new translation copy english.lbx (or another existing translation that is closer to your language; note that english.lbx and german.lbx are reference translations, all other files are not guaranteed to be complete) to languagename.lbx, where languagename is the name used by Babel for the language.

To debug or verify that a translation is complete, copy doc/latex/biblatex/examples/03-localization-keys.tex to tex/latex/biblatex/lbx. Edit 03-localization-keys.tex so Babel (and hence Biblatex) uses the language you are translating. Compiling the file will warn you about missing strings, and looking at the generated file will help you to proofread your translation.

If you are translating for an upcoming release, i.e., you have cloned the Git repository, please remember to build and install the package as described above before trying to compile 03-localization-keys.tex.

If your language inherits from another, you'll have to take extra care as new strings aren't reported if they are already translated in the inherited language.

Help

• biblatex comes with example files in the doc/latex/biblatex/examples directory in the distribution. There are a lot of practical examples here along with comments in the source .tex files which help to explain details not dwelt on in the PDF manual.
• StackExchange

Debug and feature requests

Suggestions and bug reports are welcome.

• Go to the Github issues page.
• Open an issue.
• Add a minimal working example if possible. This helps a great deal facilitate a swift response.

biblatex's Issues

entry sets and refsections

In example 14 (references by section), replacing the first chapter contents with:

\chapter{Title of first chapter}
\begin{refsection}
\cite{set}
\end{refsection}

generates the error:

ERROR: Undefined control sequence.

--- TeX said ---
<argument> \blx@tempa 

l.37 \begin{document}

The error only occurs when citing entry sets.

Language Mapping problems when using babel and automatic language detection

I seem to be having issues with language mappings which might be a bug. But I'm not sure I understand them well enough to know if what I'm seeing is a bug. If it's not, please set me straight ASAP and close it.

The following MWE illustrates the problem. Please note that the mapping of English language to the French language localisation file is done simply for the purposes of illustration!

\documentclass{article}
\usepackage[english]{babel}% NO PROBLEM IF I REMOVE THIS
\usepackage[style=verbose,language=auto]{biblatex}% NO PROBLEM IF LANGUAGE=ENGLISH
\DeclareLanguageMapping{english}{french}
\addbibresource{biblatex-examples.bib}
\begin{document}
\nocite{*}
\printbibliography
\end{document}

Contrary to what one might expect, this seems to use the language definitions from english.lbx, rather than french.lbx.

If one (a) deletes babel (remembering that my system uses English as default) or (b) changes language to "english" in the Biblatex options, then I get the behaviour I expected (i.e. I get French language bibstrings and so forth).

Obviously, I didn't see this behaviour when doing anything as silly as mapping English to French! I was mapping English to a custom .lbx file; but I seem to be seeing the same behaviour if babel is being used and the language is not explicitly set to English: the custom language mapping is being ignored and english.lbx loaded. Is that as it should be?

Can you add 'author-pages' citation style to biblatex?

Can you add 'author-pages' citation style to biblatex? It should be able to automatically handle multiple citation and generate correct hyperref links.

Examples:
.bib file:

@Book{author137,
author="Author",
pages="137",
}

@Book{author274,
author="Author",
pages="274",
}

\usepackage[style=authorpages][biblatex]
...
This is a sentence. \cite{author137}

Produces:

This is a sentence. (Author, p137)

\usepackage[style=authorpages][biblatex]
...
This is a sentence. There are two sentences. \cite{author137, author274}

Produces:

This is a sentence. There are two sentences. (Author, p137, p274)

Regards.

KOMA: subbibliography headings

The subbibliography headings get a number although they shouldn't when typeset with the twoside option in the KOMA script classes . See here for details and solution.

Indexing more than one field

Hello,

I would like to index more than one fied, to have index entry like author!title!pages. I did'tn see how can I do.

For yet, I index these 3 fields separtly and concate them bt python script.

\therefsegment

Somehow the \therefsegment command is broken in the newest biblatex.
When I compile 12-references-by-segment.tex from the biblatex examples, the references back to the segments don't work. I get a lot of LaTeX Warning: Reference refsegment:2 on page 4 undefined on input line 39 no matter how often I compile.

Wrong numbers assigned when breaking bibliography into segments with multiple citation orders

It seems that as of biblatex 2.x and biber 1.x, the sorting option is now supported on the \printbibliography command, which should allow one to break a bibliography into fragments with independent sorting orders. However, when using numbered references, there seems to be a bug which causes numbers to be assigned in the wrong order (even when using the defernumbers option). At TeX.SE I've posted a more detailed explanation and a minimal example.

Allow more than one check for \printbibliography

I just realized that you can only use one filter at a time defined with \defbibcheck. Is there any reason not to allow something like \printbibliography[check=filter1,check=filter2]?

\citeorder variant

Just came across this question:

http://tex.stackexchange.com/q/55256

It is an interesting one. Could a variant of \citeorder be created? Say \citeorder* indexes entries by the order of citation command; entries first cited in the same command are assigned the same index. Then we could use sortcites=true and sorting=cy with

\DeclareSortingScheme{cy}{\sort{\citeorder*\field{year}}}

Bug in loading biblatex

I wanted test issue for #31, with the master branch (was I wrong ?), but I obtain at the loading of biblatex

g = inserted for \ifnum. D l.86

?


\DeclareSourcemap: xdata field seems to interfere with overwrite=false

Consider the following minimal example:

\documentclass{article}

\usepackage{filecontents}

\usepackage{biblatex}

\begin{filecontents*}{test.bib}
@XData{JLS,
  journaltitle    = "Journal of Life Stories"
}
@Article{Mustermann2012,
  author          = "Mustermann, Max",
  title           = "My Life",
  year            = "2012",
  volume          = 29,
  xdata           = "JLS"
}
\end{filecontents*}

\addbibresource{test.bib}

\DeclareSourcemap{
  \maps[datatype=bibtex, overwrite=false]{
    \map{
      \step[fieldset=volume, fieldvalue=30]
    }
  }
}

\begin{document}

\nocite{Mustermann2012}

\printbibliography

\end{document}

Despite overwrite=false in the source mapping, the volume number is overwritten. Surprisingly, this seems to be related to the xdata field. If it is removed or set to an empty value everything works as expected.

\ExecuteBibliographyOptions{backend=biber} stopped working

Maybe I did something wrong with building the latest version, but with biblatex 2.0, version from 2012/05/13 \ExecuteBibliographyOptions{backend=biber} gives me an error:

See the keyval package documentation for explanation.
Type  H <return>  for immediate help.
 ...                                              

l.6 \ExecuteBibliographyOptions{backend=biber}

? 

When I define 'backend=biber' as an option with \usepackage[…]{biblatex}, everything works fine.

Missing postnote delimiter with fullcite

The problem was reported over at SE:

http://tex.stackexchange.com/questions/80389/problem-with-biblatex-and-footnotes

Looks like the problem is related to \finentry and was introduced some time after 1.7. 1.7 uses:

\protected\def\blx@finentry@usedrv{%
  \unspace
%  \blx@initunit
}

The later versions uncomment \blx@initunit and this gives the missing postnote delimiters in \fullcite and friends. Was there any particular reason for this change?

Collation tailoring

Could you please tell me how I should use collation tailoring in biblatex/biber? I need to sort cyrillic letters before the others (this is called collation reordering, afaik). Playing with sortlocale option didn't help. Biber's --collate_options seems not to allow reorder (I tried biber --collate_options="reorder => 'Cyrl, others'").

Group anonymous entry in final bibliography

Hi,

the default stand sorting scheme nty dispatch all anonymous entry inside bibliography.

I made my owm sorting scheme, http://geekographie.maieul.net/Tri-des-oeuvres-anonymes, but maybe a similar schem could be add to the standard files ?

\MakeSentenceCase and friends doesn’t work with constructs like {\char"00E5}

The question biblatex-apa and Unicode characters on TeX.SX demonstrates that the command \MakeSentenceCase doesn’t work for constructs such as {\char"00E5}.

\ifsingletitle and missing labelname

This is another request concerning the missing labelname.
\ifsingletitle seems to not work in this case. Could it be made working?

authoryear style prints author, year for citation

Since the beginning of November, style=authoryear or style=authoryear-comp will result in citations that have a colon between author and year. Looks strange to me and the behaviour was different before November. Anyway, not sure if this is a bug...

New test script shows errors in some example files

I wrote a new test script which runs the installed biblatex+biber on all of the doc examples files and looks for errors in the logs. Here is the output for the ones with problems (4 example files have errors/warnings). We should look into these:

==============================
Test file: 17-numeric-prefixed-2.tex

PDFLaTeX errors/warnings
------------------------
! Package keyval Error: No value specified for resetnumbers.
! Package keyval Error: No value specified for resetnumbers.

See the keyval package documentation for explanation.
Type  H <return>  for immediate help.

Biber errors/warnings
---------------------
==============================

==============================
Test file: 18-numeric-hybrid.tex

PDFLaTeX errors/warnings
------------------------
! Package keyval Error: No value specified for omitnumbers.
Package biblatex Warning: Please rerun LaTeX.
! Package keyval Error: No value specified for omitnumbers.

See the keyval package documentation for explanation.
Type  H <return>  for immediate help.

Biber errors/warnings
---------------------
==============================


==============================
Test file: 21-indexing-advanced.tex

PDFLaTeX errors/warnings
------------------------
LaTeX Warning: Command \markboth  has changed.
LaTeX Warning: Command \markright  has changed.

Biber errors/warnings
---------------------
==============================


==============================
Test file: 82-style-debug.tex

PDFLaTeX errors/warnings
------------------------
! Undefined control sequence.
\blx@bbx@debug ...][-\thelisttotal ]}\abx@donames 
                                                  \def \do {\printlist [debu...
l.33 
--
! Undefined control sequence.
\blx@bbx@debug ...][-\thelisttotal ]}\abx@dolists 
                                                  \def \do {\printfield [deb...
l.33 
--
! Undefined control sequence.
\blx@bbx@debug ...rintfield [debug]}\abx@dofields 
                                                  \do {options}\do {execute}...
l.33 

Biber errors/warnings
---------------------
==============================

Problems with Koma-Script support

Hi,
ist it possible to add support for KoMa-script pagestyles-mechnisim (scrplain, scrheadings) It's quite ugly to see, that the bibliography doesn't have the same pagestyles like the rest of the document.

Multiple \DeclareSortExclusion clear each other out

Consider the following MW:

\documentclass{article}
\usepackage{filecontents}

\begin{filecontents}{\jobname.bib}
@article{Bli74,
  author = {Blinder, Alan S.},
  year = {1974},
  title = {The economics of brushing teeth},
  journaltitle = {Journal of Political Economy},
  volume = {82},
  number = {4},
  pages = {887--891}}
  @inbook{PsyG,
  keywords = {simmel}, hyphenation = {german},
  author = {Georg Simmel},
  title = {Zur Psychologie des Geldes},
    booktitle = {Aufsätze 1887 bis 1890. Über sociale Differenzierung. Die Probleme der Geschichtsphilosophie (1892)},
    editor = {Heinz-Jürgen Dahme},
    volume = {2},
      maintitle = {Georg Simmel Gesamtausgabe},
      maineditor = {Otthein Rammstedt},
  address = {Frankfurt am Main},
  publisher = {Suhrkamp},
  year = {1999},
  sortyear = {1889},
  edition = {2},
  origdate = {1889-05},
  pages = {49-65},
  shorthand = {PsyG}}  
@collection{Ackerman.Strickland:1981,
    Address = {Bloomington},
    Author = {Ackerman, Forrest J. and Strickland, A. W.},
    Title = {A Reference Guide to American Science Fiction Films},
    Volume = {1},
    Year = {1981}}
}
\end{filecontents}

\usepackage[utf8]{inputenc}
\usepackage[ngerman]{babel}
\usepackage[style=authoryear]{biblatex}
\ExecuteBibliographyOptions{backend=biber}
\usepackage{csquotes}

\addbibresource{\jobname.bib}
\usepackage{hyperref}

\DeclareSortExclusion{collection}{author,editor,sortname,translator}
\DeclareSortExclusion{collection}{maintitle}
\DeclareNosort{
\nosort{type_title}{\regexp{\AA\s+}}}

\begin{document}

\cite{PsyG,Bli74,Ackerman.Strickland:1981}

\printbibliography
\end{document}

If there is only one \DeclareSortExclusion (\DeclareSortExclusion{collection}{author,editor,sortname,translator}), is correctly sorted under "R". As soon as I add the second \DeclareSortExclusion which shouldn't have any effect, the entry is sorted under "A".

! Extra \fi

Hi. I have just installed biblatex 2.3 (biblatex-2.3.tds.tgz) under ~/texmf/.

The document below compiles by running latex and biber on foo.tex. However, I get an ! Extra \fi error whenever I run latex on it. How can I get rid of it? Thank you!

This is pdfTeX, Version 3.1415926-1.40.10 (TeX Live 2009/Debian)
entering extended mode
(./foo.tex
LaTeX2e <2009/09/24>
Babel <v3.8l> and hyphenation patterns for english, usenglishmax, dumylang, noh
yphenation, french, basque, ibycus, monogreek, greek, ancientgreek, portuguese,
 loaded.
(/usr/share/texmf-texlive/tex/latex/base/article.cls
Document Class: article 2007/10/19 v1.4h Standard LaTeX document class
(/usr/share/texmf-texlive/tex/latex/base/size10.clo))
(/home/rostov/texmf/tex/latex/biblatex/biblatex.sty
(/home/rostov/texmf/tex/latex/biblatex/biblatex2.sty
(/home/rostov/texmf/tex/latex/etoolbox/etoolbox.sty
(/usr/share/texmf-texlive/tex/latex/etex-pkg/etex.sty))
(/usr/share/texmf-texlive/tex/latex/graphics/keyval.sty)
(/usr/share/texmf-texlive/tex/latex/oberdiek/kvoptions.sty
(/usr/share/texmf-texlive/tex/generic/oberdiek/kvsetkeys.sty
(/usr/share/texmf-texlive/tex/generic/oberdiek/infwarerr.sty)
(/usr/share/texmf-texlive/tex/generic/oberdiek/etexcmds.sty)))
(/home/rostov/texmf/tex/latex/logreq/logreq.sty
(/home/rostov/texmf/tex/latex/logreq/logreq.def))
(/usr/share/texmf-texlive/tex/latex/base/ifthen.sty)
(/usr/share/texmf-texlive/tex/latex/ltxmisc/url.sty)
(/home/rostov/texmf/tex/latex/biblatex/blx-dm.def)
! Extra \fi.
<argument> ...expandafter ,\CurrentOption }}}}\fi

l.4790 \ProcessLocalKeyvalOptions{blx@opt@eldt}

?

Here are the relevant examples:

foo.tex:

\documentclass{article}
\usepackage[backend=biber]{biblatex}
\bibliography{ref.bib}
\begin{document}
First sentence\autocite[1]{paper}.
\end{document}

ref.bib:

@Article{paper, author={Name}, title={Title}, journaltitle={Journal}, volume={1}, issue={1}, pages={1--2}, year={2000}}

DOS-style end-of-line markers in csf files

I’ve just noticed that the csf files all have DOS-style end-of-line markers. Is this on purpose?

Support of URN

It would be great, if you could add support for URN (see RFC1737 and RFC2141).

I found a solution on the web using eprint and eprinttype fields:

% use eprint for urn: example fields (bib-file)
% % eprint = {urn:nbn:de:bsz:100-opus-5191},
% % eprinttype = {urn},
% in your document preamble define
\DeclareFieldFormat{eprint:urn}{%
  URN\addcolon\space
  \ifhyperref
    {\href{http://www.nbn-resolving.org/#1}{\nolinkurl{#1}}}
    {\nolinkurl{#1}}}

(credit goes to Martin Weis: https://groups.google.com/forum/#!msg/de.comp.text.tex/D-EBL3OfIQE/yJW8gtLnEHMJ)

\DeclareStyleSourcemap doesn't work

When I replace \DeclareSourcemap in my style with \DeclareStyleSourcemap it stops working. Biblatex is 2.4. Below is a sort of MWE I tried to compose. It works with Sourcemap, but not with StyleSourcemap.

\RequirePackage{filecontents}
\begin{filecontents}{example.bbx}
\RequireBibliographyStyle{numeric}
\DeclareSourcemap{
      \maps[datatype=bibtex]{
        \map[overwrite]{
          \step[fieldset=options, fieldvalue={useauthor=false}]
        }
     }
}
\end{filecontents}
\begin{filecontents}{\jobname.bib}
@BOOK{book,
 author = {Author},
 title = {Title},
}
\end{filecontents}
%\listfiles
\documentclass{article}
\usepackage[utf8]{inputenc}
\usepackage[english]{babel}
\usepackage[bibstyle=example]{biblatex}
\addbibresource{\jobname.bib}

\begin{document}
\nocite{*}
\printbibliography
\end{document}

Incompatibility between biblatex and the silence package

A recent question on StackExchange has spotted an incompatibility between biblatex and the silence package (which I’m the maintainer of). The reason for this incompatibility is that \blx@warning uses \blx@noline for gobbling line numbers until the biblatex package has finished loading.

As egreg demonstrates in his answer to the question it’s relatively easy to add corresponding compatibility code to the silence package. But clearly, I would prefer not to have to support \blx@warning (and other package-specific feedback macros) explicitly.

Hence my question: Would it be possible to do without the \blx@noline trick, e.g. by replacing

\protected\def\blx@warning#1{%
  \begingroup
  \blx@safe@actives
  \PackageWarning{biblatex}{#1\blx@noline}%
  \endgroup}
\protected\def\blx@warning@noline#1{%
  \begingroup
  \blx@safe@actives
  \PackageWarningNoLine{biblatex}{#1}%
  \endgroup}

with

\protected\def\blx@warning@noline#1{%
  \begingroup
  \blx@safe@actives
  \PackageWarningNoLine{biblatex}{#1}%
  \endgroup}
\let\blx@warning\blx@warning@noline
\AtEndOfPackage{
  \protected\def\blx@warning#1{%
    \begingroup
    \blx@safe@actives
    \PackageWarning{biblatex}{#1}%
    \endgroup}}

and

\protected\def\blx@info#1{%
  \begingroup
  \blx@safe@actives
  \PackageInfo{biblatex}{#1\blx@noline}%
  \endgroup}
\def\blx@info@noline#1{%
  \begingroup
  \blx@safe@actives
  \PackageInfo{biblatex}{#1\@gobble}%
  \endgroup}

with

\protected\def\blx@info@noline#1{%
  \begingroup
  \blx@safe@actives
  \PackageInfo{biblatex}{#1\@gobble}%
  \endgroup}
\let\blx@info\blx@info@noline
\AtEndOfPackage{
  \protected\def\blx@info#1{%
    \begingroup
    \blx@safe@actives
    \PackageInfo{biblatex}{#1}%
    \endgroup}}

?

Title/year disambiguation

hello!

Is it possible to implement a title/year disambiguation similar to the extrayear or extratitle? It would be helpful when the labelname is missing. The extratitle disambiguates even when years are different.

Add parttitle field

The following example can not be properly expressed by biblatex at the moment:

Cassirer, Ernst: Gesammelte Werke. Bd. 11.: Philosophie der symbolischen Formen. Teil 1: Die Sprache. Hrsg. von Birgit Recki.
Bearb. von Claus Rosenkranz. Hamburg 2001.

What we have here is a work (Philosophie der symbolischen Formen) which consists of three individual books, each of them with their own title. This work which was originally published as three-part book, is now available as part of a multi-volume work (Gesammelte Werke). Typically, this will be done the following way:

maintitle = {Gesammelte Werke},
title = {Philosophie der symbolischen Formen}
volume = {11}
part = {1}

Unfortunately, there's no clean way to give the title of the individual book ("Die Sprache). I therefore suggest to add a parttitle field.

Version in CTAN broken

This might not be the correct place but in the 2.1 releases biblatex.sty, the VERSION and DATE have NOT been replaced by the build script. This throws errors when compiling documents.

Source mapping for style authors

We have the preamble-only \DeclareSourcemap and the biber.conf file for the user to specify mapping rules. What should style authors use? There is \DeclareDefaultSourcemap, but this seems more suited to handling different data formats.

Incorrect mincitenames

Setting mincitenames here doesn't give the correct value:

\documentclass{article}
\usepackage[T1]{fontenc}
\usepackage[maxbibnames=6,minbibnames=6,maxcitenames=2,mincitenames=2]{biblatex}

\AtEveryCite{(\theminnames, \themaxnames)}
\AtBeginBibliography{(\theminnames, \themaxnames)}

\addbibresource{biblatex-examples.bib}
\begin{document}
\textcite{aksin}
\printbibliography
\end{document}

This was originally reported at SF (ID 3574212).

Small improvements to the build script

I’d like to propose some small improvements to the build script (dev):

--- a/build/build.sh
+++ b/build/build.sh
@@ -18,6 +18,7 @@
 declare VERSION=$1
 declare DATE=`date '+%Y/%m/%d'`

+[ -e build/tds ] || mkdir build/tds
 \rm -rf build/tds/*
 \rm -f build/biblatex.tgz
 cp -r bibtex build/tds/
@@ -30,7 +31,7 @@
 perl -pi -e "s|\\%v.+|\\%v$VERSION|;" build/tds/tex/latex/biblatex/*.def

 # Can't do in-place on windows (cygwin)
-find build/tds -name \*.bak | xargs rm
+find build/tds -name \*.bak | xargs \rm -f
 find build/tds -name auto | xargs \rm -rf

 if [ "$2" = "norel" ]

The first change ensures that the tds subdirectory exists before the first copy operation takes place. The second change is for the sake of consistency.

Problem with defernumbers and biber

I wonder if one of the real TeX experts can look at this? Given:

\documentclass{article}
\usepackage[backend=biber,style=numeric-comp,defernumbers]{biblatex}
\begin{document}
\newrefsection[biblatex-examples.bib]
\cite{bertram,companion}
\printbibliography
\end{document}

and the sequence latex,biber,latex

the .aux file contains incorrectly:

\abx@aux@number{2}{bertram}{1}{3}
\abx@aux@number{3}{companion}{1}{4}

instead of

\abx@aux@number{2}{bertram}{1}{1}
\abx@aux@number{3}{companion}{1}{2}

Running latex once more fixes it. This is odd. It seems that in biblatex2.sty,

blx@labelnumber@\the\c@refsection

is being incremented twice for some reason and then this is written to the .aux, causing the the second latex after biber to pick up a number one higher than it should and the label is incorrect in the output. Running latex once more and it's fine thereafter. I suspect it's something fairly simple but I can't see it ...

Change text on CTAN

The text in the pink frame of CTAN is speaking about bibtex and biber explained after. I think it will be nice to speak of biber first, because it's now the default background.

"Verbose" alphabetic labels

There are a number of questions at TeX.SE that request an alphabetic style with author-year citation labels. For example:

http://tex.stackexchange.com/q/11827

Can these labels be specified with \DeclareLabelalphaTemplate?

language of relatedstrings

At the moment relatedstrings are printed in the bibentry language, which varies in a multilanguage bibliography. Is it possible to change this? I'd rather expect them to be in the main language of the document. I tried to adjust the language in the 'related' macro, but with no success.

Undefined CS with sortcites

sortcites orders citations according to the scheme specified by the sorting package option. If this scheme actually isn't used in a bibliography, I get an undefined control sequence error:

ERROR: Undefined control sequence.

--- TeX said ---
<argument> \blx@tempb                       

Here's an example.

\documentclass{article}
\usepackage[american]{babel}
\usepackage{csquotes}
\usepackage[style=authoryear,sortcites,sorting=nyt]{biblatex}

\addbibresource{biblatex-examples.bib}

\begin{document}
\cite{companion,knuth:ct,markey}
%\printbibliography
\printbibliography[sorting=ydnt]
\end{document}

Citing a single subentry gives wrong result with numeric-comp style

This cam to me via biblatex-chem, but it is a core bug somewhere:

\listfiles{}
\documentclass{article}
\usepackage{filecontents}
\begin{filecontents}{bibexample.bib}
  @Set{ aldol-borodin,
    entryset =   {Borodin1864,Borodin1873},
  }
  @article {Borodin1864,
    author =     {Borodin, A.},
    title =      {Ueber die Einwirkung des Natriums auf Valeraldehyd},
    journaltitle = {J. Prakt. Chem.},
    volume =     93,
    number =     1,
    url =        {http://dx.doi.org/10.1002/prac.18640930168},
    doi =        {10.1002/prac.18640930168},
    pages =      {413--425},
    year =       1864,
  }
  @article {Borodin1873,
    author =     {Borodin, A.},
    title =      {Ueber einen neuen Abkoemmling des Valerals},
    journaltitle = {Ber. Dtsch. Chem. Ges.},
    volume =     6,
    number =     2,
    url =        {http://dx.doi.org/10.1002/cber.18730060232},
    doi =        {10.1002/cber.18730060232},
    pages =      {982--985},
    year =       1873,
  }
  @article {Kane1838a,
    author =     {Kane, Robert},
    title =      {Ueber den Essiggeist und einige davon abgeleitete
      Verbindungen},
    journaltitle = {J. Prakt. Chem.},
    volume =     15,
    number =     1,
    url =        {http://dx.doi.org/10.1002/prac.18380150112},
    doi =        {10.1002/prac.18380150112},
    pages =      {129--155},
    year =       1838,
  }
\end{filecontents}
\usepackage[backend=biber,
citestyle=numeric-comp,
subentry]{biblatex}
\bibliography{bibexample}
\begin{document}
Who discovered the aldol reaction? Borodin\autocite{aldol-borodin} or even Kane\autocite{Kane1838a}?
Borodin's first publication was published 26 years after Kane's
work\autocite{Borodin1864,Kane1838a}.
\printbibliography
\end{document}

Compare the last citation when using the numeric style.

sourcemap issue

Hello!

The folowing code:

\documentclass{article}
\usepackage[english]{babel}
\usepackage{biblatex}
\addbibresource{biblatex-examples.bib}

\DeclareSourcemap{
\maps[datatype=bibtex]{
    \map[overwrite]{
        \step[fieldset=options, fieldvalue={ZZZ}]
    }
}}
\begin{document}
\end{document}

leads to the following compilation error:

Entity: line 148: parser error : expected '>'
</bcf:map map_overwrite="1">
^
INFO - This is Biber 1.0 (beta)
INFO - Logfile is 'sourcemap.blg'
INFO - Reading 'sourcemap.bcf'

I used the dev branch from the repository.

Include in TL12

TeXLive 11 has just been frozen forever and work on TeXLive 12 has begun. It seems like a good idea to have a release version of biblatex 2.0 and biber 1.0 to have it included in the TL12 version which burned put on DVD.

New bibstring for pubstate "prepublished"

This feature request has already been on the sourceforge tracker for a while. Since I'm not sure wether this tracker is actually still active, I repost it here.

In some fields it has become quite common to have articles prepublished online before they are officially published in the respective journal. I therefore suggest a new bibstring "prepublished" for the pubstate field.

\ExecuteBibliographyOptions{backend=biber} stopped working

Maybe I did something wrong with building the latest version, but with biblatex 2.0, version from 2012/05/13 \ExecuteBibliographyOptions{backend=biber} gives me an error:

! Package keyval Error: backend undefined.

See the keyval package documentation for explanation.
Type  H <return>  for immediate help.
 ...                                              

l.6 \ExecuteBibliographyOptions{backend=biber}

? 

When I define 'backend=biber' as an option with \usepackage[…]{biblatex}, everything works fine.

Undefined CS with entry sets

Citing all of the entries in the documentation bib file generates undefined control sequence errors:

! Undefined control sequence.
<argument> ...c@refsection @entry@\blx@slist@name
...
! Undefined control sequence.
<argument> \blx@tempa 

l.25 \begin{document}

It looks like this is associated with biber and entry sets. Here's an example.

\documentclass{article}
\usepackage[backend=biber]{biblatex}

\begin{filecontents}{\jobname.bib}
@article{glashow,
  author = {Glashow, Sheldon},
  title = {Partial Symmetries of Weak Interactions},
  journaltitle = {Nucl.~Phys.},
  volume = {22},
  date = {1961},
  pages = {579--588}}
@article{weinberg,
  author = {Weinberg, Steven},
  title = {A Model of Leptons},
  journaltitle = {Phys.~Rev.~Lett.},
  volume = {19},
  date = {1967},
  pages = {1264--1266}}
@set{set,
  entryset = {glashow,weinberg},
  annotation = {A \texttt{set} with two members}}
\end{filecontents}
\addbibresource{\jobname.bib}

\begin{document}
%\cite{glashow,weinberg}
\nocite{set}
\printbibliography
\end{document}

Suggestion: The &-sign a normal letter

Traditionally in bibtex databases the &-sign must be written in TeX syntax "&". My suggestion: With biblatex/biber it should be possible to write "&" instead of "&" and of course the old version should also be valid. I see no conflicts with tabulars etc. The advantage would be easier typing and easier converting from/to other bibliographical sources.

...Rolf

Multiple \DeclareSortExclusion clear each other out

Consider the following MWE:

\usepackage{filecontents}

\begin{filecontents}{\jobname.bib}
@article{Bli74,
  author = {Blinder, Alan S.},
  year = {1974},
  title = {The economics of brushing teeth},
  journaltitle = {Journal of Political Economy},
  volume = {82},
  number = {4},
  pages = {887--891}}
  @inbook{PsyG,
  keywords = {simmel}, hyphenation = {german},
  author = {Georg Simmel},
  title = {Zur Psychologie des Geldes},
    booktitle = {Aufsätze 1887 bis 1890. Über sociale Differenzierung. Die Probleme der Geschichtsphilosophie (1892)},
    editor = {Heinz-Jürgen Dahme},
    volume = {2},
      maintitle = {Georg Simmel Gesamtausgabe},
      maineditor = {Otthein Rammstedt},
  address = {Frankfurt am Main},
  publisher = {Suhrkamp},
  year = {1999},
  sortyear = {1889},
  edition = {2},
  origdate = {1889-05},
  pages = {49-65},
  shorthand = {PsyG}}  
@collection{Ackerman.Strickland:1981,
    Address = {Bloomington},
    Author = {Ackerman, Forrest J. and Strickland, A. W.},
    Title = {A Reference Guide to American Science Fiction Films},
    Volume = {1},
    Year = {1981}}
}
\end{filecontents}

\usepackage[utf8]{inputenc}
\usepackage[ngerman]{babel}
\usepackage[style=authoryear]{biblatex}
\ExecuteBibliographyOptions{backend=biber}
\usepackage{csquotes}

\addbibresource{\jobname.bib}
\usepackage{hyperref}

\DeclareSortExclusion{collection}{author,editor,sortname,translator}
\DeclareSortExclusion{collection}{maintitle}
\DeclareNosort{
\nosort{type_title}{\regexp{\AA\s+}}}

\begin{document}

\cite{PsyG,Bli74,Ackerman.Strickland:1981}

\printbibliography
\end{document}

If there is only one \DeclareSortExclusion (\DeclareSortExclusion{collection}{author,editor,sortname,translator}), is correctly sorted under "R". As soon as I add the second \DeclareSortExclusion which shouldn't have any effect, the entry is sorted under "A".

Possibility to determine whether a title is unique

While working on a style which could handle tv series and shows the necessity came up to determine whether multiple episodes of a certain show are cited. Since tv shows often don't have a creator in the traditional it's necessary to determine whether a title is unique. See the details here.

Setting datamodel within a style

How can I set a datamodel from within a style file? Simple
\ExecuteBibliographyOptions{datamodel=dm}
throws this error:
! Package keyval Error: datamodel undefined

At the same time, setting datamodel usepackage option works fine.
I'm using version 2.0 from texlive 2012. This is an MWE (I tried to simplify things a little):

\RequirePackage{filecontents}
\begin{filecontents}{dm.dbx}
\end{filecontents}

\begin{filecontents}{style.bbx}
\ExecuteBibliographyOptions{datamodel=dm}       % this does not work
\end{filecontents}

\documentclass{article}
\usepackage[bibstyle=style,
%datamodel=dm,                      % this works
]{biblatex}
\addbibresource{biblatex-examples.bib}

\begin{document}
\cite{knuth:ct}
\end{document}

Padding does not work when sorting by entrykey

It seems that padding does not work for the field entrykey. If I run biber 1.2 on the following, the entries are sorted lexicographically in the references (i.e., Paper B appears before Paper A). (It works correctly when sorting by year.)

\documentclass{article}
\begin{filecontents}{\jobname.bib}
   @misc{2,
     author = {A. Author},
     title = {Paper A},
     year = {2012}
   }
   @misc{10,
     author = {B. Author},
     title = {Paper B},
     year = {2012}
   }
\end{filecontents}
\usepackage[style=alphabetic,sorting=key]{biblatex}
\DeclareSortingScheme{key}{ 
    \sort{ 
        \field[padside=left,padwidth=3,padchar=0]{entrykey}
    } 
}
\DeclareFieldFormat{labelalpha}{\thefield{entrykey}}
\DeclareFieldFormat{extraalpha}{}
\addbibresource{\jobname.bib}
\begin{document}
    \nocite{*}
    \printbibliography
\end{document}

Can't find biblatex-examples.bib

(I've mentioned this via email before, but figured the issue should get documented here.)

This error message occurs because installing with TeX Live no longer gives you an additional copy of the bib file here:

texmf/bibtex/bib/biblatex/biblatex-examples.bib

The TDS on SF looks fine, though. Any idea what could be going wrong in the upload to CTAN?

Update: I updated to 2.2 via tlmgr. I get two copies of biblatex-examples.bib here:

1. texmf/doc/latex/biblatex/examples
2. texmf/doc/latex/biblatex/bibtex/bib

but 2 should be texmf/bibtex/bib/biblatex. The TDS in the upload looks OK.

Option to relax dataonly setting for related entries

Considering this recent post on TeX.SE I am wondering whether we can relax the default dataonly option setting for related entries. In particular if the related entry could take the setting skipbib, its labelname could be considered in name disambiguation so that the following setup would work.

\begin{filecontents*}{lit.bib}
@BOOK{werner,
  author = {Werner, Dennis},
  title = {Title of the Book}}
@INCOLLECTION{werner2,
  title = {Title of the Article},
  Author = {Tester, Hans},
  related = {werner4}}
@BOOK{werner3,
  author = {Werner, Dennis},
  editor = {Schneider, Uwe AND Werner, Hans},
  title = {Title of the Article}}
@COLLECTION{werner4,
  editor = {Schneider, Uwe AND Werner, Hans},
  title = {Title of the Book}}
\end{filecontents*}

\documentclass{article}
\usepackage[backend=biber,style=authortitle,
  uniquename=allfull]{biblatex}
\bibliography{lit}

\newbibmacro*{in:labelname}[1]{%
  \entrydata{#1}{\printnames{labelname}}}

\renewbibmacro*{cite}{%
  \iffieldundef{shorthand}
    {\ifnameundef{labelname}{}{%
       \printnames{labelname}\setunit{\nametitledelim}}%
     \usebibmacro{cite:title}%
     \ifentrytype{incollection}
       {\setunit{\addcomma\space}%
        \forcsvfield{\usebibmacro{in:labelname}}{related}}{}}
    {\usebibmacro{cite:shorthand}}}

\begin{document}
\null\vfill
Filler.\footcite{werner} Filler.\footcite{werner2}
\printbibliography
\end{document}