【问题标题】:How to localize OpenApi3 api definition to several languages?如何将 OpenApi3 api 定义本地化为多种语言?
【发布时间】:2018-02-04 10:43:18
【问题描述】:

我将我的 API 定义为 OpenAPI3 文档,并且我使用 Swagger UI 作为查看器。现在所有的“描述”字段都是英文的。但我需要支持多种语言的 API 文档(例如英语和俄语)。

如何将 OpenAPI3 文档本地化为多种语言?是否存在一些标准机制或者唯一可能的方法是为这个问题编写我自己的自定义解决方案?

【问题讨论】:

  • “写一些自行车解决方案”这是什么意思?
  • 这意味着,我应该为这个问题编写自己的自定义解决方案,因为标准机制不存在
  • 你真的应该避免这样的成语,它们绝对不是全球公认的。
  • 好的,抱歉。我解决了问题
  • OpenAPI 规范存储库中的相关讨论:github.com/OAI/OpenAPI-Specification/issues/274

标签: swagger-ui openapi


【解决方案1】:

我相信这个扩展可能是一个解决方案(未经测试):https://www.npmjs.com/package/swagger-i18n-extension

据我了解,这需要使用 JS 在旅途中额外重新翻译 YAML 文件,因此我不确定它能否与 Swagger UI 无缝协作。

【讨论】:

    猜你喜欢
    • 2020-01-03
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    • 2018-12-13
    • 1970-01-01
    • 2016-03-01
    • 1970-01-01
    • 2011-07-22
    相关资源
    最近更新 更多