Дословный текст в Doxia APT Table - PullRequest
3 голосов
/ 28 марта 2012

Используя Doxia APT формат, я бы хотел включить дословный текст или фрагмент в таблицу.

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

Однако, поскольку doxia дословный текст и макросы оба должны быть без отступа , а таблица требует предыдущей разметки, я не уверен, что существует это простой способ сделать это.

Если говорить более конкретно, я использую Maven 3 для создания документации сайта с подходящими документами. Я хотел бы включить многострочные представления JSON в столбец таблицы.

В качестве обходного пути каждая строка имеет один пробел, и необходимо экранировать несколько символов json, что нелегко прочитать или сохранить (хотя отображаемая страница выглядит нормально). Например:

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

В идеале, чтобы поддерживать читабельность таблицы, я бы предпочел использовать фрагмент доксиа или подобный макрос для динамической вставки кода, но также мог бы использовать дословный текст. Например, я бы хотел бы , чтобы иметь возможность сделать что-то вроде следующего, что недопустимо:

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

Есть ли способ сделать это?

...