生成HTML文件时输入参数?

Input parameters when generating HTML file?

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

有什么方法可以为每个 HTML 文件生成发送基 URL 吗?

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

就我而言,我使用了多个文件:

  • 一个顶级文件(例如V1.md),包含Metadata和对API
  • 的全面介绍
  • 每个资源一个文件(例如 AuthResource.mdUserResource.md),其中我仅记录该资源的功能

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

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