2012-07-12 29 views
47

Tôi đang cố gắng sử dụng \cite trong Doxygen để tạo trang thư mục và cũng là tham chiếu trong văn bản của tôi. Tôi có bibtex trong đường dẫn tìm kiếm của mình và tệp .bib thích hợp. Tôi đã thêm tệp .bib vào CITE_BIB_FILES và đang sử dụng nhãn BibTex phù hợp được tìm thấy trong tệp .bib. Doxygen đang tạo trang thư mục nhưng nó trống. Nó cũng tạo liên kết trích dẫn trong văn bản tài liệu, nhưng liên kết cũng trống. Bất kỳ ý tưởng làm thế nào tôi có thể nhận được các thông tin trích dẫn hiển thị?Doxygen cite tạo thư mục rỗng

+0

Bạn có tham số 'OUTPUT_DIRECTORY' trong bộ cấu hình của mình không? – pmr

+1

hệ điều hành nào bạn đang làm việc trên .. và bạn đang sử dụng công cụ nào. –

+0

Tôi có OUTPUT_DIRECTORY trong bộ cấu hình của mình. Tôi đang làm việc trên OS X (Mountain Lion) và tôi đã sử dụng thuật sĩ khi tôi gặp phải vấn đề trước đó. Lần này, tôi đã tự chỉnh sửa tập tin cấu hình trong Emacs và chạy 'doxygen Doxyfile'. Sau đó tôi đã biên dịch nguồn mủ ở dòng lệnh và kết quả là PDF tạo ra trích dẫn thích hợp. Tôi đoán vấn đề ban đầu của tôi liên quan đến một số vấn đề (có thể là do người dùng liên quan!) Với trình hướng dẫn. – user1401630

Trả lời

1

Khi bạn đặt CITE_BIB_FILES trong DoxyFile, bạn có bao gồm phần mở rộng .bib trên tên tệp không? Doxygen tuyên bố nó sẽ tự động thêm phần mở rộng .bib, nhưng nếu bạn bỏ qua doxygen dường như bị nhầm lẫn và không tạo tệp citelist.doc đúng cách.

Bao gồm .bib trong tên tệp và nó sẽ hoạt động tốt, ít nhất đó là trường hợp của tôi.

9

Tôi đang đối mặt với cùng một vấn đề. Có một phụ thuộc perl để tạo trích dẫn. Vì vậy, bạn phải có cả perl và bibtex trong đường dẫn hệ thống.

Bỏ qua ví dụ trên, mà chỉ áp dụng đối với cao su, để sử dụng doxygen (Lưu ý: không có dấu ngoặc):

\cite Hale 

tập tin Các .bib phải được nằm trong thư mục làm việc doxygen.

thư mục trang Tài liệu tham khảo HTML sau đó sẽ được sản xuất bởi doxygen với:

[1] J. K. Hale. Lý thuyết về phương trình vi phân chức năng. Springer-Verlag, Berlin-Heidelberg-New York, 1977.

cho mục Yếm sau:

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

điều này hữu ích cho tôi. Đã được bao quanh các phím với {}, bây giờ tôi nhớ không sử dụng chúng trong các ý kiến ​​doxygen. – ofloveandhate

2

lẽ muộn một chút, nhưng tôi đã có cùng một vấn đề. Doxygen tạo ra một thư mục cho đầu ra LaTeX, nhưng không phải cho đầu ra HTML và không có câu trả lời được đề xuất nào làm việc cho tôi.

Theo đề xuất của @Raffi, đây có vẻ là lỗi trong Doxygen < 1.8.3. Tôi đã sử dụng Doxygen 1.8.1.1 và nó không hoạt động. Sau đó, tôi cài đặt Doxygen 1.8.3.1 mà không thay đổi bất cứ điều gì khác và nó hoạt động tốt.

0

Để tạo thư mục, bạn cần cài đặt Perl và thêm nó vào đường dẫn tìm kiếm, cùng với bibtex. Trong tài liệu hướng dẫn cho CITE_BIB_FILES nó cho biết:

"CITE_BIB_FILES ... Để sử dụng tính năng này, bạn cần bibtex và perl có sẵn trong đường dẫn tìm kiếm ..."

1

Để \cite để hoạt động đúng bạn cần:

  • hãy chắc chắn để đưa file.bib bạn trong thư mục làm việc, nơi bạn gọi doxygen Doxyfile
  • bibtex thực thi phải nằm trong đường dẫn tìm kiếm
  • perl thực thi phải nằm trong đường dẫn tìm kiếm
  • các RefName được sử dụng trong \cite RefName phải có mục nhập tương ứng trong file.bib