]> granicus.if.org Git - docbook-dsssl/commitdiff
New online demos
authorNorman Walsh <ndw@nwalsh.com>
Tue, 25 Jun 2002 13:57:50 +0000 (13:57 +0000)
committerNorman Walsh <ndw@nwalsh.com>
Tue, 25 Jun 2002 13:57:50 +0000 (13:57 +0000)
15 files changed:
slides/demo/Makefile [new file with mode: 0644]
slides/demo/default/.cvsignore [new file with mode: 0644]
slides/demo/frames1/.cvsignore [new file with mode: 0644]
slides/demo/frames2/.cvsignore [new file with mode: 0644]
slides/demo/frames3/.cvsignore [new file with mode: 0644]
slides/demo/frames4/.cvsignore [new file with mode: 0644]
slides/demo/frames5/.cvsignore [new file with mode: 0644]
slides/demo/frames6/.cvsignore [new file with mode: 0644]
slides/demo/frames7/.cvsignore [new file with mode: 0644]
slides/demo/index.html [new file with mode: 0644]
slides/demo/plain/.cvsignore [new file with mode: 0644]
slides/demo/source/slides.xml [new file with mode: 0644]
slides/demo/tables/.cvsignore [new file with mode: 0644]
slides/demo/vslides/.cvsignore [new file with mode: 0644]
slides/demo/w3c/.cvsignore [new file with mode: 0644]

diff --git a/slides/demo/Makefile b/slides/demo/Makefile
new file mode 100644 (file)
index 0000000..b76e790
--- /dev/null
@@ -0,0 +1,47 @@
+XSLTPROC=xsltproc
+SLIDES=../source/slides.xml
+XSLT=$(XSLTPROC) $(SLIDES)
+
+all: default plain tables vslides w3c frames
+
+frames: frames1 frames2 frames3 frames4 frames5 frames6 frames7
+
+.PHONY: default plain tables vslides w3c \
+        frames1 frames2 frames3 frames4 frames5 frames6 frames7
+
+default:
+       cd default && rm -f *.html && $(XSLT) ../../xsl/default.xsl
+
+plain:
+       cd plain && rm -f *.html && $(XSLT) ../../xsl/plain.xsl
+
+tables:
+       cd tables && rm -f *.html && $(XSLT) ../../xsl/tables.xsl
+
+vslides:
+       cd vslides && rm -f *.html && $(XSLT) ../../xsl/vslides.xsl
+
+w3c:
+       cd w3c && rm -f *.html && $(XSLT) ../../xsl/w3c.xsl
+
+frames1:
+       cd frames1 && rm -f *.html && $(XSLT) ../../xsl/frames.xsl overlay=0 multiframe=0 dynamic.toc=0 active.toc=0
+
+frames2:
+       cd frames2 && rm -f *.html && $(XSLT) ../../xsl/frames.xsl overlay=1 multiframe=0 dynamic.toc=0 active.toc=0
+
+frames3:
+       cd frames3 && rm -f *.html && $(XSLT) ../../xsl/frames.xsl overlay=0 multiframe=1 dynamic.toc=0 active.toc=0
+
+frames4:
+       cd frames4 && rm -f *.html && $(XSLT) ../../xsl/frames.xsl overlay=0 multiframe=0 dynamic.toc=1 active.toc=0
+
+frames5:
+       cd frames5 && rm -f *.html && $(XSLT) ../../xsl/frames.xsl overlay=0 multiframe=0 dynamic.toc=0 active.toc=1
+
+frames6:
+       cd frames6 && rm -f *.html && $(XSLT) ../../xsl/frames.xsl overlay=1 multiframe=0 dynamic.toc=1 active.toc=1
+
+frames7:
+       cd frames7 && rm -f *.html && $(XSLT) ../../xsl/frames.xsl overlay=0 multiframe=1 dynamic.toc=1 active.toc=1
+
diff --git a/slides/demo/default/.cvsignore b/slides/demo/default/.cvsignore
new file mode 100644 (file)
index 0000000..2d19fc7
--- /dev/null
@@ -0,0 +1 @@
+*.html
diff --git a/slides/demo/frames1/.cvsignore b/slides/demo/frames1/.cvsignore
new file mode 100644 (file)
index 0000000..2d19fc7
--- /dev/null
@@ -0,0 +1 @@
+*.html
diff --git a/slides/demo/frames2/.cvsignore b/slides/demo/frames2/.cvsignore
new file mode 100644 (file)
index 0000000..2d19fc7
--- /dev/null
@@ -0,0 +1 @@
+*.html
diff --git a/slides/demo/frames3/.cvsignore b/slides/demo/frames3/.cvsignore
new file mode 100644 (file)
index 0000000..2d19fc7
--- /dev/null
@@ -0,0 +1 @@
+*.html
diff --git a/slides/demo/frames4/.cvsignore b/slides/demo/frames4/.cvsignore
new file mode 100644 (file)
index 0000000..2d19fc7
--- /dev/null
@@ -0,0 +1 @@
+*.html
diff --git a/slides/demo/frames5/.cvsignore b/slides/demo/frames5/.cvsignore
new file mode 100644 (file)
index 0000000..2d19fc7
--- /dev/null
@@ -0,0 +1 @@
+*.html
diff --git a/slides/demo/frames6/.cvsignore b/slides/demo/frames6/.cvsignore
new file mode 100644 (file)
index 0000000..2d19fc7
--- /dev/null
@@ -0,0 +1 @@
+*.html
diff --git a/slides/demo/frames7/.cvsignore b/slides/demo/frames7/.cvsignore
new file mode 100644 (file)
index 0000000..2d19fc7
--- /dev/null
@@ -0,0 +1 @@
+*.html
diff --git a/slides/demo/index.html b/slides/demo/index.html
new file mode 100644 (file)
index 0000000..6968f95
--- /dev/null
@@ -0,0 +1,26 @@
+<html>
+<head>
+<title>Slides Demos</title>
+</head>
+<body>
+<h1>Slides Demos</h1>
+
+<p>There are 12 online demo versions of the slides presentation:</p>
+
+<dl>
+<dt><a href="default/index.html">default</a>, a simple presentation</dt>
+<dt><a href="plain/index.html">plain</a>, a simple presentation</dt>
+<dt><a href="tables/index.html">tables</a>, uses a table for the ToC on each page</dt>
+<dt><a href="vslides/index.html">vslides</a>, uses a vertical navigation style</dt>
+<dt><a href="w3c/index.html">w3c</a>, uses a style like the W3C "talk" style</dt>
+<dt><a href="frames1/frames.html">frames1</a>, uses frames</dt>
+<dt><a href="frames2/frames.html">frames2</a>, uses frames and JavaScript</dt>
+<dt><a href="frames3/frames.html">frames3</a>, uses multiple frames</dt>
+<dt><a href="frames4/frames.html">frames4</a>, uses frames and JavaScript</dt>
+<dt><a href="frames5/frames.html">frames5</a>, uses frames and JavaScript</dt>
+<dt><a href="frames6/frames.html">frames6</a>, uses frames and JavaScript</dt>
+<dt><a href="frames7/frames.html">frames7</a>, uses frames and JavaScript</dt>
+</dl>
+</body>
+</html>
+
diff --git a/slides/demo/plain/.cvsignore b/slides/demo/plain/.cvsignore
new file mode 100644 (file)
index 0000000..2d19fc7
--- /dev/null
@@ -0,0 +1 @@
+*.html
diff --git a/slides/demo/source/slides.xml b/slides/demo/source/slides.xml
new file mode 100644 (file)
index 0000000..fb0b05c
--- /dev/null
@@ -0,0 +1,249 @@
+<?xml version='1.0'?>
+<!DOCTYPE slides SYSTEM "../../slides.dtd">
+<?dbhtml graphics-dir="../../graphics" css-stylesheet-dir="../../browser"?>
+<?dbhtml script-dir="../../browser"?>
+<slides>
+<slidesinfo>
+  <title>The Slides Document Type</title>
+  <titleabbrev>Slides</titleabbrev>
+  <author><firstname>Norman</firstname><surname>Walsh</surname></author>
+  <pubdate>Tuesday, 25 June 2002</pubdate>
+  <releaseinfo role="version">3.0b1</releaseinfo>
+  <copyright><year>2002</year>
+             <holder>Norman Walsh</holder></copyright>
+</slidesinfo>
+
+<foil><title>Introduction</title>
+<para>This is the introductory slide.</para>
+<para>If you use foil groups (previously called sections), you can
+have introductory slides before the first group.</para>
+</foil>
+
+<foilgroup><title>Purpose and History</title>
+
+<para>Groups can now have introductory text as well.</para>
+
+<foil><title>What Are Slides?</title>
+<itemizedlist>
+<listitem><para>An XML presentation tool
+</para></listitem>
+<listitem><para>Suitable for HTML or PDF presentations
+</para></listitem>
+<listitem><para>Supported by Open Source software
+</para></listitem>
+</itemizedlist>
+</foil>
+
+<foil><title>Where Do They Come From?</title>
+
+<itemizedlist>
+<listitem><para>Maintained by the <ulink url="http://docbook.sourceforge.net/">DocBook
+Open Repository</ulink> Project at
+<ulink url="http://sourceforge.net/">SourceForge</ulink>
+</para></listitem>
+<listitem><para>Customization layer of
+<ulink url="http://www.oasis-open.org/docbook/xml/simple/">Simplified DocBook</ulink>
+</para></listitem>
+</itemizedlist>
+</foil>
+
+<foil><title>Why?</title>
+
+<itemizedlist>
+<listitem><para>So Norm could give presentations
+</para></listitem>
+<listitem><para>So Norm could publish those presentations on the web
+</para></listitem>
+<listitem><para>So Norm could have <emphasis>accessible</emphasis> presentations
+that didn't rely on the grotesque HTML output of some otherwise bloated, proprietary
+tool
+</para></listitem>
+<listitem><para>So Norm could cut-and-paste from his DocBook articles and papers
+directly into his slides
+</para></listitem>
+<listitem><para>Oh, let's face it: because it was there. Like the proverbial mountain.
+</para></listitem>
+</itemizedlist>
+</foil>
+</foilgroup>
+
+<foilgroup><title>Authoring</title>
+
+<para>How to write a presentation.</para>
+
+<foil><title>Minimal Presentation</title>
+
+<para>The smallest possible presentation looks like this:</para>
+
+<screen><![CDATA[<?xml version='1.0'?>
+<!DOCTYPE slides PUBLIC "-//Norman Walsh//DTD Slides XML V3.0b1//EN"
+                 "http://docbook.sourceforge.net/release/slides/3.0b1/slides.dtd">
+<slides>
+<slidesinfo>
+<title>Presentation Title</title>
+</slidesinfo>
+<foil><title>Foil Title</title>
+<para>Foil content</para>
+</foil>
+</slides>]]></screen>
+
+<para>Every presentation must contain at least one slide.</para>
+</foil>
+
+<foil><title>Presentation Metadata</title>
+
+<para>Presentations usually have more metadata in the <literal>slidesinfo</literal>
+wrapper. Here's a typical example:</para>
+
+<screen><![CDATA[<slidesinfo>
+  <title>Supporting Localized Generated Text</title>
+  <titleabbrev>Generated Text</titleabbrev>
+  <author><firstname>Norman</firstname><surname>Walsh</surname></author>
+  <pubdate>Sunday, 08 Apr 2001</pubdate>
+  <confgroup>
+    <conftitle>XSLTUK-01</conftitle>
+    <confdates>08 Apr - 09 Apr 2001</confdates>
+    <conftitle role="address">Keble College, Oxford, UK</conftitle>
+    <confnum>1</confnum>
+  </confgroup>
+  <releaseinfo role="version">Version TEST</releaseinfo>
+  <copyright><year>2001</year>
+             <holder>Sun Microsystems, Inc.</holder></copyright>
+</slidesinfo>]]></screen>
+</foil>
+
+<foil><title>Presentation Content</title>
+
+<para>It's common for individual slides to consist of a single
+bulleted or numbered list. However, the full range of <quote>block
+level</quote> Simplified DocBook elements are avialable.</para>
+
+</foil>
+</foilgroup>
+
+<foilgroup><title>Styling</title>
+
+<para>How to transform a presentation.</para>
+
+<foil><title>HTML</title>
+
+<para>There are a lot of HTML options. When you publish your
+presentation on the web, it's probably best to use one of the simpler,
+more accessible styles. For your actual live presentation, you may
+want to choose something fancier.</para>
+
+</foil>
+
+<foil><title>Plain HTML</title>
+
+<itemizedlist>
+<listitem><para><ulink url="../default/"><filename>default.xsl</filename></ulink>
+and
+<ulink url="../plain/"><filename>plain.xsl</filename></ulink>
+produce fairly simple presentations
+</para></listitem>
+<listitem><para><ulink url="../tables/"><filename>tables.xsl</filename></ulink>
+uses a table to show the navigation context (somewhat like the tabular
+<ulink url="http://docbook.sourceforge.net/">Website</ulink> style)
+</para></listitem>
+<listitem><para><ulink url="../vslides/"><filename>vslides.xsl</filename></ulink>
+places navigation on the left side instead of the top and bottom
+</para></listitem>
+<listitem><para><ulink url="../w3c/"><filename>w3c.xsl</filename></ulink>
+produces slides that resemble the format used by the W3C for presentations
+</para></listitem>
+</itemizedlist>
+
+</foil>
+
+<foil><title>Fancy HTML</title>
+
+<itemizedlist>
+<listitem><para><ulink url="../frames1/frames.html"><filename>frames.xsl</filename></ulink>
+uses frames. There are several options that you can apply:
+</para>
+<itemizedlist>
+<listitem><para><ulink url="../frames2/frames.html">overlay</ulink> uses CSS absolute positioning
+to keep the navigation static on the pages (only works on recent browsers)
+</para></listitem>
+<listitem><para><ulink url="../frames3/frames.html">multiframe</ulink> uses additional frames
+to keep the navigation static on the pages
+</para></listitem>
+<listitem><para><ulink url="../frames4/frames.html">dynamic.toc</ulink> uses JavaScript to keep
+the table of contents and the current slide in sync (only works on recent browsers)
+</para></listitem>
+<listitem><para><ulink url="../frames5/frames.html">active.toc</ulink> uses JavaScript to make
+the table of context <quote>active</quote> so that you can open and close the foil
+groups (only works on recent browsers)
+</para></listitem>
+<listitem><para>These toc styles can be combined with
+<ulink url="../frames6/frames.html">overlay</ulink> or <ulink url="../frames7/frames.html">multiframe</ulink>
+</para></listitem>
+</itemizedlist>
+</listitem>
+</itemizedlist>
+</foil>
+
+<foil><title>PDF</title>
+
+<para>The <filename>fo-plain.xsl</filename> stylesheet produces XSL Formatting
+Objects that can subsequently be turned into PDF.</para>
+
+</foil>
+
+</foilgroup>
+
+<foilgroup><title>Presentation</title>
+
+<para>How to customize and present a set of slides.</para>
+
+<foil><title>Look And Feel</title>
+
+<para>For HTML display, most of the actual
+<quote>look-and-feel</quote> of the presentation is controlled by the CSS
+stylesheet(s) used.</para>
+
+</foil>
+
+<foil><title>Presentation Tips</title>
+
+<itemizedlist>
+<listitem><para>It's usually best if each slide is only one page (avoid scrolling).
+</para></listitem>
+<listitem><para>If you'll be giving your presentation with a projector, make sure you
+know what resolution you'll have available and test your presentation at that resolution.
+</para></listitem>
+<listitem><para>Make your fonts bigger so the folks in the back of the room can read
+your slides.
+</para></listitem>
+<listitem><para>Test the equipment before your presentation begins. Really.
+</para></listitem>
+<listitem><para>Speak more slowly. I always forget that one.
+</para></listitem>
+</itemizedlist>
+</foil>
+
+</foilgroup>
+
+<foilgroup><title>Conclusions</title>
+
+<foil><title>Conclusions</title>
+
+<para>It's customary to have a conclusions slide.</para>
+
+</foil>
+
+<foil><title>References</title>
+
+<para>References are a good idea too.</para>
+
+</foil>
+
+<foil><title>Q&amp;A</title>
+
+<para>Any questions?</para>
+
+</foil>
+</foilgroup>
+
+</slides>
diff --git a/slides/demo/tables/.cvsignore b/slides/demo/tables/.cvsignore
new file mode 100644 (file)
index 0000000..2d19fc7
--- /dev/null
@@ -0,0 +1 @@
+*.html
diff --git a/slides/demo/vslides/.cvsignore b/slides/demo/vslides/.cvsignore
new file mode 100644 (file)
index 0000000..2d19fc7
--- /dev/null
@@ -0,0 +1 @@
+*.html
diff --git a/slides/demo/w3c/.cvsignore b/slides/demo/w3c/.cvsignore
new file mode 100644 (file)
index 0000000..2d19fc7
--- /dev/null
@@ -0,0 +1 @@
+*.html