aglio - 生成HTML文件时输入参数？

Question

我目前正在使用 aglio 为几个不同的服务组生成 API 规范。我现在面临的问题是我想将规范部署到多个环境（针对不同的消费者群体），因此显示的基本 URL 需要不同。

有没有办法为每个 HTML 文件生成发送一个基本 URL？

Answer 1

您可以使用包含功能<!-- include(OtherFile.md) -->。

就我而言，我使用了许多文件：

• 一个顶级文件（例如V1.md），包含元数据和 API 的总体介绍
• 每个资源一个文件（例如AuthResource.md, UserResource.md），我只记录该资源的功能

顶级文件对每个资源文件都有一个包含语句。在 Aglio 中，我只选择顶级文件。

在您的情况下，您可能能够在顶级文件之前使用特定于客户或特定于环境的文件。将元数据移动到客户特定文件并让它们包含顶级文件。然后，您可以将每个客户特定的文件呈现为 HTML。