@@ -1032,8 +1032,7 @@ To produce the slide show, simply type
10321032
10331033 pandoc -w s5 -s eating.txt > eating.html
10341034
1035−and open up `eating.html` in a browser. The HTML file embeds
1036−all the required javascript and CSS, so no other files are necessary.
1035+and open up `eating.html` in a browser.
10371036
10381037Note that by default, the S5 writer produces lists that display
10391038"all at once." If you want your lists to display incrementally
@@ -1048,3 +1047,17 @@ incrementally without the `-i` option and all at once with the
10481047In this way incremental and nonincremental lists can be mixed in
10491048a single document.
10501049
1050+Note: the S5 file produced by pandoc with the `-s/--standalone` option
1051+embeds the javascript and CSS required to show the slides. Thus it
1052+does not depend on any additional files: you can send the HTML file to
1053+others, and they will be able to view the slide show just by opening
1054+it. However, if you intend to produce several S5 slide shows, and you
1055+are displaying them on your own website, it is better to keep the S5
1056+javascript and CSS files separate from the slide shows themselves, so
1057+that they may be cached. The best approach in this case is to use pandoc
1058+without the `-s` option to produce the body of the S5 document, which
1059+can then be inserted into an HTML template that links to the javascript
1060+and CSS files required by S5. (See the instructions on the S5 website.)
1061+Alternatively, you may use `-s` together with the `-H/--custom-header`
1062+option.
1063+