org-tutorials/non-beamer-presentations.org

   1 #+TITLE:     Writing Non-Beamer presentations in org-mode
   2 #+AUTHOR:    Eric Schulte
   3 #+DATE:      <2011-06-02 Thu>
   4 #+DESCRIPTION:
   5 #+KEYWORDS:
   6 #+LANGUAGE:  en
   7 #+OPTIONS:   H:3 num:nil toc:t \n:nil @:t ::t |:t ^:nil -:t f:t *:t <:t
   8 #+OPTIONS:   TeX:t LaTeX:t skip:nil d:nil todo:t pri:nil tags:not-in-toc
   9 #+INFOJS_OPT: view:nil toc:nil ltoc:t mouse:underline buttons:0 path:http://orgmode.org/org-info.js
  10 #+EXPORT_SELECT_TAGS: export
  11 #+EXPORT_EXCLUDE_TAGS: noexport
  12 #+LINK_UP:
  13 #+LINK_HOME:
  14
  15 * Introduction
  16
  17 While [[file:org-beamer/tutorial.org][Beamer]] is a great option for generating high-quality
  18 presentations from Org-mode documents, sometimes a lighter-weight
  19 simpler option is desirable.  This page presents two alternative
  20 options for giving quick slide-show presentations from Org-mode
  21 documents.
  22
  23 - [[Epresent]] :: is an Emacs minor mode for giving presentations.  The
  24      Emacs editor is used in a full-screen mode as the presentation
  25      engine, and headings of the Org-mode buffer are presented
  26      directly (with a few nice bells and whistles).
  27
  28 - [[S5]] :: is a standards-based suite for writing slide-show
  29      presentations in html web pages.  The browser is used as the
  30      presentation engine, and a slightly altered form of Org-mode's
  31      HTML export serves as the base of the presentation.
  32
  33 - org-html5presentation :: Is an Exporter of Org-mode documents to
  34      HTML5 slide show presentations.
  35      (see [[https://gist.github.com/509761][gist.github.com/509761]] for code and usage information)
  36
  37 * Epresent
  38   :PROPERTIES:
  39   :CUSTOM_ID: Epresent
  40   :END:
  41
  42 Epresent was originally developed on top of outline mode by Tom
  43 Tromey.  Eric Schulte then adopted it for work with Org-mode.  The
  44 code for using Org-mode with epresent is available at
  45 https://github.com/eschulte/epresent.
  46
  47 Epresent leverages existing Org-mode features like inline image
  48 display, inline latex fragments, and in-buffer code fontification to
  49 generate very nice (if somewhat nerdy) looking presentations directly
  50 from within Emacs.  This has the nice benefit that during-presentation
  51 editing and code evaluation is possible.
  52
  53 The README file in the epresent repository has instillation
  54 instructions, however usage is as simple as...
  55 1. =M-x load-file epresent.el=
  56 2. open the example =present.org= file located in the repository
  57 3. call =M-x epresent-run=
  58 4. press "=t=" to view the top level of the presentation
  59 5. navigate the presentation with "=n=", "=p=", "=t=" and quit with "=q="
  60
  61 * S5
  62   :PROPERTIES:
  63   :CUSTOM_ID: S5
  64   :END:
  65
  66 [[http://meyerweb.com/eric/tools/s5/][S5]] is a "/Simple Standards-Based Slide Show System/" implemented using
  67 HTML, CSS and Javascript.
  68
  69 Two S5 options exist for Org-mode.
  70
  71 1. Yann Hodique has developed a javascript based option which works
  72    directly with Org-mode's existing html export.
  73
  74    This technique is described on Yann's blog
  75    [[http://www.hodique.info/blog/2009/11/14/s5_presentation_from_org-mode][s5 presentation from org-mode]].
  76
  77 2. There is also code implementing an altered version of Org-mode's
  78    existing html export tailored to generating static S5
  79    presentations.
  80
  81   This second technique is described below.
  82
  83 ** Code and usage for =org-export-as-s5=.
  84 - The emacs-lisp code available [[http://gitweb.adaptive.cs.unm.edu/org-S5.git/blob_plain/HEAD:/org-export-as-s5.el][here]] defines a single function
  85   (=org-export-as-s5=) as a simple wrapper around Org-mode's existing
  86   html export.  This function is based heavily on Pierre de Buyl's
  87   [[http://thread.gmane.org/gmane.emacs.orgmode/33143/match=s5][very thorough S5 export instructions]] posted to the Org-mode mailing
  88   list.
  89
  90 - Simply evaluate this code, or add it to your =.emacs=, then call
  91   =M-x org-export-as-s5= from within an Org-mode buffer. *Note*: the
  92   [[http://gitweb.adaptive.cs.unm.edu/org-S5.git/tree/HEAD:/ui][ui]] directory holding S5 support files must be located in the same
  93   directory as the exported html.
  94
  95 - Currently there are three themes which can be set with the
  96   following.
  97   #+begin_src emacs-lisp
  98     (setq org-s5-theme "railscast")   ; based off `color-theme-railscasts'
  99     (setq org-s5-theme "default")     ; the default S5 theme
 100     (setq org-s5-theme "i18n")        ; the i18n theme by the author of S5
 101   #+end_src
 102
 103 - This entire directory is available as a [[https://github.com/eschulte/org-S5/blob/master/org-export-as-s5.el][git repository]]
 104
 105 - For two examples of org-S5 in action see [[http://eschulte.github.com/org-S5/][here]]