生成HTML文件時輸入參數？

Question

我目前正在與aglio合作爲幾個不同的服務組生成API規範。我現在面臨的問題是我想將規範部署到多個環境（針對不同的消費者羣體），因此顯示的基本URL需要不同。

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

Answer 1

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

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

• 一個頂層的文件（例如V1.md），包含Metadata和全面介紹了API每個資源
• 一個文件（例如AuthResource.md， UserResource.md），其中我僅記錄該資源的功能

頂層文件具有每個資源文件的include語句。在Aglio中，我只選擇頂層文件。

對於您的情況，您可能能夠使用之前的客戶特定文件或特定於環境的文件的頂層文件。將元數據移至特定於客戶的文件，並使其包含頂級文件。然後，您可以將每個客戶特定的文件呈現爲HTML。