为swagger设置本地编辑器

问题描述 投票:1回答:2

我打算用swagger写一些api文档,但网络ui对我来说似乎很破碎。我正在尝试设置它,以便我可以在我的本地计算机上的任何编辑器中编写,并在我的浏览器中自动重新加载结果(或者至少自动重建,以便我可以刷新以查看结果)。我可以看到有一些工具swagger codegenswagger ui,但这些似乎是相当复杂的工具,做了很多我不需要的东西,我无法弄清楚如何设置他们做我想要的。我还可以看到有一个VS Code的插件可以做到这一点,但我宁愿使用vim。

如果我只想要读取文本文件的内容并在每次文本文件更改时构建html,我该如何设置?

swagger documentation
2个回答
0
投票

为什么你不想和邮递员一起去。 Postman有许多功能,包括导出和导入API。但是如果您不想使用那个或任何其他工具,如您提到的swagger ui等,那么您可以构建自己的json文件,您可以使用它来每次构建您的html,这样如果您在json中更改任何内容,那么它将反映在您的网页上。


0
投票

我使用这个vscode plugin,它提供类似于在线编辑器的分屏视图,但在本地运行。

© www.soinside.com 2019 - 2024. All rights reserved.