home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / comms_networking / zonk / rawdocs / tutor < prev    next >
Encoding:
Text File  |  1999-02-13  |  3.0 KB  |  52 lines

  1. $zonkpage 1.0
  2.  
  3. title: Getting started, a basic tutorial
  4.  
  5. text:{Double-click on the !zonk application to get !deskzonk on the icon bar.
  6.  
  7. Have a look in the !zonkexamp directory (it's only an application so that it sets a system variable to point to itself).
  8.  
  9. <b>Note: You can't run the !zonkexamp from inside the archive as they need to write back to the htm directory in !zonkexamp</b>
  10.  
  11. Check in the htm directory within !zonkexamp and note that it just contains some images files (gifs and jpegs).
  12.  
  13. Drag the file <fn>ex1/dat</fn> from !zonkexamp to the !deskzonk icon on the iconbar.
  14.  
  15. You should now see:<ul>
  16.  
  17. <li>A taskwindow open and messages from the main Zonk program <b>[1]</b>
  18.   
  19. <li>Almost immediately the last message should read "zonk complete."
  20. </ul>
  21.   
  22. If you now look in the htm directory you should now have your first "Zonked" file.
  23.  
  24. Have a look at the three files <fn>ex1/dat</fn>, <fn>ex1/tpl</fn> and <fn>ex1/htm</fn>. Read the comments in the first two and compare the input with the output. remember that this is a very simple example. You have only began to scratch the surface of what Zonk can do.
  25.  
  26. <fn>ex1/dat</fn> is a user datafile
  27. <fn>ex1/tpl</fn> is a template
  28. <fn>ex1/htm</fn> is finished html
  29.  
  30. <sh>Having got this far...</sh>
  31. I'd like to make the point that I see Zonk being used by two distinct (but possibly overlapping) types of user. The first type is the non-technical person who wishes to create html pages easily and quickly. These users will simply create data files for use with templates written by others.  If you fall into this class then you probably know as much as you need to know about Zonk already. You now need to find yourself a technically minded friend to write you the templates you require. Writing templates is not difficult but a familiarity with basic programming concepts will certainly help.
  32.  
  33. It is at the second type of user, the technical ones, that the <ref tutor2>rest of the tutorial</r> and documentation is aimed.
  34.  
  35.  
  36.  
  37. <sh>I don't understand...</sh>
  38.  
  39. Question: How did Zonk know to use the template <fn>ex1/tpl</fn> when I dropped <fn>ex1/dat</fn> on it's icon? Is it just based on the filename?
  40.  
  41. Answer: You decide, Zonk's <ref sconf>configuration file</r> (<fn>ZonkSys</fn> inside !Zonk) tells Zonk how to find a template based on the input datafile name through a series of mappings (which you can write yourself if you want). However there is also a directive that you can include in the datafile to tell Zonk to use a specific template for that file, go <ref dlay>here</r> for the details.
  42.  
  43.  
  44. <sh>What if...</sh>
  45.  
  46. <b>[1]</b> If for any reason a taskwindow doesn't open check that your system is setup correctly to run TaskObey (type FD7) files. If you type
  47. <lit>Show Alias$@RunType_FD7</lit> at a command line you should see something like:
  48.  
  49. <lit>Alias$@RunType_FD7 : TaskWindow |"Obey %*0|" -name |"Task Obey|" -quit</lit> 
  50.  
  51. If you still can't get things working try setting the type of the file <fn>!start</fn> inside !zonk to Obey instead of TaskObey
  52.