Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/shower/cli

Command line interface for Shower
https://github.com/shower/cli

cli shower

Last synced: about 1 month ago
JSON representation

Command line interface for Shower

Awesome Lists containing this project

README

        

# Shower CLI


Shower logo

**Command line interface for [Shower](http://shwr.me/)**

[![npm](https://img.shields.io/npm/v/@shower/cli.svg)](https://www.npmjs.com/package/@shower/cli)
[![Build Status](https://travis-ci.org/shower/cli.svg?branch=master)](https://travis-ci.org/shower/cli)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/shower/cli/blob/master/LICENSE.md)

## Quick Creating Slides

```sh
npx @shower/cli create my-slides
```

*([npx](https://medium.com/@maybekatz/introducing-npx-an-npm-package-runner-55f7d4bd282b) comes with npm 5.2+ and higher)*

## Installation

Install ShowerCLI using `npm`:
```bash
$ npm install --global @shower/cli
```

or via `yarn`:
```bash
$ yarn global add @shower/cli
```

The minimum supported Node version is `v8.0.0` by default.

**Note:** For easy creation of slides for one command,
we recommend installing the `@shower/cli` globally.
After the presentation is created, ShowerCLI
is added as dev-dependencies by default

## Usage:

```
shower [--version] [--help] [ []]

Options:
--cwd working directory to use [string] [default: $PWD]
-h, --help Show help [boolean]
-v, --version Show version number [boolean]
```

**`$ shower create []` - Create a new project**

```
Positionals:
directory [default: "slides"]

Options:
--yes, -y [boolean] [default: false]
```

**`$ shower serve` - Serve the presentation in development mode**

```
Options:
--open, -o Open browser [default: false]
--port, -p Listening Port [number] [default: 8080]
--ui Whether to run BrowserSync UI [default: false]
--notify Whether to show BrowserSync notifications [default: false]
```

**`$ shower bundle` - Gather the necessary files in a separate folder**

```
Options:
--output, -o In which folder will the bundled presentation be written
[string] [default: "bundled"]
--files, -f List of files that will get the build [array]
```

**`$ shower archive` - Create an archive of the bundled presentation**

```
Options:
--output, -o Archive name [string] [default: "presentation.zip"]
--files, -f List of files that will get the build [array]
```

**`$ shower pdf` - Converts the presentation to PDF**

The browser that [implements the Chrome Debugging Protocol](https://github.com/cyrus-and/chrome-remote-interface/#implementations) is required.
If you installed Chrome / Chromium to the custom path or use another browser, set PUPPETEER_EXECUTABLE_PATH environment variable.

```
Options:
--output, -o File name [string] [default: "index.pdf"]
```

**`$ shower publish` - Publish presentation with [GitHub Pages](https://pages.github.com/)**

```
Options:
--files, -f List of files that will get the build [array]
```

---
Licensed under [MIT License](LICENSE.md).