1 | <?xml version='1.0'?>
|
---|
2 |
|
---|
3 | <dbs:slides xmlns="http://docbook.org/ns/docbook"
|
---|
4 | xmlns:dbs="http://docbook.org/ns/docbook-slides"
|
---|
5 | xmlns:xlink="http://www.w3.org/1999/xlink">
|
---|
6 | <info>
|
---|
7 | <title>The DocBook Slides Extension</title>
|
---|
8 | <titleabbrev>DocBook Slides</titleabbrev>
|
---|
9 | <author>
|
---|
10 | <personname>
|
---|
11 | <firstname>Gábor</firstname>
|
---|
12 | <surname>Kövesdán</surname>
|
---|
13 | </personname>
|
---|
14 | <affiliation>
|
---|
15 | <orgname>The DocBook Project</orgname>
|
---|
16 | </affiliation>
|
---|
17 | <email>gabor@kovesdan.org</email>
|
---|
18 | </author>
|
---|
19 | <pubdate>3 Aug 2012</pubdate>
|
---|
20 | <releaseinfo role="version">5.0</releaseinfo>
|
---|
21 | <copyright>
|
---|
22 | <year>2012</year>
|
---|
23 | <holder>Gábor Kövesdán</holder>
|
---|
24 | </copyright>
|
---|
25 | </info>
|
---|
26 |
|
---|
27 | <dbs:foil dbs:style="introduction">
|
---|
28 | <info>
|
---|
29 | <title>Introduction</title>
|
---|
30 | </info>
|
---|
31 |
|
---|
32 | <para>DocBook Slides ...</para>
|
---|
33 |
|
---|
34 | <itemizedlist>
|
---|
35 | <listitem>
|
---|
36 | <para>is a multi-namespace schema extension
|
---|
37 | to the original <link xlink:href="http://www.docbook.org/">DocBook</link>
|
---|
38 | <xref linkend="docbook5"/> schema.</para>
|
---|
39 | </listitem>
|
---|
40 |
|
---|
41 | <listitem>
|
---|
42 | <para>was originally created by
|
---|
43 | <personname><firstname>Norman</firstname><surname>Walsh</surname></personname>.</para>
|
---|
44 | </listitem>
|
---|
45 |
|
---|
46 | <listitem>
|
---|
47 | <para>and was later redesigned for DocBook 5.0 by
|
---|
48 | <personname><firstname>Gábor</firstname><surname>Kövesdán</surname></personname>.</para>
|
---|
49 | </listitem>
|
---|
50 | </itemizedlist>
|
---|
51 |
|
---|
52 | <para>This document serves for two purposes:</para>
|
---|
53 |
|
---|
54 | <itemizedlist>
|
---|
55 | <listitem>
|
---|
56 | <para>To explain DocBook Slides.</para>
|
---|
57 | </listitem>
|
---|
58 |
|
---|
59 | <listitem>
|
---|
60 | <para>To serve itself as a test document to demonstrate how
|
---|
61 | slides are marked up and how different output formats are
|
---|
62 | rendered.</para>
|
---|
63 | </listitem>
|
---|
64 | </itemizedlist>
|
---|
65 | </dbs:foil>
|
---|
66 |
|
---|
67 | <dbs:foil>
|
---|
68 | <info>
|
---|
69 | <title>Basic Concepts</title>
|
---|
70 | </info>
|
---|
71 |
|
---|
72 | <itemizedlist>
|
---|
73 | <listitem>
|
---|
74 | <para>DocBook is an XML <xref linkend="w3c-xml"/> grammar to mark up
|
---|
75 | papers and books and then process them with XML-related standards.
|
---|
76 | It concentrates on structure and semantics, not layout.</para>
|
---|
77 | </listitem>
|
---|
78 |
|
---|
79 | <listitem>
|
---|
80 | <para>DocBook Slides is an extension for DocBook to create
|
---|
81 | presentation slides.</para>
|
---|
82 | </listitem>
|
---|
83 |
|
---|
84 | <listitem>
|
---|
85 | <para>By nature, layout is part of a presentation but DocBook Slides
|
---|
86 | still focuses on structure and semantics.</para>
|
---|
87 | </listitem>
|
---|
88 |
|
---|
89 | <listitem>
|
---|
90 | <para>DocBook Slides uses almost the entire DocBook grammar and
|
---|
91 | provides only a minimal set of layout-controlling elements.
|
---|
92 | This keeps is simple and easy to use.</para>
|
---|
93 | </listitem>
|
---|
94 |
|
---|
95 | <listitem>
|
---|
96 | <para>And still, you can copy-paste, use XInclude, etc.</para>
|
---|
97 | </listitem>
|
---|
98 | </itemizedlist>
|
---|
99 | </dbs:foil>
|
---|
100 |
|
---|
101 | <dbs:foilgroup>
|
---|
102 | <info>
|
---|
103 | <title>Features of DocBook Slides</title>
|
---|
104 | </info>
|
---|
105 |
|
---|
106 | <para>Let's see some features of DocBook
|
---|
107 | Slides.</para>
|
---|
108 |
|
---|
109 | <dbs:foil>
|
---|
110 | <info>
|
---|
111 | <title>Using Namespaces</title>
|
---|
112 | </info>
|
---|
113 |
|
---|
114 | <para>DocBook Slides uses a separate namespace for its elements.
|
---|
115 | This has various advantages:</para>
|
---|
116 |
|
---|
117 | <itemizedlist>
|
---|
118 | <listitem>
|
---|
119 | <para>It isolates the extension elements and the original
|
---|
120 | DocBook schema does not have to know anything about them.</para>
|
---|
121 | </listitem>
|
---|
122 |
|
---|
123 | <listitem>
|
---|
124 | <para>It also avoids name clashes and XML processors can easily
|
---|
125 | distinguish between the two set of elements.</para>
|
---|
126 | </listitem>
|
---|
127 |
|
---|
128 | <listitem>
|
---|
129 | <para>This modular concept makes it easy to extend the official
|
---|
130 | stylesheets with specific processing.</para></listitem>
|
---|
131 | </itemizedlist>
|
---|
132 | </dbs:foil>
|
---|
133 |
|
---|
134 | <dbs:foil>
|
---|
135 | <info>
|
---|
136 | <title>Easy to Learn</title>
|
---|
137 | </info>
|
---|
138 |
|
---|
139 | <para>If you already know and use DocBook, DocBook Slides is for you:</para>
|
---|
140 |
|
---|
141 | <itemizedlist>
|
---|
142 | <listitem>
|
---|
143 | <para>You can use the usual inline and block elements when marking up
|
---|
144 | your text, you only have to learn a few new markup elements.</para>
|
---|
145 | </listitem>
|
---|
146 |
|
---|
147 | <listitem>
|
---|
148 | <para>Also, you may include DocBook fragments with XInclude.
|
---|
149 | Imagine an important table that is part of your scientific
|
---|
150 | paper and you also want to show it on a conference.
|
---|
151 | You do not have to copy-paste it but you can just have it in
|
---|
152 | one single file that you later include in both documents.</para>
|
---|
153 | </listitem>
|
---|
154 | </itemizedlist>
|
---|
155 | </dbs:foil>
|
---|
156 |
|
---|
157 | <dbs:foil>
|
---|
158 | <info>
|
---|
159 | <title>Development Status</title>
|
---|
160 | </info>
|
---|
161 |
|
---|
162 | <itemizedlist>
|
---|
163 | <listitem>
|
---|
164 | <para>DocBook Slides - just like DocBook - is an open source product
|
---|
165 | and it is under constant development and improvement.</para>
|
---|
166 | </listitem>
|
---|
167 |
|
---|
168 | <listitem>
|
---|
169 | <para>The curently supported output formats are
|
---|
170 | plain XHTML, S5 XHTML <xref linkend="s5"/>,
|
---|
171 | W3C HTML Slidy <xref linkend="slidy"/> and XSL FO <xref linkend="w3c-xslfo"/>.
|
---|
172 | In the future, support for other important
|
---|
173 | output formats (e.g. HTML5, EPUB) may be added.</para>
|
---|
174 | </listitem>
|
---|
175 | </itemizedlist>
|
---|
176 | </dbs:foil>
|
---|
177 | </dbs:foilgroup>
|
---|
178 |
|
---|
179 | <dbs:foilgroup xml:id="introductionary-examples">
|
---|
180 | <info>
|
---|
181 | <title>Tutorial Examples</title>
|
---|
182 | </info>
|
---|
183 |
|
---|
184 | <para>Let's see some basic examples.</para>
|
---|
185 |
|
---|
186 | <dbs:foil>
|
---|
187 | <info>
|
---|
188 | <title>A Minimal Markup 1</title>
|
---|
189 | </info>
|
---|
190 |
|
---|
191 | <informalexample>
|
---|
192 | <programlisting><?xml version='1.0'?>
|
---|
193 | <dbs:slides xmlns="http://docbook.org/ns/docbook"
|
---|
194 | xmlns:dbs="http://docbook.org/ns/docbook-slides"> <co xml:id="co.slides"/>
|
---|
195 | <title>Presentation Title</title> <co xml:id="co.slides.title"/>
|
---|
196 | </programlisting>
|
---|
197 |
|
---|
198 | <calloutlist>
|
---|
199 | <callout arearefs="co.slides">
|
---|
200 | <para>The root element with proper namespace declarations.</para>
|
---|
201 | </callout>
|
---|
202 |
|
---|
203 | <callout arearefs="co.slides.title">
|
---|
204 | <para>It contains the title but can have more.</para>
|
---|
205 | </callout>
|
---|
206 | </calloutlist>
|
---|
207 | </informalexample>
|
---|
208 | </dbs:foil>
|
---|
209 |
|
---|
210 | <dbs:foil>
|
---|
211 | <info>
|
---|
212 | <title>A Minimal Markup 2</title>
|
---|
213 | </info>
|
---|
214 |
|
---|
215 | <informalexample>
|
---|
216 | <programlisting>
|
---|
217 | <dbs:foil> <co xml:id="co.foil"/>
|
---|
218 | <title>Foil Title</title>
|
---|
219 | <para>Foil content</para> <co xml:id="co.foil.para"/>
|
---|
220 | </dbs:foil>
|
---|
221 | </dbs:slides></programlisting>
|
---|
222 | <calloutlist>
|
---|
223 | <callout arearefs="co.foil">
|
---|
224 | <para>At least one foil obligatory.</para>
|
---|
225 | </callout>
|
---|
226 |
|
---|
227 | <callout arearefs="co.foil.para">
|
---|
228 | <para>A foil can contain any block element from DocBook.</para>
|
---|
229 | </callout>
|
---|
230 | </calloutlist>
|
---|
231 | </informalexample>
|
---|
232 | </dbs:foil>
|
---|
233 |
|
---|
234 | <dbs:foil>
|
---|
235 | <info>
|
---|
236 | <title>The Whole Example</title>
|
---|
237 | </info>
|
---|
238 |
|
---|
239 | <para>Let's see the whole markup together:</para>
|
---|
240 |
|
---|
241 | <informalexample>
|
---|
242 | <programlisting><?xml version='1.0'?>
|
---|
243 | <dbs:slides xmlns="http://docbook.org/ns/docbook"
|
---|
244 | xmlns:dbs="http://docbook.org/ns/docbook-slides">
|
---|
245 | <title>Presentation Title</title>
|
---|
246 | <dbs:foil>
|
---|
247 | <title>Foil Title</title>
|
---|
248 | <para>Foil content</para>
|
---|
249 | </dbs:foil>
|
---|
250 | </dbs:slides></programlisting>
|
---|
251 | </informalexample>
|
---|
252 | </dbs:foil>
|
---|
253 |
|
---|
254 | <dbs:foil>
|
---|
255 | <info>
|
---|
256 | <title>Grouping Foils</title>
|
---|
257 | </info>
|
---|
258 |
|
---|
259 | <para>We can form groups of logical sets of foils and also add some
|
---|
260 | introductionary text for them. In the rendered forms, these groups
|
---|
261 | can have a table of contents of the included slides. You can also
|
---|
262 | see such groups in this presentation.</para>
|
---|
263 |
|
---|
264 | <informalexample>
|
---|
265 | <programlisting><![CDATA[<dbs:foilgroup>
|
---|
266 | <title>Group 1</title>
|
---|
267 |
|
---|
268 | <para>This is an introduction.</para>
|
---|
269 |
|
---|
270 | <dbs:foil>
|
---|
271 | ...
|
---|
272 | </dbs:foil>
|
---|
273 | </dbs:foilgroup>]]></programlisting>
|
---|
274 | </informalexample>
|
---|
275 | </dbs:foil>
|
---|
276 | </dbs:foilgroup>
|
---|
277 |
|
---|
278 | <dbs:foilgroup>
|
---|
279 | <info>
|
---|
280 | <title>Markup Examples</title>
|
---|
281 | </info>
|
---|
282 |
|
---|
283 | <para>Let's see how to create the particular foils with
|
---|
284 | DocBook Slides.</para>
|
---|
285 |
|
---|
286 | <dbs:foil>
|
---|
287 | <info>
|
---|
288 | <title>Info Content</title>
|
---|
289 | </info>
|
---|
290 |
|
---|
291 | <para>You can wrap the title into the <tag><info></tag> element that
|
---|
292 | comes from the DocBook schema. It also means you can
|
---|
293 | add the usual authoring information here:</para>
|
---|
294 |
|
---|
295 | <informalexample>
|
---|
296 | <programlisting><![CDATA[
|
---|
297 | <info>
|
---|
298 | <title>Group 1</title>
|
---|
299 |
|
---|
300 | <author>
|
---|
301 | <personname>
|
---|
302 | <firstname>John</firstname>
|
---|
303 | <surname>Doe</surname>
|
---|
304 | </personname>
|
---|
305 | <affiliation>FooBar Inc.</affiliation>
|
---|
306 | </author>
|
---|
307 |
|
---|
308 | <copyright><year>2012</year></copyright>
|
---|
309 | </info>]]></programlisting>
|
---|
310 | </informalexample>
|
---|
311 | </dbs:foil>
|
---|
312 |
|
---|
313 | <dbs:foil>
|
---|
314 | <info>
|
---|
315 | <title>Block Content</title>
|
---|
316 | </info>
|
---|
317 |
|
---|
318 | <itemizedlist>
|
---|
319 | <listitem>
|
---|
320 | <para>You have access to all of the block content elements in DocBook,
|
---|
321 | e.g. you can create a simple paragraph with
|
---|
322 | <code><para></code>, just like in DocBook.</para>
|
---|
323 | </listitem>
|
---|
324 |
|
---|
325 | <listitem>
|
---|
326 | <para>Or you can use lists, like <code><itemizedlist></code>.</para>
|
---|
327 | </listitem>
|
---|
328 | </itemizedlist>
|
---|
329 |
|
---|
330 | <programlisting>Or <programlisting> with some code or markup inside.</programlisting>
|
---|
331 | </dbs:foil>
|
---|
332 |
|
---|
333 | <dbs:foil>
|
---|
334 | <info>
|
---|
335 | <title>Inline Content</title>
|
---|
336 | </info>
|
---|
337 |
|
---|
338 | <itemizedlist>
|
---|
339 | <listitem>
|
---|
340 | <para>Just like block elements, you can also use inline DocBook
|
---|
341 | elements to mark up your content on your foils.</para>
|
---|
342 | </listitem>
|
---|
343 |
|
---|
344 | <listitem>
|
---|
345 | <para>For example, you can <emphasis>emphasize</emphasis>
|
---|
346 | something with <tag><emphasis></tag> or you
|
---|
347 | can mark <literal>literal</literal> text as such with
|
---|
348 | <tag><literal></tag>.</para>
|
---|
349 | </listitem>
|
---|
350 |
|
---|
351 | <listitem>
|
---|
352 | <para>By the way, the inline markup citation above is marked up
|
---|
353 | with <tag><tag></tag>.</para>
|
---|
354 | </listitem>
|
---|
355 |
|
---|
356 | <listitem>
|
---|
357 | <para>Apart from these, feel free to use the rest of
|
---|
358 | the markup elements.</para>
|
---|
359 | </listitem>
|
---|
360 | </itemizedlist>
|
---|
361 | </dbs:foil>
|
---|
362 |
|
---|
363 | <dbs:foil>
|
---|
364 | <info>
|
---|
365 | <title>FAQ Listings</title>
|
---|
366 | </info>
|
---|
367 |
|
---|
368 | <qandaset>
|
---|
369 | <qandaentry>
|
---|
370 | <question>
|
---|
371 | <para>What else can I use to make my slides useful
|
---|
372 | and practical?</para>
|
---|
373 | </question>
|
---|
374 |
|
---|
375 | <answer>
|
---|
376 | <para>You can include some questions and answers with
|
---|
377 | <tag><qandaset></tag> and related elements to answer some
|
---|
378 | frequently asked questions.</para>
|
---|
379 | </answer>
|
---|
380 | </qandaentry>
|
---|
381 | </qandaset>
|
---|
382 | </dbs:foil>
|
---|
383 |
|
---|
384 | <dbs:foil>
|
---|
385 | <info>
|
---|
386 | <title>References</title>
|
---|
387 | </info>
|
---|
388 |
|
---|
389 | <itemizedlist>
|
---|
390 | <listitem>
|
---|
391 | <para>Sometimes you need to add some remarks and some
|
---|
392 | references to your slide content.</para>
|
---|
393 | </listitem>
|
---|
394 |
|
---|
395 | <listitem>
|
---|
396 | <para>For small remarks, you can use the
|
---|
397 | <code><footnote></code> element to insert a footnote
|
---|
398 | that will appear on the same foil where it is inserted.</para>
|
---|
399 | </listitem>
|
---|
400 |
|
---|
401 | <listitem>
|
---|
402 | <para>Or for references to external content
|
---|
403 | - books and websites - you can include one or more
|
---|
404 | bibliography foils in the end.</para>
|
---|
405 | </listitem>
|
---|
406 |
|
---|
407 | <listitem>
|
---|
408 | <para>On these foils, instead of the usual bulleted points, use the
|
---|
409 | <code><bibliography></code> element and you
|
---|
410 | will get a nicely formatted reference list.</para>
|
---|
411 | </listitem>
|
---|
412 |
|
---|
413 | <listitem>
|
---|
414 | <para>Use <code><xref></code> in the content
|
---|
415 | to generate a link to the reference entry.</para>
|
---|
416 | </listitem>
|
---|
417 | </itemizedlist>
|
---|
418 | </dbs:foil>
|
---|
419 |
|
---|
420 | <dbs:foil dbs:incremental="1">
|
---|
421 | <info>
|
---|
422 | <title>Incremental Slides</title>
|
---|
423 | </info>
|
---|
424 |
|
---|
425 | <itemizedlist>
|
---|
426 | <listitem>
|
---|
427 | <para>If you set the <code>dbs:incremental</code> attribute ...</para>
|
---|
428 | </listitem>
|
---|
429 |
|
---|
430 | <listitem>
|
---|
431 | <para>... to <literal>1</literal> on a foil, ...</para>
|
---|
432 | </listitem>
|
---|
433 |
|
---|
434 | <listitem>
|
---|
435 | <para>... then you will get incremental lists, ...</para>
|
---|
436 | </listitem>
|
---|
437 |
|
---|
438 | <listitem>
|
---|
439 | <para>... like this if they are supported in the output format. (XHTML-based)</para>
|
---|
440 | </listitem>
|
---|
441 | </itemizedlist>
|
---|
442 | </dbs:foil>
|
---|
443 |
|
---|
444 | <dbs:foil dbs:collapsible="1">
|
---|
445 | <info>
|
---|
446 | <title>Collapsible Lists</title>
|
---|
447 | </info>
|
---|
448 |
|
---|
449 | <para>You can see a collapsible list below (depending on the output
|
---|
450 | format). Click on the node to expand it.</para>
|
---|
451 |
|
---|
452 | <orderedlist>
|
---|
453 | <listitem>
|
---|
454 | <orderedlist>
|
---|
455 | <listitem>
|
---|
456 | <para>If you set the <code>dbs:collapsible</code> attribute ...</para>
|
---|
457 | </listitem>
|
---|
458 |
|
---|
459 | <listitem>
|
---|
460 | <para>... to <literal>1</literal> on a foil, ...</para>
|
---|
461 | </listitem>
|
---|
462 |
|
---|
463 | <listitem>
|
---|
464 | <para>... then you will get collapsible lists, ...</para>
|
---|
465 | </listitem>
|
---|
466 |
|
---|
467 | <listitem>
|
---|
468 | <para>... like this if they are supported in the output format. (Slidy)</para>
|
---|
469 | </listitem>
|
---|
470 | </orderedlist>
|
---|
471 | </listitem>
|
---|
472 | </orderedlist>
|
---|
473 | </dbs:foil>
|
---|
474 |
|
---|
475 | <dbs:foil>
|
---|
476 | <info>
|
---|
477 | <title>Building Blocks</title>
|
---|
478 | </info>
|
---|
479 |
|
---|
480 | <itemizedlist>
|
---|
481 | <listitem>
|
---|
482 | <para>Slides are layout-oriented documents; formatting
|
---|
483 | is a crucial part of them.</para>
|
---|
484 | </listitem>
|
---|
485 |
|
---|
486 | <listitem>
|
---|
487 | <para>DocBook aims to separate structure and layout but for
|
---|
488 | Slides sometimes it is not entirely possible, yet the
|
---|
489 | layout-related markup is tried to be kept minimal.</para>
|
---|
490 | </listitem>
|
---|
491 |
|
---|
492 | <listitem>
|
---|
493 | <para>You can use the <tag><dbs:block></tag> element
|
---|
494 | that will be transformed to a container type in the
|
---|
495 | generated document (e.g. <tag><div></tag> in HTML).</para>
|
---|
496 | </listitem>
|
---|
497 |
|
---|
498 | <listitem>
|
---|
499 | <para>You can also apply the <literal>dbs:style</literal> attribute
|
---|
500 | to blocks and you can even embed them into each other.</para>
|
---|
501 | </listitem>
|
---|
502 |
|
---|
503 | <listitem>
|
---|
504 | <para>Use CSS or extend the XSLT stylesheets to control
|
---|
505 | renering of your custom blocks.</para>
|
---|
506 | </listitem>
|
---|
507 | </itemizedlist>
|
---|
508 | </dbs:foil>
|
---|
509 |
|
---|
510 | <dbs:foil>
|
---|
511 | <info>
|
---|
512 | <title>Block Example</title>
|
---|
513 | </info>
|
---|
514 |
|
---|
515 | <dbs:block dbs:style="left">
|
---|
516 | <para>This is the left block.</para>
|
---|
517 | </dbs:block>
|
---|
518 |
|
---|
519 | <dbs:block dbs:style="right" dbs:incremental="1">
|
---|
520 | <para>This is the right block. And it is marked incremental.</para>
|
---|
521 | </dbs:block>
|
---|
522 | </dbs:foil>
|
---|
523 | </dbs:foilgroup>
|
---|
524 |
|
---|
525 | <dbs:foilgroup>
|
---|
526 | <title>Images and Formulas</title>
|
---|
527 |
|
---|
528 | <dbs:foil>
|
---|
529 | <info>
|
---|
530 | <title>Incremental Images</title>
|
---|
531 | </info>
|
---|
532 |
|
---|
533 | <para>This is only supported in XHTML-based output.</para>
|
---|
534 |
|
---|
535 | <dbs:block dbs:incremental="1" dbs:style="face_container">
|
---|
536 | <mediaobject>
|
---|
537 | <imageobject>
|
---|
538 | <imagedata dbs:style="face_first" fileref="images/face1.gif"/>
|
---|
539 | </imageobject>
|
---|
540 | </mediaobject>
|
---|
541 |
|
---|
542 | <mediaobject>
|
---|
543 | <imageobject>
|
---|
544 | <imagedata dbs:style="face_other" fileref="images/face2.gif"/>
|
---|
545 | </imageobject>
|
---|
546 | </mediaobject>
|
---|
547 |
|
---|
548 | <mediaobject>
|
---|
549 | <imageobject>
|
---|
550 | <imagedata dbs:style="face_other" fileref="images/face3.gif"/>
|
---|
551 | </imageobject>
|
---|
552 | </mediaobject>
|
---|
553 |
|
---|
554 | <mediaobject>
|
---|
555 | <imageobject>
|
---|
556 | <imagedata dbs:style="face_other" fileref="images/face4.gif"/>
|
---|
557 | </imageobject>
|
---|
558 | </mediaobject>
|
---|
559 | </dbs:block>
|
---|
560 | </dbs:foil>
|
---|
561 |
|
---|
562 | <dbs:foil>
|
---|
563 | <info>
|
---|
564 | <title>Embedded SVG</title>
|
---|
565 | </info>
|
---|
566 |
|
---|
567 | <para>You can embed SVG
|
---|
568 | <footnote><para>See <uri xlink:href="http://www.w3.org/TR/SVG11/">http://www.w3.org/TR/SVG11/</uri>.</para></footnote>
|
---|
569 | code, like this:</para>
|
---|
570 |
|
---|
571 | <programlisting><![CDATA[<svg xml:id="circle"
|
---|
572 | xmlns="http://www.w3.org/2000/svg"
|
---|
573 | version="1.1">
|
---|
574 | <circle cx="100" cy="50" r="40" stroke="black"
|
---|
575 | stroke-width="2" fill="yellow" />
|
---|
576 | </svg>]]></programlisting>
|
---|
577 |
|
---|
578 | <svg xml:id="circle" xmlns="http://www.w3.org/2000/svg" version="1.1">
|
---|
579 | <circle cx="100" cy="50" r="40" stroke="black" stroke-width="2" fill="yellow" />
|
---|
580 | </svg>
|
---|
581 | </dbs:foil>
|
---|
582 |
|
---|
583 | <dbs:foil>
|
---|
584 | <info>
|
---|
585 | <title>Embedded MathML</title>
|
---|
586 | </info>
|
---|
587 |
|
---|
588 | <para>You can embed MathML
|
---|
589 | <footnote><para>See <uri xlink:href="http://www.w3.org/TR/MathML3/">http://www.w3.org/TR/MathML3/</uri>.</para></footnote>
|
---|
590 | code, like this:</para>
|
---|
591 |
|
---|
592 | <programlisting><![CDATA[<math xml:id="identity-matrix-2dim"
|
---|
593 | xmlns="http://www.w3.org/1998/Math/MathML">
|
---|
594 | <matrix>
|
---|
595 | <matrixrow><cn>1</cn><cn>0</cn></matrixrow>
|
---|
596 | <matrixrow><cn>0</cn><cn>1</cn></matrixrow>
|
---|
597 | </matrix>
|
---|
598 | </math>]]></programlisting>
|
---|
599 |
|
---|
600 | <math xml:id="identity-matrix-2dim" xmlns="http://www.w3.org/1998/Math/MathML">
|
---|
601 | <matrix>
|
---|
602 | <matrixrow><cn>1</cn><cn>0</cn></matrixrow>
|
---|
603 | <matrixrow><cn>0</cn><cn>1</cn></matrixrow>
|
---|
604 | </matrix>
|
---|
605 | </math>
|
---|
606 | </dbs:foil>
|
---|
607 | </dbs:foilgroup>
|
---|
608 |
|
---|
609 | <dbs:foilgroup>
|
---|
610 | <info>
|
---|
611 | <title>Presentation</title>
|
---|
612 | </info>
|
---|
613 |
|
---|
614 | <dbs:foil>
|
---|
615 | <info>
|
---|
616 | <title>Available Formats</title>
|
---|
617 | </info>
|
---|
618 |
|
---|
619 | <informaltable>
|
---|
620 | <tgroup cols="2">
|
---|
621 | <thead>
|
---|
622 | <row><entry>Stylesheet</entry><entry>Description.</entry></row>
|
---|
623 | </thead>
|
---|
624 |
|
---|
625 | <tbody>
|
---|
626 | <row>
|
---|
627 | <entry>xhtml/plain.xsl</entry>
|
---|
628 | <entry>Single plain XHTML file.</entry>
|
---|
629 | </row>
|
---|
630 |
|
---|
631 | <row>
|
---|
632 | <entry>xhtml/slidy.xsl</entry>
|
---|
633 | <entry>Single XHTL file in W3C HTML Slidy format.</entry>
|
---|
634 | </row>
|
---|
635 |
|
---|
636 | <row>
|
---|
637 | <entry>xhtml/s5.xsl</entry>
|
---|
638 | <entry>Single XHTML file in S5 format.</entry>
|
---|
639 | </row>
|
---|
640 |
|
---|
641 | <row>
|
---|
642 | <entry>fo/plain.xsl</entry>
|
---|
643 | <entry>XSL Formatting Objects for printed output.</entry>
|
---|
644 | </row>
|
---|
645 |
|
---|
646 | </tbody>
|
---|
647 | </tgroup>
|
---|
648 | </informaltable>
|
---|
649 | </dbs:foil>
|
---|
650 |
|
---|
651 | <dbs:foil>
|
---|
652 | <info>
|
---|
653 | <title>Plain XHTML</title>
|
---|
654 | </info>
|
---|
655 |
|
---|
656 | <itemizedlist>
|
---|
657 | <listitem>
|
---|
658 | <para>It is a simple plain <acronym>XHTML</acronym> output with
|
---|
659 | some classes given on the elements. These let you create your
|
---|
660 | own CSS stylesheet for the rendering.</para>
|
---|
661 | </listitem>
|
---|
662 |
|
---|
663 | <listitem>
|
---|
664 | <para>It is actually quite similar to the
|
---|
665 | <acronym>S<superscript>5</superscript></acronym> format with
|
---|
666 | <acronym>S<superscript>5</superscript></acronym>-specific
|
---|
667 | parts removed. The objective with this format was simplicity
|
---|
668 | and <acronym>S<superscript>5</superscript></acronym>
|
---|
669 | already achieves that quite well but in case you do not want
|
---|
670 | to use that framework, you can create your own one.</para>
|
---|
671 | </listitem>
|
---|
672 |
|
---|
673 | <listitem>
|
---|
674 | <para>The stylesheet to choose for this format is
|
---|
675 | <filename>xhtml/plain.xsl</filename>.</para>
|
---|
676 | </listitem>
|
---|
677 | </itemizedlist>
|
---|
678 | </dbs:foil>
|
---|
679 |
|
---|
680 | <dbs:foil>
|
---|
681 | <info>
|
---|
682 | <title>W3C HTML Slidy</title>
|
---|
683 | </info>
|
---|
684 |
|
---|
685 | <itemizedlist>
|
---|
686 | <listitem>
|
---|
687 | <para>W3C <uri xlink:href="http://www.w3.org/Talks/Tools/Slidy2/">HTML Slidy</uri>
|
---|
688 | is an XHTML framework for presentations.</para>
|
---|
689 | </listitem>
|
---|
690 |
|
---|
691 | <listitem>
|
---|
692 | <para>It seems mature and well maintained.</para>
|
---|
693 | </listitem>
|
---|
694 |
|
---|
695 | <listitem>
|
---|
696 | <para>HTML Slidy handles well long content. Its formatting
|
---|
697 | allows more text on a single foil and even if your text
|
---|
698 | overflows, you can scroll inside the single foil. It also
|
---|
699 | supports collapsible lists and a JavaScript clock so that you
|
---|
700 | do not run out of time.</para>
|
---|
701 | </listitem>
|
---|
702 |
|
---|
703 | <listitem>
|
---|
704 | <para>For HTML Slidy, use
|
---|
705 | <filename>xhtml/slidy.xsl</filename>.</para>
|
---|
706 | </listitem>
|
---|
707 | </itemizedlist>
|
---|
708 | </dbs:foil>
|
---|
709 |
|
---|
710 | <dbs:foil>
|
---|
711 | <info>
|
---|
712 | <title>S5 Format</title>
|
---|
713 | </info>
|
---|
714 |
|
---|
715 | <itemizedlist>
|
---|
716 | <listitem>
|
---|
717 | <para><acronym xlink:href="http://meyerweb.com/eric/tools/s5/">S<superscript>5</superscript></acronym>
|
---|
718 | stands for <emphasis>Simple Standards-Based Slide Show System</emphasis>.</para>
|
---|
719 | </listitem>
|
---|
720 |
|
---|
721 | <listitem>
|
---|
722 | <para>It is yet another XHTML-based framework for slideshows, like
|
---|
723 | HTML Slidy.</para>
|
---|
724 | </listitem>
|
---|
725 |
|
---|
726 | <listitem>
|
---|
727 | <para>Its JavaScript code behaves somewhat differently and it is less
|
---|
728 | mature.</para>
|
---|
729 | </listitem>
|
---|
730 |
|
---|
731 | <listitem>
|
---|
732 | <para>It supports incremental lists but in general, it is not so
|
---|
733 | feature-rich as HTML Slidy.</para>
|
---|
734 | </listitem>
|
---|
735 |
|
---|
736 | <listitem>
|
---|
737 | <para>To create your <acronym>S<superscript>5</superscript></acronym>
|
---|
738 | presentation, pick the
|
---|
739 | <filename>xhtml/s5.xsl</filename> stylesheet.</para>
|
---|
740 | </listitem>
|
---|
741 | </itemizedlist>
|
---|
742 | </dbs:foil>
|
---|
743 |
|
---|
744 | <dbs:foil>
|
---|
745 | <info>
|
---|
746 | <title>XSL FO Format</title>
|
---|
747 | </info>
|
---|
748 |
|
---|
749 | <itemizedlist>
|
---|
750 | <listitem>
|
---|
751 | <para>XSL FO is an XML vocabulary to describe how formatted
|
---|
752 | output is presented.</para>
|
---|
753 | </listitem>
|
---|
754 |
|
---|
755 | <listitem>
|
---|
756 | <para>It is used here as an intermediate format between DocBook Slides
|
---|
757 | and printable output.</para>
|
---|
758 | </listitem>
|
---|
759 |
|
---|
760 | <listitem>
|
---|
761 | <para>First, generate the XSL FO document.</para>
|
---|
762 | </listitem>
|
---|
763 |
|
---|
764 | <listitem>
|
---|
765 | <para>Then use your XSL FO processor to render your printable
|
---|
766 | document in PDF, PostScript, etc. depending on the capabilities of
|
---|
767 | the software you use.</para>
|
---|
768 | </listitem>
|
---|
769 |
|
---|
770 | <listitem>
|
---|
771 | <para>If you need a free processor, take a look at
|
---|
772 | Apache FOP <xref linkend="fop"/>.</para>
|
---|
773 | </listitem>
|
---|
774 | </itemizedlist>
|
---|
775 | </dbs:foil>
|
---|
776 |
|
---|
777 | <dbs:foil>
|
---|
778 | <info>
|
---|
779 | <title>XSLT Parameters</title>
|
---|
780 | </info>
|
---|
781 |
|
---|
782 | <itemizedlist>
|
---|
783 | <listitem>
|
---|
784 | <para>The provided stylesheets offer XSLT <xref linkend="w3c-xslt"/> parameters
|
---|
785 | to adjust some tunables of the output generation.</para>
|
---|
786 | </listitem>
|
---|
787 |
|
---|
788 | <listitem>
|
---|
789 | <para>The parameters are documented in the documentation
|
---|
790 | that accompanies the DocBook XSL distribution.</para>
|
---|
791 | </listitem>
|
---|
792 |
|
---|
793 | <listitem>
|
---|
794 | <para>All the DocBook Slides stylesheets are extensions of the
|
---|
795 | original DocBook stylesheets so adjusting their parameters may also
|
---|
796 | affect your rendered slides.</para>
|
---|
797 | </listitem>
|
---|
798 | </itemizedlist>
|
---|
799 | </dbs:foil>
|
---|
800 |
|
---|
801 | <dbs:foil>
|
---|
802 | <info>
|
---|
803 | <title>Customizations</title>
|
---|
804 | </info>
|
---|
805 |
|
---|
806 | <para>Sometimes parameters are not enough and you need to modify
|
---|
807 | the templates to achieve your goal. Customizations are easy
|
---|
808 | to create with XSLT.</para>
|
---|
809 |
|
---|
810 | <orderedlist>
|
---|
811 | <listitem>
|
---|
812 | <para>Just pick up a stylesheet that you want to customize.</para>
|
---|
813 | </listitem>
|
---|
814 |
|
---|
815 | <listitem>
|
---|
816 | <para>Create a new, empty stylesheet that imports the original
|
---|
817 | one.</para>
|
---|
818 | </listitem>
|
---|
819 |
|
---|
820 | <listitem>
|
---|
821 | <para>Override the original templates that do not work
|
---|
822 | in the way you desire.</para>
|
---|
823 | </listitem>
|
---|
824 |
|
---|
825 | <listitem>
|
---|
826 | <para>Of course, this requires some knowledge in XSLT and
|
---|
827 | you will need to read the code to see what to override.</para>
|
---|
828 | </listitem>
|
---|
829 | </orderedlist>
|
---|
830 | </dbs:foil>
|
---|
831 | </dbs:foilgroup>
|
---|
832 |
|
---|
833 | <dbs:foilgroup>
|
---|
834 | <info>
|
---|
835 | <title>Authoring with DocBook Slides 5.0</title>
|
---|
836 | </info>
|
---|
837 |
|
---|
838 | <dbs:foil>
|
---|
839 | <info>
|
---|
840 | <title>Choosing a Validator</title>
|
---|
841 | </info>
|
---|
842 |
|
---|
843 | <itemizedlist>
|
---|
844 | <listitem>
|
---|
845 | <para>Once you have some slides marked up in DocBook Slides,
|
---|
846 | you probably want to make sure your markup is valid. Otherwise,
|
---|
847 | it is not guaranteed that the output will be generated properly.
|
---|
848 | For this, you need a validator.</para>
|
---|
849 | </listitem>
|
---|
850 |
|
---|
851 | <listitem>
|
---|
852 | <para>The DocBook Slides schema is described in the RELAX-NG grammar language.</para>
|
---|
853 | </listitem>
|
---|
854 |
|
---|
855 | <listitem>
|
---|
856 | <para>The recommended RELAX-NG validator is
|
---|
857 | <application>jing</application> <xref linkend="jing"/>.</para>
|
---|
858 | </listitem>
|
---|
859 |
|
---|
860 | <listitem>
|
---|
861 | <para>Alternatively, you can use <application>Emacs/nXML</application>
|
---|
862 | with the supplied <filename>locatingrules.xml</filename> file.</para>
|
---|
863 | </listitem>
|
---|
864 | </itemizedlist>
|
---|
865 |
|
---|
866 | <warning>
|
---|
867 | <para>The RELAX-NG validation in the xmllint program from libxml2 is known to have
|
---|
868 | bugs and does not work correctly with DocBook Slides.</para>
|
---|
869 | </warning>
|
---|
870 | </dbs:foil>
|
---|
871 |
|
---|
872 | <dbs:foil>
|
---|
873 | <info>
|
---|
874 | <title>Validating Slides</title>
|
---|
875 | </info>
|
---|
876 |
|
---|
877 | <itemizedlist>
|
---|
878 | <listitem>
|
---|
879 | <para>With <command>jing</command>, run:
|
---|
880 | <userinput>jing ~/docbook-slides/slides.rng foo.xml</userinput>.</para>
|
---|
881 | </listitem>
|
---|
882 |
|
---|
883 | <listitem>
|
---|
884 | <para>For <application>Emacs/nXML</application>, you can put the following into
|
---|
885 | your <filename>emacs.conf</filename>:</para>
|
---|
886 |
|
---|
887 | <programlisting>
|
---|
888 | (setq rng-schema-locating-files
|
---|
889 | (append
|
---|
890 | '("~/docbook-slides/locatingrules.xml")))</programlisting>
|
---|
891 |
|
---|
892 | <para>Or you can do <userinput>M-x customize-variable rng-schema-locating-files</userinput>
|
---|
893 | and then add the absolute path to the file.</para>
|
---|
894 | </listitem>
|
---|
895 | </itemizedlist>
|
---|
896 | </dbs:foil>
|
---|
897 |
|
---|
898 | <dbs:foil>
|
---|
899 | <info>
|
---|
900 | <title>Transforming DocBook Slides Documents</title>
|
---|
901 | </info>
|
---|
902 |
|
---|
903 | <itemizedlist>
|
---|
904 | <listitem>
|
---|
905 | <para>You need an XSLT processor to transform the documents.
|
---|
906 | For example, you can use either <command>xsltproc</command> from
|
---|
907 | <application>libxslt</application> <xref linkend="libxslt"/>, <application>Xalan</application>
|
---|
908 | or <application>Saxon</application>.</para>
|
---|
909 | </listitem>
|
---|
910 |
|
---|
911 | <listitem>
|
---|
912 | <para>It is recommended to use <command>xsltproc</command>, since
|
---|
913 | it is significantly faster than the other two and the DocBook Slides
|
---|
914 | stylesheets were also tested with it.</para>
|
---|
915 | </listitem>
|
---|
916 |
|
---|
917 | <listitem>
|
---|
918 | <para>Pick the proper stylesheet for your chosen output format.
|
---|
919 | For example, it is <filename>xhtml/slidy.xsl</filename> for
|
---|
920 | HTML Slidy.</para>
|
---|
921 | </listitem>
|
---|
922 |
|
---|
923 | <listitem>
|
---|
924 | <para>Type: <userinput>xsltproc xsl/slides/xhtml/slidy.xsl foo.xml > foo.html</userinput></para>
|
---|
925 | </listitem>
|
---|
926 | </itemizedlist>
|
---|
927 | </dbs:foil>
|
---|
928 |
|
---|
929 | <dbs:foil>
|
---|
930 | <info>
|
---|
931 | <title>Rendering Printable Output</title>
|
---|
932 | </info>
|
---|
933 |
|
---|
934 | <itemizedlist>
|
---|
935 | <listitem>
|
---|
936 | <para>First create the XSL FO document with XSLT:
|
---|
937 | <userinput>xsltproc xsl/slides/fo/plain.xsl foo.xml > foo.fo</userinput></para>
|
---|
938 | </listitem>
|
---|
939 |
|
---|
940 | <listitem>
|
---|
941 | <para>Then use your XSL FO processor to render the final document.</para>
|
---|
942 | </listitem>
|
---|
943 |
|
---|
944 | <listitem>
|
---|
945 | <para>For example, to render a PDF with Apache FOP, type:
|
---|
946 | <userinput>fop foo.fo foo.pdf</userinput></para>
|
---|
947 | </listitem>
|
---|
948 | </itemizedlist>
|
---|
949 | </dbs:foil>
|
---|
950 | </dbs:foilgroup>
|
---|
951 |
|
---|
952 | <dbs:foilgroup>
|
---|
953 | <info>
|
---|
954 | <title>DocBook Slides Limitations</title>
|
---|
955 | </info>
|
---|
956 |
|
---|
957 | <dbs:foil>
|
---|
958 | <info>
|
---|
959 | <title>Foil Content</title>
|
---|
960 | </info>
|
---|
961 |
|
---|
962 | <para>Creating slides is quite different from creating
|
---|
963 | papers and books.</para>
|
---|
964 |
|
---|
965 | <itemizedlist>
|
---|
966 | <listitem>
|
---|
967 | <para>Presentational slide are layout-oriented by nature as opposed to DocBook, which is
|
---|
968 | structure-oriented. The content of the foil must fit but there
|
---|
969 | is no easy way to detect this so this should be checked
|
---|
970 | and controlled manually.</para>
|
---|
971 | </listitem>
|
---|
972 |
|
---|
973 | <listitem>
|
---|
974 | <para>Formatting of slide content is not necessarily consistent but part
|
---|
975 | of the design of each foil and illustration used in
|
---|
976 | the presentation, while an important principle of
|
---|
977 | DocBook is separating content and styling. To achieve
|
---|
978 | something very unique, you will probably need heavy
|
---|
979 | customization.</para>
|
---|
980 | </listitem>
|
---|
981 | </itemizedlist>
|
---|
982 | </dbs:foil>
|
---|
983 |
|
---|
984 | <dbs:foil>
|
---|
985 | <info>
|
---|
986 | <title>Animations and Sound Effects</title>
|
---|
987 | </info>
|
---|
988 |
|
---|
989 | <para>DocBook was invented for mostly printed or web
|
---|
990 | content, while slides are rarely presented in a
|
---|
991 | printed form.</para>
|
---|
992 |
|
---|
993 | <itemizedlist>
|
---|
994 | <listitem>
|
---|
995 | <para>Slides are usually shown on computer screen or
|
---|
996 | projector and may heavily use animated or audio content
|
---|
997 | to support the presentations.</para>
|
---|
998 | </listitem>
|
---|
999 |
|
---|
1000 | <listitem>
|
---|
1001 | <para>Most of the possible output formats are usually
|
---|
1002 | used in printed form or on the web. The first lacks
|
---|
1003 | the possibility of animated and audio content and the
|
---|
1004 | second one lacks good open standards for doing so.</para>
|
---|
1005 | </listitem>
|
---|
1006 |
|
---|
1007 | <listitem>
|
---|
1008 | <para>Maybe a future HTML5 or OpenDocument support
|
---|
1009 | can bring in some new features but for now, you cannot
|
---|
1010 | really use animations and sound.</para>
|
---|
1011 | </listitem>
|
---|
1012 | </itemizedlist>
|
---|
1013 | </dbs:foil>
|
---|
1014 | </dbs:foilgroup>
|
---|
1015 |
|
---|
1016 | <dbs:foilgroup>
|
---|
1017 | <info>
|
---|
1018 | <title>Frequently Asked Questions</title>
|
---|
1019 | </info>
|
---|
1020 |
|
---|
1021 | <dbs:foil>
|
---|
1022 | <info>
|
---|
1023 | <title>Compatibility</title>
|
---|
1024 | </info>
|
---|
1025 |
|
---|
1026 | <qandaset>
|
---|
1027 | <qandaentry>
|
---|
1028 | <question>
|
---|
1029 | <para>Is DocBook Slides 5.0 stylesheets compatible with
|
---|
1030 | older versions of DocBook Slides or vice versa?</para>
|
---|
1031 | </question>
|
---|
1032 |
|
---|
1033 | <answer>
|
---|
1034 | <para>Not at all, since it is heavily redesigned. But
|
---|
1035 | you can find an XSLT transformation in the
|
---|
1036 | <filename class="directory">tools/</filename>
|
---|
1037 | directory, which can convert your slides to the new
|
---|
1038 | schema.</para>
|
---|
1039 | </answer>
|
---|
1040 | </qandaentry>
|
---|
1041 | </qandaset>
|
---|
1042 | </dbs:foil>
|
---|
1043 |
|
---|
1044 | <dbs:foil>
|
---|
1045 | <info>
|
---|
1046 | <title>Contribution</title>
|
---|
1047 | </info>
|
---|
1048 |
|
---|
1049 | <qandaset>
|
---|
1050 | <qandaentry>
|
---|
1051 | <question>
|
---|
1052 | <para>Can I contribute to the schema or to the stylesheets?</para>
|
---|
1053 | </question>
|
---|
1054 |
|
---|
1055 | <answer>
|
---|
1056 | <para>Of course, any contribution that can be useful for
|
---|
1057 | other users and fits the concept of DocBook Slides
|
---|
1058 | is more than welcome.</para>
|
---|
1059 | </answer>
|
---|
1060 | </qandaentry>
|
---|
1061 |
|
---|
1062 | <qandaentry>
|
---|
1063 | <question>
|
---|
1064 | <para>What to do with my contribution?</para>
|
---|
1065 | </question>
|
---|
1066 |
|
---|
1067 | <answer>
|
---|
1068 | <para>Please first ask review on
|
---|
1069 | the <link xlink:href="mailto:docbook-apps@lists.oasis-open.org">docbook-apps
|
---|
1070 | mailing list</link> and users and other developers will tell you
|
---|
1071 | what to improve and how to submit your work for inclusion.</para>
|
---|
1072 | </answer>
|
---|
1073 | </qandaentry>
|
---|
1074 | </qandaset>
|
---|
1075 | </dbs:foil>
|
---|
1076 |
|
---|
1077 | <dbs:foil>
|
---|
1078 | <info>
|
---|
1079 | <title>Help</title>
|
---|
1080 | </info>
|
---|
1081 |
|
---|
1082 | <qandaset>
|
---|
1083 | <qandaentry>
|
---|
1084 | <question>
|
---|
1085 | <para>How can I get help in using the schema and the
|
---|
1086 | accompanying stylesheets?</para>
|
---|
1087 | </question>
|
---|
1088 |
|
---|
1089 | <answer>
|
---|
1090 | <para>There is a
|
---|
1091 | <link xlink:href="mailto:docbook-apps@lists.oasis-open.org">docbook-apps
|
---|
1092 | mailing list</link> for general questions on DocBook and related
|
---|
1093 | technologies. There are numerous users and developers subscribed to
|
---|
1094 | this list, so probably you can get help there.</para>
|
---|
1095 | </answer>
|
---|
1096 | </qandaentry>
|
---|
1097 | </qandaset>
|
---|
1098 | </dbs:foil>
|
---|
1099 | </dbs:foilgroup>
|
---|
1100 |
|
---|
1101 | <dbs:foilgroup>
|
---|
1102 | <info>
|
---|
1103 | <title>Mini-Reference</title>
|
---|
1104 | </info>
|
---|
1105 |
|
---|
1106 | <para>Here you have the short and informal description of the DocBook
|
---|
1107 | Slides elements. It is not meant to be a full and formalized
|
---|
1108 | referenced but rather a cheatsheet to look at.</para>
|
---|
1109 |
|
---|
1110 | <dbs:foil>
|
---|
1111 | <info>
|
---|
1112 | <title>dbs:slides</title>
|
---|
1113 | </info>
|
---|
1114 |
|
---|
1115 | <itemizedlist>
|
---|
1116 | <listitem>
|
---|
1117 | <para><emphasis>May contain:</emphasis> db:title, db:titleabbrev,
|
---|
1118 | db:subtitle, db:info, dbs:foilgroup, dbs:foil</para>
|
---|
1119 | </listitem>
|
---|
1120 |
|
---|
1121 | <listitem>
|
---|
1122 | <para><emphasis>Usage:</emphasis> It is the root element that encloses the authoring
|
---|
1123 | info and the particular foils that may be grouped to foil
|
---|
1124 | groups.</para>
|
---|
1125 | </listitem>
|
---|
1126 | </itemizedlist>
|
---|
1127 | </dbs:foil>
|
---|
1128 |
|
---|
1129 | <dbs:foil>
|
---|
1130 | <info>
|
---|
1131 | <title>dbs:foilgroup</title>
|
---|
1132 | </info>
|
---|
1133 |
|
---|
1134 | <itemizedlist>
|
---|
1135 | <listitem>
|
---|
1136 | <para><emphasis>May contain:</emphasis> db:title, db:titleabbev,
|
---|
1137 | db:subtitle, db:info, [block content], dbs:foil, dbs:speakernotes,
|
---|
1138 | dbs:handoutnotes</para>
|
---|
1139 | </listitem>
|
---|
1140 |
|
---|
1141 | <listitem>
|
---|
1142 | <para><emphasis>Usage:</emphasis> It groups together various foils. It can have its own info
|
---|
1143 | section and an optional introductionary text. Depending on your XSLT
|
---|
1144 | parameters, it may generate a table of contents of enclosed foils.
|
---|
1145 | Its usage is not obligatory but may be very useful for grouping together
|
---|
1146 | logically related foils. It may have some speaker notes and handout notes, as well.</para>
|
---|
1147 | </listitem>
|
---|
1148 | </itemizedlist>
|
---|
1149 | </dbs:foil>
|
---|
1150 |
|
---|
1151 | <dbs:foil>
|
---|
1152 | <info>
|
---|
1153 | <title>dbs:foil</title>
|
---|
1154 | </info>
|
---|
1155 |
|
---|
1156 | <itemizedlist>
|
---|
1157 | <listitem>
|
---|
1158 | <para><emphasis>May contain:</emphasis> db:title, db:titleabbev,
|
---|
1159 | db:subtitle, db:info, [block content], dbs:speakernotes,
|
---|
1160 | dbs:handoutnotes</para>
|
---|
1161 | </listitem>
|
---|
1162 |
|
---|
1163 | <listitem>
|
---|
1164 | <para><emphasis>Usage:</emphasis> It marks up a single foil. Use
|
---|
1165 | DocBook block elements to mark up your content. It may have some speaker
|
---|
1166 | notes and handout notes, as well.</para>
|
---|
1167 | </listitem>
|
---|
1168 | </itemizedlist>
|
---|
1169 | </dbs:foil>
|
---|
1170 |
|
---|
1171 | <dbs:foil>
|
---|
1172 | <info>
|
---|
1173 | <title>dbs:block</title>
|
---|
1174 | </info>
|
---|
1175 |
|
---|
1176 | <itemizedlist>
|
---|
1177 | <listitem>
|
---|
1178 | <para><emphasis>May contain:</emphasis> [block content]</para>
|
---|
1179 | </listitem>
|
---|
1180 |
|
---|
1181 | <listitem>
|
---|
1182 | <para><emphasis>Usage:</emphasis> It divides the content into layout units
|
---|
1183 | that can later processed in a specific way.</para>
|
---|
1184 | </listitem>
|
---|
1185 | </itemizedlist>
|
---|
1186 | </dbs:foil>
|
---|
1187 |
|
---|
1188 | <dbs:foil>
|
---|
1189 | <info>
|
---|
1190 | <title>dbs:speakernotes</title>
|
---|
1191 | </info>
|
---|
1192 |
|
---|
1193 | <itemizedlist>
|
---|
1194 | <listitem>
|
---|
1195 | <para><emphasis>May contain:</emphasis> [block content]</para>
|
---|
1196 | </listitem>
|
---|
1197 |
|
---|
1198 | <listitem>
|
---|
1199 | <para><emphasis>Usage:</emphasis> Notes that are not meant to be presented to
|
---|
1200 | the audience but to the speaker.</para>
|
---|
1201 | </listitem>
|
---|
1202 | </itemizedlist>
|
---|
1203 | </dbs:foil>
|
---|
1204 |
|
---|
1205 | <dbs:foil>
|
---|
1206 | <info>
|
---|
1207 | <title>dbs:handoutnotes</title>
|
---|
1208 | </info>
|
---|
1209 |
|
---|
1210 | <itemizedlist>
|
---|
1211 | <listitem>
|
---|
1212 | <para><emphasis>May contain:</emphasis> [block content]</para>
|
---|
1213 | </listitem>
|
---|
1214 |
|
---|
1215 | <listitem>
|
---|
1216 | <para><emphasis>Usage:</emphasis> Notes that are not to accompany
|
---|
1217 | printed slides.</para>
|
---|
1218 | </listitem>
|
---|
1219 | </itemizedlist>
|
---|
1220 | </dbs:foil>
|
---|
1221 |
|
---|
1222 | <dbs:foil>
|
---|
1223 | <info>
|
---|
1224 | <title>Attribute dbs:incremental</title>
|
---|
1225 | </info>
|
---|
1226 |
|
---|
1227 | <itemizedlist>
|
---|
1228 | <listitem>
|
---|
1229 | <para><emphasis>Usage:</emphasis> Makes the content incremental.
|
---|
1230 | Allowed on any element and inherited to child elements
|
---|
1231 | but not applicable everywhere and its effect depends on the output
|
---|
1232 | format.</para>
|
---|
1233 | </listitem>
|
---|
1234 | </itemizedlist>
|
---|
1235 | </dbs:foil>
|
---|
1236 |
|
---|
1237 | <dbs:foil>
|
---|
1238 | <info>
|
---|
1239 | <title>Attribute dbs:collapsible</title>
|
---|
1240 | </info>
|
---|
1241 |
|
---|
1242 | <itemizedlist>
|
---|
1243 | <listitem>
|
---|
1244 | <para><emphasis>Usage:</emphasis> Makes the content collapsible.
|
---|
1245 | Allowed on any element and inherited to child elements
|
---|
1246 | but not applicable everywhere and its effect depends on the output
|
---|
1247 | format.</para>
|
---|
1248 | </listitem>
|
---|
1249 | </itemizedlist>
|
---|
1250 | </dbs:foil>
|
---|
1251 |
|
---|
1252 | <dbs:foil>
|
---|
1253 | <info>
|
---|
1254 | <title>Attribute dbs:style</title>
|
---|
1255 | </info>
|
---|
1256 |
|
---|
1257 | <itemizedlist>
|
---|
1258 | <listitem>
|
---|
1259 | <para><emphasis>Usage:</emphasis> Classifies the given element
|
---|
1260 | to a specific formatting class. Typically applicable to foils,
|
---|
1261 | foilgroups and mediaobject. Allowed anywhere but not processed
|
---|
1262 | everywhere. In HTML it naturally maps to the <literal>class</literal>
|
---|
1263 | attribute.</para>
|
---|
1264 | </listitem>
|
---|
1265 | </itemizedlist>
|
---|
1266 | </dbs:foil>
|
---|
1267 | </dbs:foilgroup>
|
---|
1268 |
|
---|
1269 | <dbs:foil>
|
---|
1270 | <info>
|
---|
1271 | <title>Related Standards</title>
|
---|
1272 | </info>
|
---|
1273 |
|
---|
1274 | <bibliography>
|
---|
1275 | <title>Related Standards</title>
|
---|
1276 |
|
---|
1277 | <biblioentry xml:id="w3c-xml">
|
---|
1278 | <title>Extensible Markup Language (XML)</title>
|
---|
1279 |
|
---|
1280 | <org>
|
---|
1281 | <orgname>W3C</orgname>
|
---|
1282 | </org>
|
---|
1283 |
|
---|
1284 | <bibliosource class="uri" xlink:href="http://www.w3.org/TR/REC-xml/">http://www.w3.org/TR/REC-xml/</bibliosource>
|
---|
1285 | </biblioentry>
|
---|
1286 |
|
---|
1287 | <biblioentry xml:id="docbook5">
|
---|
1288 | <title>The DocBook Schema Version 5.0</title>
|
---|
1289 |
|
---|
1290 | <org>
|
---|
1291 | <orgname>OASIS</orgname>
|
---|
1292 | </org>
|
---|
1293 |
|
---|
1294 | <bibliosource class="uri" xlink:href="http://docs.oasis-open.org/docbook/specs/docbook-5.0-spec-os.html">http://docs.oasis-open.org/docbook/specs/docbook-5.0-spec-os.html</bibliosource>
|
---|
1295 | </biblioentry>
|
---|
1296 |
|
---|
1297 | <biblioentry xml:id="w3c-xslt">
|
---|
1298 | <title>XSL Transformations (XSLT) Version 1.0</title>
|
---|
1299 |
|
---|
1300 | <org>
|
---|
1301 | <orgname>W3C</orgname>
|
---|
1302 | </org>
|
---|
1303 |
|
---|
1304 | <bibliosource class="uri" xlink:href="http://www.w3.org/TR/xslt">http://www.w3.org/TR/xslt</bibliosource>
|
---|
1305 | </biblioentry>
|
---|
1306 |
|
---|
1307 | <biblioentry xml:id="w3c-xslfo">
|
---|
1308 | <title>Extensible Stylesheet Language (XSL) Version 1.1</title>
|
---|
1309 |
|
---|
1310 | <org>
|
---|
1311 | <orgname>W3C</orgname>
|
---|
1312 | </org>
|
---|
1313 |
|
---|
1314 | <bibliosource class="uri" xlink:href="http://www.w3.org/TR/xsl/">http://www.w3.org/TR/xsl/</bibliosource>
|
---|
1315 | </biblioentry>
|
---|
1316 | </bibliography>
|
---|
1317 | </dbs:foil>
|
---|
1318 |
|
---|
1319 | <dbs:foil>
|
---|
1320 | <info>
|
---|
1321 | <title>Supported HTML Presentation Frameworks</title>
|
---|
1322 | </info>
|
---|
1323 |
|
---|
1324 | <bibliography>
|
---|
1325 | <title>Supported HTML Presentation Frameworks</title>
|
---|
1326 |
|
---|
1327 | <biblioentry xml:id="s5">
|
---|
1328 | <title>S<superscript>5</superscript></title>
|
---|
1329 | <subtitle>A Simple Standards-Based Slide Show System</subtitle>
|
---|
1330 |
|
---|
1331 | <bibliosource class="uri" xlink:href="http://meyerweb.com/eric/tools/s5/">http://meyerweb.com/eric/tools/s5/</bibliosource>
|
---|
1332 | </biblioentry>
|
---|
1333 |
|
---|
1334 | <biblioentry xml:id="slidy">
|
---|
1335 | <title>HTML Slidy</title>
|
---|
1336 | <subtitle>Slide Shows in HTML and XHTML</subtitle>
|
---|
1337 |
|
---|
1338 | <bibliosource class="uri" xlink:href="www.w3.org/Talks/Tools/Slidy2/">www.w3.org/Talks/Tools/Slidy2/</bibliosource>
|
---|
1339 | </biblioentry>
|
---|
1340 | </bibliography>
|
---|
1341 | </dbs:foil>
|
---|
1342 |
|
---|
1343 | <dbs:foil>
|
---|
1344 | <info>
|
---|
1345 | <title>Recommended Tools</title>
|
---|
1346 | </info>
|
---|
1347 |
|
---|
1348 | <bibliography>
|
---|
1349 | <title>Recommended Tools</title>
|
---|
1350 |
|
---|
1351 | <biblioentry xml:id="jing">
|
---|
1352 | <title>Jing RELAX-NG validator</title>
|
---|
1353 |
|
---|
1354 | <bibliosource class="uri" xlink:href="http://www.thaiopensource.com/relaxng/jing.html">http://www.thaiopensource.com/relaxng/jing.html</bibliosource>
|
---|
1355 | </biblioentry>
|
---|
1356 |
|
---|
1357 | <biblioentry xml:id="libxslt">
|
---|
1358 | <title>libxslt</title>
|
---|
1359 | <subtitle>The XSLT C library for GNOME</subtitle>
|
---|
1360 |
|
---|
1361 | <bibliosource class="uri" xlink:href="http://xmlsoft.org/xslt/">http://xmlsoft.org/xslt/</bibliosource>
|
---|
1362 | </biblioentry>
|
---|
1363 |
|
---|
1364 | <biblioentry xml:id="fop">
|
---|
1365 | <title>Apache FOP</title>
|
---|
1366 |
|
---|
1367 | <bibliosource class="uri" xlink:href="http://xmlgraphics.apache.org/fop/">http://xmlgraphics.apache.org/fop/</bibliosource>
|
---|
1368 | </biblioentry>
|
---|
1369 | </bibliography>
|
---|
1370 | </dbs:foil>
|
---|
1371 | </dbs:slides>
|
---|