2012-07-09 71 views
4

我已經創建了一個.NET C#項目,我使用類似於///<summary>A summary...</summary>的塊來評論我想使用Doxygen進行文檔化。我建立了Doxygen,它運行了大約100個.tex文件和一個Makefile。如何運行Doxygen Makefile?

據我所知,Makefile是生成PDF格式文檔的關鍵,但是我沒有得到它的工作。

當我在Doxygen LaTeX輸出目錄中時,通過在終端中編寫來使用Mac來執行LaTeX和Doxygen位。

all: refman.pdf 

pdf: refman.pdf 

refman.pdf: clean refman.tex 
      pdflatex refman 
     makeindex refman.idx 
     pdflatex refman 
     latex_count=5 ; \ 
     while egrep -s 'Rerun (LaTeX|to get cross-references right)' refman.log && [ $$latex_count -gt 0 ] ;\ 
      do \ 
       echo "Rerunning latex...." ;\ 
       pdflatex refman ;\ 
       latex_count=`expr $$latex_count - 1` ;\ 
      done 


    clean: 
     rm -f *.ps *.dvi *.aux *.toc *.idx *.ind *.ilg *.log *.out *.brf *.blg *.bbl refman.pdf 

運行時,我得到以下信息:

MacBook-Pro-13:latex sehlstrom$ make 
rm -f *.ps *.dvi *.aux *.toc *.idx *.ind *.ilg *.log *.out *.brf *.blg *.bbl refman.pdf 
make: *** No rule to make target `refman.tex', needed by `refman.pdf'. Stop. 

我怎樣才能獲得Makefil事的工作?

+0

您是否首先運行doxygen?在Doxyfile中啓用了LaTeX輸出嗎?是否創建了'refman.tex'? – 2012-07-09 19:07:14

+0

@BenVoigt是的,我運行Doxygen,它給了我目標文件夾中大約100個.tex文件。 Doxygen也創建瞭如問題所示的Makefile。不會創建一個'refman.tex'文件 - 我必須創建該文件嗎?如果是這種情況,是否應該編寫一個特定的文檔來使Makefile兼容? – sehlstrom 2012-07-09 19:31:01

+0

我認爲這應該是由Doxygen產生的。 「doxygen」命令是否完成沒有錯誤? – 2012-07-09 19:34:15

回答

3

refman.tex應該由Doxygen創建。我剛剛測試了我的安裝版本,doxygen 1.7.2,並創建了refman.tex

確保您沒有設置任何選項,說明這是不應該有自己的索引的較大項目的組件。

+0

謝謝您花時間檢查!我重置了所有設置,並再次提供給它,現在它生成refman.tex文件。但是,運行make -f Makefile時,輸出爲4頁,沒有任何內容=/ – sehlstrom 2012-07-09 20:04:41

+0

@sehlstrom:並且您確實有HTML格式的內容?有幾個設置,例如'EXTRACT_PRIVATE_MEMBERS'或'EXTRACT_UNDOCUMENTED',可能導致幾乎所有的內容都消失,但它們應該同樣影響LaTeX和HTML。 – 2012-07-09 20:20:28

+0

HTML輸出很好,一切都在那裏。經過一段時間的測試,最後我收到一條錯誤消息,說明有什麼不對。對於包含在refman.tex中的所有.tex文件,我會在輸入行10上找到類似於此處的'LaTeX Warning:Reference'class_f_e_1_1solid2d_1_1_f_eplani4''。'refman.tex中的相應行看起來像這樣:\ input {class_f_e_1_1solid2d_1_1_f_eplani4}'。 – sehlstrom 2012-07-09 21:09:39