GNOME Bugzilla – Bug 317328
Difficult to add citations and cross references.
Last modified: 2011-07-28 18:47:43 UTC
I would like to be able to add a bibliography to the documentation. Much of my work involves scientific codes which often reference papers written by many authors. It would be really great to be able to have a \cite tag in the manner of LaTeX which could be used in conjunction with a BibTeX database to add a line to the documentation such as "See: A. N. Other et. al. Proc. R. Soc. Blah. pp223" Currently I am doing this by hand, using a preprocessing stage which is of course error prone. Perhaps this could be done by subverting doxytag?
My graceful approach to this is embedding the standard LaTeX cite with the doxygen brackets \latexonly \cite{...} \endlatexonly in the source code, then calling doxygen in a script like this one: # using xr later on echo "EXTRA_PACKAGES = xr" >> Doxyfile doxygen Doxyfile # wherever the OUTPUT was put according to Doxyfile cd .../doc/latex # edit the refman.tex... sed 's+tableofcontents+tableofcontents \\bibliographystyle{alpha} \\bibliography{eso,all}+' refman.tex > tmp1.tex # supposed we're using xr.sty, further editing sed 's+makeindex+makeindex \\externaldocument[1-]{VLT-TRE-AOS-15753-0001} \\externaldocument[10-]{UL-TRE-AOS-15753-0010}+' tmp1.tex > refman.tex # pre-run bibtex pdflatex refman bibtex -terse refman rm refman.pdf make refman.pdf
*** This bug has been marked as a duplicate of bug 503239 ***