Есть ли генератор 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