Doxygen\cite, производящий пустую библиографию

Я пытаюсь использовать \cite в Doxygen для создания страницы библиографии, а также ссылки в моем тексте. У меня есть bibtex в моем пути поиска и в соответствующем файле .bib. Я добавил файл .bib в CITE_BIB_FILES и использую соответствующий ярлык BibTex, найденный в файле .bib. Doxygen создает страницу библиографии, но она пуста. Он также создает ссылку ссылки в тексте документации, но ссылка также пуста. Любая идея, как я могу получить информацию о цитировании?

Ответ 1

У меня была та же проблема. Для генерации цитат существует зависимость perl. Таким образом, вы должны иметь как perl, так и bibtex в системном пути.

Игнорируйте приведенный выше пример, применимый только к латексу, для использования в doxygen (Примечание: без брекетов):

\cite Hale

Файл .bib должен находиться в рабочем каталоге doxygen.

Библиографические ссылки HTML-страница будет затем создаваться с помощью doxygen с:

[1] Дж. К. Хейл. Теория функционально-дифференциальных уравнений. 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
   }

Ответ 2

Может быть, немного поздно, но у меня была та же проблема. Doxygen создал библиографию для выхода LaTeX, но не для вывода HTML, и ни один из предложенных ответов не работал у меня.

Как было предложено @Raffi, это кажется ошибкой в Doxygen < 1.8.3. Я использовал Doxygen 1.8.1.1, и это не сработало. Затем я установил Doxygen 1.8.3.1 без изменения чего-либо еще, и он работал нормально.

Ответ 3

Когда вы устанавливаете CITE_BIB_FILES в DoxyFile, вы включаете расширение .bib в имя файла? Doxygen утверждает, что он автоматически добавит расширение .bib, но если вы опустите его, то doxygen, похоже, запутался и не сгенерировал файл citelist.doc должным образом.

Включите .bib в имя файла, и он должен работать нормально, по крайней мере, это относится ко мне.

Ответ 4

Для правильной работы \cite вам необходимо:

обязательно разместите file.bib в рабочем каталоге, где вы вызываете doxygen Doxyfile
bibtex исполняемый файл должен находиться в пути поиска
perl исполняемый файл должен находиться в пути поиска
RefName, используемый в \cite RefName, должен иметь соответствующую запись в file.bib

Ответ 5

Чтобы создать библиографию, вам нужно установить Perl и добавить его в путь поиска вместе с bibtex. В документации для CITE_BIB_FILES говорится:

"CITE_BIB_FILES... Для использования этой функции вам нужны bibtex и perl, доступные в пути поиска..."