@@ -1268,11 +1268,12 @@ and ConTeXt.
12681268Producing HTML slide shows with Pandoc
12691269======================================
12701270
1271−Producing a [Slidy] or [S5] web-based slide show with Pandoc is easy. A
1272−title page is constructed automatically from the document's title block
1273−(see above). Each section (with a level-one header) produces a single
1274−slide. (Note that if the section is too big, the slide will not fit on
1275−the page; S5 is not smart enough to produce multiple pages.)
1271+You can use Pandoc to produce an HTML + javascript slide presentation
1272+that can be viewed via a web browser. There are two ways to do this,
1273+using [S5] or [Slidy].
1274+
1275+Using S5
1276+--------
12761277
12771278Here's the markdown source for a simple slide show, `eating.txt`:
12781279
@@ -1292,15 +1293,69 @@ Here's the markdown source for a simple slide show, `eating.txt`:
12921293
12931294To produce the slide show, simply type
12941295
1295− pandoc -w slidy -s eating.txt > eating.html
1296+ pandoc -w s5 -s eating.txt > eating.html
12961297
1297−for Slidy, or
1298+A title page is constructed automatically from the document's title
1299+block. Each section (with a level-one header) produces a single slide.
1300+(Note that if the section is too big, the slide will not fit on the
1301+page; S5 is not smart enough to produce multiple pages.)
1302+
1303+The S5 file produced by pandoc with the `-s/--standalone`
1304+option embeds the javascript and CSS required to show the slides. Thus
1305+it does not depend on any additional files: you can send the HTML file
1306+to others, and they will be able to view the slide show just by opening
1307+it. However, if you intend to produce several S5 slide shows, and you
1308+are displaying them on your own website, it is better to keep the S5
1309+javascript and CSS files separate from the slide shows themselves, so
1310+that they may be cached. The best approach in this case is to use pandoc
1311+without the `-s` option to produce the body of the S5 document, which
1312+can then be inserted into an HTML template that links to the javascript
1313+and CSS files required by S5. (See the instructions on the S5 website.)
1314+Alternatively, you may use `-s` together with the `--template` option to
1315+specify a custom template.
1316+
1317+You can change the style of the slides by putting customized CSS files
1318+in `$DATADIR/s5/default`, where `$DATADIR` is the user data directory
1319+(see `--data-dir`, above). The originals may be found in pandoc's system
1320+data directory (generally `$CABALDIR/pandoc-VERSION/s5/default`). Pandoc
1321+will look there for any files it does not find in the user data
1322+directory.
1323+
1324+Using Slidy
1325+-----------
1326+
1327+If you use Slidy, things work a bit differently. Instead of
1328+automatically chopping the document into sections on the level-1
1329+headers, you can choose how to segment the document into slides
1330+yourself. Just insert a horizontal rule at each slide boundary.
1331+For example:
12981332
1299− pandoc -w s5 -s eating.txt > eating.html
1333+ % Eating Habits
1334+ % John Doe
1335+ % March 22, 2005
13001336
1301−for S5.
1337+ # In the morning
1338+
1339+ - Eat eggs
1340+ - Drink coffee
1341+
1342+ -----------------------------------------
13021343
1303−and open up `eating.html` in a browser.
1344+ # In the evening
1345+
1346+ - Eat spaghetti
1347+ - Drink wine
1348+
1349+ ------------------------------------------
1350+
1351+ The end!
1352+
1353+To produce the slide show, simply type
1354+
1355+ pandoc -w slidy -s eating.txt > eating.html
1356+
1357+Incremental lists
1358+-----------------
13041359
13051360Note that by default, these writers produces lists that display
13061361"all at once." If you want your lists to display incrementally
@@ -1315,29 +1370,6 @@ incrementally without the `-i` option and all at once with the
13151370In this way incremental and nonincremental lists can be mixed in
13161371a single document.
13171372
1318−Notes on S5:
1319−
1320−- The S5 file produced by pandoc with the `-s/--standalone`
1321− option embeds the javascript and CSS required to show the slides. Thus
1322− it does not depend on any additional files: you can send the HTML file
1323− to others, and they will be able to view the slide show just by opening
1324− it. However, if you intend to produce several S5 slide shows, and you
1325− are displaying them on your own website, it is better to keep the S5
1326− javascript and CSS files separate from the slide shows themselves, so
1327− that they may be cached. The best approach in this case is to use pandoc
1328− without the `-s` option to produce the body of the S5 document, which
1329− can then be inserted into an HTML template that links to the javascript
1330− and CSS files required by S5. (See the instructions on the S5 website.)
1331− Alternatively, you may use `-s` together with the `--template` option to
1332− specify a custom template.
1333−
1334−- You can change the style of the slides by putting customized CSS files
1335− in `$DATADIR/s5/default`, where `$DATADIR` is the user data directory
1336− (see `--data-dir`, above). The originals may be found in pandoc's system
1337− data directory (generally `$CABALDIR/pandoc-VERSION/s5/default`). Pandoc
1338− will look there for any files it does not find in the user data
1339− directory.
1340−
13411373Literate Haskell support
13421374========================
13431375