Redocly/redoc
1
1
Fork 0
mirror of https://github.com/Redocly/redoc.git synced 2024-11-14 12:56:34 +03:00
Code Issues Packages Projects Releases Wiki Activity
aaa3b3280c
redoc/docs/deployment/cli.md
Heather Cloward 6cbd96a24a
[GSoD]Reorganizes the quickstart into a deployment guide and quickstart (#1749) 
* Reorganizes the quickstart into a deployment guide and quickstart

* Minor edits

* fix: minor formatting issue

* fix: simplify phrasing

* Adds redirects, link to preview-docs docs, and other review edits

* remove IE polyfills as IE is no longer supported

Co-authored-by: Ivana Isadora Devcic <33730345+skadinna@users.noreply.github.com>
2021-11-23 16:07:56 +11:00

3.4 KiB
Raw Blame History

title redirectFrom
Using the Redoc CLI
/docs/quickstart/cli/

Using the Redoc CLI

With Redoc's command-line interface you can bundle your OpenAPI definition and API documentation (made with Redoc) into a zero-dependency HTML file and locally render your OpenAPI definition with Redoc.

Step 1 - Install Redoc CLI

You can install the redoc-cli package globally using one of the following package managers:

Or you can install redoc-cli using npx.

Install Redoc CLI with yarn

To install the redoc-cli package globally with yarn:

yarn global add redoc-cli

Install Redoc with npm

To install the redoc-cli package globally with npm:

npm i -g redoc-cli

Install with npx

To install the redoc-cli package locally with npx, navigate to your project directory in your terminal, then use the following command:

npx redoc-cli

Step 2 - Use the CLI

Redoc CLI commands

The CLI includes the following commands:

  • redoc-cli serve [spec]: Starts a local server with Redoc. You must include the required parameter, spec, which is a reference to an OpenAPI definition. Options include:
    • --ssr: Implements a server-side rendering model.
    • --watch: Automatically reloads the server while you edit your OpenAPI definition.
    • --options: Customizes your output using Redoc options. To add nested options, use dot notation.
  • redoc-cli bundle [spec]: Bundles spec and Redoc into a zero-dependency HTML file. Options include:
    • -t or --template: Uses custom Handlebars templates to render your OpenAPI definition.
    • --templateOptions: Adds template options you want to pass to your custom Handlebars template. To add options, use dot notation.
  • --help: Prints help text for the Redoc CLI commands and options.
  • --version: Prints the version of the redoc-cli package you have installed.

Redoc CLI examples

Bundle

Bundle with the main color changed to orange:

redoc-cli bundle openapi.yaml --options.theme.colors.primary.main=orange

Bundle using a custom Handlebars template and add custom templateOptions:

redoc-cli bundle http://petstore.swagger.io/v2/swagger.json -t custom.hbs --templateOptions.metaDescription "Page meta description"

Sample Handlebars template:

<!DOCTYPE html>
<html>
    <head>
        <meta charset="utf8" />
        <title>{{title}}</title>
        <!-- needed for adaptive design -->
        <meta description="{{{templateOptions.metaDescription}}}">
        <meta name="viewport" content="width=device-width, initial-scale=1">
        <style>
            body {
            padding: 0;
            margin: 0;
            }
        </style>
        {{{redocHead}}}
        {{#unless disableGoogleFont}}<link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">{{/unless}}
    </head>
    <body>
      {{{redocHTML}}}
    </body>
</html>

Serve

Serve with the nativeScrollbars option set to true:

redoc-cli serve  openapi/dist.yaml --options.nativeScrollbars