问题标签 [aglio]

如何在 MSON 中指定数组应仅包含类型 A、B 或 C，而不包含任何其他类型？

我试过了

但是 aglio 生成的 JSON 模式只要求数组的第一个元素是 A 类型。

我无法使用 Aglio 的--server选项或与的选项和插件gulp配对来实时重新加载 LESS 和 Jade 文件。connectlivereloadgulp-aglio

这是由于缓存吗？或者是connect实时重装能力的限制？

使我的更改呈现的唯一方法是按 ctrl-C 并再次运行 gulp。

这是我的 gulpfile.js：

这是我的 apib 文档的片段。本质上，我希望能够在请求和响应部分之后放置其他描述性信息，但是不会呈现此信息。相反，新标题下的任何其他文本都被解释为响应 200 部分的一部分。我希望能够在错误部分中放置一个表格，因此理想情况下这些数据将被降价渲染。用 aglio 可以吗？谢谢！

我有一个带有多个参数的资源，以及一个带有额外参数的单个操作。我怎样才能用最少的重复来写这个？

像这样的东西，但实际上有效：

所有其他操作都应该列出type，而 GET 应该同时列出type和page。

如果我使用示例值定义资源类型，如何针对特定示例覆盖它们？

我试过了，但是渲染的输出忽略了 Body 并使用了全局 Sample 。

奇怪的是，如果您从模式中删除示例值，它会正确使用 Body 作为 Request 但对于 Response 它的每个字符串参数为"Hello, world!"，每个数字为1，等等。

当您使用二进制文件时 - 您有这样的选择：

但是如果我需要从 js 库做同样的事情呢？我检查了代码，它看起来没有这种可能性，但也许我错了。我可以从 js 代码中调用二进制文件，但对我来说这看起来有点过头了。Aglio 版本是 2.3.0

Api Blueprint MSON 中是否有任何 json 模式，例如 excel 表？

我正在几个客户之间设计一些api。所以我需要能够呈现为易于阅读的格式的 api 文档工具。我搜索这 3 个解决方案。（Swagger、RAML、Api 蓝图）。我决定使用 Api Blueprint 是因为它可以通过 markdown 呈现更丰富的形式。Api Blueprint 中的几乎所有功能都让我满意。但是 json 模式格式非常复杂且难以阅读。我希望我的结果 html 最终如下所示。（我使用 aglio 作为 Api Blueprint html 渲染器。）

这是我的apib源代码

我是 aglio 的新手，我试图为我的文档呈现属性，但它不起作用。

尝试使用 `aglio -i input.apib --theme-template Triple -o output.html 呈现此函数时，我看不到属性。为什么？

我希望它看起来像这样，您可以在其中看到参数和属性

我在 GitHub 问题线程中找到了这张图片

感谢您的帮助。

我有一个 API 蓝图，它是这样的：

当我用类似的东西运行 Aglio 时：

我得到如下输出：

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

其他事实：

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

在这里，我在名为的对象中定义了一个属性，Page Index它chartControllers必须是一个名为的对象数组chartController。

它为我提供了以下主体，这很好：

但！它为我提供了不完整的架构！它没有描述chartController。架构如下：

我该如何解决这个问题并看到chartController在模式中定义？