Генерация PDF/HTML из вывода Doxygen Docbook

Doxygen 1.8.4 включает патч, добавляющий поддержку Docbook. Это можно включить с помощью GENERATE_DOCBOOK. Я пробовал это с существующей базой кода, и я могу создать каталог docbook, содержащий файлы xml.

  • Как я могу создать файл PDF из этого вывода?
  • Как я могу просмотреть вывод docbook в веб-браузере? Этот вопрос может быть не актуален, если контент будет идентичен стандартному выводу doxygen, но мне любопытно.

person GrandAdmiral    schedule 07.01.2014    source источник


Ответы (2)


Специализация Dockbook содержит множество преобразований XSL, включая HTML и XSL FO для получения PDF. Я бы посоветовал поискать в Docbook и загрузить их.

person Kevin Brown    schedule 07.01.2014

Простой способ:

  • Установить затмение
  • Перейдите на Eclipse Marketplace, найдите docbook и установите оттуда DEP4E.
  • Создать проект DocBook
  • Замените существующую документацию своей
  • Запустите build.xml — Ant спросит, в каких форматах публиковать книгу. Выберите PDF.
person Gangnus    schedule 31.01.2014
comment
Я установил DEP4E, но не вижу DocBook ни в одной из опций New-›Project. Я использую версию Eclipse CDT для Kepler SR1. - person GrandAdmiral; 31.01.2014
comment
Его нет в проекте. Он находится сразу в New item, у меня он над подпунктом Project - person Gangnus; 31.01.2014
comment
Но у меня это есть и в Project. Кеплер SR1 тоже. Вы перезапустили Eclipse? - person Gangnus; 31.01.2014
comment
Да, я перезапускал его несколько раз. Меню «Новое» начинается с «Проект Makefile с существующим кодом», «Проект C++», «Проект C» и «Проект...» DocBook не видно. - person GrandAdmiral; 31.01.2014
comment
Проверьте сведения об установке в справке. Первый (или последний) плагин должен быть DEP4E. Это? Если нет, то он не установлен. - person Gangnus; 01.02.2014
comment
Имя: DEP4E — функция, версия: 2013.10.2 установлена. - person GrandAdmiral; 01.02.2014
comment
У меня то же самое :-(. У вас свежая установка Eclipse или старая, с другими плагинами? Я начал со Standard Eclipse. Это выглядит как конфликты - person Gangnus; 01.02.2014