Это приложение для Linux под названием Swagger2Markup, последний выпуск которого можно загрузить как Releasev1.3.4.zip. Его можно запустить онлайн на бесплатном хостинг-провайдере OnWorks для рабочих станций.
Загрузите и запустите онлайн это приложение под названием Swagger2Markup с OnWorks бесплатно.
Следуйте этим инструкциям, чтобы запустить это приложение:
- 1. Загрузил это приложение на свой компьютер.
- 2. Введите в нашем файловом менеджере https://www.onworks.net/myfiles.php?username=XXXXX с желаемым именем пользователя.
- 3. Загрузите это приложение в такой файловый менеджер.
- 4. Запустите онлайн-эмулятор OnWorks Linux или Windows или онлайн-эмулятор MACOS с этого веб-сайта.
- 5. В только что запущенной ОС OnWorks Linux перейдите в наш файловый менеджер https://www.onworks.net/myfiles.php?username=XXXXX с желаемым именем пользователя.
- 6. Скачайте приложение, установите его и запустите.
СКРИНШОТЫ:
Swagger2Разметка
ОПИСАНИЕ:
Основная цель этого проекта — упростить создание актуальной документации RESTful API путем объединения документации, написанной от руки, с автоматически созданной документацией API, созданной Swagger. В результате должно получиться актуальное, легко читаемое онлайн- и офлайн-руководство пользователя, сравнимое с документацией GitHub по API. Вывод Swagger2Markup можно использовать в качестве альтернативы пользовательскому интерфейсу swagger и использовать как статический контент. Swagger2Markup преобразует файл Swagger JSON или YAML в несколько документов AsciiDoc или GitHub Flavored Markdown, которые можно комбинировать с рукописной документацией. Исходный файл Swagger можно найти локально или удаленно через HTTP. Swagger2Markup поддерживает спецификации Swagger 1.2 и 2.0. Внутри он использует официальный парсер swagger и мой компоновщик документов разметки. Вы можете использовать Swagger2Markup, чтобы преобразовать ваш YAML-файл Swagger с контрактом в удобочитаемый формат.
Особенности
- Для проекта требуется как минимум JDK 8
- Вы можете использовать Swagger2Markup для преобразования файла Swagger YAML, связанного с первым контрактом, в удобочитаемый формат.
- Объедините это с рукописной документацией
- Вы можете выбрать подход «сначала код» и использовать Swagger2Markup вместе со Swagger JAX-RS.
- AsciiDoc предпочтительнее Markdown, так как у него больше возможностей
- Вы можете создавать документацию HTML5, PDF и EPUB с помощью asciidoctorj.
Язык программирования
Java
Категории
Это приложение также можно загрузить с https://sourceforge.net/projects/swagger2markup.mirror/. Он был размещен в OnWorks, чтобы его можно было легко запускать в Интернете с помощью одной из наших бесплатных операционных систем.