web-dev-qa-db-fra.com

Comment obtenir un seul document PDF de Doxygen?

Lorsque je génère de la documentation Doxygen au format PDF, j'obtiens de nombreux fichiers différents avec un seul diagramme dans chacun.
Est-il possible d'obtenir un seul document PDF, organisé comme un livre, à peu près comme la version HTML?
Est-il possible de l'obtenir automatiquement, c'est-à-dire sans traiter manuellement les fichiers latex?

Merci!

pdfpdf-generationdoxygendocumentation-generationpdflatex
37
Pietro

Voir Conversion d'un document LaTeX en un PDF .

Lorsque Doxygen a terminé le traitement, dans le répertoire latex, il y a un fichier appelé "refman.tex".

Il existe trois façons d'utiliser ce fichier pour sortir "un livre" de Doxygen:

  • LaTeX -> dvips -> ps2pdf

    myfile latex

    dvips monfichier

    ps2pdf myfile.ps

  • LaTeX -> dvipdfm

    myfile latex

    dvipdfm monfichier

  • pdflatex (ou pdftex pour TeX ordinaire)

    pdflatex myfile

38
synthesizerpatel

En utilisant Doxygen 1.8.4+ (sous Windows), il existe également un script make.bat pour que vous n'ayez même pas besoin d'ouvrir la ligne de commande.

  1. Configurez Doxygen pour la sortie LaTeX.

    GENERATE_LATEX = YES LATEX_OUTPUT = latex OUTPUT_DIRECTORY =

  2. Configurez toutes vos images pour la sortie LaTeX.

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

  3. Exécutez Doxygen.

  4. Courir {OUTPUT_DIRECTORY}\{LATEX_OUTPUT}\make.bat.
  5. Ouvert {OUTPUT_DIRECTORY}\{LATEX_OUTPUT}\refman.pdf.

Si refman.pdf n'est pas créé, exécutez make.bat à partir d'une fenêtre de commande et lisez les erreurs.

Erreurs comme: 'pdflatex' is not recognized as an internal or external command,... Signifie que vous n'avez pas prérequis pour exécuter du latex. D'autres erreurs peuvent être dues à des packages latex manquants ou à des bogues doxygen provoquant des fichiers .tex invalides.

Une fois que vous avez installé tous les prérequis et une bonne version de doxygen, la procédure la plus simple devrait fonctionner à chaque fois.

16
Denise Skidmore

Patel a raison - vous devez exécuter Doxygen, puis Latex pour créer le document unique.

Pour moi, en utilisant Doxygen 1.7.3, le fichier racine de la construction en latex semble être "refman.tex".

Doxygen crée également un Makefile, donc si vous avez make (je ne l'ai pas sur ma boîte Win7), vous pouvez simplement taper make dans le répertoire latex.

Je pointe mon application TeXnicCenter sur refman.tex et je crée de cette façon.

J'espère que cela t'aides,

-Mat

11
Matt

En supposant que doxygen est correctement configuré, sous Linux:

doxygen
cd latex
make

Le fichier généré sera refman.pdf sauf s'il est configuré autrement.

9
Owl

D'autres personnes n'ont pas mentionné de détail:

Pour que la route pdflatex fonctionne, votre répertoire de travail actuel doit être le dossier latex généré, sinon vous obtenez des erreurs comme doxygen.sty cannot be found.

4
kakyo