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?
source to share
No one has answered this question yet
Check out similar questions: