Moving docs tree to docs-xml to make room for generated docs in the release tarball.
[kai/samba.git] / docs-xml / xslt / db2latex-xsl / xsl / slides / sample_foiltex / slides.xml
1 <?xml version='1.0'?>
2 <!--
3 <!DOCTYPE slides SYSTEM "../../schema/dtd/slides.dtd">
4 -->
5 <slides>
6 <slidesinfo>
7   <title>The Slides Document Type</title>
8   <author><firstname>Norman</firstname><surname>Walsh</surname></author>
9   <pubdate>Tuesday, 25 June 2002</pubdate>
10   <releaseinfo role="version">3.1.0</releaseinfo>
11   <copyright><year>2002</year>
12              <holder>Norman Walsh</holder></copyright>
13 </slidesinfo>
14
15 <foil><title>Introduction</title>
16 <para>This is the introductory slide.</para>
17 <para>If you use foil groups (previously called sections), you can
18 have introductory slides before the first group.</para>
19 <warning><title>Warning! :)</title>
20 <para>This is a work in progress ("release early, release often")</para>
21 </warning>
22 </foil>
23
24 <foilgroup><title>Purpose and History</title>
25
26 <para>Groups can now have introductory text as well.</para>
27
28 <foil><title>What Are Slides?</title>
29 <itemizedlist>
30 <listitem><para>An XML presentation tool
31 </para></listitem>
32 <listitem><para>Suitable for HTML or PDF presentations
33 </para></listitem>
34 <listitem><para>Supported by Open Source software
35 </para></listitem>
36 </itemizedlist>
37 </foil>
38
39 <foil><title>Where Do They Come From?</title>
40
41 <itemizedlist>
42 <listitem><para>Maintained by the <ulink url="http://docbook.sourceforge.net/">DocBook
43 Open Repository</ulink> Project at
44 <ulink url="http://sourceforge.net/">SourceForge</ulink>
45 </para></listitem>
46 <listitem><para>Customization layer of
47 <ulink url="http://www.oasis-open.org/docbook/xml/simple/">Simplified DocBook</ulink>
48 </para></listitem>
49 </itemizedlist>
50 </foil>
51
52 <foil><title>Why?</title>
53
54 <itemizedlist>
55 <listitem><para>So Norm could give presentations
56 </para></listitem>
57 <listitem><para>So Norm could publish those presentations on the web
58 </para></listitem>
59 <listitem><para>So Norm could have <emphasis>accessible</emphasis> presentations
60 that didn't rely on the grotesque HTML output of some otherwise bloated, proprietary
61 tool
62 </para></listitem>
63 <listitem><para>So Norm could cut-and-paste from his DocBook articles and papers
64 directly into his slides
65 </para></listitem>
66 <listitem><para>Oh, let's face it: because it was there. Like the proverbial mountain.
67 </para></listitem>
68 </itemizedlist>
69 </foil>
70 </foilgroup>
71
72 <foilgroup><title>Authoring</title>
73
74 <para>How to write a presentation.</para>
75
76 <foil><title>Minimal Presentation</title>
77
78 <para>The smallest possible presentation looks like this:</para>
79
80 <screen><![CDATA[<?xml version='1.0'?>
81 <!DOCTYPE slides PUBLIC "-//Norman Walsh//DTD Slides XML V3.0b1//EN"
82                  "http://docbook.sourceforge.net/release/slides/3.0b1/slides.dtd">
83 <slides>
84 <slidesinfo>
85 <title>Presentation Title</title>
86 </slidesinfo>
87 <foil><title>Foil Title</title>
88 <para>Foil content</para>
89 </foil>
90 </slides>]]></screen>
91
92 <para>Every presentation must contain at least one slide.</para>
93 </foil>
94
95 <foil><title>Presentation Metadata</title>
96
97 <para>Presentations usually have more metadata in the <literal>slidesinfo</literal>
98 wrapper. Here's a typical example:</para>
99
100 <screen><![CDATA[<slidesinfo>
101   <title>Supporting Localized Generated Text</title>
102   <titleabbrev>Generated Text</titleabbrev>
103   <author><firstname>Norman</firstname><surname>Walsh</surname></author>
104   <pubdate>Sunday, 08 Apr 2001</pubdate>
105   <confgroup>
106     <conftitle>XSLTUK-01</conftitle>
107     <confdates>08 Apr - 09 Apr 2001</confdates>
108     <conftitle role="address">Keble College, Oxford, UK</conftitle>
109     <confnum>1</confnum>
110   </confgroup>
111   <releaseinfo role="version">Version TEST</releaseinfo>
112   <copyright><year>2001</year>
113              <holder>Sun Microsystems, Inc.</holder></copyright>
114 </slidesinfo>]]></screen>
115 </foil>
116
117 <foil><title>Presentation Content</title>
118
119 <para>It's common for individual slides to consist of a single
120 bulleted or numbered list. However, the full range of <quote>block
121 level</quote> Simplified DocBook elements are avialable.</para>
122
123 </foil>
124 </foilgroup>
125
126 <foilgroup><title>Styling</title>
127
128 <para>How to transform a presentation.</para>
129
130 <foil><title>HTML</title>
131
132 <para>There are a lot of HTML options. When you publish your
133 presentation on the web, it's probably best to use one of the simpler,
134 more accessible styles. For your actual live presentation, you may
135 want to choose something fancier.</para>
136
137 </foil>
138
139 <foil><title>Plain HTML</title>
140
141 <itemizedlist>
142 <listitem><para><ulink url="../default/"><filename>default.xsl</filename></ulink>
143 and
144 <ulink url="../plain/"><filename>plain.xsl</filename></ulink>
145 produce fairly simple presentations
146 </para></listitem>
147 <listitem><para><ulink url="../tables/"><filename>tables.xsl</filename></ulink>
148 uses a table to show the navigation context (somewhat like the tabular
149 <ulink url="http://docbook.sourceforge.net/">Website</ulink> style)
150 </para></listitem>
151 <listitem><para><ulink url="../vslides/"><filename>vslides.xsl</filename></ulink>
152 places navigation on the left side instead of the top and bottom
153 </para></listitem>
154 <listitem><para><ulink url="../w3c/"><filename>w3c.xsl</filename></ulink>
155 produces slides that resemble the format used by the W3C for presentations
156 </para></listitem>
157 </itemizedlist>
158
159 </foil>
160
161 <foil><title>Fancy HTML</title>
162
163 <itemizedlist>
164 <listitem><para><ulink url="../frames1/frames.html"><filename>frames.xsl</filename></ulink>
165 uses frames. There are several options that you can apply:
166 </para>
167 <itemizedlist>
168 <listitem><para><ulink url="../frames2/frames.html">overlay</ulink> uses CSS absolute positioning
169 to keep the navigation static on the pages (only works on recent browsers)
170 </para></listitem>
171 <listitem><para><ulink url="../frames3/frames.html">multiframe</ulink> uses additional frames
172 to keep the navigation static on the pages
173 </para></listitem>
174 <listitem><para><ulink url="../frames4/frames.html">dynamic.toc</ulink> uses JavaScript to keep
175 the table of contents and the current slide in sync (only works on recent browsers)
176 </para></listitem>
177 <listitem><para><ulink url="../frames5/frames.html">active.toc</ulink> uses JavaScript to make
178 the table of context <quote>active</quote> so that you can open and close the foil
179 groups (only works on recent browsers)
180 </para></listitem>
181 <listitem><para>These toc styles can be combined with
182 <ulink url="../frames6/frames.html">overlay</ulink> or <ulink url="../frames7/frames.html">multiframe</ulink>
183 </para></listitem>
184 </itemizedlist>
185 </listitem>
186 </itemizedlist>
187 </foil>
188
189 <foil><title>PDF</title>
190
191 <para>The <filename>fo-plain.xsl</filename> stylesheet produces XSL Formatting
192 Objects that can subsequently be turned into PDF.</para>
193
194 </foil>
195
196 </foilgroup>
197
198 <foilgroup><title>Presentation</title>
199
200 <para>How to customize and present a set of slides.</para>
201
202 <foil><title>Look And Feel</title>
203
204 <para>For HTML display, most of the actual
205 <quote>look-and-feel</quote> of the presentation is controlled by the CSS
206 stylesheet(s) used.</para>
207
208 </foil>
209
210 <foil><title>Presentation Tips</title>
211
212 <itemizedlist>
213 <listitem><para>It's usually best if each slide is only one page (avoid scrolling).
214 </para></listitem>
215 <listitem><para>If you'll be giving your presentation with a projector, make sure you
216 know what resolution you'll have available and test your presentation at that resolution.
217 </para></listitem>
218 <listitem><para>Make your fonts bigger so the folks in the back of the room can read
219 your slides.
220 </para></listitem>
221 <listitem><para>Test the equipment before your presentation begins. Really.
222 </para></listitem>
223 <listitem><para>Speak more slowly. I always forget that one.
224 </para></listitem>
225 </itemizedlist>
226 </foil>
227
228 </foilgroup>
229
230 <foilgroup><title>Conclusions</title>
231
232 <foil><title>Conclusions</title>
233
234 <para>It's customary to have a conclusions slide.</para>
235
236 </foil>
237
238 <foil><title>References</title>
239
240 <para>References are a good idea too.</para>
241
242 </foil>
243
244 <foil><title>Q&amp;A</title>
245
246 <para>Any questions?</para>
247
248 </foil>
249 </foilgroup>
250
251 </slides>