2

I want to switch to a bibliography system that will take care of me for the next 10 years. I wish TUG clearly endorsed the future---what to deprecate, what to use. (Without it, they are becoming irrelevant to me.) Now, my reading is that biblatex and biber are the way forward, but this is somewhat murky. Is this correct?

Now I need a starter document. Not a long detailed reference manual, but document examples. I have seen plenty of web links, but many were over 10 years old, had missing links, described no workflow, and/or did not work. My trusty 2nd edition LaTeX companion from 2004 is about bibtex. (I guess Tex.sx has taken over.) I think it would be useful to have a document to which I should send PhD students who are just learning to use latex. The manual is clearly not for them. R calls these kinds of documents "vignettes."

So, here is a simple test.tex file

\documentclass[12pt]{article}

\usepackage{biblatex}  %% backend=biber is now the default
\addbibresource{testbib.bib}  %% replaces \bibliography

\begin{document}

I am citing \cite{fama-french:2002}.  %  original had typo.  mea culpa

----------------

\printbibliography

\end{document}

and a testbib.bib file

@article{ fama-french:2002,
author = { Eugene F. Fama and Kenneth R. French },
title = { The Equity Premium },
year = 2002,
volume = 57,
number = 1,
month = apr,
journal = { The Journal of Finance }
}

The workflow now would presumably be

$ pdflatex test.tex
$ biber test  ## unfortunately, it still does not understand biber test.tex
$ pdflatex test.tex
$ pdflatex test.tex

This is a good starter workflow, thanks to help from Joseph, Ulrike, Tom, moewe and cfr.

Does someone have a vignette, preferably with more different kinds of documents and cites?

/iaw

ivo Welch
  • 3,766
  • 3
    I'm not really sure what the objective question is here: future-gazing is always prone to being a matter of opinion. – Joseph Wright Aug 12 '15 at 16:29
  • 5
    Well your entry is named fama-french:2002 and not fama:french:2002 (dash instead of colon). And yes biber doesn't compile your tex file but the .bcf as bibtex did compile your .aux-file. I also would use \addbibresource{testbib.bib} instead of \bibliography{testbib}. Beside this your example is fine. (And I naturally recommend biblatex ...) – Ulrike Fischer Aug 12 '15 at 16:35
  • 1
    You need \addbibresource{testbib.bib} rather than \bibliography{testbib} (note that you need the extension). And, the latest versions of Biblatex uses Biber as the backend by default; you don't need to specify it. – twsh Aug 12 '15 at 16:36
  • 4
  • There are also some other guides about such as this UiO guide and https://www.sharelatex.com/blog/2013/07/31/getting-started-with-biblatex.html, there are also some non-English guides out there. – moewe Aug 12 '15 at 17:04
  • 4
    I would also recommend using biblatex and Biber, as they are very flexible, offer lots of functionality ot of the box and don't use some kind of reverse Polish notation. In case of journal submissions and the like, however, sometimes one is stuck with BibTeX - the publishing world moves slowly. See Biblatex: submitting to a journal. – moewe Aug 12 '15 at 17:06
  • 1
    @Tom It is recommended to switch to the newer syntax, but \bibliography{testbib} is still supported. Specifying the backend explicitly avoids Biblatex warning about non-specification on the console. – cfr Aug 12 '15 at 17:19
  • Do we get anywhere with this question? I feel that you are asking a lot of things in one question, some of them have already been answered (biblatex for beginners); and others seem to want us to predict the future, force the TUG to endorse certain packages or at least endorse your understanding... – moewe Aug 15 '15 at 11:11
  • What do we do about this question now? I feel that in essence this question is a duplicate of biblatex for idiots (the part where you ask for a "vignette"). The other bits are either trivial problems (a typo in your reference), opinion-based (do we think biblatex is the way forward; I for one think so, but others might rightfully disagree) and a comment on the TUG. I'm tempted to vote to close a s a duplicate, but since that would not go through a review, I'd like to discuss this first. – moewe Aug 19 '15 at 07:42
  • the comments pretty much answered it. you can close this as a duplicate. (the nice aspect here is that the duplicate answer remains searchable.) alternatively, I can summarize the above as an answer and mark it answered. – ivo Welch Aug 28 '15 at 13:33
  • I'll do that then. – moewe Aug 29 '15 at 05:41

0 Answers0