From b1a2f02082d89b21d659264bc83e0ddbcca656e2 Mon Sep 17 00:00:00 2001
From: John MacFarlane <fiddlosopher@gmail.com>
Date: Wed, 25 Jan 2012 11:51:36 -0800
Subject: [PATCH] Improved README on slides.
---
README | 38 ++++++++++++++++++++++++++------------
1 file changed, 26 insertions(+), 12 deletions(-)
diff --git a/README b/README
index de161b367..4435e2812 100644
--- a/README
+++ b/README
@@ -1947,7 +1947,7 @@ using [S5], [DZSlides], or [Slidy]. You can also produce a PDF slide
show using [LaTeX beamer]: just use the `--beamer` option with `pdf`
output.
-Here's the markdown source for a simple slide show, `eating.txt`:
+Here's the markdown source for a simple slide show, `habits.txt`:
% Habits
% John Doe
@@ -1999,6 +1999,13 @@ for DZSlides, or
for beamer.
+With all HTML slide formats, the `--self-contained` option can be used to
+produce a single file that contains all of the data necessary to display the
+slide show, including linked scripts, stylesheets, images, and videos.
+
+Structuring the slide show
+--------------------------
+
The document is carved up into slides according to the following
rules. The *content level* is the the highest header level in the hierarchy
that is followed immediately by content, and not another header, somewhere in
@@ -2033,17 +2040,6 @@ website at `w3.org` (for Slidy). (These paths can be changed by setting
the `slidy-url` or `s5-url` variables; see `--variable`, above.) For DZSlides,
the (relatively short) javascript and css are included in the file by default.
-You can change the style of the slides by putting customized CSS files
-in `$DATADIR/s5/default` (for S5) or `$DATADIR/slidy` (for Slidy),
-where `$DATADIR` is the user data directory (see `--data-dir`, above).
-The originals may be found in pandoc's system data directory (generally
-`$CABALDIR/pandoc-VERSION/s5/default`). Pandoc will look there for any
-files it does not find in the user data directory.
-
-The `--self-contained` option can be used to produce a single file that
-contains all of the data necessary to display the slide show, including
-linked scripts, stylesheets, images, and videos.
-
Incremental lists
-----------------
@@ -2059,6 +2055,24 @@ all at once with the `-i` option), put it in a block quote:
In this way incremental and nonincremental lists can be mixed in
a single document.
+Styling the slides
+------------------
+
+You can change the style of HTML slides by putting customized CSS files
+in `$DATADIR/s5/default` (for S5) or `$DATADIR/slidy` (for Slidy),
+where `$DATADIR` is the user data directory (see `--data-dir`, above).
+The originals may be found in pandoc's system data directory (generally
+`$CABALDIR/pandoc-VERSION/s5/default`). Pandoc will look there for any
+files it does not find in the user data directory.
+
+For dzslides, the CSS is included in the HTML file itself, and may
+be modified there.
+
+To style beamer slides, you can specify a beamer "theme" or "colortheme"
+using the `-V` option:
+
+ pandoc --beamer habits.txt -V theme:Warsaw -o habits.pdf
+
Literate Haskell support
========================