2012-07-09 4 views
4

Я создал проект .NET C#, который я прокомментировал, используя блоки, похожие на ///<summary>A summary...</summary>, которые я хотел бы документировать, используя Doxygen. Я установил Doxygen, и он запускает генерацию около 100.tex-файлов и Makefile.Как запустить Doxygen Makefile?

Как я понял, Makefile является ключом к созданию документации в формате PDF, однако я не могу заставить ее работать.

Я использую Mac для выполнения бит LaTeX и Doxygen, написав в терминале, когда я вхожу в выходной каталог Doxygen LaTeX.

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? Является ли выход LaTeX включенным в Doxyfile? Существует ли 'refman.tex'? –

+0

@BenVoigt Да, я запустил Doxygen, и он дал мне около 100.tex-файлов в папке назначения. Doxygen также создал Makefile, как показано в вопросе. Файл 'refman.tex' еще не создан - мне нужно создать этот файл? Если это так, существует ли конкретный способ записи документа, чтобы сделать Makefile совместимым? – sehlstrom

+0

Я думаю, что это должно быть создано Doxygen. Закончилась ли команда doxygen без ошибок? –

ответ

3

refman.tex Предполагается, что вы создали Doxygen. Я только что тестировал свою версию, doxygen 1.7.2, и создал refman.tex.

Убедитесь, что вы не устанавливаете параметр, который говорит, что это компонент более крупного проекта, который не должен иметь собственный индекс.

+0

Спасибо, что нашли время, чтобы проверить! Я сбросил все настройки и снова дал его назад, и теперь он создает файл refman.tex. Однако при запуске make-f Makefile вывод состоит из 4 страниц без содержимого =/ – sehlstrom

+0

@sehlstrom: И у вас есть контент в формате HTML? Существует несколько настроек, таких как 'EXTRACT_PRIVATE_MEMBERS' или' EXTRACT_UNDOCUMENTED', которые могут привести к исчезновению почти всего содержимого, но они должны влиять как на LaTeX, так и на HTML одинаково. –

+0

Выход HTML в порядке, все есть. Протестировано немного, и, наконец, я получаю сообщение об ошибке, говорящее, что не так. Для всех .tex-файлов, которые должны быть включены в refman.tex, я получаю что-то вроде этого: «LaTeX Warning: Reference' class_f_e_1_1solid2d_1_1_f_eplani4 »на странице 5, не определено в строке ввода 10.' Соответствующая строка в refman.tex выглядит так: '\ input {class_f_e_1_1solid2d_1_1_f_eplani4} '. – sehlstrom

Смежные вопросы