Aglio

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

我得到如下输出：

请注意，路径变量根本不存在。

其他事实：

aglio 在生成输出时未显示任何警告
API 蓝图验证良好。
我尝试了 aglio 提供的所有主题，结果相同。

Answer 1

Kyle Fuller (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)

Aglio - API 蓝图 - 路径变量未显示

Aglio - API Blueprint - Path variables not showing up

rest

apiblueprint