Doxygen: Comment intégrer des images sur la page principale pour tous les formats de sortie?

Je suis Doxygen 1.8.6 sur Ubuntu 14.04 pour générer la documentation de l'API C/C++ fichiers d'en-tête.

J'ai une première page en format markdown (fichier mainpage.md) et souhaitez intégrer une image (fichier logo.png) dans cette page.

Actuellement, je travail pour une sortie HTML, avec la structure de répertoire suivante:

 travail 
├── de la page d'accueil.md 
├── ressources 
│   └── logo.png 
└── html 
└── index.html

La façon la démarque dans mainpage.md intègre l'image, est:

![The Logo](../resources/logo.png)

Cela fonctionne, mais il repose sur le fait que le code HTML répertoire de sortie est d'un niveau vers le bas à partir du répertoire de travail, et (fwiw) qui n'est pas synchronisé avec l'emplacement de la mainpage.md fichier contenant la référence.

Je dois avouer que je n'ai pas essayer ce qui se passe avec d'autres formats de sortie
(destiné à des formats: HTML, PDF via LaTex, des pages de man, Eclipse), mais
ils peuvent travailler différemment w.r.t. leur répertoire de sortie et la référence vers le fichier image.

Mes questions sont:

  1. Faire le ci-dessus mentionné d'autres formats de sortie de travailler avec ce démarque de référence?
  2. Est-il plus le format de sortie de façon agnostique pour référencer le fichier image à partir de la page principale de markdown?

Andy

Avez-vous eu un coup d'oeil à IMAGE_PATH = ressources et ![Logo] logo.png) pour la version HTML? et à l' @commande image?
Veuillez également consulter la documentation n le chapitre sur les Démarques et sa mise en œuvre dans doxygen: stack.nl/~dimitri/doxygen/manual/markdown.html

OriginalL'auteur Andreas Maier | 2015-06-16

  1. 6

    Malheureusement vous avez besoin des images de multiples commandes pour faire ce travail. Latex nécessitera un fichier pdf compatible type d'image, les navigateurs web nécessitent généralement un autre type d'image, etc., ainsi, le commande image doit être émises à plusieurs reprises pour spécifier le fichier d'image pour chaque format

    \image html logo.png
\image latex logo.eps

    Les formats suivants sont pris en charge: html, latex, docbook et rtf.

    Vous pouvez utiliser les courts chemins si vous mettez vos images dans un dossier d'image et de spécifier l'emplacement dans votre configuration:

    IMAGE_PATH     = my_image_dir
    Est-il possible de redimensionner une image lorsqu'elle est reliée au travers de Markdown?
    pour le latex ou html? Pour le html: stackoverflow.com/questions/15975262/...
    pour le latex de dimensionnement voir la documentation Doxygen pour \image stack.nl/~dimitri/doxygen/manuelle/commandes.html#cmdimage
    Pas sûr si c'est contrôlable avec docbook ou rtf.
    voici le nouveau lien: doxygen.nl/manual/commands.html#cmdimage

    OriginalL'auteur Denise Skidmore