Doxygen 表绘图

Question

我想在文档中插入一个 ASCII 艺术表（如下所示）。doxygen 的 Markdown 功能挡住了一切，把它搞砸了。我试过 HTML 表，它们很好，但源文档变得不可读。

我可以以某种方式让 doxygen 不处理某个部分但仍将其包含在输出文件中吗？类似于此处 4 个空格允许以固定宽度字体插入已格式化的文本。

 |-------------|-------------------------|---------------|
 |AUTO_NEW_OFF | Entry action            | LED_FLASH     |
 |             |                         | SEQ_OFF       |
 |-------------|-------------------------|---------------|
 |             | eXit action             |               |
 |-------------|-------------------------|---------------|
 |             |                         |               |
 |-------------|-------------------------|---------------|
 | OFF         | SEQ complete            |               |
 |-------------|-------------------------|---------------|

---

我想我已经可以自己回答这个问题了。

围栏代码块 (3 x ~) 功能似乎工作正常

~~~
|-------------|-------------------------|---------------|
| MAN_NEW_OFF | Entry action            | LED_FLASH     |
|             |                         | SEQ_OFF       |
|-------------|-------------------------|---------------|
~~~

Answer 1

对隔离代码的改进是用 doxygen 命令@verbatim和包围表格@endverbatim。

如果您使用“代码”样式，无论是 markdown~~~还是 doxygen @code，当前或未来版本的 Doxygen 有可能会开始尝试在语法上对其进行着色。