Slideshow FAQ.

1 files changed, 30 insertions, 0 deletions

diff --git a/doc/faq.txt b/doc/faq.txt
index 0e777c6..9f3f56a 100644
--- a/doc/faq.txt
+++ b/doc/faq.txt
@@ -9,6 +9,36 @@ AsciiDoc Frequently Asked Questions
   newer FAQs may apply to the trunk and not the current release.

 ======

 

+== Can AsciiDoc generate slide shows?

+There are a number of browser based HTML slideshow applications

+written in JavaScript, most could probably be made to work with

+AsciiDoc. Here's how use http://staticfree.info/projects/jqs5/[JQS5]

+to turn an AsciiDoc document (`mydoc.txt`) into a slideshow

+(`mydoc.html`):

+

+. Download and extract the 'JQS5' tarball.

+. Put this your document's 'docinfo' file (`mydoc-docinfo.html`):

++

+---------------------------------------------------------------------

+<link rel="stylesheet" href="./jqs5/jqs5.css">

+<link rel="stylesheet" href="./jqs5/theme/staticfree/style.css">

+<script src="./jqs5/jquery-1.2.6.js" type="text/javascript"></script>

+<script src="./jqs5/jqs5.js" type="text/javascript"></script>

+<script type="text/javascript">

+      $(document).ready(jqs5_init);

+</script>

+<style type="text/css"> hr { visibility: hidden; } </style>

+---------------------------------------------------------------------

+  * The `./jqs5/jquery-1.2.6.js` file name may differ depending on the

+    version of 'JQS5'.

+  * The last line hides 'hr' elements generated by by the Asciidoc

+    'html4' backend.

+

+. Generate the slideshow (`mydoc.html`) with this command:

+

+  $ asciidoc -bhtml4 -adocinfo mydoc.txt

+

+

 == The AsciiDoc toclevels attribute does not work with DocBook outputs, why?

 DocBook has no provision for specifying table of contents levels but

 you can set the TOC level further down the toolchain by passing the