doxygen引用md文件
在doxygen中直接引用.md的文件名,文档生成过程中会自动将.md添加为一个子页面。
doxygen官方教程
md设置红色字体
md的标签中提供设置字体颜色的标签,需要使用HTML标签实现对字体颜色样式的变更(md兼容HTML)。
<font color='red'>text</font>
详细教程链接:markdown 语法之字体、字号、颜色以及背景色
doxygen生成.chm无法显示红色字体
doxygen生成.chm显示红色字体无效,但是使用Markdown编辑工具MarkdownPad显示正常。
在stack overflow找到设置字体HTML标签无效原因:
Similarly to Jakob’s answer, you can use HTML tags. Just a note that the
color
attribute offont
(<font color=...>
) is deprecated in HTML5. The following syntax would be HTML5-compliant:
This <span style="color:red">word</span>
is not black Same caution that Jakob made probably still applies:
对部分HTML标签的不兼容,造成.md在doxygen生成文档中无法正常显示。.md文件中的红色字体部分无法被正常显示HTML标签。
使用<span/>
替换<font/>
标签,如下:
<span style="color: red"> Some red text </span>
重新生成文档,.chm正常显示红色字体。
小结
如果想让.md的内容多种多样,除了熟练使用md标准的标签外,还要熟悉部分HTML标签,如果出现标签无法显示等问题,可以试着排除HTML标签错误导致的问题。