Doxygen \cite producing empty bibliography

I'm trying to use \cite in Doxygen to produce a bibliography page and also a reference within my text. I have bibtex in my search path and a proper .bib file. I have added the .bib file to CITE_BIB_FILES and am using a proper BibTex label found in the .bib file. Doxygen is creating a bibliography page, but it is empty. It is also creating a citation link in the documentation text, but the link is also empty. Any idea how I can get the citation info displayed?


Solution 1:

I was facing the same problem. There is an perl dependency to generate citation. So you must have both perl and bibtex in the system path.

Ignore the example above, that only applies to Latex, for doxygen use (Note: no braces):

\cite Hale

The .bib file has to be located in doxygen working directory.

Bibliographic References HTML page will be then produced by doxygen with:

[1]J. K. Hale. Theory of functional–differential equations. Springer–Verlag, Berlin–Heidelberg–New York, 1977.

for the following bib entry:

   @BOOK{Hale,
   author = "J. K. Hale",
   title = "Theory of functional--differential equations",
   publisher = "Springer--Verlag, Berlin--Heidelberg--New York",
   year = 1977
   }

Solution 2:

In order for \cite to work properly you need:

  • be sure to put your file.bib in the working directory where you call doxygen Doxyfile
  • bibtex executable must be in the search path
  • perl executable must be in the search path
  • the RefName used in \cite RefName must have a corresponding entry in file.bib

Solution 3:

Maybe a little late, but I had the same problem. Doxygen generated a bibliography for LaTeX output, but not for HTML output and none of the proposed answers worked for me.

As suggested by @Raffi, this seems to be a bug in Doxygen < 1.8.3. I used Doxygen 1.8.1.1 and it did not work. Then I installed Doxygen 1.8.3.1 without changing anything else and it worked fine.