HOW TO USE THE SUPER DUPER PHRASE TUTORER ============================================= The idea of the super-duper phrase tutorer is to help you to improve your comprehension of a foreign language by playing the sounds of phrases and allowing you to view a translation of them into your language as well as the untranslated text of the phrase. To use the program you type a command (such as the letter 'w' plus the [enter] key]) in the top 'text box' (which has 'Enter a command' written above it) and the program responds by doing something (playing a phrase, or translating a phrase etc). In the 'message box' which is the large text box on the web page, the program normally tells you what command it has just executed. A QUICK EXAMPLE OF USING THE PROGRAM ------------------------------------ When the web page loads you will see a message in the larger text box saying how many phrases are available. Step 1. In the smaller text box (which has 'Enter a Command' written above it) type the letter 'w' and then press the [enter] key. Dont type any spaces or tabs and use lower case, please. You should hear the sound of a randomly selected (or sequential) phrase being spoken. If not please see the 'Questions' section below. Step 2. In the smaller text box (I'll call it the 'command-box' from now on) type 'a' and press the [enter] key. You should hear the same phrase being spoken again. Step 3. In the command-box type 'v' and press the [enter] key. In the larger text box (I'll call it the 'message-box' from now on) you should see the text of the phrase that was just played. The text is in the original language. It is not translated. Step 4. In the command-box type 'x' and press the [enter] key. In the message box you will see (hopefully) the translation of the phrase. This translation is normally generated by some automatic engine (usually google language tools or babelfish). Step 5. In the command-box type 'w' and press the [enter] key. A new randomly selected (or sequential) phrase is spoken. Step 6. You can continue entering commands (letters plus the [enter] key) into the command box in any order that you like. SOME QUESTIONS: --------------- WHAT IS A COMMAND (IN THE CONTEXT OF THIS PROGRAM)? A command is just a letter or word which you type into the 'command box' (the small text box) plus the [enter] key and which makes the program do something. I TYPED A COMMAND AND NOTHING HAPPENED? WHATS GOING ON? Make sure that the cursor was in the 'command box' which is the smaller text box which has something like 'enter a command' written above it Make sure that you pressed the [enter] key after typeing the letter in the command box. Make sure that you didn't type any spaces or tabs before or after the command (ED: This should be fixed). Make sure that you didn't use capital letters for the command. The command should be lower case. I TYPED A COMMAND AND NOTHING HAPPENED EXCEPT THAT I SAW A MESSAGE SAYING 'SORRY THE PROGRAM DOESNT UNDERSTAND THAT COMMAND' Make sure that you didn't type any spaces or tabs before or after the command (ED: This should be fixed). Make sure that you didn't use capital letters for the command. The command should be lower case. Make sure that the command that you typed in the command box was a 'valid' command for the program. You can see what are the valid commands by typing ? and [enter] into the command box. The message-box will then display a list of the valid commands I TYPED THE COMMAND 'w' AND I SAW THE MESSAGE '2 [Command: w] MAY BE SHORT DELAY' BUT I DIDNT HEAR ANY SOUND. WHY? This question could have a number of answers. In order to hear the sound you need all of the following things: 1. To hear the sound you need a 'sound-card', To check if you have a sound-card look at the back of your computer and see if there are 3 small round holes in a row, often with coloured rings. If not buy a sound-card and have it installed into your computer. If you dont want to do that you could investigate programs that play sound files through the dodgy built-in speaker and please tell me the results of your experiments. But you probably won't be able to use this web-based program. On a Microsoft Windows computer, if you have a sound card correctly installed you will usually see a small yellow speaker icon in the lower right hand corner of the screen. 2. you need speakers connected to that sound-card (or a set of headphones). Obtain speakers or headphones and plug them into the small round hole which says 'line out' or which has a little picture of headphones next to it or something like that. 3. You need the volume on the speakers to be turned up sufficiently. There should be a knob on your speakers. Twist it. You also may need to change the volume using a piece of software. On Microsoft Windows PCs this software can sometimes be found using the menus start-->programs-->entertainment-->volume-control also you may be able to see the software by double-clicking on the small yellow speaker icon which is usually in the bottom right hand corner of the screen. On computers running Linux you may be able to find the answer to the question of how to adjust your speaker volume by consulting the 'Linux Cookbook' which is available at www.dsl.org 4. You need the correct plugin or activeX object to be installed in your browser. For the netscape browser version 4.61 you need the 'LiveAudio' plugin that allows the browser to play 'wav' format audio files. If you need the LiveAudio plugin search on the internet for 'npaudio.dll' and then copy it into the netscape 'plugin' directory. The LiveAudio file is also available at http://www.geocities.com/matth3wbishop/projects/npaudio.class The file name extension is '.class' instead of '.dll' because the Yahoo Geocities web-site system will not allow file name extensions of '.dll'. If you want to use this file you will have to rename it to 'npaudio.dll' before or after you copy it to the netscape 'plugins' directory. With the Netscape Browser you should be able to find out what the plug-in directory is by choosing from the menus Help --> About Plug-ins You will then see a list of plug-ins that are currently installed and the directory in which they are installed. The 'LiveAudio' plug-in is an old plug-in and does not appear to be available from the Netscape web-site. From some preliminary testing the LiveAudio plug-in does not appear to work with later versions of the Netscape Navigator Browser. The Real Audio plug-in may work with more modern browsers and in addition is able to play .mp3 format files. Also, it is possible to script this plug-in using Javascript according to information found at www.cookwood.com. However this program, is not able to use the Real Audio plug-in currently <2003> For the Internet Explorer browser you need (I think) an 'ActiveX object', but Internet Explorer should automatically install this if it is not already. In other words for Internet Explorer this shouldn't be a problem. There are probably other reasons which I have not mentioned why the sound file will not play. The Audio tutoring program has only been tested successfully on Microsoft Windows PCs running IE 4,5,6 and Netscape 4.61. On computers running an 'Apple' operating system, the Javascript for the program does not seem to work. WHAT IS A 'LESSON' IN THE CONTEXT OF THIS PROGRAM? A lesson is just a set of phrases (usually about 50). The program only plays the phrases that are in the current lesson. This is because it is probably easier to try and learn a small number of phrases at once in order to give your-self a sense of progress and achievement. WHAT ARE THE 'LESSON' LINKS AT THE RIGHT HAND SIDE OF THE WEB-PAGE FOR? These links are to allow you to load a new set of (usually 50) phrases into the program. The program will only play the phrases in the current 'lesson'. This allows you to just practice a manageable number of phrases at once. HOW TO I LOAD A NEW LESSON (GO TO A NEW LESSON)? Click on one of the links on the right-hand side of the vocab-tutor web page which says something like 'lesson n' where n is some number. WHEN I FIRST LOAD THE VOCAB TUTOR WHAT LESSON AM I IN? You are in the 'all lessons' or 'all phrases' lesson which means that all available phrases are loaded and will be played by the program. WHATS THE WIDE BUT THIN TEXT BOX NEAR THE BOTTOM OF THE PAGE THAT SEEMS TO CONTAIN A LIST OF URLS? WHATS IT FOR? Really you dont need to worry about this box. It just contains the urls that the program uses to play ('speak') the phrases. If you feeling adventurous you can cut and paste your own urls of sound files in the and then type 'load' in the command box. The program will then use your sound urls instead of its normal ones. But you normally wouldn't need to do this. I NOTICE THAT AFTER I TYPE 'w' PLUS [ENTER] THERE IS A DELAY BEFORE THE PHRASE IS 'SPOKEN'. WHY IS THIS? This is because the sound file of the phrase has to be downloaded from the internet before it can be played. That is why the first time that you play a phrase there will be a delay but the next time that that same phrase plays it should play instantaneously. YOU SEEM TO BE USING SOUND FILES THAT WERE CREATED BY OTHER PEOPLE AND ARE STORED ON OTHER PEOPLES SERVERS. ISNT THIS A LITTLE BIT RUDE NOT TO SAY WRONG? Yes in a sense it is wrong, but since this is a non-commercial and education project I feel reasonably justified. WHAT TYPES OF SYSTEMS HAS THIS WEB PAGE BEEN TESTED ON? Microsoft Windows PCs (Win 2000) with the browsers Microsoft Internet Explorer 4.7, 5, 6 Nescape Navigator 4.61 Apple Macintosh (OSX) Browser ? The sound files are not playing, and the javascript is not working as it should. For example when messages are displayed after a command the iWordCounter variable is undefined and printed out as NaN. Also the sCurrentWord variable is undefined Linux Completely untested Other Unixes Completely untested WHY DID YOU USE JAVASCRIPT TO DEVELOPE THIS INSTEAD OF A "PROPER" LANGUAGE? I wanted to create a program that could be used from an Internet Cafe, where in many cases (especially in Europe) the user is unable to download and run an application. The other alternative was to use a Java applet. However, if this program was written in Java it would only be able to access sound files that were on the same server as the applet (without server-side logic which I dont have access to). Javascript allows me to access the sound files in their original internet location. SUGGESTED WAYS TO USE THE PHRASE TUTOR ========================================= Use the w command to play the next random (or sequential) word. Listen carefully to the word and repeat the sound to yourself as faithfully as you can. Try to imagine how the word is spelt even if you dont know what it means. Use the a command to play the word as many times as you wish. With some languages it is easier to know how the word is spelt than others. For example, Spanish is generally considered easier to understand phonetically than French. Once you have had a guess at how the word is spelt, use the v command to view the text of the word and see how accurate you were. By looking at the spelling of the word you may be able to work out what the word means. Finally use the x command to translate the word into your own language (at the moment, only english) DEFINITIONS =============== Sequential Mode The super duper phrase tutor can be put into a playing mode (which I call 'sequential mode') in which each available phrase sound is played one after the other, so that no phrase will be repeated. This is useful if you want to test that you understand every phrase in a given "lesson". Random Mode This playing mode is where the phrase sound played is chosen randomly from the currently available selection of phrases, in other words all those phrase sounds in the current "lesson". In this mode a phrase sound may be repeated. This mode is useful when you are first learning the phrases; by playing the phrases in a random order you are unable to memorise the order of phrases and therefor "think" that you know what a phrase means but really just remember the translation "by heart". OTHER NOTES AND COMMENTS ======================== At the url http://www.geocities.com/matth3wbishop/spanish/vocab-sp.txt http://www.geocities.com/matth3wbishop/spanish/vocab-fr.txt there is also a vocab tutor which is written as a script designed to be run in a unix shell. The user interface is approximately the same the web version. However at the moment the script uses some programs which are not standard in the unix shell, such as a file called wav.exe which is the program which actually plays the sound file. This is actually a windows program. (This is because I developed the program in a 'cygwin' shell on a windows pc). It should not be difficult to adapt the program to run in a 'standard' unix shell, but I havent done this yet. IDEAS FOR FUTURE DEVELOPEMENT OF THIS PROGRAM (WEB PAGE) Testing on various platforms. May have to use flash to get it to work on Apple. Better translations of phrases.