Doxygen 表：创建在源代码中有换行符的表

Question

/**
 * | A | B |
 * | - | - |
 * | 123 | This should be a long line with
 * a line break without breaking the table |
 * | A further | row |
 */

Doxygen 在“with”之后停止表解析。我怎样才能防止这种行为？

Answer 1

我发现对表格使用标记不够方便。如果你从at切换到html，那么你将不会有任何需要打破的问题。 我在 Doxyfile 中为我的表创建了以下别名以简化代码：

"table_start_b{1}=<table><caption align= bottom>\1</caption>" \
"table_start_t{1}=<table><caption align= top>\1</caption>" \
"table_end=</table>" \
"table_h2{2}=<tr><th>\1</th><th>\2</th></tr>" \
"table_row2{2}=<tr><td align= center>\1</td><td align= center>\2</td></tr>" \

并按如下方式使用它：

\table_start_t{Abbreviations}
    \table_h2{ 
               Acronym , 
               Description }
    \table_row2{ "TBD" , "To be 
                          defined" }
\table_end

在任何地方换行都没有问题。

Answer 2

不理想但仍有可能。标记可读，最终结果也不错。

/**
 * | A | B |
 * | - | - |
 * | 123 | This should be a long line with
 * |     | a line break without breaking the table |
 * | A further | row |
 */