slides-cli

0.3.1 • Public • Published

Slides CLI

Stories in Ready Dependency Status devDependency Status Build Status


Slides (CLI) is an easy way to create HTML slideshows from a markdown document. Just list your slides in one document and let Slides to the rest. It will split your slides and convert them to the reveal.js format. You can also pass an metadata that will be used so style your slide (i. e. a background image)

Installation

Install Slides using npm:
$ npm install -g slides-cli
You will then have access to the slides command.

Usage

slides expects a src/ directory with a slides.md file in it (this can be changed, see Options below). Any other files/folders in the src/ directory (with the exception of .scss file) will be coppied to the build/ folder when you run the command.

Command Line Args

  • cwd: Change the projects root
  • path: Change the path to the input file (defaults to slides.md)

Format

title: My Presenation
author: Me
--
Slide 1
- some
- bullet
- points
 
-- {
    background:
        img: 'some/img.jpg'
}
Slide 2
![alt](path/to/another/img.ext)
 
-- {
    background:
        img: 'img/logo.png'
        size: '120px'
        position: '10% 5%'
}
Our Company!

The section before the first -- is presentation metadata, like the title, author or stylesheets you want to include (see Theming below). This metadata is accesible from within the templates.

Slides are separated by two dashes --. You can pass options along with a slide by wrapping YAML data within the {}s. For the most part these options are passed directly to reveal.js (through HTML).

Presentation Options

The only options that are used internally are:

  • reveal: object that will be passed directly to Reveal.initialize
  • theme: controlls the css and templates paths
    • css: the path to the scss file you want to render
    • templates: path to a wrap.hbt and a slide.hbt template

Theming

Your custom style sheet will be processed with SASS, so make sure, it has a .scss extension. Include @import "base" at the top of your file to include the reveal.js base CSS.

The default theme is reveal.js's default theme.

Please refer to the reveal.js docs for more information on how to theme the slide shows.

Roadmap

  • custom templates
  • use matadata within slides
  • built in static file server
  • plugin support
  • shortcodes (maybe as plugin)

Readme

Keywords

none

Package Sidebar

Install

npm i slides-cli

Weekly Downloads

1

Version

0.3.1

License

MIT

Last publish

Collaborators

  • robinthrift