Redocly/redoc
1
1
Fork 0
mirror of https://github.com/Redocly/redoc.git synced 2024-12-04 14:23:43 +03:00
Code Issues Packages Projects Releases Wiki Activity
d724440085
redoc/cli
History
Waldir Pimenta eba55124c9
docs: improve the redoc cli README (#1679) 
- Break some long lines
- Add some articles (the, a)
- Add a couple links for additional context
- Expand the SSR acronym
- Describe what --watch does
2021-07-09 10:25:52 +03:00
..
.npmignore chore: fix .npmignore 2018-03-21 18:02:25 +02:00
Dockerfile doc: fix some typos (#1117) 2019-12-10 08:13:37 +02:00
index.ts chore: upgrade dependencies (#1634) 2021-06-02 15:53:36 +03:00
npm-shrinkwrap.json chore(cli): v0.12.1 2021-06-09 17:25:34 +03:00
package.json chore(cli): v0.12.1 2021-06-09 17:25:34 +03:00
README.md docs: improve the redoc cli README (#1679) 2021-07-09 10:25:52 +03:00
template.hbs feat(cli): add disableGoogleFont parameter to cli (#1045) 2019-09-25 18:14:21 +02:00

README.md

redoc-cli

ReDoc's Command Line Interface

Installation

You can use redoc-cli by installing the package globally, or using npx.

Usage

The two following commands are available:

  • redoc-cli serve [spec] - starts the server with spec rendered with ReDoc. Supports a server-side rendering mode (--ssr), and can watch the spec (--watch) to automatically reload the page whenever it changes.
  • redoc-cli bundle [spec] - bundles spec and ReDoc into a zero-dependency HTML file.

Some examples:

  • Bundle with the main color changed to orange:
    $ redoc-cli bundle [spec] --options.theme.colors.primary.main=orange
  • Serve with the nativeScrollbars option set to true:
    $ redoc-cli serve [spec] --options.nativeScrollbars
  • Bundle using a custom Handlebars template (check the default template for an example):
    $ redoc-cli bundle [spec] -t custom.hbs
  • Bundle using a custom template and add custom templateOptions:
    $ redoc-cli bundle [spec] -t custom.hbs --templateOptions.metaDescription "Page meta description"

For more details, run redoc-cli --help.