生成HTML文件时输入参数?
Input parameters when generating HTML file?
我目前正在使用 aglio 为几个不同的服务组生成 API 规范。我现在面临的问题是我想将规范部署到多个环境(针对不同的消费者群体),因此显示的基础 URLs 需要不同。
有什么方法可以为每个 HTML 文件生成发送基 URL 吗?
您可以使用 include 功能 <!-- include(OtherFile.md) -->
。
就我而言,我使用了多个文件:
- 一个顶级文件(例如
V1.md
),包含Metadata和对API 的全面介绍
- 每个资源一个文件(例如
AuthResource.md
、UserResource.md
),其中我仅记录该资源的功能
顶层文件对每个资源文件都有一个包含语句。在 Aglio 中,我 select 只有顶级文件。
在您的情况下,您可以在顶级文件之前使用特定于客户或特定于环境的文件。将元数据移动到客户特定的文件中,并让它们包含顶级文件。然后您可以将每个客户特定的文件渲染到 HTML.
我目前正在使用 aglio 为几个不同的服务组生成 API 规范。我现在面临的问题是我想将规范部署到多个环境(针对不同的消费者群体),因此显示的基础 URLs 需要不同。
有什么方法可以为每个 HTML 文件生成发送基 URL 吗?
您可以使用 include 功能 <!-- include(OtherFile.md) -->
。
就我而言,我使用了多个文件:
- 一个顶级文件(例如
V1.md
),包含Metadata和对API 的全面介绍
- 每个资源一个文件(例如
AuthResource.md
、UserResource.md
),其中我仅记录该资源的功能
顶层文件对每个资源文件都有一个包含语句。在 Aglio 中,我 select 只有顶级文件。
在您的情况下,您可以在顶级文件之前使用特定于客户或特定于环境的文件。将元数据移动到客户特定的文件中,并让它们包含顶级文件。然后您可以将每个客户特定的文件渲染到 HTML.