使用Doxia APT格式,我想在表格中包含逐字文本或片段。
*------------+----------------------------+
|| col1 || col2 |
*------------+----------------------------+
| some text | VERBATIM TEXT OR SNIPPET |
*------------+----------------------------+
但是,由于 doxia逐字文本和宏都必须是非缩进的,并且表格需要前面的标记,我不确定是否有一种简单的方法来实现这一点。
更具体地说,我使用 Maven 3 生成带有 apt 文档的站点文档。我想在表格列中包含多行 JSON 表示。
作为一种解决方法,每一行都是等宽的,并且必须对几个 json 字符进行转义,这不容易阅读或维护(尽管呈现的页面看起来很好)。例如:
*------------+----------------------------+
|| col1 || col2 |
*------------+----------------------------+
| some text | <<<\{>>>\ |
| | <<<\ "id":"12345",>>>\ |
| | <<<\ "name":"value">>>\ |
| | <<<\}>>> |
*------------+----------------------------+
理想情况下,为了保持表格的可读性,我更喜欢使用 doxia 片段或类似的宏来动态插入代码,但也可以使用逐字文本。例如,我希望能够执行以下无效的操作:
*------------+-----------------------------+
|| col1 || col2 |
*------------+-----------------------------+
| some text | %{snippet|url=example.json} |
*------------+-----------------------------+
有没有办法做到这一点?