3

Doxia APT形式を使用して、テーブル内に逐語的なテキストまたはスニペットを含めたいと考えています。

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

ただし、doxia の逐語的なテキストマクロはどちらもインデントされていない必要があり、表には前にマークアップが必要であるため、これを簡単に実現できる方法があるかどうかはわかりません。

具体的には、適切なドキュメントを含むサイト ドキュメントを生成するために Maven 3 を使用しています。テーブル列に複数行の JSON 表現を含めたいと考えています。

回避策として、各行を等幅にし、いくつかの json 文字をエスケープする必要があります。これは、読み取りや保守が容易ではありません (ただし、レンダリングされたページは問題なく表示されます)。例えば:

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

理想的には、テーブルの読みやすさを維持するために、doxia スニペットまたは同様のマクロを使用してコードを動的に挿入することを好みますが、逐語的なテキストを使用することもできます。たとえば、次のようなことができるようにしたいのですが、これは有効ではありません。

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

これを達成する方法はありますか?

4

0 に答える 0