Presidium Open Source

Importers


OpenAPI3

Presidium includes a Golang tool (presidium-oapi3) for importing your OpenAPI 3 spec into Presidium documentation.

  1. Install the presidium-oapi3 tool using Homebrew:
brew install SPANDigital/tap/presidium-oapi3

Example:

$ presidium-oapi3 convert -f <YOUR_API_SPEC> -o <THE_OUTPUT_DIRECTORY> -r <THE_PRESIDIUM_REFERENCE_URL>

The following options are available for presidium-oapi3:

OptionDescription
-n, --apiName stringThe name under which the generated docs will be grouped
-f, --file stringOpenAPI 3 spec file
-o, --outputDir stringThe output directory
-r, --referenceURL stringThe reference URL (default “reference”)
-h, --helphelp for convert