Doxygen \ cite产生空的参考书目

时间:2012-07-12 15:01:34

标签: doxygen

我正在尝试在Doxygen中使用\cite来生成参考书目页面以及我的文本中的参考文献。我的搜索路径中有bibtex和正确的.bib文件。我已将.bib文件添加到CITE_BIB_FILES并使用.bib文件中的正确BibTex标签。 Doxygen正在创建一个参考书目页面,但它是空的。它还在文档文本中创建引文链接,但链接也是空的。知道怎样才能显示引文信息吗?

5 个答案:

答案 0 :(得分:9)

我遇到了同样的问题。有一个perl依赖项来生成引文。因此,您必须在系统路径中同时包含perl和bibtex。

忽略上面的示例,仅适用于Latex,用于doxygen使用(注意:没有大括号):

\cite Hale

.bib文件必须位于doxygen工作目录中。

书目参考HTML页面将由doxygen生成:

[1:J。 K. Hale。 泛函微分方程理论。 Springer-Verlag,柏林 - 海德堡 - 纽约,1977年。

以下bib条目:

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

答案 1 :(得分:3)

要使\cite正常工作,您需要:

  • 请务必将file.bib放在您致电doxygen Doxyfile
  • 的工作目录中
  • bibtex可执行文件必须位于搜索路径中
  • perl可执行文件必须位于搜索路径中
  • RefName中使用的\cite RefName必须在file.bib中有相应的条目

答案 2 :(得分:2)

也许有点晚了,但我遇到了同样的问题。 Doxygen为LaTeX输出生成了一个参考书目,但不是HTML输出,并且没有提出的答案对我有效。

正如@Raffi所建议的那样,这似乎是Doxygen中的错误< 1.8.3 即可。我使用了Doxygen 1.8.1.1但它没有用。然后我安装了Doxygen 1.8.3.1而没有改变其他任何东西,它工作正常。

答案 3 :(得分:1)

在DoxyFile中设置CITE_BIB_FILES时,您是否在文件名中包含.bib扩展名? Doxygen声称它会自动添加.bib扩展名,但如果省略它,那么doxygen似乎会混淆并且不会正确生成citelist.doc文件。

在文件名中包含.bib,它应该可以正常工作,至少对我来说是这样。

答案 4 :(得分:0)

为了创建参考书目,您需要安装Perl,并将其与bibtex一起添加到搜索路径中。在文档中 对于CITE_BIB_FILES,它说:

" CITE_BIB_FILES ...要使用此功能,您需要在搜索路径中提供bibtex和perl ..."