Artifact 9db6996c143a422b473027785e8d13c5bbba991d:


0000: 47 6f 74 63 68 61 73 21 0a 3d 3d 3d 3d 3d 3d 3d  Gotchas!.=======
0010: 0a 0a 41 6c 6c 20 69 74 65 6d 73 20 66 6f 72 20  ..All items for 
0020: 61 20 70 61 67 65 20 2a 6d 75 73 74 2a 20 62 65  a page *must* be
0030: 20 70 61 72 74 20 6f 66 20 61 20 6c 69 73 74 21   part of a list!
0040: 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e  .~~~~~~~~~~~~~~~
0050: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e  ~~~~~~~~~~~~~~~~
0060: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a  ~~~~~~~~~~~~~~~.
0070: 0a 20 20 20 4f 4b 3a 20 20 20 20 20 28 6c 69 73  .   OK:     (lis
0080: 74 20 28 66 75 6e 63 74 69 6f 6e 31 20 70 61 72  t (function1 par
0090: 61 6d 31 29 28 66 75 6e 63 74 69 6f 6e 32 20 70  am1)(function2 p
00a0: 61 72 61 6d 32 29 29 0a 20 20 20 4e 4f 54 20 4f  aram2)).   NOT O
00b0: 4b 3a 20 28 62 65 67 69 6e 20 28 66 75 6e 63 74  K: (begin (funct
00c0: 69 6f 6e 31 20 70 61 72 61 6d 31 29 28 66 75 6e  ion1 param1)(fun
00d0: 63 74 69 6f 6e 32 20 70 61 72 61 6d 32 29 29 0a  ction2 param2)).
00e0: 0a 0a 56 61 72 69 6f 75 73 20 63 6f 6d 70 6f 6e  ..Various compon
00f0: 65 6e 74 73 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e  ents.~~~~~~~~~~~
0100: 7e 7e 7e 7e 7e 7e 7e 0a 0a 54 68 65 20 55 52 4c  ~~~~~~~..The URL
0110: 3a 0a 0a 68 74 74 70 3a 2f 2f 74 68 65 2e 64 6f  :..http://the.do
0120: 6d 61 69 6e 2e 63 6f 6d 2f 70 61 67 65 6e 61 6d  main.com/pagenam
0130: 65 2f 70 31 2f 70 32 2f 70 33 3f 70 61 72 61 6d  e/p1/p2/p3?param
0140: 31 3d 76 61 6c 75 65 31 0a 0a 28 73 3a 67 65 74  1=value1..(s:get
0150: 2d 70 61 67 65 2d 70 61 72 61 6d 73 29 20 3d 3e  -page-params) =>
0160: 20 27 28 22 70 31 22 20 22 70 32 22 29 0a 0a 28   '("p1" "p2")..(
0170: 73 3a 67 65 74 2d 70 61 72 61 6d 20 27 70 61 72  s:get-param 'par
0180: 61 6d 31 29 20 3d 3e 20 22 76 61 6c 75 65 31 22  am1) => "value1"
0190: 0a 0a 43 72 65 61 74 65 20 61 20 6c 69 6e 6b 2e  ..Create a link.
01a0: 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a  .~~~~~~~~~~~~~~.
01b0: 0a 28 73 3a 6e 75 6c 6c 20 22 5b 22 20 28 73 3a  .(s:null "[" (s:
01c0: 61 20 6e 61 6d 65 20 27 68 72 65 66 20 0a 20 20  a name 'href .  
01d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 3a               (s:
01e0: 6c 69 6e 6b 2d 74 6f 20 28 73 74 72 69 6e 67 2d  link-to (string-
01f0: 61 70 70 65 6e 64 20 22 6c 6f 63 61 74 69 6f 6e  append "location
0200: 2f 22 20 28 73 74 72 69 6e 67 2d 69 6e 74 65 72  /" (string-inter
0210: 73 70 65 72 73 65 20 70 20 22 2f 22 29 20 22 22  sperse p "/") ""
0220: 29 29 29 20 22 5d 20 22 29 29 29 0a 0a 0a 0a 43  ))) "] ")))....C
0230: 61 6c 6c 20 63 75 72 72 65 6e 74 20 70 61 67 65  all current page
0240: 20 77 69 74 68 20 6e 65 77 20 70 61 72 61 6d 0a   with new param.
0250: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e  ~~~~~~~~~~~~~~~~
0260: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e  ~~~~~~~~~~~~~~~~
0270: 0a 0a 49 6e 20 76 69 65 77 2e 73 63 6d 3a 0a 0a  ..In view.scm:..
0280: 20 28 73 3a 63 65 6e 74 65 72 20 22 5b 22 20 28   (s:center "[" (
0290: 73 3a 61 20 27 68 72 65 66 20 28 73 3a 6c 69 6e  s:a 'href (s:lin
02a0: 6b 2d 74 6f 20 22 70 6f 6c 6c 73 22 0a 20 20 20  k-to "polls".   
02b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
02c0: 20 20 20 20 20 20 20 20 27 69 64 0a 20 20 20 20          'id.    
02d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
02e0: 20 20 20 20 20 20 20 20 28 62 65 67 69 6e 0a 20          (begin. 
02f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0300: 20 20 20 20 20 20 20 20 20 20 20 20 20 28 70 6f               (po
0310: 6c 6c 3a 70 6f 6c 6c 20 27 66 69 6c 6c 2d 70 6f  ll:poll 'fill-po
0320: 6c 6c 73 29 0a 20 20 20 20 20 20 20 20 20 20 20  lls).           
0330: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0340: 20 20 20 28 70 6f 6c 6c 3a 70 6f 6c 6c 20 27 67     (poll:poll 'g
0350: 65 74 2d 6e 65 78 74 2d 70 6f 6c 6c 29 29 29 0a  et-next-poll))).
0360: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0370: 20 20 20 20 20 20 20 20 20 20 22 47 6f 20 74 6f            "Go to
0380: 20 74 68 65 20 6e 65 78 74 20 70 6f 6c 6c 22 29   the next poll")
0390: 20 20 22 5d 22 29 0a 0a 49 6e 20 63 6f 6e 74 72    "]")..In contr
03a0: 6f 6c 2e 73 63 6d 3a 0a 0a 28 6c 65 74 20 28 28  ol.scm:..(let ((
03b0: 70 6f 6c 6c 2d 69 64 20 28 73 3a 67 65 74 2d 70  poll-id (s:get-p
03c0: 61 72 61 6d 20 27 69 64 29 29 29 0a 20 3b 3b 20  aram 'id))). ;; 
03d0: 64 6f 20 73 74 75 66 66 20 62 61 73 65 64 20 6f  do stuff based o
03e0: 6e 20 70 6f 6c 6c 2d 69 64 0a 0a 0a 43 61 6c 6c  n poll-id...Call
03f0: 20 61 6e 20 61 63 74 69 6f 6e 20 6f 6e 20 61 20   an action on a 
0400: 73 70 65 63 69 66 69 63 20 70 61 67 65 0a 7e 7e  specific page.~~
0410: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e  ~~~~~~~~~~~~~~~~
0420: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a  ~~~~~~~~~~~~~~~.
0430: 0a 20 28 73 3a 61 20 27 68 72 65 66 20 28 73 3a  . (s:a 'href (s:
0440: 6c 69 6e 6b 2d 74 6f 20 22 70 6f 6c 6c 73 22 20  link-to "polls" 
0450: 27 69 64 20 28 70 6f 6c 6c 3a 70 6f 6c 6c 20 27  'id (poll:poll '
0460: 67 65 74 20 27 69 64 29 20 0a 09 09 09 20 20 20  get 'id) ....   
0470: 20 20 20 20 27 61 63 74 69 6f 6e 20 22 70 6f 6c      'action "pol
0480: 6c 2e 65 64 69 74 22 29 0a 20 20 20 20 20 20 20  l.edit").       
0490: 20 20 20 20 20 22 53 75 67 67 65 73 74 20 63 68       "Suggest ch
04a0: 61 6e 67 65 73 20 74 6f 20 74 68 69 73 20 70 6f  anges to this po
04b0: 6c 6c 22 29 0a 0a 20 4e 4f 54 20 54 52 55 45 21  ll").. NOT TRUE!
04c0: 20 54 68 69 73 20 63 61 6c 6c 73 20 66 75 63 74   This calls fuct
04d0: 69 6f 6e 20 70 6f 6c 6c 2e 65 64 69 74 20 28 73  ion poll.edit (s
04e0: 68 6f 75 6c 64 20 62 65 20 69 6e 20 63 6f 6e 74  hould be in cont
04f0: 72 6f 6c 2e 73 63 6d 29 2e 20 50 61 72 61 6d 65  rol.scm). Parame
0500: 74 65 72 20 73 65 74 20 69 73 20 27 69 64 20 74  ter set is 'id t
0510: 6f 20 61 20 70 6f 6c 6c 20 6e 75 6d 2e 0a 0a 0a  o a poll num....
0520: 41 20 63 6f 6d 70 6c 65 78 20 6c 69 6e 6b 20 65  A complex link e
0530: 78 61 6d 70 6c 65 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e  xample.~~~~~~~~~
0540: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 28  ~~~~~~~~~~~~~..(
0550: 73 3a 61 20 22 52 65 70 6c 79 22 20 27 68 72 65  s:a "Reply" 'hre
0560: 66 20 28 73 3a 6c 69 6e 6b 2d 74 6f 20 28 73 3a  f (s:link-to (s:
0570: 63 75 72 72 65 6e 74 2d 70 61 67 65 29 20 0a 09  current-page) ..
0580: 20 20 20 20 20 20 20 20 20 20 20 27 61 63 74 69             'acti
0590: 6f 6e 20 22 64 69 73 63 75 73 73 69 6f 6e 2e 72  on "discussion.r
05a0: 65 70 6c 79 22 20 3b 3b 20 3c 70 61 67 65 3e 2e  eply" ;; <page>.
05b0: 3c 61 63 74 69 6f 6e 3e 0a 09 20 20 20 20 20 20  <action>..      
05c0: 20 20 20 20 20 27 72 65 70 6c 79 5f 74 6f 20 28       'reply_to (
05d0: 6e 75 6d 62 65 72 2d 3e 73 74 72 69 6e 67 20 28  number->string (
05e0: 68 61 73 68 2d 74 61 62 6c 65 2d 72 65 66 20 72  hash-table-ref r
05f0: 6f 77 20 27 70 6f 73 74 73 2e 69 64 29 29 20 0a  ow 'posts.id)) .
0600: 09 20 20 20 20 20 20 20 20 20 20 20 27 69 64 20  .           'id 
0610: 28 73 3a 67 65 74 20 22 64 69 73 63 75 73 73 69  (s:get "discussi
0620: 6f 6e 2e 70 61 72 65 6e 74 5f 6f 62 6a 65 63 74  on.parent_object
0630: 5f 69 64 22 29 29 20 22 72 65 70 6c 79 22 29 0a  _id")) "reply").
0640: 0a 3b 3b 20 75 73 65 20 28 73 3a 67 65 74 2d 70  .;; use (s:get-p
0650: 61 72 61 6d 20 74 6f 20 67 65 74 20 74 68 65 20  aram to get the 
0660: 27 69 64 2c 20 6f 72 20 27 72 65 70 6c 79 5f 74  'id, or 'reply_t
0670: 6f 20 76 61 6c 75 65 73 0a 0a 0a 47 65 74 20 61  o values...Get a
0680: 6e 64 20 73 65 74 20 61 20 73 65 73 73 69 6f 6e  nd set a session
0690: 20 76 61 72 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e   var.~~~~~~~~~~~
06a0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a  ~~~~~~~~~~~~~~..
06b0: 28 73 3a 73 65 73 73 69 6f 6e 2d 76 61 72 2d 67  (s:session-var-g
06c0: 65 74 20 22 6b 65 79 6e 61 6d 65 22 29 0a 28 73  et "keyname").(s
06d0: 3a 73 65 73 73 69 6f 6e 2d 76 61 72 2d 73 65 74  :session-var-set
06e0: 21 20 22 6b 65 79 6e 61 6d 65 22 20 22 76 61 6c  ! "keyname" "val
06f0: 75 65 22 29 0a 0a 35 2e 31 20 50 61 67 65 20 6c  ue")..5.1 Page l
0700: 6f 63 61 6c 20 76 61 72 73 0a 0a 28 73 3a 73 65  ocal vars..(s:se
0710: 74 21 20 6b 65 79 20 76 61 6c 29 0a 28 73 3a 67  t! key val).(s:g
0720: 65 74 20 6b 65 79 29 0a 0a 0a 6d 61 6b 65 20 61  et key)...make a
0730: 20 73 65 6c 65 63 74 69 6f 6e 20 64 72 6f 70 20   selection drop 
0740: 64 6f 77 6e 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e  down.~~~~~~~~~~~
0750: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a  ~~~~~~~~~~~~~~~.
0760: 0a 49 6e 20 76 69 65 77 2e 73 63 6d 3a 20 0a 0a  .In view.scm: ..
0770: 28 73 3a 73 65 6c 65 63 74 20 27 28 28 22 57 6f  (s:select '(("Wo
0780: 72 6c 64 22 20 30 29 28 22 43 6f 75 6e 74 72 79  rld" 0)("Country
0790: 22 20 31 29 28 22 53 74 61 74 65 22 20 32 29 28  " 1)("State" 2)(
07a0: 22 54 6f 77 6e 2f 43 69 74 79 22 20 33 29 29 20  "Town/City" 3)) 
07b0: 27 6e 61 6d 65 20 27 73 63 6f 70 65 29 0a 0a 49  'name 'scope)..I
07c0: 6e 20 63 6f 6e 74 72 6f 6c 2e 73 63 6d 3a 0a 0a  n control.scm:..
07d0: 28 6c 65 74 20 28 28 73 63 6f 70 65 20 28 73 3a  (let ((scope (s:
07e0: 67 65 74 2d 69 6e 70 75 74 20 27 73 63 6f 70 65  get-input 'scope
07f0: 29 29 29 0a 20 20 2e 2e 2e 2e 0a 0a 0a 53 69 6d  ))).  .......Sim
0800: 70 6c 65 20 65 72 72 6f 72 20 72 65 70 6f 72 74  ple error report
0810: 69 6e 67 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e  ing.~~~~~~~~~~~~
0820: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 49 6e 20 63  ~~~~~~~~~~..In c
0830: 6f 6e 74 72 6f 6c 2e 73 63 6d 3a 0a 28 73 3a 73  ontrol.scm:.(s:s
0840: 65 74 2d 65 72 72 20 22 59 6f 75 20 6d 75 73 74  et-err "You must
0850: 20 70 72 6f 76 69 64 65 20 61 6e 20 65 6d 61 69   provide an emai
0860: 6c 20 61 64 64 72 65 73 73 22 29 0a 0a 49 6e 20  l address")..In 
0870: 76 69 65 77 2e 73 63 6d 3a 0a 28 73 3a 67 65 74  view.scm:.(s:get
0880: 2d 65 72 72 20 73 3a 65 72 72 2d 66 6f 6e 74 29  -err s:err-font)
0890: 0a 0a 4f 72 3a 0a 28 73 3a 67 65 74 2d 65 72 72  ..Or:.(s:get-err
08a0: 20 28 6c 61 6d 62 64 61 20 28 78 29 28 73 3a 65   (lambda (x)(s:e
08b0: 72 72 2d 66 6f 6e 74 20 78 20 28 73 3a 62 72 29  rr-font x (s:br)
08c0: 29 29 29 0a 0a 0a 53 68 61 72 69 6e 67 20 64 61  )))...Sharing da
08d0: 74 61 20 62 65 74 77 65 65 6e 20 70 61 67 65 73  ta between pages
08e0: 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e  .~~~~~~~~~~~~~~~
08f0: 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 0a 0a 4e 4f 54  ~~~~~~~~~~~..NOT
0900: 45 3a 20 54 68 69 73 20 64 61 74 61 20 69 73 20  E: This data is 
0910: 2a 6e 6f 74 2a 20 70 72 65 73 65 72 76 65 64 20  *not* preserved 
0920: 62 65 74 77 65 65 6e 20 63 67 69 20 63 61 6c 6c  between cgi call
0930: 73 2e 0a 0a 3b 3b 20 49 6e 20 66 69 72 73 74 20  s...;; In first 
0940: 70 61 67 65 20 63 61 6c 6c 65 64 0a 28 73 3a 73  page called.(s:s
0950: 68 61 72 65 64 2d 73 65 74 21 20 22 73 6f 6d 65  hared-set! "some
0960: 6b 65 79 22 20 73 6f 6d 65 76 61 6c 75 65 29 0a  key" somevalue).
0970: 0a 3b 3b 20 49 6e 20 61 20 70 61 67 65 20 63 61  .;; In a page ca
0980: 6c 6c 65 64 20 6c 61 74 65 72 0a 28 6c 65 74 20  lled later.(let 
0990: 28 28 64 61 74 20 28 73 3a 73 68 61 72 65 64 2d  ((dat (s:shared-
09a0: 67 65 74 20 22 73 6f 6d 65 6b 65 79 22 29 29 29  get "somekey")))
09b0: 0a 20 20 28 20 2e 2e 2e 2e 20 29 29 0a 0a 0a 4d  .  ( .... ))...M
09c0: 69 73 63 20 75 73 65 66 75 6c 20 73 74 75 66 66  isc useful stuff
09d0: 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e  .~~~~~~~~~~~~~~~
09e0: 7e 7e 0a 0a 20 20 69 2e 20 4c 61 7a 79 2f 73 61  ~~..  i. Lazy/sa
09f0: 66 65 20 73 74 72 69 6e 67 2d 3e 6e 75 6d 62 65  fe string->numbe
0a00: 72 20 0a 0a 28 73 3a 61 6e 79 2d 3e 6e 75 6d 62  r ..(s:any->numb
0a10: 65 72 20 76 61 6c 29 0a 0a 20 20 69 69 2e 20 52  er val)..  ii. R
0a20: 61 6e 64 6f 6d 20 73 74 72 69 6e 67 0a 0a 28 73  andom string..(s
0a30: 65 73 73 69 6f 6e 3a 6d 61 6b 65 2d 72 61 6e 64  ession:make-rand
0a40: 2d 73 74 72 69 6e 67 20 6c 65 6e 29 0a 0a 20 69  -string len).. i
0a50: 69 69 2e 20 73 74 72 69 6e 67 20 74 6f 20 6e 75  ii. string to nu
0a60: 6d 62 65 72 20 66 6f 72 20 70 67 69 6e 74 0a 20  mber for pgint. 
0a70: 0a 28 73 3a 61 6e 79 2d 3e 70 67 69 6e 74 20 76  .(s:any->pgint v
0a80: 61 6c 29 0a 0a 0a 46 6f 72 6d 73 20 61 6e 64 20  al)...Forms and 
0a90: 69 6e 70 75 74 0a 7e 7e 7e 7e 7e 7e 7e 7e 7e 7e  input.~~~~~~~~~~
0aa0: 7e 7e 7e 7e 7e 0a 0a 28 73 3a 66 6f 72 6d 20 27  ~~~~~..(s:form '
0ab0: 61 63 74 69 6f 6e 20 22 6c 6f 67 69 6e 2e 6c 6f  action "login.lo
0ac0: 67 69 6e 22 20 27 6d 65 74 68 6f 64 20 22 70 6f  gin" 'method "po
0ad0: 73 74 22 0a 20 20 20 28 73 3a 69 6e 70 75 74 2d  st".   (s:input-
0ae0: 70 72 65 73 65 72 76 65 20 27 74 79 70 65 20 22  preserve 'type "
0af0: 74 65 78 74 22 20 27 6e 61 6d 65 20 22 65 6d 61  text" 'name "ema
0b00: 69 6c 2d 61 64 64 72 65 73 73 22 20 27 73 69 7a  il-address" 'siz
0b10: 65 20 22 31 36 22 20 27 6d 61 78 6c 65 6e 67 74  e "16" 'maxlengt
0b20: 68 20 22 33 30 22 29 0a 20 20 20 28 73 3a 69 6e  h "30").   (s:in
0b30: 70 75 74 20 27 74 79 70 65 20 22 73 75 62 6d 69  put 'type "submi
0b40: 74 22 20 20 20 27 6e 61 6d 65 20 22 66 6f 72 6d  t"   'name "form
0b50: 2d 6e 61 6d 65 22 20 27 76 61 6c 75 65 20 22 6c  -name" 'value "l
0b60: 6f 67 69 6e 22 29 29 0a 0a 28 73 3a 67 65 74 2d  ogin"))..(s:get-
0b70: 69 6e 70 75 74 20 27 65 6d 61 69 6c 2d 61 64 64  input 'email-add
0b80: 72 65 73 73 29 0a 0a 54 6f 20 70 72 65 73 65 72  ress)..To preser
0b90: 76 65 20 74 68 65 20 69 6e 70 75 74 20 73 69 6d  ve the input sim
0ba0: 70 6c 79 20 64 6f 20 61 20 73 65 74 20 6f 66 20  ply do a set of 
0bb0: 74 68 65 20 76 61 6c 75 65 20 6f 6e 20 74 68 65  the value on the
0bc0: 20 27 6e 61 6d 65 20 66 69 65 6c 64 3a 0a 28 73   'name field:.(s
0bd0: 3a 73 65 74 21 20 22 65 6d 61 69 6c 2d 61 64 64  :set! "email-add
0be0: 72 65 73 73 22 20 22 6d 61 74 74 40 6b 69 61 74  ress" "matt@kiat
0bf0: 6f 61 2e 63 6f 6d 22 29 0a 0a                    oa.com")..