API 蓝图参数名称未显示

Question

我是 API 蓝图的新手，所以请原谅我的天真。我正在尝试格式化一些参数，例如 Aglio 示例中给出的：

+ Parameters

    + name (optional, string, `alice`) ... Search for a user by name
    + joinedBefore (optional, string, `2011-01-01`) ... Search by join date
    + joinedAfter (optional, string, `2011-01-01`) ... Search by join date

但是，参数名称显示的只是参数的索引。这是来自 Atom API-Display 包的显示：https://atom.io/packages/api-blueprint-preview。

如何让它显示参数的名称？

Answer 1

蓝图的sn-p看起来还可以。只是为了 - 你能分享用于定义相应资源的 URI 模板吗？ URI 模板应包含如下内容：

{?name,joinedBefore,joinedAfter}

例如

# Resource [/resource{?name,joinedBefore,joinedAfter}]

但蓝图再次看起来不错，因此可能是 Aglio 或预览包本身的问题。最好通过https://github.com/danielgtaylor/aglio/issues?state=open或https://github.com/danielgtaylor/atom-api-blueprint-preview/issues查看和报告。