Как получить один PDF-документ от Doxygen? - PullRequest
37 голосов
/ 04 ноября 2010

Когда я генерирую документацию Doxygen в формате PDF, я получаю множество различных файлов с одной диаграммой в каждом.
Можно ли получить один документ PDF, организованный как книга, примерно как HTML-версия?1002 * Можно ли получить его автоматически, то есть без ручного обращения с латексными файлами?

Спасибо!

Ответы [ 5 ]

38 голосов
/ 31 июля 2011

См. Преобразование документа LaTeX в документ PDF .

Когда Doxygen заканчивает обработку, в каталоге латекса появляется файл с именем 'refman.tex'.

Существует три способа использования этого файла для получения книги из Doxygen:

  • LaTeX -> dvips -> ps2pdf

    латекс myfile

    dvips myfile

    ps2pdf myfile.ps

  • LaTeX -> dvipdfm

    латекс myfile

    dvipdfm myfile

  • pdflatex (или pdftex для простого TeX)

    pdflatex myfile

15 голосов
/ 24 января 2014

Используя Doxygen 1.8.4+ (в Windows), также есть скрипт make.bat, поэтому вам даже не нужно открывать командную строку.

  1. Настройка Doxygen дляВыход LaTeX.

    GENERATE_LATEX = YES LATEX_OUTPUT = latex OUTPUT_DIRECTORY =

  2. Настройте все изображения для вывода LaTeX.

    \image html application.jpg \image latex application.eps "My application" width=10cm

  3. Выполнить Doxygen.

  4. Выполнить {OUTPUT_DIRECTORY}\{LATEX_OUTPUT}\make.bat.
  5. Открыть {OUTPUT_DIRECTORY}\{LATEX_OUTPUT}\refman.pdf.

Если refman.pdf не создан, запустите make.bat из командного окна и прочитайте ошибки.

Ошибки типа: 'pdflatex' is not recognized as an internal or external command, ... Означают, что у вас нет предпосылок для запуска латекса вообще.Другие ошибки могут быть связаны с отсутствующими пакетами из латекса или ошибками doxygen, вызывающими недопустимые файлы .tex.

После установки всех необходимых компонентов и хорошей версии doxygen более простая процедура должна работать каждый раз.

11 голосов
/ 20 декабря 2012

Патель прав - вам нужно запустить Doxygen, затем какой-нибудь Latex для создания единого документа.

Для меня, используя Doxygen 1.7.3, кажется, что корневой файл для латексной сборки выглядит так:refman.tex ".

Doxygen также создает Makefile, поэтому, если у вас есть make (у меня в Win7 нет), вы можете просто набрать make в каталоге латекса.

Я указываю свое приложение TeXnicCenter на refman.tex и строю таким образом.

Надеюсь, это поможет,

-Matt

9 голосов
/ 17 февраля 2015

Предполагая, что doxygen настроен правильно, в Linux:

doxygen
cd latex
make

Созданный файл будет refman.pdf, если не настроен иначе

4 голосов
/ 04 апреля 2014

Другие люди не упомянули детали:

Чтобы маршрут pdflatex работал, ваш текущий рабочий каталог должен быть сгенерированной латексной папкой, в противном случае вы получите такие ошибки, как doxygen.sty cannot be found.

...