生成HTML文件时输入参数？

Question

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

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

Answer 1

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

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

• 一个顶级文件（例如V1.md），其中包含Metadata以及API的整体介绍
• 每个资源一个文件（例如AuthResource.md，UserResource.md），其中我只记录该资源的功能

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

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