RefTeX won't find my .bib file in local library tree

Question

RefTeX gives out the following error when trying to insert a citation:

  No valid bibliography in this document, and no default available

I keep a master .bib file in ~/Library/texmf/bibtex/bib/master_bib.bib. Biblatex-biber recognize the file when I run it, so a bibliography is generated. The problem is that RefTeX does not recognize the file and yields the above error. I have also placed the .bib file in the same directory as the .tex file, with the same results.

This post seemed promising https://tex.stackexchange.com/questions/23780/reftex-wont-detect-my-bib-file but that one self-resolved automagically.

The RefTeX manual (p.20) says that

If you do not use BibTEX, but the document contains an explicit thebibliography environment, RefTEX will collect its information from there.

however, I don't see where or how I could include this.

How can I get this to work?

Here's a MWE:

\documentclass{article}

\usepackage[
    backend=biber, 
    style=authoryear, 
    maxcitenames=2, 
    sorting=nyt,
    backref=true
    ]{biblatex}
    \addbibresource{master_bib.bib}

\begin{document}
    Some text. \parencite{Mays:2005, Chow:1998}

\printbibliography
\end{document}

%%% Local Variables: 
%%% mode: latex
%%% TeX-engine: xetex
%%% End:

I'm running Emacs 24, with AUCTeX 11.86, TeX Live 2011 from MacTeX.

Answer 1

There are two ways to make RefTeX find your bibliography. I suggest to use both approaches for robustness.

• To make RefTeX recognize your bibliography you can add it to the list reftex-default-bibliography. To do this add the following to your .emacs:

  ;; So that RefTeX finds my bibliography
  (setq reftex-default-bibliography '("path/to/bibfile.bib"))
  

  and replace path/to/bibfile.bib with the path to your bib file. Note that it is a list so that it can contain several paths if you want to point it to several bibliographies. This approach is good for accessing your .bib file via RefTeX in Org-mode.

• Another way to make RefTeX recognize the bibliography in \addbibresource you can add it to the variable reftex-bibliography-commands by adding the following to your .emacs:

  ;; So that RefTeX also recognizes \addbibresource. Note that you
  ;; can't use $HOME in path for \addbibresource but that "~"
  ;; works.
  (setq reftex-bibliography-commands '("bibliography" "nobibliography" "addbibresource"))
  

Both variables are documented in the manual.

Answer 2

Adding

%%% reftex-default-bibliography: ("path/to/bibfile.bib")

at the end of my file with other commands related to the file looks better to me.

Answer 3

I solved this problem by inserting '(reftex-use-external-file-finders t) into my emacs init file.

It makes RefTeX use the appropriate command from reftex-external-file-finders to find the file. In my case that is kpsewhich -format=.bib %f. The default is looking in the folders specified in the environment variables BIBINPUT and TEXINPUT.

I prefer this variant mainly because I expect that emacs and latex will use the same method for determining what bib file to use. It also feels more flexible, as you do not need to modify it if you create another central biblography.

Answer 4

I've seen people suggest that there's a fault in RefTeX, corrected by inserting

(setq reftex-external-file-finders
'(("tex" . "/path/to/kpsewhich -format=.tex %f")
  ("bib" . "/path/to/kpsewhich -format=.bib %f")))

This is not necessary for me.

Answer 5

Sometimes the issue may just be that the file has not been parsed. This has happened to me a few times eventhough it should've been parsed when opened (especially when I have multiple latex projects open at the same time).

In such situations (supposing your reftex-bibliography-commands contains addbibresource already), the quickest fix is just M-x reftex-parse-all.