Verbal text in Table APT Doxia

Using Doxia APT format , I would like to include verbatim text or snippet inside a table.

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

      

However, since doxia verbatim text and macros both need to be non-indented and the table requires prior markup, I'm not sure if there is an easy way to accomplish this.

To be more specific, I am using Maven 3 to generate site documentation using apt docs. I would like to include multi-line JSON views in a table column.

As a workaround, each line is monospaced and some of the json characters have to be escaped, which is not easy to read or maintain (although the rendered page looks fine). For example:

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

      

Ideally, to keep the table readable, I would prefer to use a doxia snippet or similar macro to inject code dynamically, but could also use plain text. For example, I would like to do something like the following, which is not valid:

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

      

Is there a way to do this?

+3


source to share





All Articles