Как получить единый документ PDF из Doxygen?

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

Спасибо!


pdf pdf-generation pdflatex documentation-generation doxygen
person Pietro    schedule 04.11.2010    source источник

Ответы (6)


arrow_upward
43
arrow_downward

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

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

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

  • LaTeX -> dvips -> ps2pdf

    латекс myfile

    dvips myfile

    ps2pdf myfile.ps

  • LaTeX -> dvipdfm

    латекс myfile

    dvipdfm myfile

  • pdflatex (или pdftex для обычного TeX)

    pdflatex myfile

person synthesizerpatel    schedule 31.07.2011

arrow_upward
20
arrow_downward

Используя 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 из командного окна и прочтите ошибки.

Ошибки типа: _5 _... Означают, что у вас нет предпосылок для работы с латексом в все. Другие ошибки могут быть связаны с отсутствием пакетов latex или ошибками doxygen, вызывающими недопустимые файлы .tex.

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

person Denise Skidmore    schedule 23.01.2014
comment
make.bat создается версией Windows, в Linux сгенерированный файл называется Makefile. - person Étienne; 30.07.2014
comment
Вы должны пройти это, чтобы сделать, или это сценарий? - person Denise Skidmore; 30.07.2014
comment
Это выполняется make - person Étienne; 31.07.2014
comment
В Linux введите make в каталоге latex. Созданный документ - refman.pdf. - person nvd; 23.09.2014
comment
В моем случае все изображения, указанные через \ image, отсутствуют. Я что-нибудь упускаю? - person elgnoh; 28.04.2015
comment
Указываете ли вы отдельные команды изображений для вывода в латексном и html-формате? - person Denise Skidmore; 28.04.2015
comment
У вас должна быть отдельная команда изображения для каждого формата вывода: stack .nl / ~ dimitri / doxygen / manual / commands.html # cmdimage. - person Denise Skidmore; 28.04.2015
comment
Другой простой способ проверить - путь к изображению. stack.nl/~dimitri/doxygen/manual/config.html# cfg_image_path - person Denise Skidmore; 28.04.2015
comment
В Cygwin после запуска make я получаю сообщение об ошибке: pdflatex command not found. Есть идеи, как заставить его работать в Cygwin? - person Danijel; 20.02.2017
comment
Вы установили LaTeX? На пути к Cygwin? - person Denise Skidmore; 20.02.2017
comment
У меня это не сработало. Я запустил файл make.bat, но он не создал никакой выходной папки в папке latex - person Pete; 28.03.2018
comment
он распечатал какие-либо ошибки? запускать с консоли, а не дважды щелкать, чтобы вы могли видеть, что он выводит на экран. - person Denise Skidmore; 28.03.2018
comment
Он не создаст новую папку, только новый файл. Ваш вывод Doxygen должен выводить папку latex. Внутри папки latex находится ваш make.bat, и в той же папке вы должны найти refman.pdf. - person Denise Skidmore; 28.03.2018

arrow_upward
18
arrow_downward

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

doxygen
cd latex
make

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

person Owl    schedule 17.02.2015

arrow_upward
12
arrow_downward

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

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

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

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

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

-Матт

person Matt    schedule 20.12.2012
comment
Doxygen также имеет make.bat в системах Windows, и это Makefile (для * nix make) - person albert; 17.03.2020

arrow_upward
6
arrow_downward

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

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

person kakyo    schedule 04.04.2014

arrow_upward
1
arrow_downward

Я бы добавил еще один совет. Не игнорируйте предупреждения о латексе. pdflatex может не создать выходной файл, а также какие-либо значимые ошибки.

У меня была аналогичная неприятная ситуация, и простое исправление всех предупреждений помогло создать правильный выходной файл без каких-либо дополнительных проблем.

person Roargh    schedule 16.03.2020