# include/exclude comment content - based on html vs. latex ?

3 messages
Open this post in threaded view
|
Report Content as Inappropriate

## include/exclude comment content - based on html vs. latex ?

 Hello, Doxygen-users,   In Doxygen 1.8.10 (on Windows), is there any way to have different portions of the Doxygen comment block appear depending on which output is generated?   I was producing only HTML, and so I had nice tables of thumbnail images that the user can click to open a full-size page of the image. But now that I’ve added PDF (well, Doxygen->LaTeX->PDF), verbiage such as “click the thumbnail” doesn’t make sense. I’m using the full-size image for the “\image latex” instead of what I use for the html output (an on the thumbnail that resolves to the full-size image).   As well, there are places where I’d like to simply refer people to a named section in the PDF, but in the HTML include an actual image.   I know that I could use separate Doxyfile config files and the ENABLED_SECTIONS to selectively enable parts of the comments based on their output (for example; __INCLUDE_PDF-ONLY_CONTENT__ and __INCLUDE_HTML-ONLY_CONTENT__), but then that’s yet another configuration file to keep in sync. So I’m hoping for some smarter way to get Doxygen comments into only one output format.   I do know about the \htmlonly and \latexonly commands, but then I really have to know how to deal with low-level LaTeX coding, which I’d prefer Doxygen took care of.   Thanks for any suggestions, -Monique   ------------------------------------------------------------------------------ _______________________________________________ Doxygen-users mailing list [hidden email] https://lists.sourceforge.net/lists/listinfo/doxygen-users
Open this post in threaded view
|
Report Content as Inappropriate

## Re: include/exclude comment content - based on html vs. latex ?

 At Mon, 22 Aug 2016 14:57:32 -0700 Monique Semp <[hidden email]> wrote: > > > > Hello, Doxygen-users, > > In Doxygen 1.8.10 (on Windows), is there any way to have different portions > of the Doxygen comment block appear depending on which output is generated? > > I was producing only HTML, and so I had nice tables of thumbnail images that > the user can click to open a full-size page of the image. But now that > I've added PDF (well, Doxygen->LaTeX->PDF), verbiage such as "click the > thumbnail" doesn't make sense. I'm using the full-size image for the > "\image latex" instead of what I use for the html output (an on > the thumbnail that resolves to the full-size image). > > As well, there are places where I'd like to simply refer people to a named > section in the PDF, but in the HTML include an actual image. You would just use \ref.  For either HTML or LaTeX. > > I know that I could use separate Doxyfile config files and the > ENABLED_SECTIONS to selectively enable parts of the comments based on their > output (for example; __INCLUDE_PDF-ONLY_CONTENT__ and > __INCLUDE_HTML-ONLY_CONTENT__), but then that's yet another configuration > file to keep in sync. So I'm hoping for some smarter way to get Doxygen > comments into only one output format. > > I do know about the \htmlonly and \latexonly commands, but then I really > have to know how to deal with low-level LaTeX coding, which I'd prefer > Doxygen took care of. Doxygen will *still* take of it.  You don't really have to deal with low-level LaTeX (or even HTML) coding, although there really isn't anything there anyway.   The \htmlonly and \latexonly don't mean those sections contain either HTML or LaTeX, only that those sections should only be processed for those specific output formats.  You would still use normal Doxygen commands.   For the most part, you don't actually use any low-level LaTeX coding -- in a sense, there isn't any such thing as "low-level LaTeX coding", since *LaTeX* is pretty much a high level thing. > > Thanks for any suggestions, > -Monique > MIME-Version: 1.0 > > ------------------------------------------------------------------------------ > > MIME-Version: 1.0 > > _______________________________________________ > Doxygen-users mailing list > [hidden email] > https://lists.sourceforge.net/lists/listinfo/doxygen-users> >                                                                                         -- Robert Heller             -- 978-544-6933 Deepwoods Software        -- Custom Software Services http://www.deepsoft.com/  -- Linux Administration Services [hidden email]       -- Webhosting Services                                   ------------------------------------------------------------------------------ _______________________________________________ Doxygen-users mailing list [hidden email] https://lists.sourceforge.net/lists/listinfo/doxygen-users