home *** CD-ROM | disk | FTP | other *** search
/ Kids Cube / 4_History.iso / kanasens / ks.doc < prev    next >
Text File  |  1991-11-10  |  13KB  |  268 lines
  1.                               KANA SENSEI
  2.                          ("Syllabary Teacher")
  3.  
  4.  
  5.                            PROGRAM INFORMATION
  6.  
  7.  
  8.      Kana Sensei (KS) is a computer program which was designed and developed
  9. as an aid for learning Japanese.  It is useful for all students of Japanese.
  10. Beginning students can quiz themselves on the hiragana and katakana "alphabet"
  11. symbols while intermediate and advanced students can quiz themselves on
  12. Japanese vocabulary and Japanese grammar.  I have also been told by a nihon-
  13. jin (Japanese person) that this program would also be useful for Japanese
  14. students who are learning English.
  15.      As far as I have been able to determine, nothing like Kana Sensei exists.
  16. General quiz programs can be used for quizzing from english to romaji or vice
  17. versa but this does not aid in retention of the kana symbols.  Kana Sensei
  18. utilizes katakana and hiragana fonts in addition to the romaji and english,
  19. hence, providing further reinforcement of the kana, romaji, and english.  I
  20. am currently in the process of adding kanji so that the Japanese writing
  21. system will be completely contained.  If you register the use of this program,
  22. you will receive information concerning my progress in this regard.
  23. Note: If you are unfamiliar with the words "hiragana," "katakana," or "kanji"
  24. the menu option "What is Kana?" will display a short essay describing the
  25. Japanese writing system (see directions below).
  26.      Kana Sensei should run on any IBM PC compatible system.  Minimum system
  27. memory requirements haven't been totally determined but 512K should be plenty.
  28. Kana quizzes must be executed on EGA or VGA compatible systems for proper
  29. performance but all other functions should run properly on any PC system.
  30. Users of monochrome systems (with graphics) will probably want to experiment
  31. with the color configuration (see below) for the best display.
  32.  
  33.  
  34.                                DIRECTIONS
  35.  
  36.      To execute Kana Sensei simply type "ks" at the system prompt:
  37.      A>ks (for example)
  38.      Note, however, that the current disk must be contain Kana Sensei and
  39. its files.  For example, if Kana Sensei were on disk A and the current system
  40. drive was disk C then typing ks at the C> prompt would not
  41. work.  Instead one should change to the proper drive first, for example:
  42.      C>A:
  43.      A>ks
  44.      Following this step, KS will begin execution and a title screen (in
  45. hiragana) will come up on the display.  If the animation mode is on, it can be
  46. short-circuited by pressing ESC.  After the title screen is fully displayed,
  47. simply press any key.  A message concerning shareware and program registration
  48. will be displayed, if the file containing this message is missing or altered
  49. then program execution will be aborted.  Use the cursor and page-up/page-down
  50. keys to move within this file.  Pressing ESC will take you to the main menu.
  51.  
  52.  
  53.                             THE MAIN MENU
  54.  
  55.      The main menu displays a list of 6 choices which looks something like
  56.      this:
  57.  
  58.                            Program Information
  59.  
  60.                            What Is Kana?
  61.  
  62.                            Quiz on Kana
  63.  
  64.                            Create/Edit Kana Quiz
  65.  
  66.                            Set Configuration/Options
  67.  
  68.                            Exit
  69.  
  70.      To select one of these choices (detailed below) move the bar cursor with
  71. the cursor keys until the option selected is highlighted, then press ENTER.
  72. As the cursor is moved, a help line is displayed at the bottom of the screen
  73. which gives a one sentence summary of the highlighted option.  An alternative
  74. method for selecting a menu choice is to press the first (highlighted) letter
  75. of the option that is to be selected.
  76.  
  77. Menu Option 1 -- Program Information
  78.  
  79.      This option displays this document.  Simply use the cursor keys or the
  80. page-up and page-down keys to move within this file.  When done, just press
  81. ESC to return to the main menu.
  82.  
  83. Menu Option 2 -- What is Kana?
  84.  
  85.      This option displays a document I have created which tells a little bit
  86. about the history of the Japanese writing system (kanji, hiragana and
  87. katakana).  In addition, it gives simple pronunciation guidelines for Japanese
  88. phonemes.  As in Option 1, use the cursor and paging keys to move within the
  89. file and press ESC to exit.
  90.  
  91. Menu Option 3 -- Quiz on Kana
  92.  
  93. Note: this program option will only execute properly on VGA or EGA systems.
  94.  
  95.      Select this option to execute a quiz.  The quiz files that are found in
  96. the current directory are displayed alphabetically.  Each file is numbered and
  97. the quiz title for each may be displayed (depending on the setting of the
  98. display option below).  Use the cursor keys and/or page keys to scroll through
  99. the entries then enter the number of the file that you wish to execute (or
  100. press ESC to return to the main menu).  After selecting a quiz, KS will load
  101. the quiz and display the quiz screen.
  102.      The Quiz Mode setting, displayed near the top of the screen, determines
  103. how the quiz is executed.  There are four quiz modes from which to choose:
  104.                       1) Kana to Romaji;
  105.                       2) Kana to English;
  106.                       3) Kana to Both Romaji and English;
  107.                       4) English to Romaji.
  108.      In quiz modes 1, 2, & 3, the kana is displayed and the user is asked to
  109. enter either the romaji equivalent, english translation, or both.  In quiz
  110. mode 4, the english is displayed and the user must enter the Japanese
  111. translation in romaji.  I usually write the kanji (or kana) on a piece of
  112. scrap paper.  Of course, KS can't check my kana so I deliberately enter the
  113. wrong romaji answer if I have any doubts about the accuracy of my characters.
  114. For example, if KS displayed "university," one may know the appropriate
  115. romaji is is "daigaku" but may not remember how to correctly write the
  116. kanji (or hiragana).
  117.      In all modes, after the student's answer is entered, KS displays the
  118. correct answer(s).  The student's score and total number of quiz entries are
  119. also displayed at the top of the screen.
  120.      To change the quiz mode while within a quiz, press F1.  Note, however,
  121. that changing the quiz mode while within a quiz may affect KS's scorekeeping.
  122. The default quiz mode (the mode that KS is initially set to) may also be changed
  123. (see option 5 below).  After a quiz is completed, the option of repeating
  124. missed questions is given.  The entire quiz may also be repeated.  To exit out
  125. of the quiz before completion, just press ESC.
  126.  
  127. Menu Option 4 -- Create/Edit Kana Quiz
  128.  
  129.      Select this option to create or edit Kana Sensei quizzes.  A quiz
  130. directory will appear as in Option 3.  To edit a quiz, enter its directory
  131. number;  to create a new quiz enter 0.  If you are creating a new quiz, you
  132. will be prompted for a new quiz name which should be entered without a file
  133. extension.  If a quiz with the entered name already exists, then you will have
  134. the option of aborting or overwriting the old quiz.  In addition, the option
  135. of saving the old quiz as a backup file (with a .kbk extension) will be given.
  136. To restore a backup quiz, just rename it from DOS (consult your DOS manual on
  137. the rename command, if necessary).
  138.  
  139.      Each entry for a quiz consists of three items:
  140.  
  141.                          1) Kana Sensei Romaji String;
  142.                          2) Romaji String;
  143.                          3) Translation String.
  144.  
  145.      1) The KS Romaji String is a line of text which instructs Kana
  146. Sensei how to display an entry using the Japanese fonts.  This string is
  147. normally regular (Hepburn-style) romaji with a few exceptions for the
  148. following ambiguous cases:
  149.            n=n'    ; Example: onna        --> on'na         (female)
  150.            o=o'    ; Example: mizu o nomu --> mizu o' nomu  (I drink water)
  151.           zu=tzu   ; (this phoneme is rarely used)
  152.           ji=tji   ; (this one is rare, too)
  153.     If n is used instead of n' in a non-ambiguous manner, KS usually figures
  154.     it out.  (For example, the word "hana" is ambiguous but "ondan" is not).
  155.  
  156. To change fonts enter :K: (for katakana) or :H: (for hiragana).  The
  157. default font is hiragana, hence, if the entry consists entirely of hiragana
  158. neither :K: or :H: should be inserted.  The special cases are displayed on
  159. the entry screen for easy reference.
  160.      Some examples of correct KS Romaji Strings are:
  161.      han'a      --  prints the hiragana characters for "flower"
  162.      gakkou     --  prints out the hiragana characters for "student"
  163.      :K:naifu   --  prints out the katakana characters for "knife"
  164.      kuruma     --  prints out the hiragana characters for "car"
  165.  
  166.      2) The Romaji String is simply the normal romaji representation(s) of the
  167. KS Romaji String.  If there is more than one correct possibility, separate
  168. them with one of these symbols: | ; : \ or /.  The correct Romaji Strings for
  169. the above examples would be:
  170.      hana
  171.      gakkoo|gakkou
  172.      naifu|naihu
  173.      kuruma
  174.  
  175.      3) The Translation String is the translated representation(s) of the
  176. Japanese word or phrase.  As above, more than one correct answer may be
  177. entered.  The following translation strings would be appropriate for the
  178. above examples:
  179.      flower;flowers
  180.      student
  181.      knife
  182.      car|automobile|vehicle
  183.  
  184.      The function keys for editing are displayed on the screen.  Using these,
  185. one can change a quiz title, change a quiz name, edit or add or delete quiz
  186. entries, and save the completed quiz.
  187.      When first creating your own quizzes, you may want to look at the quizzes
  188. that were included with Kana Sensei for reference on proper quiz syntax.  The
  189. quiz files (.ksq files) can easily be printed through a word processor or
  190. directly from DOS.  The command "COPY filename.KSQ PRN" should print out the
  191. quiz file on most systems.
  192.      Since Kana Sensei quiz files are simple text files, they may also be
  193. created with a word processor.  If created this way, they should be created in
  194. the following form:
  195.  
  196.      line 1: Quiz Title
  197.      line 2: Kana Sensei Romaji String for Entry #1
  198.      line 3: Romaji String(s) for Entry #1
  199.      line 4: English Translation(s) for Entry #1
  200.        .
  201.      <repeat lines 2-4 for all quiz entries>
  202.        .
  203.      line n: Last line contains string "***"
  204.  
  205. No lines from 2 to n should be left blank.
  206. Note that the quiz file must be saved with the file extension ".ksq" for Kana
  207. Sensei to recognize it as a quiz.
  208.  
  209. Menu Option 5 -- Set Configuration/Options
  210.  
  211.      This option allows users to customize Kana Sensei options for one's own
  212. taste and requirements.  The following options may be changed:
  213.  
  214.      Automatic Video Selection - if off, the user is prompted to specify the
  215.                                  video mode that is used when first running KS.
  216.      Fast Title                - if on, the beginning title screen is not
  217.                                  animated
  218.      Display File Titles       - if on, the title for each quiz will be
  219.                                  displayed when selecting a quiz to execute
  220.                                  or edit;  when off, the display is less
  221.                                  informative but quicker on slower systems
  222.      Omit Spaces               - if on, spaces will be omitted when displaying
  223.                                  the Japanese screen fonts.
  224.      Sound                     - if on, a "beep" will sound when a wrong
  225.                                  answer is entered.
  226.      Background Color          - These last options allow the user to
  227.      Text Color                  change the default colors
  228.      Frame Color
  229.      Font Color
  230.      Highlight Color
  231.      Cursor Color
  232.  
  233.      If one wishes to save the option settings, just press F1.  To revert to 
  234. the default values, press 0; to revert to the last saved values, press 1.  
  235. (These commands are displayed on a menu bar at the bottom of the window).
  236.  
  237.  
  238. Menu Option 6 -- Exit
  239.      
  240.      Select this option to exit Kana Sensei and return to DOS.
  241.  
  242.  
  243.                           DESCRIPTION OF FILES
  244.  
  245.      The Kana Sensei disk contains several files as elaborated below:
  246.  
  247.      KS.EXE        -  Kana Sensei executable program
  248.      KS.DOC        -  Kana Sensei Program Information (this text)
  249.      KS_SHARE.DOC  -  Text File Containing Shareware/Registration Info
  250.      KSHIST.DOC    -  Text File Containing the History of Kana
  251.      KS.CFG        -  KS Configuration Information (need not be present)
  252.       *.@          -  All files with a .@ extension are font files
  253.       *.KSQ        -  All files with a .ksq extension are KS Quiz Files 
  254.       *.KBK        -  Files with .kbk extensions are backup quiz files and
  255.                       may be restored by using the DOS rename commmand
  256.                       (example:  A>ren quiz1.kbk quiz1.ksq)
  257.  
  258.      NOTE:  KS.DOC, KSHIST.DOC, and KS_SHARE.DOC can be printed out from
  259.             DOS by typing the command "COPY filename PRN" at the DOS prompt
  260.  
  261.  
  262.      Comments, suggestions or 
  263.      problems may be sent to:                Mike Chachich (KS)
  264.                                              P.O. Box 290-232
  265.                                              Waterford, MI     48329
  266.  
  267. <EOF>
  268.