Aglio - API Blueprint - переменные пути не отображаются

Question

У меня есть план API, который выглядит примерно так:

## Organization Users [/organizations/{id}/Users]

         + Parameters

            + id (string, required) - path variable, id of the organization.


some text was here.

### Get Org Users [GET]

some text was here.

+ Request (application/json)

Когда я запускаю Aglio с чем-то похожим на:

aglio --theme-variables streak  -i AppServices/Organizations.apib -o Build/AppServices.html

Я получаю вывод как:

Обратите внимание, что переменные пути просто отсутствуют.

Другие факты:

1. При генерации вывода aglio не выводит предупреждение
2. План API проверяет нормально.
3. Я перепробовал все темы, которые может предложить Аглио, тот же результат.

Answer 1

Кайл Фуллер ( https://github.com/kylef) ответил на мой вопрос о проблемах Aglio с github:

Раздел параметров предназначен неверно и поэтому отображается как необработанное описание уценки.

Я думаю, что вы хотите что-то вроде:

## Organization Users [/organizations/{id}/Users]

+ Parameters
    + id (string, required) - path variable, id of the organization.

some text was here.

### Get Org Users [GET]

some text was here.

+ Request (application/json)