Кто-нибудь знает, есть ли версия raml2html для Raml 1.0? Я нашел только инструменты для Raml 0.8, например raml2html или raml2md, но не работает для Raml 1.0.Есть ли генератор Raml 1.0 (не 0.8) HTML?
ответ
Владелец raml2html и raml2md ушел, и два репозитория не находятся в обслуживании сейчас.
raml2html и raml2md зависит от raml2obj и raml2obj зависит от raml-parser, который поддерживает только 0,8 сейчас. Новый анализатор raml равен raml-js-parser-2, однако он все еще находится в состоянии бета-тестирования
raml2html 1.0, я думаю, все еще находится на экспериментальной фазе.
Существует трюк для raml2html для работы с файлами RAML 1.0, отключив проверку на парсере RAML.
Нам нужно изменить raml.loadFile(source)
вызов в raml2obj к raml.loadFile(source, {validate: false})
реф: 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 Это порождает Документация RESTful API, написанная в RAML и поддерживает 1,0
Возможно, вы уже знаете об этом, но да raml2html и raml2md 4.x работают с RAML 1.0.
Ну, владелец (я) искал новых сопровождающих, но так и не оставил. Репозитории все еще поддерживаются, хотя я все еще ищу новых сопровождающих и участников! –