0.0.1 • Published 4 years ago
presidium-oapi3 v0.0.1
Presidium OpenAPI 3
A Golang tool for importing your OpenAPI 3 spec into Presidium documentation.
Prerequisites
- npm 6+
Generation
This tool can be run as a:
- Standalone executable:
Part of your Presidium Project
Standalone
Install presidium-oapi3 globally usin npm
npm install -g presidium-oapi-3
Execute presidium-oapi3 will print the usage:
presidium-oapi3 -h
A Presidium tool that converts OAPI3 spec's to markdown
Usage:
presidium-oapi3 [flags]
presidium-oapi3 [command]
Available Commands:
convert Converts an OpenAPI 3 spec to markdown
help Help about any command
Flags:
-h, --help help for presidium-oapi3
Use "presidium-oapi3 [command] --help" for more information about a command.
To convert a file you simply:
presidium-oapi3 convert -f <YOUR_API_SPEC> -o <THE_OUTPUT_DIRECTORY> -r <THE_PRESIDIUM_REFERENCE_URL>
Part Of Your Project
Include as part of the npm build building your Presidium site as in the following sample:
...
"scripts" : {
"import-open-api-3" : "presidium-oapi3 convert -f <YOUR_API_SPEC> -o <THE_OUTPUT_DIRECTORY> -r <THE_PRESIDIUM_REFERENCE_URL>"
},
"devDependencies": {
"presidium-oapi-3" : "#.#.#"
}
...
0.0.1
4 years ago