home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / t / teach241.zip / TWCAI2.CHP < prev    next >
Text File  |  1992-12-11  |  28KB  |  927 lines
  1. #OFF
  2. %
  3. #EF
  4. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  5.         |STEPS|   |STEP 2|  |NUMAID|   |QUICK REFERENCE|   |JUMP START|  |ABOUT|
  6. #HH,1,5,80,1,1,0
  7. #R6
  8.                ╥ ╥          ╖      ╓─┐ ╥         ╥           ╓─┐
  9.                ╟─╢ ╓╖ ╥┐ ╓╖  ╓─    ║   ╟┐ ╓┐ ╥┐ ─╫─ ╓╖ ╥┐    ╓─┘
  10.                ╨ ╨ ╙─ ╨  ╙─  ─╜    ╙─┘ ╨└ ╙┴ ╟┘  ╙┘ ╙─ ╨     ╙─┘
  11.  
  12.          ╓╥┐           ╥     ╥         ┌╥┬┐       ╥        ∞
  13.           ║  ╓╖ ╥┬┐ ╥┐ ║ ╓┐ ─╫─ ╓╖      ║┴│ ╓╖ ╓─ ╟┐ ╓┐ ╥┐ ╥ ╓─ ╓─
  14.           ╨  ╙─ ╨ ┴ ╟┘ ╨ ╙┴  ╙┘ ╙─      ╨ ┴ ╙─ ╙─ ╨└ ╙┴ ╨└ ╨ ╙─ ─╜
  15.  
  16.  
  17.  
  18.                                   Preview
  19.         ~b~Y~I┌───────────────────────────────────────────────────────────┐~z
  20.         ~b~Y~I│Chapter 2 discusses the common organization and elements   │~z
  21.         ~b~Y~I│of all CAITeach template files.  For example:  all have 16 │~z
  22.         ~b~Y~I│lines, a number line, remark line and a common sequence.   │~z
  23.         ~b~Y~I│In the next chapters we will look at each template, but by │~z
  24.         ~b~Y~I│discussing their common parts we save doing it four times. │~z
  25.         ~b~Y~I└───────────────────────────────────────────────────────────┘~z
  26. #NE
  27. #HH,1,24,80,1,1,0
  28. #HF,1,25,80,25,176,1,0
  29. #W
  30.  
  31. #NC
  32. #BO,20,12,64,19,2,1,1,5,14,4
  33. As mentioned in Chapter 1, you really
  34.  
  35. need a printout of Quick Reference, and
  36.  
  37. NumAid for this Chapter.
  38.  
  39. %
  40. #EF
  41. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  42.       |CAITEST FILE|     |STEPS|     |STEP 2|    |MERGE|     |JUMP START|
  43. #HH,1,5,80,1,1,0
  44. #R6
  45.  ▄█▀▀▀▀▀█▄ .∙      The three Steps in writing a CAITest are:
  46. ▐█▐─ô═ô─▌█▌∙.
  47.  └┤ /U\ ┌┘ .∙         Step 1. Write tutorial in ~W~ITutorialWriter~Y~I
  48.   │█▀▀▀█│             ~C~IStep 2~Y~I. Construct CAI file in editor & DOS test
  49.   └┬███┬┘             Step 3. Run CAITest File from ~W~ITutorialWriter~Y~I
  50. ▒▒▒▒\■/▒▒▒▒
  51.                    This tutorial does not discuss Step 1.
  52.  
  53.                    ~C~IStep 2~Y~I consists of four parts:
  54.                       * Merging                 * Composing
  55.                       ~F*~F Checking (mechanics)    ~F*~F Testing at DOS
  56.  
  57.     This Chapter discusses only the last ~Ftwo~F parts of ~C~IStep 2~Y~I.
  58.  
  59.     ~KI carefully picked mechanics and testing for Chapter 2~k.  ~W~IOnce you under-
  60. stand the basic elements, and can get your questions to run from DOS you are
  61. ready for experimentation~Y~I.
  62.  
  63.     Any errors made in ~C~IStep 3~Y~ are immediately obvious when testing.
  64. #HH,1,24,80,1,1,0
  65. #HF,1,25,80,25,176,1,0
  66. #WP,H
  67.  
  68. %
  69. #EF
  70. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  71.  
  72. #AR,0,7
  73. Before you can check something you
  74. must know its parts.  The parts
  75. of a CAITest are templates, each
  76. stored as a text file.
  77.  
  78. This chapter starts our study
  79. of templates.
  80.  
  81. #HH,1,24,80,1,1,0
  82. #HF,1,25,80,25,176,1,0
  83. #WP,H
  84.  
  85. %
  86. #EF
  87. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  88.         |TEMPLATES|     |MERGE|     |STEPS|     |STEP 2|     |CAITEACH|
  89. #AP,0,12
  90. Now to work.....
  91.  
  92. I'm going to discuss the three divisions and
  93. each line of CAITeach Templates.  Suggest
  94. you scan the hypertext Templates.
  95.  
  96. I'm going to show you how to manually renumber
  97. and check, at DOS, a previously merged and
  98. composed file.
  99.  
  100. When finished you'll know the basic mechanics
  101. or all templates and the CAITest file.
  102. #HH,1,5,80,1,1,0
  103.  
  104.  
  105. #HH,1,24,80,1,1,0
  106. #HF,1,25,80,25,176,1,0
  107. #WP,H
  108.  
  109. #NC
  110. #BO,10,12,64,18,2,1,1,5,14,4
  111. You might learn, by observation, how to write
  112.  
  113. within the templates (compose) in this chapter,
  114.  
  115. but that is completely detailed in later chapters.
  116.  
  117. %
  118. #EF
  119. #T15,1,Mechanics: Renumbering and Testing the CAITeach Question File from DOS
  120.                              |STEPS|     |STEP 2|
  121. #HH,1,6,80,1,1,0
  122. #AR,0,7
  123. This is Part 2 and 4 of Step 2, or
  124. "b" and "d", depending on how
  125. you sequence them.
  126.  
  127. But, it is the most important
  128. mechanical part of constructing
  129. CAITeach question files.
  130. #HH,1,5,80,1,1,0
  131.  
  132. #HH,1,24,80,1,1,0
  133. #HF,1,25,80,25,176,1,0
  134. #WP,H
  135.  
  136. %
  137. #EF
  138. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  139.     |{4TYPES|     |MERGE|     |TEMPLATES|   |STEPS|  |STEP 2|  |JUMP START|
  140. #HH,1,5,80,1,1,0
  141. #R10
  142.  ▄█▀▀▀▀▀█▄ .∙      Much learning is by experimentation and observation ---
  143. ▐█▐─ô═ô─▌█▌∙.         my preferred method.
  144.  └┤ /U\ ┌┘ .∙
  145.   │█▀▀▀█│          This chapter introduces you to ~W~ICAITeach~Y~I by showing
  146.   └┬███┬┘            you a completed file.
  147. ▒▒▒▒\■/▒▒▒▒
  148.                    One of these last things you did in Chapter 1 was run a
  149.                      file that demonstrated the four ~C~ICAITeach templates~Y~I.
  150.  
  151.     Next, we will examine that file in great detail.  I rewrote it as a ~C~ICOM~Y~I
  152. file so I could get some color.  Of course, you could, and should review it
  153. in your editor.
  154. #HH,1,24,80,1,1,0
  155. #HF,1,25,80,25,176,1
  156. #WP,H
  157.  
  158. %
  159. #EF
  160. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  161.            |4TYPES|     |NUMAID|     |TEMPLATES|   |STEPS|  |STEP 2|
  162. #AP,0,12
  163. You will next view the file {4TYPES.CHP, the one
  164. you ran in Chapter 1.
  165.  
  166. During this first view just get used to my
  167. display  as we will use it several times
  168. Note how the line number count is
  169. displayed.  Bottom right.  Called "Rows."
  170.  
  171. There are notes at the bottom of the file.
  172.  
  173. After exit, I'll ask you how many lines there
  174. were, excluding my boxed comments.
  175. #HH,1,5,80,1,1,0
  176.  
  177. #HH,1,24,80,1,1,0
  178. #HF,1,25,80,25,176,1,0
  179. #WP,H
  180.  
  181. #U{4TYPESC.COM
  182.  
  183. #EF
  184. #T15,1,Renumbering and Testing the CAITeach Question File from DOS
  185.  
  186. #QQ,R,2
  187. How many lines were in the
  188. original file, {4TYPES.CHP
  189. 80
  190. 80,eighty
  191. #R4
  192. Five Questions times 16 lines per question = 80 lines.
  193.  
  194. #HH,1,24,80,1,1,0
  195. #HF,1,25,80,25,176,1,0
  196. #WP,H
  197.  
  198. 0,12,60,18,2,1,1,5,14,4
  199. Next questions assume you have copy
  200.  
  201. of Quick Reference beside you.
  202.  
  203. = This will help you work with it =
  204.  
  205. %
  206. #EF
  207. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  208.          |NUMAID|     |TEMPLATES|   |STEPS|  |STEP 2|    |JUMP START|
  209. #HH,1,5,80,1,1,0
  210.  
  211.  ▄█▀▀▀▀▀█▄ .∙      Let's talk about the number of lines in the file
  212. ▐█▐─ô═ô─▌█▌∙.        and the number required for each question...
  213.  └┤ /U\ ┌┘ .∙
  214.   │█▀▀▀█│          All CAI question ~C~Itemplates~Y~I are divided into three
  215.   └┬███┬┘            divisions, each with a set number of lines:
  216. ▒▒▒▒ ■ ▒▒▒▒
  217.                          Header........................... 5 lines
  218.                          Question/Text/Mouse...............9 lines
  219.                          Answer............................2 lines
  220.                                                            ========
  221.                                                 TOTAL       ~F16~F lines
  222.  
  223.     Therefore, one question would have 16 lines, two questions would
  224. have 32 lines, three questions 48 lines, and four questions 64, and five
  225. questions 80 lines.  Your ~W~INumAid~Y~I might help here.
  226.  
  227. #HH,1,24,80,1,1,0
  228. #HF,1,25,80,25,176,1,0
  229. #WP,H
  230.  
  231. %
  232. #EF
  233. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  234. #QQ,R,3
  235. There were 80 lines in the file you
  236. looked at.  Each question has 16 lines.
  237. How many questions were there?
  238. 5
  239. five,5
  240. #HH,1,24,80,1,1,0
  241. #HF,1,25,80,25,176,1,0
  242. #WP,H
  243.  
  244. %
  245. #EF
  246. #T15,1,Mechanics: Renumbering and Testing the CAITeach Question File from DOS
  247.  
  248. #QQ,R,2
  249. If your file has 10 questions,
  250. how many total lines are there?
  251. 160
  252. 160
  253. #HH,1,24,80,1,1,0
  254. #HF,1,25,80,25,176,1,0
  255. #WP,H
  256.  
  257. %
  258. #EF
  259. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  260.  
  261. #QQ,R,3
  262. If your file has 9 questions,
  263. and 1 study screen, how many
  264. total lines are there?
  265. 160
  266. 160
  267. #R4
  268. STUDY screens and QUESTIONS take 10 lines each.
  269. However, the STUDY screens are not counted in the scoring process.
  270.  
  271. #HH,1,24,80,1,1,0
  272. #HF,1,25,80,25,176,1,0
  273. #WP,H
  274.  
  275. %
  276. #EF
  277. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  278.           |NUMAID|   |TEMPLATES|   |STEPS|   |STEP 2|   |JUMP START|
  279. #HH,1,5,80,1,1,0
  280. #R12
  281.  ▓▓▓▓▓▓▓▓▌         OK!  I'm going to show you ~W~I{4TYPES.CHP~Y~I again.
  282.  ▓▓▓▌ ▓▓▓▌
  283.      ▓▓▓▌          Note that the first line of each question is numbered.
  284.  
  285.      ▓▓▓▌          Next, I'll ask you the first number found on line one
  286.      Next            of the fourth question.
  287.  
  288.  
  289. #HH,1,24,80,1,1,0
  290. #HF,1,25,80,25,176,1,0
  291. #WP,H
  292.  
  293. #U{4TYPESC.COM
  294.  
  295. %
  296. #EF
  297. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  298. message
  299.  
  300. #QQ,R,2
  301. What is the first number found
  302. on line one of the fourth question?
  303. 49
  304. 49
  305. #R4
  306. It must be flush left, within the first five spaces.
  307.  
  308. #HH,1,24,80,1,1,0
  309. #HF,1,25,80,25,176,1,0
  310. #WP,H
  311.  
  312. %
  313. #EF
  314. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  315.          |NUMAID|     |TEMPLATES|   |STEPS|  |STEP 2|     |JUMP START|
  316. #HH,1,5,80,1,1,0
  317. #R10
  318.  ▓▓▓▓▓▓▓▓▌         OK.  I'm going to show you ~W~I{4TYPES.CHP~Y~I again.
  319.  ▓▓▓▌ ▓▓▓▌
  320.      ▓▓▓▌          Note that the line on which each question starts has a
  321.                      line number and  " = Q Number2," both optional.
  322.      ▓▓▓▌
  323.      Next           ~C~INumber2~Y~I is a variable.  It will not be ~C~INumber2~Y~I, but
  324.                       a number represented by the variable.  The equals sign
  325.                       is cosmetic, entirely optionally. You may omit it, or use
  326.                       any character which makes it easier for you to read.
  327.  
  328.     Next, I'll ask you what that ~C~INumber2~Y~I represents on each line.  HINT: Compare
  329. ~C~INumber2~Y~I with the position of that particular question in the file.
  330. #HH,1,24,80,1,1,0
  331. #HF,1,25,80,25,176,1,0
  332. #WP,H
  333.  
  334. #U{4TYPESC.COM
  335.  
  336.  
  337. #EF
  338. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  339. #R4
  340. This number is used by the utilities, not by ~W~ICAITeach~Y~I.
  341.  
  342.  
  343. #QQ,B,5
  344. [True of False] The CAITeach Question always starts with a line
  345. such as "Number1 = Q Number2 = Number3."  Everything but the first
  346. number is optional.  The second number, Number2, when entered, or
  347. placed there by the renumber utility is an editing aid which shows
  348. the number of the question in the CAITeach file.
  349. T
  350. true,T,t
  351.  
  352. %
  353. #EF
  354. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  355.                  |NUMAID|     |TEMPLATES|   |STEPS|  |STEP 2|
  356. #HH,1,5,80,1,1,0
  357. #R12
  358.  ▓▓▓▓▓▓▓▓▌         OK.  I'm going to show you ~W~I{4TYPES.CHP~Y~I again.
  359.  ▓▓▓▌ ▓▓▓▌
  360.      ▓▓▓▌          Note that the line on which each question starts has a
  361.                      line number, a second number, and last number, ~C~INumber3~Y~I.
  362.      ▓▓▓▌
  363.      Next          Next, I'll ask you what the variable, ~C~INumber3~Y~I, represents.
  364.  
  365.                    All of this is on Page 2 of your ~C~IQuick Reference~Y~I.
  366. #HH,1,24,80,1,1,0
  367. #HF,1,25,80,25,176,1,0
  368. #WP,H
  369.  
  370. #U{4TYPESC.COM
  371.  
  372.  
  373. #EF
  374. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  375. #QQ,B,5
  376. [True of False] The CAITeach Question always starts with a
  377. line such as Number1 = Q Number 2 = Number3  Everything but
  378. the first number is optional.  The last number, Number3, when
  379. entered, or placed there by the renumber utility is an editing
  380. aid that indicates the starting line number of the next question.
  381. T
  382. true,T,t
  383.  
  384. %
  385. #EF
  386. #HH,1,5,80,1,1,0
  387. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  388.          |NUMAID|    |TEMPLATES|   |STEPS|  |STEP 2|     |JUMP START|
  389. #HH,1,5,80,1,1,0
  390. #R12
  391.  ▓▓▓▓▓▓▓▓▌         So line 1 always starts a question or study template,
  392.  ▓▓▓▌ ▓▓▓▌           and it is always a number.
  393.      ▓▓▓▌
  394.                    Here's a summary question on line 1...
  395.      ▓▓▓▌
  396.      Next
  397.  
  398. #HH,1,24,80,1,1,0
  399. #HF,1,25,80,25,176,1,0
  400. #WP,H
  401.  
  402. ~0No % here~Y~I
  403. #EF
  404. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  405. Your answer can not have a space.
  406. #QQ,B,10
  407. Line 1 of CAI template could start with three numbers, suggested by
  408. the variables on the next line.  Examine the list and enter the number
  409. of each true statement. Do not use a space between your numbers.
  410.  
  411.                 Number1  = Q Number2 = Number3
  412.  
  413.  1. Everything but the first number is optional.
  414.  2. Number1 must be flush left, and in the first five space.
  415.  3. Number2, could be any number, might be the questions number.
  416.  4. Number3, could be any number, might be line 1 of next question.
  417. 1234
  418. 1234
  419.  
  420. %
  421. #EF
  422. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  423.                  |NUMAID|     |TEMPLATES|   |STEPS|  |STEP 2|
  424. #HH,1,5,80,1,1,0
  425. #R9
  426.  ▄█▀▀▀▀▀█▄ .∙      Only one other thing about Line 1:
  427. ▐█▐─ô═ô─▌█▌∙.
  428.  └┤ /U\ ┌┘ .∙      The renumbering utility,~W~I{RENUM~Y~I, will renumber your
  429.   │█▀▀▀█│            file if it finds any number other than 0 or a
  430.   └┬███┬┘            letter on line one of each template.
  431. ▒▒▒▒ ■ ▒▒▒▒
  432.                    You don't have to renumber your questions when you
  433.                     merge them, but if you have over five I so recommend.
  434.  
  435.                    You certainly need to know what should be there.
  436. #HH,1,24,80,1,1,0
  437. #HF,1,25,80,25,176,1,0
  438. #WP,H
  439. %
  440. #EF
  441. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  442. #HH,1,5,80,1,1,0
  443. #T15,1,Mechanics: Renumbering and Testing the CAITeach Question File from DOS
  444.  |QUICK REFERENCE|   |NUMAID|   |TEMPLATES|   |STEPS|   |STEP 2|  |JUMP START|
  445. #HH,1,5,80,1,1,0
  446. #R6
  447.                    In order to edit your files you must know the contents
  448.  ▄█▀▀▀▀▀█▄ .∙        of each line.  Now, lets examine line 3 as it is the
  449. ▐█▐─ô═ô─▌█▌∙.        second most important line.
  450.  └┤ /U\ ┌┘ .∙
  451.   │█▀▀▀█│          Your ~W~IQuick Reference~Y~I, and prior discussion
  452.   └┬███┬┘            states that ~W~ICAITeach~Y~I has four templates:
  453. ▒▒▒▒\■/▒▒▒▒
  454.                         Question Templates .............. 3
  455.                         Study, or Text ...................1
  456.  
  457.     A particular question-template is identified by a code on the third line
  458. of each question, as shown in your ~W~IQuick Reference~Y~I.
  459.  
  460.     Those are ~C~IStudy~Y~I, ~C~ITF~Y~I, ~C~IMC4,~Y~I and ~C~IKB~Y~I.
  461. #HH,1,24,80,1,1,0
  462. #HF,1,25,80,25,176,1,0
  463. #WP,H
  464.  
  465. %
  466. #EF
  467. #T15,1,Mechanics: Renumbering and Testing the CAITeach Question File from DOS
  468.       |QUICK REFERENCE|     |NUMAID|     |TEMPLATES|   |STEPS|   |STEP 2|
  469. #HH,1,5,80,1,1,0
  470. #R10
  471.  ▓▓▓▓▓▓▓▓▌         OK.  I'm going to show you ~W~I{4TYPES.CHP~Y~I again.
  472.  ▓▓▓▌ ▓▓▓▌
  473.      ▓▓▓▌
  474.                    Examine the Question Codes (QCodes), and then
  475.      ▓▓▓▌
  476.      Next          I'll ask you how many ~C~IStudy~Y~I codes were in the
  477.  
  478.                      file, and on which line they always appear.
  479.  
  480. #HH,1,24,80,1,1,0
  481. #HF,1,25,80,25,176,1,0
  482. #WP,H
  483.  
  484.  
  485. #U{4TYPESC.COM
  486.  
  487. %
  488. #EF
  489. #T15,1,Mechanics: Renumbering and Testing the CAITeach Question File from DOS
  490.  
  491. #QQ,R,2
  492. How many STUDY templates (codes)
  493. were used in the file?
  494. 2
  495. 2,two
  496. #HH,1,24,80,1,1,0
  497. #HF,1,25,80,25,176,1,0
  498. #WP,H
  499.  
  500. %
  501. #EF
  502. #EF
  503. #T15,1,Mechanics: Renumbering and Testing the CAITeach Question File from DOS
  504. #QQ,R,2
  505. On which line does one always
  506. find the STUDY code?
  507. 3
  508. 3,three
  509. #HH,1,24,80,1,1,0
  510. #HF,1,25,80,25,176,1,0
  511. #WP,H
  512.  
  513. %
  514. #EF
  515. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  516.          |NUMAID|     |TEMPLATES|   |STEPS|  |STEP 2|     |JUMP START|
  517. #HH,1,5,80,1,1,0
  518. #R7
  519.  ▄█▀▀▀▀▀█▄ .∙      You may correctly conclude that the ~C~IQuestion Codes~Y~I, or
  520. ▐█▐─ô═ô─▌█▌∙.        ~C~IQCodes~W~I are always found on line 3, and each code is~Y~I
  521.  └┤ /U\ ┌┘ .∙        ~C~Isuggested in the template file name~Y~I.
  522.   │█▀▀▀█│
  523.   └┬███┬┘                 ~C~I- File -          - Type -         - QCode -~Y~I
  524. ▒▒▒▒\■/▒▒▒▒             {T-STUDY.CHP      Study "Question"           STUDY
  525.                         {T-TF.CHP         True-False                 TF
  526.                         {T-MC4.CHP        Multiple Choice            MC
  527.                         {T-KB.CHP         Fill-In (Completion)       KB
  528.  
  529.      Line 3 of any template must contain one of the four ~C~IQCodes~W~I as identified
  530. in that column, above.  These codes are part of the template files.
  531.  
  532.     To write a question you merge one of the ~C~I- Files -~Y~I into your editor, compose
  533. your question, save it, test it, and call it from ~C~ITutorialWriter~Y~I.
  534. #HH,1,24,80,1,1,0
  535. #HF,1,25,80,25,176,1,0
  536. #WP,H
  537.  
  538.  
  539. #EF
  540. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  541. Refer to ~W~IQuick Reference ~Y~Iif necessary.
  542. #QQ,B,8
  543.              Your template files are:
  544.   {T-STUDY.CHP   {T-TF.CHP  {T-MC4.CHP  {T-KB.CHP
  545.  
  546. You are working in your editor building a CAITeach file and
  547.  
  548. want to write a study screen (template).  Enter the complete
  549.  
  550. name of the file that you merge with your working file.
  551. {T-STUDY.CHP
  552. {T-STUDY.CHP
  553.  
  554. #EF
  555. #T15,1,Mechanics: Renumbering and Testing the CAITeach Question File from DOS
  556. ~W~IQuick Reference~Y~I has it also.
  557.  
  558. #QQ,B,8
  559.              Your template files are:
  560.   {T-STUDY.CHP   {T-TF.CHP  {T-MC4.CHP  {T-KB.CHP
  561.  
  562. You are working in your editor building a CAITeach file and
  563.  
  564. want to write a fill-in (completion) question.  Enter the
  565.  
  566. name of file that you merge with your working file.
  567. {T-KB.CHP
  568. {T-KB.CHP
  569.  
  570. %
  571. #EF
  572. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  573.          |NUMAID|     |TEMPLATES|   |STEPS|  |STEP 2|     |JUMP START|
  574. #HH,1,5,80,1,1,0
  575. #R9
  576. ╔══════════════════╗
  577. ║ CAITeach Template║    Now we will start back at line 2, and
  578. ╒══════════════════╕       examine the other lines.
  579. │ Line Number      │
  580. │ ?                │    I'm going to show you ~W~I{4TYPES.CHP~Y~I again.
  581. │ 1 of 4 QCodes    │
  582. │ Citation Line    │    Note exactly what always starts line 2
  583. │ Ruler            │      of each question-template.
  584. │ 9 Text Lines     │
  585. │ 2 Answer Lines   │    Then I'll tell you what it is.
  586. └──────────────────┘
  587. #HH,1,24,80,1,1,0
  588. #HF,1,25,80,25,176,1,0
  589. #WP,H
  590.  
  591. #U{4TYPESC.COM
  592.  
  593. %
  594. #EF
  595. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  596.          |NUMAID|     |TEMPLATES|   |STEPS|  |STEP 2|     |JUMP START|
  597. #HH,1,5,80,1,1,0
  598. #R9
  599. ╔══════════════════╗
  600. ║ CAITeach Template║    Line 2 always starts with a semicolon.
  601. ╒══════════════════╕
  602. │ Line Number      │    Other than the semicolon it can contain anything
  603. │ ;  ice cream     │      else.  Use it for notes, or leave it blank.
  604. │ One of 4 QCodes  │
  605. │ Citation Line    │    Like a ~C~IREM~Y~I in BASIC.
  606. │ Ruler            │
  607. │ 9 Text Lines     │    However, it must start with a semicolon.
  608. │ 2 Answer Lines   │      (a diagnostic uses it)
  609. └──────────────────┘
  610. #HH,1,24,80,1,1,0
  611. #HF,1,25,80,25,176,1,0
  612. #WP,H
  613.  
  614. %
  615. #EF
  616. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  617.          |NUMAID|     |TEMPLATES|   |STEPS|  |STEP 2|     |JUMP START|
  618. #HH,1,5,80,1,1,0
  619. #R10
  620. ╔══════════════════╗
  621. ║ CAITeach Template║
  622. ╒══════════════════╕      I'm going to show you ~W~I{4TYPES.CHP~Y~I again.
  623. │ Line Number      │
  624. │ ; REM line       │      Scan the contents of line 4 of each template,
  625. │ 1 of 4 QCodes    │        but don't spend much time.
  626. │ ?                │
  627. │ Ruler            │      Then I'll tell you what it is.
  628. │ 9 Text Lines     │
  629. │ 2 Answer Lines   │
  630. └──────────────────┘
  631. #HH,1,24,80,1,1,0
  632. #HF,1,25,80,25,176,1,0
  633. #WP,H
  634.  
  635.  
  636. #U{4TYPESC.COM
  637.  
  638. %
  639. #EF
  640. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  641.          |NUMAID|     |TEMPLATES|   |STEPS|  |STEP 2|     |JUMP START|
  642. #HH,1,5,80,1,1,0
  643. #R9
  644. ╔══════════════════╗      Line 4 is called the citation line.
  645. ║ CAITeach Template║
  646. ╒══════════════════╕      It always displays; if blank, a blank line displays.
  647. │ Line Number      │
  648. │ ; REM line       │      I programmed it there because I often cite the book,
  649. │ 1 of 4 QCodes    │        and page number on this line.  But use it any
  650. │ Citation Line    │        way you wish.
  651. │ ?                │
  652. │ 9 Text Lines     │      Now, here comes ~W~I{4TYPES.CHP~Y~I again.  Examine what
  653. │ 2 Answer Lines   │        always appears on template line 5.
  654. └──────────────────┘
  655. #HH,1,24,80,1,1,0
  656. #HF,1,25,80,25,176,1,0
  657. #WP,H
  658.  
  659. #U{4TYPESC.COM
  660.  
  661. %
  662. #EF
  663. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  664.                  |NUMAID|     |TEMPLATES|   |STEPS|  |STEP 2|
  665. #HH,1,5,80,1,1,0
  666. #R9
  667. ╔══════════════════╗
  668. ║ CAITeach Template║      Line 5 is the ruler line, just an editing aid.
  669. ╒══════════════════╕
  670. │ Line Number      │      You may recall that the program sets the left
  671. │ ; REM line       │        screen margin at 3.  The ruler line encourages
  672. │ 1 of 4 QCodes    │        you to stop in column 75.
  673. │ Citation Line    │
  674. │ Rule:r...:...    │      When finished you may erase anything after the ~C~Ir~Y~I
  675. │ 9 Text Lines     │        in ~C~Iruler~Y~I which is used diagnostically.
  676. │ 2 Answer Lines   │
  677. └──────────────────┘
  678. #HH,1,24,80,1,1,0
  679. #HF,1,25,80,25,176,1,0
  680. #WP,H
  681.  
  682. %
  683. #EF
  684. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  685.          |NUMAID|     |TEMPLATES|   |STEPS|  |STEP 2|     |JUMP START|
  686. #HH,1,5,80,1,1,0
  687. #R9
  688. ╔══════════════════╗      I'm going to show you ~W~I{4TYPES.CHP~Y~I again.
  689. ║ CAITeach Template║
  690. ╒══════════════════╕      This time, just observe that lines 6 - 14 contain
  691. │ Line Number      │        questions, text material, mouse hot spots, or
  692. │ ; REMarks line   │        are empty.
  693. │ 1 of 4 QCodes    │
  694. │ Citation Line    │      Chapters 3 and 4 of this tutorial discuss those
  695. │ Rule:r...:..     │        lines in detail, for one composes study or
  696. │ 9 Text Lines     │        question screens one these lines, each
  697. │ Answer Line      │        according to the question type.
  698. │ Answer Comment   │
  699. └──────────────────┘
  700. #HH,1,24,80,1,1,0
  701. #HF,1,25,80,25,176,1,0
  702. #WP,H
  703.  
  704. #U{4TYPESC.COM
  705.  
  706. %
  707. #EF
  708. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  709.        |NUMAID|     |TEMPLATES|    |STEPS|    |STEP 2|     |JUMP START|
  710. #HH,1,5,80,1,1,0
  711. #R9
  712. ╔══════════════════╗
  713. ║ CAITeach Template║      But you do need to know about the last two lines,
  714. ╒══════════════════╕        called the answer lines, although there are
  715. │ Line Number      │        more details in Chapters 3 and 4.
  716. │ ; REM line       │
  717. │ 1 of 4 QCodes    │      These two lines vary by template, but you need
  718. │ Citation Line    │        to know their general characteristics
  719. │ Rule:r...:...    │        for formatting purposes.
  720. │ 9 Text Lines     │
  721. │ Answer Line      │
  722. │ Answer Comment   │       Almost finished~F....~F
  723. └──────────────────┘
  724. #HH,1,24,80,1,1,0
  725. #HF,1,25,80,25,176,1,0
  726. #WP,H
  727.  
  728. %
  729. #EF
  730. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  731.                  |NUMAID|     |TEMPLATES|   |STEPS|  |STEP 2|
  732. #HH,1,5,80,1,1,0
  733. #R10
  734.  ▓▓▓▓▓▓▓▓▌         OK.  I'm going to show you ~W~I{4TYPES.CHP~Y~I again.
  735.  ▓▓▓▌ ▓▓▓▌
  736.      ▓▓▓▌          Examine the last two lines of each ~FSTUDY~F template.
  737.  
  738.      ▓▓▓▌          Next, I'll ask what you always find on these two
  739.      Next
  740.                      particular last line.
  741. #HH,1,24,80,1,1,0
  742. #HF,1,25,80,25,176,1,0
  743. #WP,H
  744.  
  745.  
  746. #U{4TYPESC.COM
  747.  
  748.  
  749. %
  750. #EF
  751. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  752. #QQ,R,3
  753. What single symbol, or character,
  754. always starts the last two
  755. lines of a STUDY template.
  756. ;
  757. ;
  758. #HH,1,24,80,1,1,0
  759. #HF,1,25,80,25,176,1,0
  760. #WP,H
  761.  
  762. %
  763. #EF
  764. #T15,1,Mechanics: Renumbering and Testing the CAITeach Question File from DOS
  765.        |NUMAID|     |TEMPLATES|    |STEPS|    |STEP 2|     |JUMP START|
  766. #HH,1,5,80,1,1,0
  767. #R9
  768. ╔══════════════════╗
  769. ║ CAITeach Template║    Except for the study template, the next to last
  770. ╒══════════════════╕      line always includes an answer, which varies
  771. │ Line Number      │      with the template/question type, and is detailed
  772. │ ; REM line       │      in the next two chapters.
  773. │ 1 of 4 QCodes    │
  774. │ Citation Line    │
  775. │ Rule:r...:...    │    I'm going to show you ~W~I{4TYPES.CHP~Y~I.  Note the
  776. │ 9 Text Lines     │      contents of the last line, and I'll discuss it.
  777. │ Answer Line      │
  778. │ Answer Comment   │
  779. └──────────────────┘
  780. #HH,1,24,80,1,1,0
  781. #HF,1,25,80,25,176,1,0
  782. #WP,H
  783.  
  784.  
  785. #U{4TYPESC.COM
  786.  
  787.  
  788. %
  789. #EF
  790. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  791.        |NUMAID|     |TEMPLATES|    |STEPS|    |STEP 2|     |JUMP START|
  792. #HH,1,5,80,1,1,0
  793. #R8
  794. ╔══════════════════╗    Line 16, the last line is called the Answer
  795. ║ CAITeach Template║       Comment Line, and is optionally used for a
  796. ╒══════════════════╕       a teaching point.
  797. │ Line Number      │
  798. │ ; REM line       │    If the word ~C~INone~Y~I starts the line, then
  799. │ 1 of 4 QCodes    │      it is not displayed.
  800. │ Citation Line    │
  801. │ Rule:r...:...    │    However, any other line is displayed after the
  802. │ 9 Text Lines     │      student answers the question.
  803. │ Answer Line      │
  804. │ Answer Comment   │    (You may recall these are regular text lines in
  805. └──────────────────┘      the ~C~IStudy~Y~I template.)
  806.  
  807. #HH,1,24,80,1,1,0
  808. #HF,1,25,80,25,176,1,0
  809. #WP,H
  810.  
  811. #NC
  812. #BO,20,12,64,19,2,1,1,5,14,4
  813. "None" when used to suppress display
  814.  
  815. of the last line must start with a
  816.  
  817. capital "N," and not be in quotes.
  818.  
  819.  
  820. %
  821. #EF
  822. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  823.      |NUMAID|     |TEMPLATES|    |STEPS|   |STEP 2|     |QUICK REFERENCE|
  824. #HH,1,5,80,1,1,0
  825. #R12
  826.  ▄█▀▀▀▀▀█▄ .∙      ~W~IQuick Reference~Y~I condenses this information for you.
  827. ▐█▐─ô═ô─▌█▌∙.
  828.  └┤ /U\ ┌┘ .∙      ~W~INumAid~Y~I shows you the first line for 40 questions.
  829.   │█▀▀▀█│
  830.   └┬███┬┘          Work with these two beside your keyboard
  831. ▒▒▒▒ ■ ▒▒▒▒
  832.  
  833.                   ~W~IMight also be a good time to scan the template models.~Y~I
  834. #HH,1,24,80,1,1,0
  835. #HF,1,25,80,25,176,1,0
  836. #WP,H
  837.  
  838.  
  839. %
  840. #EF
  841. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  842.         |NUMAID|     |TEMPLATES|   |STEPS|  |STEP 2|     |CAITEST File|
  843. #HH,1,5,80,1,1,0
  844. #R10
  845.  ▄█▀▀▀▀▀█▄ .∙      One writes a CAITest File by merging templates into
  846. ▐█▐─ô═ô─▌█▌∙.        a master file and composing questions within the
  847.  └┤ /U\ ┌┘ .∙        template format, as in the next two chapters.  (It
  848.   │█▀▀▀█│            is not necessary to even renumber the first line of
  849.   └┬███┬┘            each template, but such is recommended, either by
  850. ▒▒▒▒ ■ ▒▒▒▒          manually changing the numbers or with the renumber
  851.                      utility.)
  852.  
  853.                    ~W~IThe next step is to test the new file, which is best
  854.                       done by running it from DOS.~Y~I
  855. #HH,1,24,80,1,1,0
  856. #HF,1,25,80,25,176,1,0
  857. #WP,H
  858.  
  859.  
  860. %
  861. #EF
  862. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  863.        |NUMAID|     |TEMPLATES|    |STEPS|    |STEP 2|     |JUMP START|
  864. #HH,1,5,80,1,1,0
  865. #R10
  866.  ▄█▀▀▀▀▀█▄ .∙      ~W~ICAITeach~Y~I files are driven, or run by file ~W~I{TEACHTW.EXE~Y~I.
  867. ▐█▐─ô═ô─▌█▌∙.
  868.  └┤ /U\ ┌┘ .∙
  869.   │█▀▀▀█│          To test a new file enter: ~W~I{TEACHTW FILE.EXT Title~Y~I
  870.   └┬███┬┘
  871. ▒▒▒▒ ■ ▒▒▒▒           {TEACHTW ............  Driver or engine
  872.                       FILE ................  Name of CAITest file
  873.                       EXT (not optional)...  Extension of CAITest file
  874.                       Title................  Any 5 words up to 41 letters
  875.  
  876. #HH,1,24,80,1,1,0
  877. #HF,1,25,80,25,176,1,0
  878. #WP,H
  879.  
  880. #NC
  881. #BO,20,12,64,19,2,1,1,5,14,4
  882. When run the Title is displayed in a box
  883.  
  884. at the top of each screen.  Color,
  885.  
  886. and box type are fixed.
  887. #NC
  888.  
  889. %
  890. #EF
  891. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  892. #AP,0,7
  893. Suggest you to run the Renumbering Utility
  894.  
  895. first.  It is menu driven.  To run, enter,
  896.  
  897. at DOS, {RENUM,   Complete details are in the
  898.  
  899. Utility Chapter.
  900. #HH,1,24,80,1,1,0
  901. #HF,1,25,80,25,176,1,0
  902. #WP,H
  903.  
  904. %
  905. #EF
  906. #T15,1,Mechanics: Checking and Testing the CAITest File from DOS
  907.    |JUMP START|    |EXPERT|    |NUMAID|     |TEMPLATES|   |STEPS|  |STEP 2|
  908. #HH,1,5,80,1,1,0
  909. #R10
  910.  ▄█▀▀▀▀▀█▄ .∙      W h a t  n e x t . . . .
  911. ▐█▐─ô═ô─▌█▌∙.
  912.  └┤    ┘ .∙      Read the Help item ~M~IExpert~Y~I. You could be
  913.   │█▀▀▀█│            ready to start experimenting.
  914.   └┬███┬┘
  915. ▒▒▒▒  ▒▒▒▒        You do need to know where the mouse hot spots
  916.                      are in the templates (so you don't write over them)
  917.                      but that is shown on your ~W~IQuick Reference~Y~I
  918.                      and the model templates.  Besides, after a couple
  919.                      of goofs it may all fall in place.
  920.  
  921.     Chapter 3 further details the ~C~IStudy~Y~I and ~C~ITrue-False~Y~I templates.
  922. #HH,1,24,80,1,1,0
  923. #HF,1,25,80,25,176,1,0
  924. #WP,H
  925. #X
  926.  
  927.