生成HTML文件时输入参数？

Question

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

是否有任何方式发送每个HTML文件生成的基本URL？

Answer 1

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

就我而言，我使用了大量的文件：

• 一个顶层的文件（例如V1.md），包含Metadata和全面介绍了API每个资源
• 一个文件（例如AuthResource.md， UserResource.md），其中我仅记录该资源的功能

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

对于您的情况，您可能能够使用之前的客户特定文件或特定于环境的文件的顶层文件。将元数据移至特定于客户的文件，并使其包含顶级文件。然后，您可以将每个客户特定的文件呈现为HTML。