doxygen-users

[Doxygen-users] Images not included in LaTeX output with Markdown File

[Michael J. <imi...@gm...>]

I am using the latest version of DOxygen on OS X 10.6.8 to write my project's documentation. We are switching to writing everything in Markdown and while the HTML renders just fine the LaTeX->PDF does not include my images. I believe I have everything correct in all the files but I can not figure out what the issue might be. Has anyone else ever encountered this issue before?

Thanks
----
Mike Jackson

Re: [Doxygen-users] Images not included in LaTeX output with Markdown File

[Stefan P. <ste...@gm...>]

Am 04.04.2013 14:58, schrieb Michael Jackson:
> I am using the latest version of DOxygen on OS X 10.6.8 to write my project's documentation. We are switching to writing everything in Markdown and while the HTML renders just fine the LaTeX->PDF does not include my images. I believe I have everything correct in all the files but I can not figure out what the issue might be. Has anyone else ever encountered this issue before?
>

How do you include the images?

There is a separate image tag for HTML and for LaTeX.

Latest versions of LaTeX support PNG images, but doxygen needs them to 
be PS.

You can use PNG in LaTeX with doxygen, see 
http://sourceforge.net/p/ultradefrag/code/4069/tree/release/doc/handbook/05_gui.dox


--
Stefan P.

Top-posting:
A: Because it messes up the order in which people normally read text.
Q: Why is top-posting such a bad thing?
A: Top-posting.
Q: What is the most annoying thing in e-mail?

Re: [Doxygen-users] Images not included in LaTeX output with Markdown File

[Michael J. <imi...@gm...>]

On Apr 4, 2013, at 5:12 PM, Stefan Pendl wrote:

> Am 04.04.2013 14:58, schrieb Michael Jackson:
>> I am using the latest version of DOxygen on OS X 10.6.8 to write my project's documentation. We are switching to writing everything in Markdown and while the HTML renders just fine the LaTeX->PDF does not include my images. I believe I have everything correct in all the files but I can not figure out what the issue might be. Has anyone else ever encountered this issue before?
>> 
> 
> How do you include the images?
> 
> There is a separate image tag for HTML and for LaTeX.
> 
> Latest versions of LaTeX support PNG images, but doxygen needs them to 
> be PS.
> 
> You can use PNG in LaTeX with doxygen, see 
> http://sourceforge.net/p/ultradefrag/code/4069/tree/release/doc/handbook/05_gui.dox
> 
> 
> --
> Stefan P.


After reducing the problem as much as I could I came to the determination that if I need images I need to do the following:

![](Images/picture.png)
@image latex Images/picture.png

Which slightly messes up the viewing of the Markdown in most viewers but I guess I can live with that. I even tried the following:

<!--
@image latex Images/picture.png
-->

But DOxygen smartly interprets that as a true comment and skips it. 

My question, is this a bug or a feature of DOxgyen.

Thanks
---
Mike Jackson

Re: [Doxygen-users] Images not included in LaTeX output with Markdown File

[Stefan P. <ste...@gm...>]

Am 04.04.2013 23:23, schrieb Michael Jackson:
>
> After reducing the problem as much as I could I came to the determination that if I need images I need to do the following:
>
> ![](Images/picture.png)
> @image latex Images/picture.png
>
> Which slightly messes up the viewing of the Markdown in most viewers but I guess I can live with that. I even tried the following:
>
> <!--
> @image latex Images/picture.png
> -->
>
> But DOxygen smartly interprets that as a true comment and skips it.
>

Bug or feature is subject to be answered by Dimitri.

I would use @latexonly/endlatexonly and use my own image placement for 
LaTeX instead of the one provided by doxygen.

The comment is working correctly.

Sorry of being rather less help for markdown, since I just use HTML and 
if things go astray in LaTeX, I use LaTeX directly.


--
Stefan P.

Top-posting:
A: Because it messes up the order in which people normally read text.
Q: Why is top-posting such a bad thing?
A: Top-posting.
Q: What is the most annoying thing in e-mail?