Есть ли генератор HTML Raml 1.0 (не 0.8)?

Кто-нибудь знает, есть ли версия raml2html для Raml 1.0? Я нашел только инструменты для Raml 0.8, например raml2html или raml2md, но не работает для Raml 1.0.

Ответ 1

Владелец raml2html и raml2md ушел, и два репозитория теперь не находятся в обслуживании.

raml2html и raml2md зависят от raml2obj, а raml2obj зависит от raml-parser, который поддерживает только 0,8 прямо сейчас. Новый анализатор raml raml-js-parser-2, однако он все еще находится в бета-состоянии

Ответ 2

Вероятно, вы уже знаете об этом, но да raml2html и raml2md 4.x работают с файлами RAML 1.0.

Ответ 3

raml2html 1.0, я думаю, все еще находится на экспериментальной фазе.
Существует трюк для raml2html для работы с файлами RAML 1.0, отключив проверку на парсере RAML.

Нам нужно изменить вызов raml.loadFile(source) в raml2obj на raml.loadFile(source, {validate: false}) ref: https://github.com/raml2html/raml2html/issues/156

Эта ссылка поможет вам больше: http://forums.raml.org/t/recommended-tool-for-raml-1-0-to-html/1251/8

Может быть альтернативой инструменту raml2html здесь: https://github.com/PGSSoft/ramlo Он генерирует документацию API RESTful, написанную в RAML, и поддерживает 1.0