Doxygen \ cite producing an empty bibliography

Question

I am trying to use \cite in Doxygen to create a bibliography page, as well as links in my text. I have bibtex in my search path and in the corresponding .bib file. I added the .bib file to CITE_BIB_FILES and use the corresponding BibTex shortcut found in the .bib file. Doxygen creates a bibliography page, but it is blank. It also creates a link link in the documentation text, but the link is also empty. Any idea how I can get citation information?

Answer 1

I had the same problem. There is a perl dependency to generate quotes. Thus, you must have both perl and bibtex in the system path.

Ignore the above example, applicable only to latex, for use in doxygen (Note: no braces):

 \cite Hale 

The .bib file must be in the doxygen working directory.

Bibliographic links An HTML page will then be created using doxygen with:

[1] J.K. Hale. The theory of functional differential equations. Springer-Verlag, Berlin-Heidelberg-New York, 1977

for the following bib entry:

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

Answer 2

Maybe a little late, but I had the same problem. Doxygen created a bibliography for LaTeX output, but not for HTML output, and none of the suggested 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.

Answer 3

When you set CITE_BIB_FILES to a DoxyFile, do you include the .bib extension in the file name? Doxygen claims that it will automatically add the .bib extension, but if you omit it, then doxygen seems to get confused and did not generate the citelist.doc file properly.

Include .bib in the file name and it should work fine, at least this applies to me.

Answer 4

For \cite to work properly, you need to:

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

Answer 5

To create a bibliography, you need to install Perl and add it to the search path along with bibtex. The documentation for CITE_BIB_FILES says:

"CITE_BIB_FILES ... To use this function, you need bibtex and perl available in the search path ..."