TE
TechEcho
Home24h TopNewestBestAskShowJobs
GitHubTwitter
Home

TechEcho

A tech news platform built with Next.js, providing global tech news and discussions.

GitHubTwitter

Home

HomeNewestBestAskShowJobs

Resources

HackerNews APIOriginal HackerNewsNext.js

© 2025 TechEcho. All rights reserved.

Generate API Documentation in AsciiDoc Format Using OpenAPI Generator

2 pointsby wing328hkover 5 years ago
Thanks &quot;man-at-home&quot; (https:&#x2F;&#x2F;github.com&#x2F;man-at-home) for contributing an AsciiDoc documentation generator to [OpenAPI Generator](https:&#x2F;&#x2F;github.com&#x2F;OpenAPITools&#x2F;openapi-generator). To generate API documentation in AsciiDoc format, please follow 3 simple steps below:<p>1. Download the Java JAR (https:&#x2F;&#x2F;oss.sonatype.org&#x2F;content&#x2F;repositories&#x2F;snapshots&#x2F;org&#x2F;openapitools&#x2F;openapi-generator-cli&#x2F;4.1.3-SNAPSHOT&#x2F;openapi-generator-cli-4.1.3-20190920.093941-26.jar)<p>2. Rename the JAR as &quot;openapi-generator-cli.jar&quot;<p>3. Run the following command to generate API documentation in AsciiDoc format for the Petstore API (https:&#x2F;&#x2F;raw.githubusercontent.com&#x2F;OpenAPITools&#x2F;openapi-generator&#x2F;master&#x2F;modules&#x2F;openapi-generator&#x2F;src&#x2F;test&#x2F;resources&#x2F;2_0&#x2F;petstore.yaml):<p>Mac&#x2F;Linux:<p>- java -jar openapi-generator-cli.jar generate -g asciidoc -i https:&#x2F;&#x2F;raw.githubusercontent.com&#x2F;OpenAPITools&#x2F;openapi-generator&#x2F;master&#x2F;modules&#x2F;openapi-generator&#x2F;src&#x2F;test&#x2F;resources&#x2F;2_0&#x2F;petstore.yaml -o &#x2F;var&#x2F;tmp&#x2F;asciidoc&#x2F;<p>Windows:<p>- java -jar openapi-generator-cli.jar generate -g asciidoc -i https:&#x2F;&#x2F;raw.githubusercontent.com&#x2F;OpenAPITools&#x2F;openapi-generator&#x2F;master&#x2F;modules&#x2F;openapi-generator&#x2F;src&#x2F;test&#x2F;resources&#x2F;2_0&#x2F;petstore.yaml -o C:\tmp\asciidoc<p>If you&#x27;ve any feedback or question, please let us know via https:&#x2F;&#x2F;github.com&#x2F;OpenAPITools&#x2F;openapi-generator&#x2F;issues&#x2F;new

no comments

no comments