Re: [Doxygen-users] problem with backslash in markdown
Brought to you by:
dimitri
From: Yngve I. L. <yng...@es...> - 2015-11-25 11:58:24
|
<html> <head> <meta content="text/html; charset=utf-8" http-equiv="Content-Type"> </head> <body bgcolor="#FFFFFF" text="#000000"> Hi,<br> <br> Thanks for the suggestion. Yes that works, but the same readme file is also used by e.g. the web page of the git repository. This web page only understands markdown, not doxygen commands.<br> <br> My solution in the end was to rename the example scripts. I still think this is somehow incorrect behaviour by doxygen though.<br> <br> Cheers,<br> Yngve<br> <br> <div class="moz-cite-prefix">On 24/11/15 20:05, Albert wrote:<br> </div> <blockquote cite="mid:CAB...@ma..." type="cite"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <div dir="ltr"> <div>Yngve,<br> </div> <div><br> When there is is no objection to using normal doxygen commands you could use \code and \endcond or \verbatim \endverbatim<br> <br> </div> Albert<br> </div> <div class="gmail_extra"><br> <div class="gmail_quote">On Tue, Nov 24, 2015 at 12:05 PM, Yngve Inntjore Levinsen <span dir="ltr"><<a moz-do-not-send="true" href="mailto:yng...@es..." target="_blank"><a class="moz-txt-link-abbreviated" href="mailto:yng...@es...">yng...@es...</a></a>></span> wrote:<br> <blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"> <div bgcolor="#FFFFFF" text="#000000"> Hi all,<br> <br> I am having an issue with backslash in markdown file which I am starting to wonder if is a bug. My README.md which I want to include as front page looks like this (simplified to make it clear):<br> <br> <blockquote type="cite"># MyCode Version 1.0.0<br> <br> <br> ## INSTALLATION INSTRUCTIONS<br> <br> The compiling is based on CMake. To build the executables, run<br> ```<br> mkdir build<br> cd build<br> cmake ..<br> make<br> ```<br> <br> ## EXAMPLES<br> <br> <br> Run examples by typing:<br> ```<br> build\mycode examples\<a moz-do-not-send="true" href="http://example1.in" target="_blank">example1.in</a><br> ```<br> and<br> ```<br> build\mycode examples\<a moz-do-not-send="true" href="http://example2.in" target="_blank">example2.in</a><br> ```<br> <br> Some other information...</blockquote> <br> The trouble here I suspect, is that \example <file> is a <a moz-do-not-send="true" href="http://www.stack.nl/%7Edimitri/doxygen/manual/commands.html#cmdexample" target="_blank">command in Doxygen</a>. Doxygen thinks I want to include files <a moz-do-not-send="true" href="http://1.in" target="_blank">1.in</a> and <a moz-do-not-send="true" href="http://2.in" target="_blank">2.in</a> as examples (?). I should escape this by using \\ if I understand correctly. This does work in markdown if I do it outside the 'code-block', but inside the code block I then see two backslash also in the generated output. I tried to find a way to globally ignore backslash in doxygen (and only rely on @), but I could not find that.<br> <br> Could someone perhaps help me explain what I do wrong?<br> <br> Cheers,<br> Yngve<br> <br> </div> <br> ------------------------------------------------------------------------------<br> Go from Idea to Many App Stores Faster with Intel(R) XDK<br> Give your users amazing mobile app experiences with Intel(R) XDK.<br> Use one codebase in this all-in-one HTML5 development environment.<br> Design, debug & build mobile apps & 2D/3D high-impact games for multiple OSs.<br> <a moz-do-not-send="true" href="http://pubads.g.doubleclick.net/gampad/clk?id=254741551&iu=/4140" rel="noreferrer" target="_blank">http://pubads.g.doubleclick.net/gampad/clk?id=254741551&iu=/4140</a><br> _______________________________________________<br> Doxygen-users mailing list<br> <a moz-do-not-send="true" href="mailto:Dox...@li...">Dox...@li...</a><br> <a moz-do-not-send="true" href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" rel="noreferrer" target="_blank">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br> <br> </blockquote> </div> <br> </div> </blockquote> <br> </body> </html> |