DOxygen无法很好地处理GitHub风格的标记文档,这些文档在转换为HTML时使用代码块和反标记
我一直在尝试让DOxygen正确格式化和输出标记文件,这些文件使用围栏代码块和回标记作为内联代码标记,就像我在GitHub上使用的那样 DOxygen的默认配置没有这些废话,所以我玩了“让我们看看这个设置有什么作用!”游戏。我还浏览了他们过去几年的bug报告,没有发现任何绕过我的问题的最终修复或配置,因为其中没有一个代码示例从我的角度起作用。此外,背景标记之间的内容会得到特殊的格式设置,但这不是您在SO和GH上经常看到的代码样式格式,例如,它没有DOxygen无法很好地处理GitHub风格的标记文档,这些文档在转换为HTML时使用代码块和反标记,html,markdown,codeblocks,doxygen,Html,Markdown,Codeblocks,Doxygen,我一直在尝试让DOxygen正确格式化和输出标记文件,这些文件使用围栏代码块和回标记作为内联代码标记,就像我在GitHub上使用的那样 DOxygen的默认配置没有这些废话,所以我玩了“让我们看看这个设置有什么作用!”游戏。我还浏览了他们过去几年的bug报告,没有发现任何绕过我的问题的最终修复或配置,因为其中没有一个代码示例从我的角度起作用。此外,背景标记之间的内容会得到特殊的格式设置,但这不是您在SO和GH上经常看到的代码样式格式,例如,它没有背景色。与我以前使用的字体相比,在查看文档时,不会
背景色
。与我以前使用的字体相比,在查看文档时,不会出现稍微不同的字体
问题的关键是让标记代码块中的DOxygen标识语法不完全破坏从代码块中的注释开始的文件输出。而不是像这样获取格式:
降价物品
#include <blarg>
/*!
* \brief brief description here
* \file filename.ext
*/
class ClassName{
private:
int magicnumber;
public:
void dostuff();
};
输出
降价**的东西** 这里简要介绍一下 ```#包括 /*!**
你能提供一个复制行为的例子吗?已完成更新,样本输出@albert
Markdown **stuff**
```
#include <blarg>
/*!
* \brief brief description here
* \file filename.ext
*/
class ClassName{
private:
int magicnumber;
public:
void dostuff();
};
```
Some `markdown` stuff