生成HTML文件时输入参数？

Question

我目前正在与aglio一起为几个不同的服务组生成API规范。我现在面临的问题是，我希望将规范部署到多个环境(针对不同的使用者组)，因此显示的基本URL需要不同。

是否有任何方法可以为每个HTML文件生成发送一个基本URL？

Answer 1

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

在我的例子中，我使用了许多文件：

• 一个toplevel文件(例如V1.md)，包含元数据和API的总体介绍
• 每个资源只有一个文件(例如AuthResource.md、UserResource.md)，其中我只记录了该资源的功能

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

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