Hugo短代码不呈现规范文件

Question

我试图使用Hugo Docsy SwaggerUI短程序呈现一个美洲国家组织文件，但呈现的页面不包含预期的结果。

这是我的rest-api.md文件：

---
title: "REST API"
linkTitle: "REST API"
date: 2021-02-21
weight: 2
description: >
  REST API described using OpenAPI Specification.
---

{{< swaggerui src="http://localhost:1313/access.yaml" >}}

下面是呈现的页面：

​

​

如您所见，HTML包含以下脚本，试图呈现美洲国家组织文件：

  var resolveUrl = function () {
    var passedUrl = 'http:\/\/localhost:1313\/access.yaml';
    var baseUrl = '\/\/localhost:1313\/'.replace(/\/$/, '');
    if (passedUrl.startsWith('/')) {
      return baseUrl + passedUrl;
    }
    return passedUrl;
  };
  window.onload = function () {
    const ui = SwaggerUIBundle({
      url: resolveUrl(),
      dom_id: '#ohpen_swagger_ui',
      presets: [
        SwaggerUIBundle.presets.apis,
        SwaggerUIStandalonePreset
      ]
    });
    window.ui = ui;
  };

需要注意的是，http://localhost:1313/access.yaml成功地解析为access.yaml文件。

是什么阻止了美洲国家组织文件的呈现？

Answer 1

我发现了我的错误。必须将type设置为页面正面的swagger。

这一页必须如下：

---
title: "REST API"
linkTitle: "REST API"
type: swagger
date: 2021-02-21
weight: 2
description: >
  REST API described using OpenAPI Specification.
---

{{< swaggerui src="http://localhost:1313/access.yaml" >}}

在Hugo作为静态文件服务的情况下，可以使用相对路径/access.yaml引用美洲国家组织文件。