home *** CD-ROM | disk | FTP | other *** search
/ PC Professionell 2004 December / PCpro_2004_12.ISO / files / webserver / xampp / xampp-cocoon-addon-1.4.9-installer.exe / yapt-demo.txt < prev    next >
Encoding:
Text File  |  2004-07-12  |  3.5 KB  |  114 lines
  1. presentation: YAPT demo
  2. image-directory: yapt-demo-images
  3. author: Bertrand DelacrΘtaz
  4. date: September 2003
  5. cvs: $Id: yapt-demo.txt,v 1.5 2003/10/14 11:54:40 bdelacretaz Exp $
  6. A (short) journey through the (few) YAPT features.
  7.  
  8. slide: What is YAPT?
  9. hint-style: LotsOfText
  10.  
  11. Yet Another Presentation Tool.
  12.  
  13. The idea is to make it super-easy to create decent-looking presentations, for display or printing.
  14.  
  15. A presentation consists of a single structured (wiki-like) ASCII file, with some simple rules:
  16.  
  17. * The first line must contain "presentation:" (without quotes) followed by the presentation title.
  18.  
  19. * Each slide starts with a "slide:" line.
  20.  
  21. * Empty lines separate paragraphs. There must be an empty line between the slide: line and the slide text.
  22.  
  23. * For images, use a single line starting with img_XXXX: where XXX is the CSS class
  24. name to use. See yapt-images.css for available classes.
  25.  
  26. * A "presentation" page containing all slides is available for printing.
  27.  
  28. * Presentations are converted in XML on the way.
  29.  
  30. That's it. There are more details and examples in the following slides, and you can have a look a the yapt-demo.txt
  31. file from which this presentation is created.
  32.  
  33. slide: Navigation
  34. hint-style: LittleText
  35.  
  36. Click anywhere on a slide to go to the next one.
  37.  
  38. Use the grey links at the bottom of the page to go to the previous slide, or to the index.
  39.  
  40. note: This page uses a hint-style line to indicate that it contains little text and can use a larger font
  41.  
  42. slide: Testing source code
  43. hint-style: LittleText
  44.  
  45. You can embed source code examples using the code: demarcation.
  46.  
  47. code:
  48. <?xml version="1.0"?>
  49.   <some-element-here attrib="yes">
  50.     <child-element-indented/>
  51.   </some-element-ends>
  52.   <foo/>
  53.  
  54. Here we use the "preserve-space" option of the slop parser to preserve indentation.
  55.  
  56. Currently, code cannot contain blank lines, it would be better to use an "endcode:" marker for the end:
  57.  
  58. code:
  59. public class SomeJavaClass {
  60.   // the whole thing up to closing } should be in one block
  61.  
  62.   // this follows a blank line
  63. }
  64.  
  65.  
  66. slide: Test results
  67.  
  68. CSS styles have been tested with the latest version of Firebird, Opera and IE on Mac OSX, they might not
  69. work properly with other browsers.
  70.  
  71. When printing, only Opera honors the "page-breaks" CSS properties, current versions of other browsers
  72. will break images and slides in two when laying out pages.
  73.  
  74. slide: Image examples: half-left image
  75.  
  76. img_leftHalf: screenshot.jpg
  77. Here's a example with an image. Try zooming or resizing your browser to presentation sizes to see how the display
  78. behaves, the image must stay on the left and take half the width of the screen or page.
  79.  
  80. If you add text here it comes as a new paragraph.
  81.  
  82.  
  83. slide: Image examples: half-right image
  84.  
  85. img_rightHalf: screenshot.jpg
  86. Here's about the same thing, only with the image on the right.
  87.  
  88. subtitle: A subtitle
  89. At this size, we'd only add a small legend here.
  90.  
  91.  
  92. slide: Image examples: two images at 33%
  93.  
  94. img_leftThird: screenshot.jpg
  95. Let's try with images on both the left and right sizes, how does this behave at
  96. different zoom settings?
  97.  
  98. img_rightThird: tree.gif
  99. subtitle: Flow!
  100. When resizing, the text should flow freely between images.
  101.  
  102. slide: Conclusions
  103.  
  104. I'll try to use this tool for actual presentations in the near future, so it
  105. will certainly get some improvements.
  106.  
  107. Missing features include:
  108.  
  109. * Real bulleted lists (but according to some they are evil;-)
  110.  
  111. * Code sections (monospaced fonts etc)
  112.  
  113. * Presentation wizard to automatically generate complicated flashy layouts with lots of stupid
  114. transitions. Just kidding.