home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / educ / twrite2.zip / INSTRUCT.ION < prev    next >
Text File  |  1990-09-02  |  34KB  |  930 lines

  1.  
  2.  
  3.  
  4.                             CREATING A TUTORIAL
  5.                             -------------------
  6.  
  7. This document explains how to use TutorialWriter to write tutorials. It
  8. covers most of TutorialWriter's features and uses a limited number of
  9. Commands to demonstrate them. The Commands which are used are only briefly
  10. explained.  For a fuller explanation, refer to the Commands Tutorial listed
  11. at the Main Menu.
  12.  
  13. Type TWRITER and select Quit on the first screen of the Demo to enter the
  14. Integrated Development Environment. Follow the steps outlined below and when
  15. you've finished you will have created a tutorial with Help, HyperText,
  16. Textscreens, a Menu, a Quiz, a Test and more.
  17.  
  18.  
  19.                               The Story Board
  20.                               ---------------
  21.  
  22. Let's suppose you want to distribute copies of TutorialWriter to experts in
  23. various fields, so that they can write tutorials in their expertise areas.
  24. (TutorialWriter's major objective is to permit experts to write their own
  25. computer based tutorials without having to learn how to program a computer).
  26. These experts may not know much about writing training programs. Knowing a
  27. subject well does not always ensure the ability to teach it.
  28.  
  29. So one of the first requirements might be a tutorial on Instructional
  30. Technology to provide experts with the skills to produce effective training
  31. programs.
  32.  
  33. This fictitious tutorial will deal with three aspects of Instructional
  34. Technology - Determining the Course Content, Instructional Design and
  35. Display Standards.
  36.  
  37.  
  38.                             The Tutorial Format.
  39.                             -------------------
  40.  
  41. The tutorial will be a Multiple Chapter tutorial. It will start with a Menu
  42. Chapter, which will show the Company Logo and present a Menu.  The Menu
  43. will give access to four Subchapters. Chapter 1 will be an Introduction.
  44. Chapter 2 will deal with Determining the Course Content. Chapter 3 will be
  45. the Instructional Design chapter and Chapter 4 will explain Display
  46. Standards.
  47.  
  48. We'll start by choosing an overall PROJECT name for the tutorial. TWRITER
  49. automatically assigns different extensions to different file types, so the
  50. same name can be used for the Configuration, Help, Hypertext and Textscreen
  51. files. Since there will be more than one Chapter file, append a number to
  52. the project name.  The Project name for this tutorial will be MYTUT so the
  53. Chapters will be MYTUT0, MYTUT1, etc.
  54.  
  55.  
  56.  
  57.  
  58.                           Configuring the Tutorial
  59.                           ------------------------
  60.  
  61. When the tutorial is completed it will be displayed by TWTEACH. So the
  62. first step is to produce a Configuration file to tell TWTEACH which colors
  63. to use and what file to read first.
  64.  
  65. Select Configure Tutorial at the Main Menu. You will be asked for a file
  66. name. Type MYTUT
  67.  
  68. TWRITER will automatically create a file called MYTUT.CNF.
  69.  
  70. The Configuration Entry Screen will now be on screen. The first two fields
  71. set the Default Normal Colors for the tutorial and the next two set the
  72. Default Highlight Colors. With the cursor on any one of these fields, press
  73. F1 to see the color codes.  Set the Default Normal Text Color to Yellow by
  74. entering 14 in the first field.  Set the Default Normal Background to Blue
  75. by entering 1 in the second field.
  76.  
  77. Now set the Default Highlight Colors to White on Blue by entering 15 and 1
  78. in the next two fields.
  79.  
  80. For the Name of the Starting File enter MYTUT0. TWTEACH will look for a
  81. file called MYTUT0.CHP as the first file to read.
  82.  
  83. For the HELP, HYPERTEXT and SCREEN files, enter MYTUT. When these files are
  84. created ( a little bit later ) they will be called MYTUT.HLP, MYTUT.HYP AND
  85. MYTUT.SCR.
  86.  
  87. Move the cursor off the field you have just entered or the entry will not
  88. be recorded.  Now press F10 or Mouse Right Button to save the information
  89. to the file MYTUT.CNF.
  90.  
  91.  
  92.                        Creating the Menu Chapter
  93.                        -------------------------
  94.  
  95. Now it's time to create the Menu Chapter.  Choose Create/Edit Chapter at
  96. the Main Menu. You will be asked for a file name. Type MYTUT0. The Editor
  97. will automatically append the extension .CHP. You will be asked to confirm
  98. that this is a new file. Type Y and you will be in the Editor.
  99.  
  100. Press the F1 key. This brings up the Editor Help System which explains all
  101. Editing and TutorialWriter Commands.  Consult it if you need to check out a
  102. Command format or an Editor function.  Now press Esc to return to the
  103. Editor screen.
  104.  
  105. In the Menu Chapter we will clear the screen (#EF), put on a title (#T)
  106. and the title is HOW TO WRITE A TUTORIAL.  Then we will put on a Logo Box
  107. in Yellow on a Black background containing 5 lines of Text (#AL,5).  The
  108. five lines ( including blank lines ) immediately follow the Command.  Then
  109. we will hold the screen until a key is pressed (#WN).
  110.  
  111. Next we will call up a menu (#Mmytut) from the file MYTUT.MNU and finally
  112. mark the end of the Chapter (#X). Type in the following lines (shown between
  113. asterisks).  Make sure you follow the exact format and that the # sign is in
  114. the first column of a row.
  115.  
  116.  
  117.  
  118. *******************************************************
  119. #EF
  120. #THOW TO WRITE A TUTORIAL
  121. #AL,5
  122. MY COMPANY
  123.  
  124. presents
  125.  
  126. HOW TO WRITE A TUTORIAL
  127. #WN
  128. #MMYTUT
  129. #X
  130. *********************************************************
  131.  
  132. Now we'll change the color of HOW TO WRITE A TUTORIAL in the Logo Box. Put
  133. the cursor on the letter H and type ~W~I   This means change the color to
  134. Intense White. It should now look like this :
  135.  
  136. ~W~IHOW TO WRITE A TUTORIAL
  137.  
  138. Press F10 to save the file MYTUT0.CHP. Before we can see what these lines
  139. of code have achieved, we must create the Menu File MYTUT.MNU.  So now
  140. choose Create Menu at the Main Menu.
  141.  
  142. Again you will be asked for a file name. Type MYTUT. The Menu Utility will
  143. automatically assign the extension .MNU.
  144.  
  145. You will now see the Menu Entry Screen. As you move around the fields,
  146. press F1 for Help.  This time we will keep the default settings but you can
  147. change the look of the Menu by changing these values.
  148.  
  149.                                       ***************************
  150. In the Screen Title field enter       HOW TO WRITE A TUTORIAL
  151. In Menu title field enter             How to Write a Tutorial
  152. In the menu subtitle field enter      Main Menu
  153.                                       ***************************
  154.  
  155. Now we need four Chapter names and their associated filenames. The Chapter
  156. names will appear in the Menu.  The associated filename is the file that
  157. TWTEACH will read when that chapter is selected.
  158.  
  159. Enter these Chapters and Filenames:
  160.  
  161. ******************************************
  162. INTRODUCTION                     MYTUT1
  163. DETERMINING THE CONTENT          MYTUT2
  164. INSTRUCTIONAL DESIGN             MYTUT3
  165. DISPLAY SPECIFICATIONS           MYTUT4
  166. ******************************************
  167.  
  168. Move the cursor off the last entry ( or it will not be recorded ) and press
  169. F10 or the Mouse Right Button to save the information to the file MYTUT.MNU
  170. Now we can see what has been created.  Choose View Chapter at the Main
  171. Menu. When you are asked for a file name, press the ENTER key. All the
  172. CONFIGURATION files in the directory will be displayed.  Choose MYTUT and
  173. press the ENTER key.
  174.  
  175.  
  176.  
  177. When the tutorial runs it will present the Logo then the Menu you have
  178. created. If you choose a pick from the menu other than QUIT, you will get
  179. an error message because none of the Chapters has yet been created.
  180.  
  181.  
  182.  
  183.                            Creating Subchapter 1
  184.                            ---------------------
  185.  
  186. Select Create/Edit Chapter at the Main Menu, enter the filename MYTUT1 and
  187. confirm that it is a new file.
  188.  
  189. This is the INTRODUCTION  Subchapter, and it will have PageBack enabled. So
  190. start the Chapter with the % Marker to mark the start of the page. Then
  191. clear the screen (#EF) and put the title INTRODUCTION in a title box
  192. (#TINTRODUCTION ). Here's what you type :
  193.  
  194. ******************
  195. %
  196. #EF
  197. #TINTRODUCTION
  198. ******************
  199.  
  200. Now position the cursor at Column 2 on Row 5 (#C2,R5) and type in the text.
  201.  
  202. **************************************************************************
  203. #C2,R5
  204. This Tutorial will provide you, the Expert, with important information
  205.  
  206. on how to create Tutorials which conform to the high educational standards
  207.  
  208. set by MY COMPANY.
  209. #C2,R12
  210. It will provide a detailed explanation of the recommended methods to be used
  211.  
  212. to :
  213. ************************************************************************
  214.  
  215. Now set the cursor at Column 20 on Row 16, and make COURSE CONTENT a
  216. HyperText button by using the symbol | before and after it. Do the same for
  217. INSTRUCTIONAL DESIGN and DISPLAY SPECIFICATIONS.  Notice that the Column
  218. setting stays as previously defined, so only the Row Command (#R) is used.
  219. Then hold the screen with #WH, which activates the HELP System as well as
  220. automatically activating the HyperText.
  221.  
  222. ****************************************
  223. #C20,R16
  224. determine the |COURSE CONTENT|
  225. #R18
  226. meet |INSTRUCTIONAL DESIGN| standards
  227. #R20
  228. and conform to |DISPLAY SPECIFICATIONS|.
  229. #WH
  230. *****************************************
  231.  
  232.  
  233.  
  234. To make the text more interesting, let's highlight the words Tutorial,
  235. Tutorials and MY COMPANY. Move the cursor to the first letter and type ~H
  236. Now that the color has been set to Highlight, it will have to be reset or
  237. everything will be highlighted. Type ~N at the end of the word to change
  238. back to Normal.  The word should look like this: ~HTutorial~N  Do the same
  239. with Tutorials and MY COMPANY.
  240.  
  241. Now change the color of the word Expert to Intense Red. Put the cursor on
  242. the E and type ~R~I    Then, of course, you have to reset it with ~N   The
  243. word will look like this:   ~R~IExpert~N
  244.  
  245. The reason for adding the colors AFTER the text has been typed is to
  246. position it correctly on screen.  You will notice that after you insert the
  247. Inline Commands, the text is pushed off the screen.  When it is displayed
  248. with TWTEACH, the Commands are removed and the text will be positioned on
  249. screen as it was before the Commands were added.
  250.  
  251. Now for the next screen.  Since we are using PageBack, mark the top of
  252. the screen with % , then clear it and put on the title.  The title
  253. INTRODUCTION has already been declared, so there is no need to repeat it.
  254. The Command #T will automatically use the last declared title.
  255.  
  256. *****************
  257. %
  258. #EF
  259. #T
  260. *****************
  261.  
  262. We'll put a Remember Box on screen with centered text (#AR,1). We'll put in
  263. three lines of text (#AR,1,3) and the text follows immediately below the
  264. Command. The default colors used by the Remember Box are Intense White on
  265. Black. The color of MY COMPANY has been changed to Yellow (~Y~I) then
  266. reset to Intense White (~W~I). The same with STANDARD but this time the
  267. Background has been set to Red (~r) so it must be reset to Black at the end
  268. (~z).
  269.  
  270. Finally, the screen is held with the Command #WH,P which activates the HELP
  271. System and allows PageBack.
  272.  
  273. ************************************
  274. #AR,1,3
  275. In ~Y~IMY COMPANY~W~I
  276. a good Tutorial
  277. is a ~Y~I~rSTANDARD~W~I~z Tutorial.
  278. #WH,P
  279. ************************************
  280.  
  281. This time when a key is pressed, we do not want the screen to clear.
  282. Instead we want a Quick Question Box to appear over the screen. The Quick
  283. Question Box has three lines for the question (#QQ,B,3). The three text
  284. lines are placed immediately below the Command. The line below the third
  285. text line contains the Answer you want to present to the student after the
  286. question has been attempted. And the next line contains the matches. If
  287. TWTEACH finds any of these in the student's response, the question will
  288. have been answered correctly.
  289.  
  290.  
  291.  
  292. Hold the screen again with #WH,P and finally end the Chapter with #X.
  293.  
  294. ************************************************
  295. #QQ,B,3
  296. When a Tutorial is written to the standards
  297. desired by MY COMPANY, it meets the required
  298. DISPLAY  --------. What is the missing word?
  299. SPECIFICATIONS
  300. specification,ecifica,standard
  301. #WH,P
  302. #X
  303. ************************************************
  304.  
  305. Now press F10 to save the file to MYTUT1.CHP. Since we have created HyperText
  306. Buttons and activated the HELP System, these will have to be defined before we
  307. can view this chapter.  So select Utility Programs at the Main Menu.
  308.  
  309. Then select Help System at the Utility Menu. Enter MYTUT as the file name.
  310. TWRITER will add the extension .HLP. Now choose Add an Item from the HELP
  311. Menu.
  312.  
  313. The first field holds the word or phrase that will appear in the Help Menu
  314. when the Help System is activated.   In this field type
  315.  
  316. **************
  317. Using a Mouse
  318. **************
  319.  
  320. Move to the first field in the block and enter the text which will appear
  321. when Using a Mouse is selected.  The text will be automatically formatted
  322. to fit in a box wide enough to accommodate the longest line of text. Type
  323. in
  324.  
  325. ****************************************
  326. To use a Mouse, please load the Mouse
  327. Driver before running the Tutorial.
  328. ****************************************
  329.  
  330. Move the cursor off the last line of entered text, and press F10 or the
  331. Mouse Right Button. When asked if you want to add another, type Y
  332. Now type
  333.  
  334. ***************
  335. Using Hypertext
  336. ***************
  337.  
  338. in the first field and this text in the block
  339.  
  340. ***********************************************
  341. HyperText Buttons show up on the screen in
  342. Inverse Video (Black on Grey).  To activate
  343. them move the highlight (White on Red) to the
  344. Button using the SPACE BAR, Mouse or Arrow keys.
  345. Then press the ENTER key or Mouse Left Button.
  346. Press Esc or Mouse Button to remove message.
  347. ************************************************
  348.  
  349.  
  350. Move the cursor off the last line of entered text, and press F10 or the
  351. Mouse Right Button. When asked if you want to add another, type N. Select
  352. View at the Menu to preview how the Help System will look to the student.
  353. Select Return to exit the Help System Utility.
  354.  
  355. Select HyperText at the Utility Menu.  Enter MYTUT as the filename.
  356. TWRITER will add the extension .HYP. Now choose Add an Item from the HELP
  357. Menu.
  358.  
  359. This Utility is similar to the Help System Utility.  Enter
  360.  
  361. ***************
  362. COURSE CONTENT
  363. ***************
  364.  
  365. as the Button Word.  Note that this must be spelled identically to the word
  366. in the text, including the case used. Now type
  367.  
  368. **************************************************
  369. This is the educational material to be presented
  370. in the Tutorial.
  371.  
  372. It is determined by establishing Learning Goals
  373. then identifying the knowledge and information
  374. which a learner must have to be able to achieve
  375. these Goals.
  376. **************************************************
  377.  
  378. Move off the last line entered and press F10 or Mouse Right Button. Answer
  379. Y to Add Another and type the Button Word
  380.  
  381. ********************
  382. INSTRUCTIONAL DESIGN
  383. ********************
  384.  
  385. then the text
  386.  
  387. ************************************************
  388. These are the Learning Principles which lead to
  389. effective assimilation of the material by the
  390. student.
  391. *************************************************
  392.  
  393. Move off the last line entered and press F10 or Mouse Right Button. Answer
  394. Y to Add Another and type the Button Word
  395.  
  396. ***********************
  397. DISPLAY SPECIFICATIONS
  398. ***********************
  399.  
  400. then the text
  401.  
  402. ********************************************
  403. These ensure that all Tutorials distributed
  404. within MY COMPANY have similar interfaces
  405. and style. The students become familiar with
  406. the interface and do not have to relearn it
  407. for different Tutorials.
  408. ********************************************
  409.  
  410.  
  411.  
  412. Move off the last line entered and press F10 or Mouse Right Button. Answer
  413. N to Add Another.   Select View at the Menu to preview the HyperText as the
  414. student will see it.  Select Return to go back to the Utility Menu and then
  415. Quit to return to Main Menu.
  416.  
  417. Now you have created a Chapter with a Help System, HyperText and Paging
  418. Back. To try it out, select View Chapter at the Main Menu and choose MYTUT
  419. as the Configuration File.  When your menu is presented, select
  420. INTRODUCTION.  Be sure to try out all the features!!
  421.  
  422.                
  423.                            Creating Subchapter 2
  424.                            ---------------------
  425.  
  426. In this Chapter we will give some information then present a Quiz for the
  427. student to answer.
  428.  
  429. PageBack will be enabled and the Help System, which is global to the
  430. tutorial, will also be available.  Begin in the usual way by selecting
  431. Create/Edit Chapter. Enter MYTUT2 as the file name and confirm that it is
  432. a new Chapter. Then mark the page, clear the screen and put the title on.
  433.  
  434. *************************
  435. %
  436. #EF
  437. #TDETERMINING THE CONTENT
  438. *************************
  439.  
  440. Now we'll put the Huge Robot on screen with centered text (#AH,1). There
  441. will be six lines of text in the box so the full Command will be #AR,1,6
  442. As always, the text is immediately below the Command.  Then hold the screen
  443. with #WH which activates the Help System.
  444.  
  445. *********************************
  446. #AH,1,6
  447. DESIGNING A TUTORIAL STARTS WITH
  448. DEFINING LEARNING GOALS.
  449.  
  450. THEY DESCRIBE WHAT THE STUDENT
  451. WILL BE ABLE TO DO AFTER THE
  452. TUTORIAL HAS BEEN COMPLETED.
  453. #WH
  454. *********************************
  455.  
  456. Now the next screen.  Same again, really, but with five lines of text. The
  457. screen is held with #WH,P which enables PageBack.
  458.  
  459. **********************************
  460. %
  461. #EF
  462. #T
  463. #AH,1,5
  464. THE CONTENT OF A TUTORIAL IS THE
  465. KNOWLEDGE, SKILLS AND INFORMATION
  466. A STUDENT NEEDS TO HAVE IN ORDER
  467. TO PERFORM THE ACTIONS DESCRIBED
  468. IN THE LEARNING GOALS.
  469. #WH,P
  470. **********************************
  471.  
  472.  
  473.  
  474. The third screen will be a Quiz. It will be created by the Quiz Utility and
  475. stored in a file called MYTUT1 (just in case there will be more, the 1 has
  476. been added). The QuizTest Command #QT,Q,MYTUT1 says it is a Quiz (Q) and
  477. that tells TWTEACH that the file name MYTUT1 will have a .QIZ extension.
  478. #WH,P follows the Quiz Command to allow PageBack after the Quiz has been
  479. taken.  And, of course, the Chapter must end with #X.
  480.  
  481. **************
  482. %
  483. #EF
  484. #T
  485. #QT,Q,MYTUT1
  486. #WH,P
  487. #X
  488. *************
  489.  
  490. Save the file and select Utility Programs at the Main Menu. Now select Quiz
  491. at the Utility Menu and choose the Create option.
  492.  
  493. The Quiz Entry Screen will be presented. Press F1 on any entry field for an
  494. explanation of what should be entered. Type
  495.  
  496. ****************
  497. TUTORIAL WRITING
  498. *****************
  499.  
  500. as the Quiz Title. Then type
  501.  
  502. *******
  503. MYTUT1
  504. *******
  505.  
  506. as the file name and the file MYTUT1.QIZ will be created.
  507.  
  508. Text entered for the Quiz Question will be centered on screen according to
  509. the longest text line.  Type
  510.  
  511. ********************************
  512. Match the Questions and Answers.
  513. ********************************
  514.  
  515. Enter 4 as the Number of Questions and 3 as the Difficulty Level.  Press F1
  516. while on this field to see what Difficulty Level means. Now type in these
  517. Questions and Answers:
  518.  
  519. *************************************************************************
  520. What ensures standard Tutorials?        Using the Display Specifications
  521. How is Tutorial Content determined?     By analyzing Learning Goals
  522. What is the design starting point?      Determining Learning Goals
  523. What is the purpose of Tutorials?       To transfer knowledge and skills
  524. *************************************************************************
  525.  
  526. Move off the last entry line and press F10 to leave the Entry Screen. The
  527. next screen shows the Default Comments which will appear after the Quiz is
  528. taken.  Press F10 to accept these.
  529.  
  530.  
  531.  
  532. Select View and choose MYTUT1 to see how the Quiz will appear to the student.
  533. Then select Return to exit the Quiz Utility.  Select Quit at the Utility Menu
  534. to return to the Main Menu, and view this new Chapter by selecting View
  535. Chapter.  Choose MYTUT as the Configuration file and select DETERMINING THE
  536. CONTENT from your Menu.  Use PageBack after you have taken the Quiz and
  537. take it again. The Answers will be in a different order!
  538.  
  539.  
  540.  
  541.                            Creating Subchapter 3
  542.                            ---------------------
  543.  
  544. In this chapter we will create a Branching Test.  In a Branching Test, when
  545. the wrong answer is selected, the student is given remedial instruction and
  546. returned to the question to try again.
  547.  
  548. We will also use some highlighting tricks to make the text more interesting
  549. and introduce the pop-up window.
  550.  
  551. Start as usual by selecting Create/Edit Chapter, entering MYTUT3 as the
  552. file name and confirming that it is a new Chapter. Then mark the page,
  553. clear the screen and put the title on.  Now position the Cursor and type in
  554. the text.
  555.  
  556. **********************************************************************
  557. %
  558. #EF
  559. #TINSTRUCTIONAL DESIGN
  560. #C2,R5
  561. MY COMPANY believes that learning can be enhanced by the proper use of
  562.  
  563. Instructional Design techniques.
  564. *************************************************************************
  565.  
  566. Now use the Command #D1 to delay the printing for 1 second. Re-position the
  567. cursor and type in the text, but precede it by ~K.  This will make it print
  568. with a clicking sound. Cancel it by typing ~k at the end of the line. Notice
  569. that the #D1 Command cannot be used to space the lines. When TWTEACH reads a
  570. Command, it does not increase the row number. So leave an empty line to create
  571. the spacing. Then hold the screen with #WH, which activates the Help System.
  572.  
  573. *************************************************************************
  574. #D1
  575. #C2,R11
  576. ~KEach Tutorial should consist of one or more Topics.~k
  577.  
  578. #D1
  579. ~KEach Topic should have a Chapter to itself.~k
  580.  
  581. #D1
  582. ~KThe Topic should be sub-divided into Sections within the Chapter.~k
  583.  
  584. #D1
  585. ~KEach Section should consist of Instructional Material followed by a Quiz or
  586.  
  587. Test of the material presented.~k
  588.  
  589.  
  590.  
  591. #D1
  592. ~KThe student should be actively involved in the learning process through the
  593.  
  594. use of Questions.~k
  595. #WH
  596. ***************************************************************************
  597.  
  598. We'll drive the message home on the next screen by putting it into a
  599. Pointer Box.  First mark the page then clear the screen and put on the
  600. Title ( you don't have to supply the title - TWTEACH will use the one from
  601. the last screen ). Now call up the Pointer Box with centered text and three
  602. lines of text with the Command #AP,1,3. The text lines, including a blank
  603. line, follow immediately below the Command. Then hold the screen and enable
  604. the Help System and PageBack with #WH,P.
  605.  
  606. *************************************
  607. %
  608. #EF
  609. #T
  610. #AP,1,3
  611. ALWAYS KEEP THE STUDENT INVOLVED
  612.  
  613. BY ASKING RELEVANT QUESTIONS!
  614. #WH,P
  615. **************************************
  616.  
  617. Now we'll put a pop-up window on screen. This will appear on top of the
  618. Pointer Box, so we will not clear the screen.  Nor will we use a Page
  619. Marker. Since the pop-up window is used in conjunction with the previous
  620. screen, we do not want to PageBack to the pop-up window itself but to the
  621. previous screen. And it has already been marked.
  622.  
  623. The Command looks horrendous.  It is the most complicated Command in
  624. TutorialWriter, but if you break it into pieces, it is really quite simple.
  625.  
  626. #BO,  says This is an Overlay Box
  627. 50,4, says Start at Column 50 on Row 4
  628. 75,6, says End at Column 75 on Row 6
  629. 7,    says Use a double border with a dropped shadow
  630. 1,    says Center the Text ( 0 is leftjustify )
  631. 1,    says Explode on Screen ( 0 is appear fully drawn )
  632. 1,    says Read one line of Text
  633. 14,   says Use yellow for Text color
  634. 4     says Use red for Background color
  635.  
  636. And, of course, the line of text follows immediately below the Command.
  637.  
  638. This Command and all the others are explained in detail in the Commands
  639. Tutorial at the Main Menu.
  640.  
  641. Now hold the Screen and activate the Help System and PageBack with #WH,P
  642.  
  643. *****************************
  644. #BO,50,4,75,6,7,1,1,1,14,4
  645. THIS IS IMPORTANT
  646. #WH,P
  647. *****************************
  648.  
  649.  
  650.  
  651. Next we want to create a Branching Multiple Choice Test. This involves a
  652. number of Commands and Markers, but if we take it bit at a time, it will be
  653. simple.
  654.  
  655. The first step is to set up the screen with the Question we are asking. We
  656. start by marking the start of the Branching Test with @Q0. The @ marker
  657. must be in the first column of a row. The 0 identifies which Branching Test
  658. this is.  There can be up to 10 Branching Tests in any Chapter, identified
  659. with 0-9. Do not use a a Page Marker at the start of a Branching Test
  660. otherwise when you finish the test and PageBack, you will return to the
  661. test and be caught in a loop.
  662.  
  663. Clear the screen, put on the test title, position the Cursor and ask the
  664. Question.
  665.  
  666. **************************************************************************
  667. @Q0
  668. #EF
  669. #TTEST YOUR UNDERSTANDING
  670. #C2,R5
  671. How should the student be kept actively involved in the learning process?
  672. **************************************************************************
  673.  
  674. Now tell TWTEACH to set up a Branching Test Answer format (#QM,A) and that
  675. this is Question 0 with 4 Answers (#QM,A,0,4). Each answer is one line long
  676. and must follow immediately below the Command.
  677.  
  678. ***********************************************
  679. #QM,A,0,4
  680. By using pop-up windows
  681. By using fancy screen formatting
  682. By sending progress reports to the supervisor
  683. By asking relevant Questions
  684. ************************************************
  685.  
  686. That takes care of the Question and the Answer display. Now we have to
  687. prepare the screens which will be made active depending on the answer
  688. selected.  To mark an Answer screen, use the @ marker with the Answer
  689. number.  Here is the screen which will be displayed when Answer 1 is
  690. selected. @1 marks the start, then the screen is cleared and the title of
  691. the test is repeated.  Position the Cursor and type the message.
  692. This time use the #WH,N Command to hold the screen.  This activates the Help
  693. System and suppresses the QUIT option.
  694.  
  695. Finally, use the Loop Command #QM,L,0 to tell TWTEACH to return to the @Q0
  696. marker and start again from that point.
  697.  
  698. **************************************************************************
  699. @1
  700. #EF
  701. #T
  702. #C2,R10
  703. Pop-up windows can make the learning material more interesting, but there
  704.  
  705. is a surer way of maintaining involvement.  Try again.
  706. #WH,N
  707. #QM,L,0
  708. **************************************************************************
  709.  
  710.  
  711.  
  712. Answers 2 and 3 are handled the same way. Of course, an Answer can be as
  713. many screens long as you want. The screens will be presented one after the
  714. other until the Loop Command is encountered (#QM,L, )
  715.  
  716. **************************************************************************
  717. @2
  718. #EF
  719. #T
  720. #C2,R10
  721. Fancy formatting can make the learning material more interesting, but there
  722.  
  723. is a surer way of maintaining involvement.  Try again.
  724. #WH,N
  725. #QM,L,0
  726. @3
  727. #EF
  728. #T
  729. #C2,R10
  730. Do you really think that would work?  Think about it then try again. One
  731.  
  732. more wrong answer and it will go in my progress report to your supervisor.
  733. #WH,N
  734. #QM,L,0
  735. **************************************************************************
  736.  
  737. Now for the correct answer.  It is similar to the others but the student is
  738. given a little reward with #NE Command.  This plays a few random notes of
  739. 'Encouraging Music'. And the final Command is different. #QM,C,0 tells
  740. TWTEACH to continue the tutorial at the Marker @C0. The @ must be in the
  741. first column of a row and the 0 says that this is the continuation point
  742. for Branching Test @Q0. @Qn and @Cn must always be used as a pair ( like
  743. parentheses ) or TWTEACH will not perform correctly.
  744.  
  745. The answers can be in any order. The correct answer does not have to be the
  746. last answer. TWTEACH will ignore everything between the #QM,C,0 Command and
  747. the marker @C0.
  748.  
  749. *************************************************************
  750. @4
  751. #EF
  752. #T
  753. #C2,R10
  754. Yes, that's right!!  You have obviously been paying attention.
  755. #NE
  756. #WH,N
  757. #QM,C,0
  758. **************************************************************
  759.  
  760. Mark the continuation point then set up the final screen. The page marker
  761. is used on this screen in order to activate the last one. Two page markers
  762. have already been used, so TWTEACH has a count of 2. When PageBack is used,
  763. TWTEACH subtracts one from its total and jumps to that point. If we use
  764. PageBack here without marking this screen, TWTEACH will jump back to marker
  765. 1 which is the start of the Chapter.
  766.  
  767.  
  768.  
  769. We also have to redeclare the Chapter title because it was changed for the
  770. test. Use #WH,P to hold the screen and to allow PageBack. And finally, end
  771. the Chapter as always with #X.
  772.  
  773. ******************************************************
  774. @C0
  775. %
  776. #EF
  777. #TINSTRUCTIONAL DESIGN
  778. #C2,R10
  779. This is the end of Chapter 3 - Instructional Design
  780. #WH,P
  781. #X
  782. ******************************************************
  783.  
  784.  
  785. Press F10 to exit the Editor, select View Chapter at the Main Menu and
  786. choose MYTUT as the Configuration File.  When your menu is presented,
  787. select INSTRUCTIONAL DESIGN and try the test!!
  788.  
  789.  
  790.  
  791.                            Creating Subchapter 4
  792.                            ---------------------
  793.  
  794. In this final Chapter we will use the TWSNAP Utility to take a snap-shot of
  795. a screen, then we'll put HypertText Buttons on that screen.
  796.  
  797. The first step is to take the snap-shot. We'll use the Logo screen from the
  798. Menu Chapter of our tutorial as the screen to be snapped.  Here's how to do
  799. it.  Choose Quit at the Main Menu to exit from the TWRITER program.  Now
  800. type TWSNAP at the DOS prompt and TWSNAP will load into memory.
  801.  
  802. Next, call up the tutorial by typing TWTEACH MYTUT.  When the MYCOMPANY
  803. logo is on screen, hold down the Alt key and press S ( Alt-S activates
  804. TWSNAP ). TWSNAP will store the screen image in the current directory in a
  805. file called TWSNAP.000.  Move to the tutorial Menu and select QUIT to
  806. return to DOS. Now type TWSNAP and the program will remove itself from
  807. memory.
  808.  
  809. Type TWRITER and enter the Integrated Development Environment. Go to the
  810. Utilities Menu and choose TextScreen. Enter MYTUT as the Screen file name.
  811. (TWRITER will automatically add the extension .SCR). Choose Add a Screen,
  812. press F1 to bring up the name of the snap-shot file ( TWSNAP.000 ) and press
  813. ENTER to choose it.
  814.  
  815. Then give it the Identifier name MYLOGO. This is the name we will use in
  816. the Chapter to call up that screen. Move off the Identifier Name field and
  817. press F10 to save the file. Select View Screen to check it then return to
  818. the Main Menu.
  819.  
  820. Choose Create/Edit Chapter and enter MYTUT4 as the file name. Mark the
  821. page, clear the screen, put on the title and set the cursor. Then type in
  822. the text.
  823.  
  824.  
  825.  
  826. *************************************************************************
  827. %
  828. #EF
  829. #TDISPLAY SPECIFICATIONS
  830. #C2,R7
  831. Using standards in the creation of Tutorials is important.  No matter what
  832.  
  833. Tutorial is being taken, the student should feel familiar with the format
  834.  
  835. and presentation style.  There should be no need to learn how to deal with
  836.  
  837. a different interface each time a Tutorial is taken.
  838. #C2,R17
  839. Each Tutorial should start with the Company Logo and the colors and style
  840.  
  841. should be constant.
  842. #WN
  843. **************************************************************************
  844.  
  845. Highlight the words Tutorials and Tutorial by moving to the initial T and
  846. typing ~H. Remember to type ~N at the end of the word! ( ~HTutorial~N ).
  847. Now mark the next page and call the saved screen with #GT,mylogo.  Clear
  848. the bottom line of the saved screen ( #EL,25) and write the HyperText
  849. Buttons to the screen, positioning them with the Cursor Control Command.
  850. Hold the screen with #WH,P which allows PageBack and Help in addition to
  851. activating the HyperText Buttons. And finally, of course, end the Chapter
  852. with #X.
  853.  
  854. ********************
  855. %
  856. #GT,mylogo
  857. #EL,25
  858. #C2,R5
  859. |BACKGROUND COLOR|
  860. #C5,R12
  861. |BORDER COLOR|
  862. #C50,R12
  863. |TEXT|
  864. #WH,P
  865. #X
  866. ********************
  867.  
  868. Before we can test this Chapter, the HyperText information must be entered.
  869. Select Utility Menu then HyperText.  The HyperText file name is MYTUT. Add
  870. the three Buttons to the file.  Press F10 after each entry and re-choose
  871. the Add option.
  872.  
  873. ****************************
  874. BACKGROUND COLOR
  875.  
  876. The Logo is presented on
  877.  
  878. a Black Background.
  879. ****************************
  880.  
  881.  
  882.  
  883. ***********************
  884. BORDER COLOR
  885.  
  886. The Logo border should
  887.  
  888. be in Yellow.
  889. **********************
  890.  
  891. *********************
  892. TEXT
  893.  
  894. The Tutorial title should
  895.  
  896. be in White. 'MY COMPANY'
  897.  
  898. and 'presents' are in Yellow.
  899. *********************
  900.  
  901. Return to the Main Menu, select View Chapter and choose MYTUT as the
  902. Configuration file name.  Now you can test the full tutorial!!
  903.  
  904.  
  905.  
  906.                       Making the Distribution Diskette
  907.                       --------------------------------
  908.  
  909. The tutorial is now ready for distribution to your Experts. The
  910. distribution diskette will need the following files :
  911.  
  912. TWTEACH.EXE
  913. MYTUT.CNF
  914. MYTUT.HLP
  915. MYTUT.HYP
  916. MYTUT.SCR
  917. MYTUT.MNU
  918. MYTUT.QIZ
  919. MYTUT0.CHP
  920. MYTUT1.CHP
  921. MYTUT2.CHP
  922. MYTUT3.CHP
  923. MYTUT4.CHP
  924.  
  925. To run the tutorial, the end user types TWTEACH MYTUT. If you prefer, you
  926. can put this line in a batch file. Then the batch file can be given a more
  927. meaningful name, like GO.BAT or CBT.BAT.
  928.  
  929.  
  930.