Doxia APT表中的逐字文本

时间:2012-03-27 23:43:19

标签: maven documentation doxia

使用Doxia APT格式,我希望在表格中包含逐字文字或摘要。

*------------+----------------------------+
|| col1      || col2                      |
*------------+----------------------------+
| some text  | VERBATIM TEXT OR SNIPPET   |
*------------+----------------------------+

但是,由于doxia verbatim textmacros都必须非缩进,并且该表需要先前的标记,我不确定是否存在简单的方法来实现这一目标。

更具体地说,我使用Maven 3生成包含apt文档的站点文档。我想在表格列中包含多行JSON表示。

作为一种解决方法,每行都是等宽的,并且必须对几个json字符进行转义,这不容易阅读或维护(尽管呈现的页面看起来很好)。例如:

*------------+----------------------------+
|| col1      || col2                      |
*------------+----------------------------+
| some text  | <<<\{>>>\                  |
|            | <<<\ "id":"12345",>>>\     |
|            | <<<\ "name":"value">>>\    |
|            | <<<\}>>>                   |
*------------+----------------------------+

理想情况下,为了保持表的可读性,我宁愿使用doxia片段或类似的宏来动态插入代码,但也可以使用逐字文本。例如,我喜欢能够做类似以下的事情,这是无效的:

*------------+-----------------------------+
|| col1      || col2                       |
*------------+-----------------------------+
| some text  | %{snippet|url=example.json} |
*------------+-----------------------------+

有没有办法实现这个目标?

0 个答案:

没有答案