home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / comms_networking / zonk / rawdocs / cpullo < prev    next >
Encoding:
Text File  |  1999-02-13  |  2.1 KB  |  46 lines
  1. $zonkpage 1.07
  2.  
  3. title: Pull... commands
  4.  
  5. text:{<sh>Note</sh>
  6.  
  7. This final section of Zonk commands are special. They are <i>not processed</i> when they are in a template instead they are only processed when they are inside an already existing html file which is <ref pulo>accessed using the command</r> 
  8.  
  9. <lit>$pullout: <var>filename</var></lit>  
  10.  
  11. from a user datafile. They are also special in that they remain in the the html after they have been processed (which is why they are in the form of comments). This of course means that if you 'pullout' a file again, the commands can be processed again. Also note that at least one whitespace character is obligatory before '-->' and there must be <i>no</i> whitespace in '<!--zonk'
  12.  
  13. <sh>Pullout: syntax</sh>
  14.  
  15. <lit><!--zonk pullout <var>variablename</var> --><var>value</var><!--zonk endpullout --></lit> 
  16.  
  17. <sh>Description</sh> 
  18.  
  19. This command assigns <var>variablename</var> the value of whatever is between the pullout and endpullout comments. If you want to hide the value in the source html, use the form:
  20.  
  21. <lit><!--zonk pullout <var>variablename</var>><var>value</var><!--zonk endpullout --></lit> 
  22.  
  23. as html comments do not nest so the second '<!--' has no effect and the whole comment is closed by the '-->' at the end. 
  24.  
  25.  
  26. <a name="pi"></a><sh>Pullin: syntax</sh>
  27.  
  28. <lit><!--zonk pullin <var>variablename</var> [<var>options</var>...] --><!--zonk endpullin --></lit> 
  29.  
  30. <sh>Description</sh>
  31.  
  32. This does the opposite of pullout. It inserts the current value of <var>variablename</var> in between the pullin and endpullin tags <i>replacing whatever was there before</i>.
  33.  
  34. <var>options</var> are as for <ref ctagv>tagvalue</r> except that the 'include' option is not allowed.
  35.  
  36. <a name="rd"></a><a name="rt"></a><sh>Pullread & pullreset: syntax</sh>
  37.  
  38. <lit><!--zonk pullread <var>variablename</var> [<var>variablename</var>...] --></lit> 
  39.  
  40.  
  41. <lit><!--zonk pullreset <var>variablename</var> [<var>variablename</var>...] --></lit> 
  42.  
  43. <sh>Description</sh>
  44.  
  45. These are pullout versions of <ref cread>zonk read</r> and <ref cread#reset>zonk reset</r> respectively and behave in exactly the same way.
  46.