2012-07-12 7 views
47

Ich versuche \cite in Doxygen zu verwenden, um eine Bibliographie Seite und auch eine Referenz in meinem Text zu produzieren. Ich habe Bibtex in meinem Suchpfad und eine richtige .bib Datei. Ich habe die .bib-Datei zu CITE_BIB_FILES hinzugefügt und verwende ein korrektes BibTex-Etikett, das in der .bib-Datei gefunden wird. Doxygen erstellt eine Bibliographie Seite, aber es ist leer. Es erstellt auch einen Verweis-Link im Dokumentationstext, aber der Link ist auch leer. Irgendeine Idee, wie ich die Zitierinformationen angezeigt bekomme?Doxygen cite produziert leere Bibliographie

+0

Haben Sie den Parameter 'OUTPUT_DIRECTORY' in Ihrem Konfigurationssatz? – pmr

+1

an welchem ​​Betriebssystem arbeiten Sie .. und für welches Tool verwenden Sie es. –

+0

Ich habe OUTPUT_DIRECTORY in meinem Konfigurationssatz. Ich arbeite an OS X (Mountain Lion) und ich habe den Assistenten verwendet, als ich zuvor auf Probleme stieß. Dieses Mal habe ich die Konfigurationsdatei selbst in Emacs bearbeitet und 'doxygen Doxyfile' ausgeführt. Ich kompilierte dann die Latexquelle an der Befehlszeile und die resultierende PDF-Datei erzeugte die richtige Literaturangabe. Ich vermute, dass mein ursprüngliches Problem mit einem Problem (möglicherweise benutzerbezogen!) Mit dem Assistenten zusammenhing. – user1401630

Antwort

1

Wenn Sie CITE_BIB_FILES in DoxyFile festlegen, haben Sie die Erweiterung .bib in den Dateinamen eingeschlossen? Doxygen behauptet, dass es automatisch die Erweiterung .bib hinzufügen wird, aber wenn Sie es weglassen, scheint doxygen verwirrt zu sein und erzeugt die Datei citelist.doc nicht richtig.

Include .bib im Dateinamen und es sollte gut funktionieren, zumindest das ist der Fall für mich.

9

Ich war mit dem gleichen Problem konfrontiert. Es gibt eine Perl-Abhängigkeit, um ein Zitat zu generieren. Sie müssen also sowohl Perl als auch Bibtex im Systempfad haben.

Ignorieren Sie das obige Beispiel, dass nur auf Latex gilt für doxygen Gebrauch (Hinweis: keine Klammern):

\cite Hale 

Die bib-Datei hat in doxygen Arbeitsverzeichnis befindet.

Bibliographische Referenzen HTML-Seite wird dann von doxygen erzeugt mit:

[1] J. K. Hale. Theorie funktionaler Differentialgleichungen. Springer-Verlag, Berlin-Heidelberg-New York, 1977.

für folgenden bib Eintrag:

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

das war hilfreich für mich. Umgab die Schlüssel mit {}, jetzt erinnere ich mich, sie nicht in doxygen Kommentaren zu verwenden. – ofloveandhate

2

Vielleicht ein wenig spät, aber ich hatte das gleiche Problem. Doxygen erzeugte eine Bibliographie für die LaTeX-Ausgabe, aber nicht für die HTML-Ausgabe und keine der vorgeschlagenen Antworten funktionierte für mich.

Wie von @Raffi vorgeschlagen, scheint dies ein Fehler in Doxygen < 1.8.3 zu sein. Ich habe Doxygen 1.8.1.1 benutzt und es hat nicht funktioniert. Dann habe ich Doxygen 1.8.3.1 installiert, ohne etwas anderes zu ändern, und es hat gut funktioniert.

0

Um eine Bibliografie zu erstellen, müssen Sie Perl installieren und zusammen mit bibtex zum Suchpfad hinzufügen. In der Dokumentation für CITE_BIB_FILES heißt es:

"Die CITE_BIB_FILES ... Um diese Funktion nutzen zu können, benötigen Sie bibtex und Perl im Suchpfad ..."

1

Damit \cite richtig funktioniert, benötigen Sie:

  • sicher sein, Ihre file.bib im Arbeitsverzeichnis zu setzen, wo Sie doxygen Doxyfile
  • bibtex ausführbare rufen im Suchpfad sein muss
  • perl ausführbare muss im Suchpfad
  • die RefName in \cite RefName muss einen entsprechenden Eintrag inhaben