从邮递员集合中创建HTML文档 [英] Creating html doc from postman collection

问题描述

我已经开发了一个漂亮的扩展API，并且在Postman上有它，效果很好。现在，我必须生成一个html文档，以使其在/ docs以及其源代码中保持版本。

I've developed a pretty extense API, and I have it on Postman, which works pretty nice. Now I have to generate an html doc to keep it versioned inside /docs along with my sources.

有没有工具或方法可以实现此目的？我真的不想写所有这些文档。

Is there a tool or a way to achieve this? I really don't want to write all this documentation. Sharing the postman collection is not an option.

推荐答案

我最近遇到了同样的问题，但没有发现任何问题。因此，我创建了一个简单的工具来执行此操作。这是一个用react.js编写的非常基本的javascript应用程序。目前，它非常基本，但是我正在研究它，因此欢迎任何功能请求。

I recently had the same problem and I did not find anything. So I created a simple tool to do it. It is a very basic javascript application written with react.js. At the moment it is very basic, but I'm working on it, so any feature request is welcome.

您可以在以下位置免费使用它：http://www.vernizzis.it/docman/

You can use it for free at: http://www.vernizzis.it/docman/

另外，您可以获得代码并在以下位置进行修改： https://github.com/davidevernizzi/docman

Plus you can get the code and modify it at: https://github.com/davidevernizzi/docman

欢迎任何评论。

UPDATE1：环顾四周，我还发现了这个项目： https://github.com/JakeWorrell/docodile
和以下功能请求： https://github.com/a85/POSTMan-Chrome-Extension/issues/204

UPDATE1: looking around I also found this project: https://github.com/JakeWorrell/docodile and this feature request: https://github.com/a85/POSTMan-Chrome-Extension/issues/204

UPDATE2：功能请求（请参阅UPDATE1）已关闭，创建文档的可能性已添加到Postman云中。以下是功能请求的结束注释：

UPDATE2: the feature request (see UPDATE1) has been closed and the possibility of creating documentation has been added to Postman cloud. Here is the feature request closing comment:

这可作为Postman Cloud的一部分使用：http://blog.getpostman.com/2015/12/10/introducing-postman-cloud/ 。云为所有人托管，更新和维护文档。我建议 http://docman.launchrock.com/ 和https://github.com/JakeWorrell/docodile ，用于从收藏集中生成一次性文档。

This is available as part of Postman Cloud: http://blog.getpostman.com/2015/12/10/introducing-postman-cloud/. Cloud hosts, updates and maintains documentation for everyone. I'd suggest http://docman.launchrock.com/ and https://github.com/JakeWorrell/docodile for generating one-time documentation from Collections.

这篇关于从邮递员集合中创建HTML文档的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！