GithubHelp home page GithubHelp logo

org-slides's Introduction

Overview

This repository contains emacs lisp files providing HTML slideshow export and publishing options for the new org-mode version 8 export framework. The latest org-mode is available for checkout at git://orgmode.org/org-mode.git, and includes these classes in the contrib/lisp directory.

The Exporters

ox-deck.el

This will export/publish an org outline (or subtree) to a deck.js slideshow.

Installation

  1. Get a copy of deck.js from http://imakewebthings.com/deck.js/ or the github repositiory at https://github.com/imakewebthings/deck.js.
  2. Customize the variable org-deck-directories to include the path to the directory created in (1) above. This is required to automatically identify available deck components (extensions, themes and transitions).
  3. The exporter will create links to the themes, transitions and extensions relative to the customization variable org-deck-base-url.

Customization

The method org-deck-list-components, will list all the available extensions, themes and transitions in the directories included in org-deck-directories.

The following variables (in the customization group org-export-deck) are available to customize the slideshow generation:

optionin buffer optionpublishing optiondefault
org-deck-base-urlDECK_BASE_URL:deck-base-urldeck.js
org-deck-themeDECK_THEME:deck-themeswiss.css
org-deck-transitionDECK_TRANSITION:deck-transitionfade.css
org-deck-include-extensionsDECK_INCLUDE_EXTENSIONS:deck-include-extensions{all}
org-deck-exclude-extensionsDECK_EXCLUDE_EXTENSIONS:deck-exclude-extensions
org-deck-directories./deck.js

Using “builds”

deck.js creates “builds” through nested slides — any block level element with the class “slide” will be treated as a build. The exporter has two ways to accomplish this:

  1. Set the :HTML_CONTAINER_CLASS property on a headline to a string including slide.
  2. To build a list, set the :STEP property on the enclosing headline to t.

Generating HTML5 compatible slideshows

Standard org outlines are generated as XHTML 1.0 compatible documents. The “standard” for deck.js is HTML5. The latest version of the org exporter will allow you to modify the output as follows. By modifying the following options/variable:

optionin buffer optionpublishing optionvalue
org-html-container-elementHTML_CONTAINER:html-containersection
org-html-doctypeHTML_DOCTYPE:html-doctype<!DOCTYPE html>
org-html-divs((preamble “header” “preamble”) (content “article” “content”) (postamble “footer” “postamble))

Note that org-html-divs cannot be set with a customization or in-buffer option, but must be set with a BIND or local variable.

ox-s5.el

This will export/publish an org outline (or subtree) to an s5 slideshow.

Installation

  1. Get a copy of the s5 scripts from http://meyerweb.com/eric/tools/s5/.
  2. The exporter will create links to the javscript file and the generic stylesheets in the default directory under :s5-ui-url (org-s5-ui-url).

Customization

The following variables (in the customization group org-export-s5) are available to customize the slideshow generation:

customization variablein buffer optionpublishing optiondefault
org-s5-versionS5_VERSION:s5-version1.2a2
org-s5-theme-fileS5_THEME_FILE:s5-theme-file
org-s5-ui-urlS5_UI_URL:s5-ui-urlui
org-s5-default-viewS5_DEFAULT_VIEW:s5-default-viewslideshow
org-s5-control-visibilityS5_CONTROL_VISIBILITY:s5-control-visibilityhidden

Note that if the :s5-theme-file is nil, it will use the file default/screen.css relative to :s5-ui-url.

Using “builds”

s5 creates “builds” by including the class incremental on a headline or list (ul or ol). You can set the HTML_CONTAINER_CLASS property on a headline to “incremental”, to make it build. To make a list build, set the INCREMENTAL property on the parent headline to t.

Generating XOXO style slideshows

XOXO style slideshows (see S5 (XOXO Version)) can be generated by setting the org-html-container-element to li. This can be done in a number of ways as show in the table above under Generating HTML5 compatible slideshows.

deck.js extension

onepage is a deck.js exension which, logically, will display a deck.js slideshow as a single scrolling page. It can be toggled with the ‘o’ key, and will print with slides separated by rule instead of one slide per page.

org-slides's People

Watchers

James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.