home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / educ / pc_cai.zip / CREATE.CAI < prev    next >
Text File  |  1989-01-06  |  19KB  |  654 lines

  1. .screen 0
  2. .cls
  3. .skip 6
  4. .color 11
  5. .cen (*How to Use the PC-CAI Program Generator-CREATE*)
  6.  
  7.  
  8. .cen(*(C)Alan C. Elliott, 1986,89*)
  9. .cen(*Portions (C)Copyright Microsoft Corp. 1982-87*)
  10. .skip 4
  11. .pau (*Please press ENTER*)
  12. .cls
  13. .col 12
  14. .cen(*A BASIC UNDERSTANDING*)
  15. .skip 3
  16. .color 3
  17. The PC-CAI Program Generator, called CREATE, is very simple to use. However, 
  18. you must have a basic understanding about how a PC-CAI tutorial is set up.
  19. With CREATE, you can create a tutorial such as the one you are now using. 
  20. Once you have progressed, you may skip using CREATE at all, and create your 
  21. own PC-CAI program using a text editor, which is provided with the PC-CAI 
  22. DEVELOPMENT SYSTEM. 
  23. .skip 3
  24. Let's discover the basic structure of a PC-CAI tutorial.
  25. .skip 3
  26. .color 10
  27. .pau (*Please press ENTER*)
  28. .cls
  29.                            ┌──────────────┐
  30.                            │     TITLE    │
  31.                            └──────────────┘
  32.                                            
  33.                            ┌──────────────┐
  34.                            │   TUTORIAL   │ 
  35.                            │     TEXT     │ 
  36.                            └──────────────┘
  37. .col 3
  38. .loc 16,1
  39. A tutorial usually begins with a title. After a TITLE is given, there will 
  40. generally be some tutorial text, such as an explanation of what is coming up, 
  41. or a teaching session. This text may preceed a "Question" session, and is 
  42. displayed for the student generally once.
  43.  
  44. .pau (*Please press ENTER*)
  45. .loc 14,1
  46. .bla 8
  47. .loc 5,1
  48. .col 12
  49.                            ┌──────────────┐  
  50.                            │   TUTORIAL   │  
  51.                        |-->│     TEXT     │
  52.                        |   └──────────────┘
  53.                        |<-------    ----------> STOP
  54.                            ┌───────────────┐
  55.                            │ Q & A Session │
  56.                            └───────────────┘
  57. .loc 16,1
  58. .col 3
  59. Following tutorial text, the program may
  60.  
  61. .col 11
  62.         STOP ─ GO TO ANOTHER TEXT SECTION ─ OR BEGIN A QUESTION SECTION
  63.  
  64. .col 3
  65. For each question in the tutorial, the program must know what are the right
  66. and (sometimes) the wrong answers.
  67.  
  68. .pau (*Please press ENTER*) 
  69. .loc 16,1
  70. .bla 8
  71. .loc 13,1
  72. .col 11
  73.                                   
  74.                            ┌───────────────┐
  75.                            │   ANSWER IS   │ 
  76.                            │   EVALUATED   │
  77.                            └───────────────┘
  78. .loc 18,1
  79. .bla 6
  80. .loc 18,1
  81. .col 3
  82. After the question is asked and an answer is entered by the student, the 
  83. program checks to determine if the answer is right or wrong. 
  84.  
  85. .pau (*Please press ENTER*)
  86. .col 11
  87. .loc 15,45 (*---*)
  88. .loc 14,47 (*|*)
  89. .loc 13,47 (*|*)
  90. .loc 12,47 (*|*)
  91. .loc 11,45 (*<--*)
  92. .loc 12,50 (*Loop according to*)
  93. .loc 13,50 (*number of tries*)
  94. .loc 14,50 (*allowed.*)
  95. .loc 18,1
  96. .bla 6                                                                   
  97. .loc 18,1                                                                
  98. .col 3
  99. If the answer given is wrong, the question may be asked again. The author
  100. of the program specifies how many tries the student will have.           
  101.  
  102. .pau (*Please press ENTER*)
  103. .loc 18,1
  104. .bla 5
  105. .col 11
  106. .loc 18,1
  107.                                   
  108.                <----Continue------or-------Stop------->
  109.  
  110. .loc 18,16 (*|*)
  111. .loc 17,16 (*|*)
  112. .loc 16,16 (*|*)
  113. .loc 15,16 (*|*)
  114. .loc 14,16 (*|*)
  115. .loc 13,16 (*|*)
  116. .loc 12,16 (*|*)
  117. .loc 11,16 (*|---------->*)
  118. .loc 10,16 (*|*)
  119. .loc 9,16 (*|*)
  120. .loc 8,16 (*|*)
  121. .loc 7,16 (*------->*)
  122. .loc 21,1
  123. .col 3
  124. If the question is answered correctly, or if the number of tries is exhausted, 
  125. the tutorial may (1) STOP, (2) Begin another question, or (3) Enter another
  126. Tutorial Text section, concluding the cycle.
  127. .pau (*Please press ENTER*)
  128. .cls
  129. .col 11
  130. .skip 2
  131. .cen (*CREATE*)
  132. .col 3
  133.  
  134. That is a brief look at a typical tutorial. The CREATE program can help you 
  135. create tutorials like the one outlined above.
  136. .skip 4
  137. .col 12
  138. WHAT IS THE CREATE PROGRAM?
  139.  
  140. .col 3
  141.  
  142. CREATE is the AUTHORING SYSTEM program of the PC-CAI Development System. It 
  143. asks the tutorial author a series of questions, and from the author's answers,
  144. the program CREATE creates a PC-CAI program (stored in a computer file), which
  145. can then be run.
  146.  
  147. .pau (*Please Press ENTER*)
  148. .cls
  149. .col 12
  150.                               The Flow of Creation
  151.                                A Typical Scenario
  152.  
  153. .col 3
  154.           ONE                   TWO                     THREE
  155.     ________________      __________________      ___________________
  156.     In the beginning      Second, the author      Third, the PC-CAI run
  157.     the tutorial          uses the editor to      module is started,
  158.     author runs the       correct any typos       and the tutorial is
  159.     CREATE program.       or to make minor        tested. If corrections
  160.                           changes.                need to be made, go back
  161.                                                   to the second step.
  162. .col 10
  163.  
  164.        RESULT               RESULT                   RESULT
  165.  
  166.  
  167.     A PC-CAI tutorial    The PC-CAI tutorial        A finished product.
  168.     is stored in a       file is updated
  169.     computer file.       with corrections.
  170. .col 3
  171.  
  172. .pau (*Please press ENTER*)
  173. .cls
  174. .col 12
  175.                 TWO MAJOR PROGRAMS USED IN THE CREATION PROCESS
  176. .col 3
  177.  
  178. There are two major programs used in the creation process.
  179.  
  180. 1. CREATE - The authoring program
  181. 2. CAI    - The "run module", which interprets the tutorial program,
  182.             and causes it to do what the author has instructed. The
  183.             CAI module also contains the editor.
  184.  
  185.  
  186. There is a third important program called CAI-UTIL that contains support 
  187. routines including the IMAGE maker, used for animation and program setup.
  188.  
  189.  
  190. @begin
  191. .col 3
  192. Please enter the name of the program which creates a tutorial by asking the 
  193. author questions about the contents of the tutorial.
  194. .col 12
  195.  
  196. @read(*Enter the name here :*)
  197. @right (*CREATE*) force nocase
  198. .col 10
  199.  
  200. VERY GOOD!
  201. .play (*mfo2l16cdefgabo3c*)
  202. @end
  203.  
  204. .pau (*Please press ENTER*)
  205. .loc 9,1
  206. .bla 13
  207. .loc 11,1
  208. @begin
  209. .col 3
  210. Please enter the name of the program which runs the created tutorial.
  211. .col 12
  212.                                 
  213. @read(*Enter the name here :*)  
  214. @right (*CAI*) force nocase
  215. .col 10                         
  216. VERY GOOD!                      
  217. .play (*mfo2l16cdefgabo3c*)     
  218. @end                            
  219.                                                                        
  220. .pau (*Please press ENTER*)                                            
  221. .loc 11,1                                                              
  222. .bla 11                                                                
  223. .loc 11,1
  224. @begin                                                                 
  225. .col 3
  226. Please enter the name of the program that contains the PC-CAI editor.
  227. .col 12
  228.                                                                        
  229. @read(*Enter the name here :*)                                         
  230. @right (*CAI*) force nocase
  231. .col 10                                                                
  232. VERY GOOD!                                                             
  233. .play (*mfo2l16cdefgabo3c*)
  234. @end                                                                   
  235.  
  236. .pau (*Please press ENTER*)
  237. .cls
  238. .col 12
  239.                           BEGINNING THE CREATE PROGRAM
  240.  
  241. .col 3
  242. .skip 3
  243. To begin the CREATE tutorial, you must have the PC-CAI Development System 
  244. Diskette in Drive A (or on hard disk drive C) and the "A>" or "C>" prompt 
  245. must be on the screen. The command to begin the program is simply
  246.  
  247. A>CREATE
  248. .col 12
  249.  
  250. You try it...enter the command to begin the CREATE program:
  251. .col 7
  252.  
  253.  
  254. @begin
  255. @tries 99
  256. @READ(*A>*)
  257. @RIGHT (*CREATE*) Exact nocase
  258. .col 10
  259.  
  260. VERY GOOD!                   
  261. .play (*mfo2l16cdefgabo3c*)  
  262.  
  263. .pau (*Please press ENTER*)
  264. @wrong
  265.  
  266. Be careful in typing in the name of the CREATE program.
  267.  
  268. .pau (*Please press Enter*)  
  269. .loc 11,1
  270. .bla 11
  271. .loc 12,1
  272. @end
  273. .cls
  274. .col 3
  275.  
  276. Once the CREATE program begins, you are presented with a list of tutorial
  277. types to choose from. These types define the general "look" of a tutorial.
  278. Later, we will learn how you can create your own custom tutorial types.
  279.  
  280. ┌──────────────────────────────────────────────────────────────────────┐
  281. │1. Test:One right answer (Exact Nocase), once chance, reply           │
  282. │2. Test:One right answer (Keyword), one chance, no replys             │
  283. │3. Allow full flexibility in the design of tutorial.                  │
  284. │4. Define your own tutorial type.                                     │
  285. └──────────────────────────────────────────────────────────────────────┘
  286.  
  287. .col 12
  288. The Most Flexible
  289.  
  290. .col 3
  291. The most flexible tutorial type causes the CREATE program to ask the tutorial 
  292. author the maximum number of questions. You will often want to use a more 
  293. restricted tutorial type to avoid answering questions unnecessary for the 
  294. particular tutorial you may be creating. 
  295.  
  296. .pau (*Please press ENTER*)
  297. .cls
  298. .COL 10
  299.                              Synopsis of a tutorial
  300.  
  301. .col 3
  302.  
  303. 1. The Title Screen
  304.  
  305. 2. Textual Information
  306.  
  307. 3. Question(s)
  308.  
  309. 4. Ending
  310.  
  311.  
  312. Parts 1 and 4 occur only once, and parts 2 and 3 may occur many times.
  313.  
  314.  
  315. .pau (*Please press Enter*)
  316. .cls
  317. .cen(*Entering Text in CREATE*)
  318.  
  319. In each of the parts of CREATE where you enter textual information, the same
  320. procedure is used.
  321.  
  322. 1. The prompt ">" will always appear at the far left side of the screen.
  323.  
  324. 2. As you type information on the screen, a "word wrap" will occur when the 
  325. typing reaches the right edge of the screen, so that you need not press the 
  326. enter key as you type. Pressing the Esc key ends the entry.
  327.  
  328. 3. To backup and correct an entry on the same line, use the <-- key next to 
  329. the = key.
  330.  
  331. 4. To backup an entire line, enter a .B after the > prompt.
  332.  
  333. 5. To end a section without saving it (abort) enter a .A after the > prompt.
  334.  
  335. 6. It will often be advisible to put off correcting mistakes as you are 
  336. entering textual material, and to correct those mistakes in AE.
  337.  
  338. .pau (*Please press ENTER*)
  339. .cls
  340.                                      REVIEW
  341.  
  342.  
  343. @Beg
  344. @tri 4
  345.  
  346. In order to backup a line to make a correction, what command is entered after
  347. the > prompt?
  348.  
  349. @READ(*Enter your answer here     >*)
  350. @RIGHT(*.B*)exact nocase
  351.  
  352. Correct! Also remember that the command is abort a section is
  353. .play (*o2mbl16cdefgabo3c*)  
  354.  
  355. >.A
  356.  
  357. .pau (*Please press Enter*)
  358. @Wrong
  359.  
  360. The backup command at the > prompt is a dot (.) plus a B.
  361.  
  362. .pau (*Please press Enter*)
  363. .loc 4,1
  364. .bla 18
  365. .loc 4,1
  366. @wrong Final
  367.  
  368. The answer is   >.B
  369. @end
  370. @beg
  371. @tries 4
  372. .col 3
  373. .cls
  374.  
  375. Here is a typical situation: You have typed this textual material, and then
  376. notice that the name Washington is misspelled...
  377.  
  378. >George Wasington was the first President of the United States. He is
  379. >remembered for his brillant role commanding the Contential Army during the
  380. >American Revolution, and his wooden teeth.
  381. >
  382.  
  383. What should you do to correct the misspelling?
  384.  
  385. 1) Enter .B three times, and re-enter the sentence.
  386. 2) Enter .A to aborth the section, and begin again.
  387. 3) Wait and correct it using the PC-CAI editor AE.
  388.  
  389. @READ(*Enter the number of your answer here :*)
  390. @RIGHT(*3*) exact
  391.  
  392. Correct, that is the best choice. To correct minor (or major) mistakes, the 
  393. PC-CAI editor will do the fastest, easiest job.
  394. .play (*o2mbl16cdefgabo3c*)  
  395.  
  396. @Wrong (*2*) exact
  397.  
  398. That is a possible choice, but not the best.
  399.  
  400. .pau (*Please press ENTER*)
  401. @Wrong (*1*) exact
  402.                                               
  403. That is a possible choice, but not the best.  
  404.                                               
  405. .pau (*Please press ENTER*)                   
  406. @end
  407.  
  408. .pau (*Please press Enter*)
  409. @beg
  410. @tries 4
  411. .cls
  412.  
  413. Once you are satisfied that the entry is acceptable, which key will you press?
  414.  
  415.  
  416. 1) Esc key
  417. 2) Enter Key
  418. 3) Break Key
  419.  
  420. @Read (Enter your answer here >*)
  421. @Right(*1*) exact
  422.  
  423. Very Good!
  424. .play (*o2mbl16cdefgabo3c*)  
  425.  
  426. @Wrong
  427.  
  428. No, the proper key to press is the escape key (Esc), located at the upper 
  429. left of the keyboard. 
  430.  
  431. .pau (*Please press Enter*)
  432. @end
  433.  
  434. .pau (*Please press ENTER*)
  435. .cls
  436.                             TYPES OF ANSWER MATCHES
  437.  
  438.  
  439. During the course of creating a tutorial, or in the process of defining a 
  440. tutorial, you will need to specify what KIND of match to expect the user to 
  441. give to a question. This instructs the PC-CAI program how to MATCH the answer 
  442. the user gives to the answer that you have indicated as the correct answer.
  443.  
  444. .col 12
  445. TYPES OF MATCHES
  446.  
  447. .col 3
  448.  
  449. KEYWORD
  450.         EXACT
  451.               EXACT NOCASE
  452.                           SOUNDEX
  453.                                  DECIMAL
  454.                                         LIST
  455.                                              FORCE
  456.                                                    FORCE NOCASE
  457.  
  458. .pau (*Please press Enter*)
  459. .cls
  460. .col 12
  461. THE KEYWORD MATCH
  462.  
  463. .col 3
  464. KEYWORD matches answers by testing to see if the designated answer is 
  465. CONTAINED in the user's answer (ignoring case). For instance,
  466.  
  467. The designated answer is WASHINGTON.
  468.  
  469. The user answers George Washington.
  470.  
  471. The word WASHINGTON is contained in the answer George Washington, therefore, 
  472. it is a match.
  473.  
  474. You must be careful with the keyword match since "John Washington" and
  475. "Washington DC" would both also match the designated answer.
  476.  
  477.  
  478. .pau (*Please press Enter*)
  479. .cls
  480. .col 12
  481.                              EXACT and EXACT NOCASE
  482. .col 3
  483.  
  484. EXACT matches answers by testing that the answer matches letter by letter, 
  485. and case is important. In other words "BILL" would not match with "Bill".
  486.  
  487. EXACT NOCASE is the same as EXACT, except case does not matter. In the
  488. EXACT NOCASE instance, "BILL" and "Bill" would be a match.
  489.  
  490. Exact nocase is recommended for use in a multiple choice question, where the 
  491. list of answers is by letters such as
  492.  
  493. a. Washington
  494. b. Jefferson
  495. etc
  496.  
  497. SOUNDEX is like EXACT NOCASE, except slight misspellings will not cause a
  498. mismatch. For instance SMITH will match with SMYTH or SMYTHE.
  499.  
  500. .pau (*Please press Enter*)
  501. .cls
  502. .col 12
  503.                                     DECIMAL
  504. .col 3
  505.  
  506. DECIMAL indicates that the answer is a decimal number, that is a number of 
  507. the type 10 or 10.1 or 101.345. An answer of the type 1 3/4 would NOT be a 
  508. decimal number.
  509. .col 12
  510.  
  511.                                       LIST
  512. .col 3
  513. LIST allows the designated answer to be a list of words, separated by commas, 
  514. such as wheat, barley, oats. Case is not checked. The list may be in any 
  515. order since "barley,wheat,oats will match "oats,Barley, WHEAT".
  516.  
  517.  
  518. .col 12
  519.                              FORCE and FORCE NOCASE
  520. .col 3
  521. FORCE indicates that the user will be forced to enter the designated answer. 
  522. Any character which does not match the answer will be not be printed on the 
  523. screen, and a beep will indicate that the character is not a part of the 
  524. answer. FORCE checks for case, and FORCE NOCASE ignores case.
  525.  
  526. .pau (*Please press ENTER*)
  527. @beg
  528. @tries 4
  529. .cls
  530. Let's say you have created the question:
  531. .col 12
  532.  
  533. Who was the first president of the United States:
  534.  
  535. a. Benjamin Franklin
  536. b. Johhny Carson
  537. c. George Washington
  538. d. Francis Asbury
  539.  
  540. Please enter your answer:
  541.  
  542. .col 3
  543. What kind of answer type would you designate?
  544.  
  545. a. KEYWORD
  546. b. SOUNDEX
  547. c. EXACT
  548. d. EXACT NOCASE
  549.  
  550. @READ(*Please enter yor answer:*)
  551. @RIGHT(*d*) EXACT NOCASE
  552. .play (*o2mbl16cdefgabo3c*)
  553.  
  554. That is correct since you want the answer to be exact, but case does not 
  555. matter.
  556. @wrong
  557.  
  558. No. Remember, want the answer to match a, b, c, or d, (or A, B, C, or D).
  559.  
  560. .pau (*Please press ENTER*)
  561. @End
  562. .pau (*Please press ENTER*)
  563. @beg
  564. @tries 4
  565. .cls
  566. Suppose you enter the question:
  567.  
  568. .col 12
  569. Enter the name of the first president of the USA :
  570. .col 3
  571. What kind of answer type would you designate 
  572.                                              
  573. a. KEYWORD                                   
  574. b. SOUNDEX
  575. c. EXACT                                     
  576. d. EXACT NOCASE                              
  577.                                              
  578. @READ(*Please enter yor answer:*)
  579. @RIGHT(*a*) exact nocase
  580. .play (*o2mbl16cdefgabo3c*)
  581.  
  582. Correct, since you want the word WASHINGTON to be the keyword on which to
  583. match, and you will allow for various answers such as GEORGE WASHINGTON
  584. and G. WASHINGTON
  585. @WRONG (*b*) exact nocase
  586.  
  587. Could be right, but let's assume you want them to spell the answer correctly.
  588.  
  589. .pau (*Please press ENTER*)
  590. @wrong
  591.  
  592. No, you want the word WASHINGTON to be the keyword on which to match, and you
  593. will allow for various answers such as GEORGE WASHINGTON and G. WASHINGTON 
  594.  
  595. .pau (*Please press ENTER*)  
  596. @END
  597. .pau (*Please press ENTER*)
  598. .cls
  599. .col 12
  600.                               SUMMARY INFORMATION
  601. .col 3
  602.  
  603. 1. The most common match used is KEYWORD, with the next being EXACT NOCASE.
  604.  
  605. 2. If you use LIST, make sure the question is worded so that the user knows 
  606. that the answer must contain a list with commas separating each item.
  607.  
  608. 3. SOUNDEX check for words that "sound" correct.
  609.  
  610. 4. When you use decimal, word the question so that an answer of the type
  611. 3 3/4 is not given instead of 3.75.
  612.  
  613. 5. The FORCE match is not supported in the CREATE program since it supports 
  614. the concept of RIGHT, but does not allow a wrong answer. It may be added to a 
  615. tutorial using the AE PC-CAI editor. 
  616.  
  617.  
  618. .pau (*Please press ENTER*)
  619. .cls
  620. .color 12
  621.                                      REVIEW
  622. .color 3
  623.  
  624.  
  625. The PC-CAI system consists of several "modules".  They are
  626.  
  627. CREATE ....Helps you create tutorials
  628.  
  629.  
  630. CAI .......Runs tutorials and contains an editor to allow you to create or
  631.            edit tutorial files.
  632.  
  633.  
  634. CAI-UTIL ..Contains support routines, including the IMAGE routine that allows
  635.            you to draw pictures for use in graphics or animation.
  636. .locate 24,1
  637. .pause
  638. .cls
  639.  
  640. This ends the CREATE tutorial, part two. You should also read the "BEGINNER"
  641. chapter in the PC-CAI manual, and practice using CREATE.
  642.  
  643. Items NOT covered in this tutorial, but which appear in the manual are:
  644.  
  645. 1. How to set up function keys.
  646. 2. How to define your own tutorial type.
  647. 3. How to use the PC-CAI editor.
  648.  
  649. Please run the tutorial named CREATE2 next.
  650.  
  651.  
  652. .pau (*Please press ENTER to end this tutorial*)
  653. @MENU
  654.