medlefsen / angular-showoff

A simple presentation tool written with AngularJS, and directly inspired by ShowOff.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

angular-showoff

A presentation tool similar to Scott Chacon's Showoff, but built with AngularJS. As with ShowOff, you write the presentation slides in markdown syntax. But there is no server part, the tool is just a full client web application.

If you want to use it with Chrome, you must run a web server (Node.js for instance) to serve the files, as Chrome doesn't allow scripts in a local HTML page to make HTTP requests. Or you can start Chrome with --allow-file-access-from-files flag to disable this restriction. Firefox has no such restriction.

This application uses the markdown parser named marked, from Christopher Jeffrey. It also uses google-code-prettify for syntax highlighting of source code.

Demo is here. Use 'h' key for help.

Usage

angular-showoff needs a data/config.json config file, which defines the presentation title, and the list of slides files. Here is the sample data/config.json file :

{
    "title": "angular-showoff demo",
    "sections": [
        {"file": "data/begin/begin.md"},
        {"file": "data/end/end.md"}
    ]
}

This example loads two markdown files, containing the slides. Images referenced in the markdown files will be loaded from the same directory as the markdown file. For instance, path data/begin will be used for images in data/begin/begin.md.

As with ShowOff, you may assemble a presentation from several parts. But there is no automatic discovery of markdown files in subdirectories, you have to list all the markdown files in the config file.

The tool can show text, images, syntax highlighted code, bullet or numbered lists. It does not have transitions, nor incremental lists.

The file css/custom.css is for user-defined styles, specific to its presentations.

About

A simple presentation tool written with AngularJS, and directly inspired by ShowOff.


Languages

Language:JavaScript 81.5%Language:CSS 11.6%Language:HTML 4.5%Language:Batchfile 0.9%Language:Shell 0.8%Language:Ruby 0.7%