Doxygen \cite 产生空的参考书目答案

【问题标题】：Doxygen \cite producing empty bibliographyDoxygen \cite 产生空的参考书目
【发布时间】：2012-07-12 08:58:36
【问题描述】：

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

【问题讨论】：

你的配置集中有参数OUTPUT_DIRECTORY吗？
您正在使用哪个操作系统......以及您正在使用哪个工具。
我的配置集中确实有 OUTPUT_DIRECTORY。我正在使用 OS X (Mountain Lion)，之前遇到问题时我正在使用该向导。这一次，我自己在 Emacs 中编辑了配置文件并运行了“doxygen Doxyfile”。然后我在命令行编译了乳胶源，生成的 PDF 产生了正确的引用。我猜我最初的问题与向导的某些问题（可能与用户有关！）有关。
如果您提供一个可用于重现问题的小示例，将会很有用。
Dxoygen 版本

标签： doxygen

【解决方案1】：

我也遇到了同样的问题。有一个 perl 依赖来生成引用。所以你必须在系统路径中同时拥有 perl 和 bibtex。

忽略上面的例子，它只适用于 Latex，用于 doxygen（注意：没有大括号）：

\cite Hale

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

然后由 doxygen 生成参考书目 HTML 页面：

[1]J。 K.黑尔。 泛函微分方程理论。 Springer-Verlag，柏林-海德堡-纽约，1977 年。

以下围兜条目：

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

【讨论】：

这对我很有帮助。用 {} 包围了键，现在我记得不要在 doxygen cmets 中使用它们。

【解决方案2】：

为了让\cite 正常工作，您需要：

确保将您的file.bib 放在您调用doxygen Doxyfile 的工作目录中
bibtex 可执行文件必须在搜索路径中
perl 可执行文件必须在搜索路径中
\cite RefName 中使用的RefName 必须在file.bib 中有对应的条目

【讨论】：

【解决方案3】：

可能有点晚了，但我遇到了同样的问题。 Doxygen 为 LaTeX 输出生成了一个参考书目，但不是为 HTML 输出生成了一个参考书目，并且没有一个建议的答案对我有用。

正如@Raffi 所建议的，这似乎是Doxygen 中的一个错误。我使用了 Doxygen 1.8.1.1，但它不起作用。然后我安装了 Doxygen 1.8.3.1 没有改变任何其他东西，它工作正常。

【讨论】：

【解决方案4】：

当您在 DoxyFile 中设置 CITE_BIB_FILES 时，您是否在文件名中包含 .bib 扩展名？ Doxygen 声称它会自动添加 .bib 扩展名，但如果你省略它，doxygen 似乎会感到困惑并且无法正确生成 citelist.doc 文件。

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

【讨论】：

【解决方案5】：

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

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

【讨论】：