npm install -g @deck/appOn Node 0.10 (with npm 1):
npm install -g deck-appSee https://github.com/nearform/deck-app-unscoped for how this scope polyfilling mechanism works
deck <command> [arguments]The @deck/app module acts as an entry point and CLI tool for deck.
To learn how to use the GUI (e.g. global hot keys) see https://github.com/nearform/deck-gui
A slide deck is a "content module": a folder with at least a
package.json and deck.md file.
deck initAnalogous to npm init, the deck init command provisions
a folder with the files that make up a slide deck.
deck installMuch like npm install when run without options deck install will install dependencies for a slide deck (generally we would do this after a deck init)
deck install <slide deck name>When a slide deck is specified, deck will use npm to download
and install the content module. Unlike an npm install, the resulting
slide deck folder will placed in the current working directory instead
of a node_modules folder. Otherwise all other npm behaviours apply (e.g. will lookup from repo as per npm config etc.)
deck present [<slide deck path>] [!]When run in a slide deck folder, this will build a presentation from the deck.md file in the current folder then open @deck/gui for viewing and presenting.
If a path to a slide deck is supplied it will likewise be presented.
A special syntax deck present ! instructs deck to present the
most recently installed content module.
deck edit [<slide deck path>]Opens a slide decks deck.md file in the default systen editor (as per the $EDITOR environment variable). If given a path the deck.md file at the supplied path will be opened, otherwise a deck.md in the current folder will be opened.
deck upstream [<slide deck path>]Creates a new branch on GitHub, pushes modified content and makes a pull request with the change.
The slide deck does not need to be a git repository for upstream
to function - however Github keys are required (see https://github.com/nearform/deck-upstream)
If a path is not supplied, the current folder is assumed.
The deck system is built on and/or utilizes:
To view other pieces of the deck system see https://github.com/nearform/deck
- Please open any issues for any deck related module on the https://github.com/nearform/deck community repo.
- Any module specific PR's are welcomed on the corresponding repo.
Sponsored by nearForm
- David Mark Clements
- Mihai Dima
- Cristian Kiss
Deck is an OPEN Open Source Project. This means that:
Individuals making significant and valuable contributions are given commit-access to a project to contribute as they see fit. A project is more like an open wiki than a standard guarded open source project.
See the CONTRIBUTING.md file for more details.