--
Cheryl
"Where your treasure is, there will your heart be also."
---------- Forwarded message ----------
Date: Sun, 3 Dec 2006 11:27:45 -0600 (CST)
From: Cheryl Homiak <[EMAIL PROTECTED]>
To: [email protected]
Subject: Instructions for installing firefox with fire vox
I'm giving these directions in a slightly different order from those on the
website as I think it might be easier to do all your downloading first.
1. Go to http://www.firevox.clcworld.net and go to the installation guide link
and then the mac link.
2. do all your downloads:
A. firefox 2.
when you hit enter on the link for firefox in the installation guide, go down
to the link that says it's for Mac Osx (it will say it's 18MB). Just hitting
enter on that link should download the dmg file.
B. Java embedding plugin.
when you hit enter on this link in the installation guide, the first link on
the resulting page says Java embedding Plugin for Mac Os x. when you hit enter
on that, you are taken to a page with lots of links!!! I recommend using the
Link chooser menu and selecting the link that says "download Java embedding
Plugin". Be careful as there are several "download" links on that page but you
want this specific one. You'll be taken to another page where you should again
use the link chooser menu. Here there are two possible files you could
download; both start with "J" (Java) so use that in the link chooser menu. One
file, which claims to be the latest, is JavaEmbedding Plugin0.9.5.zip and this
is the one I used. However, there is another file on the page, with a later
date, JavaembeddingPlugin0.9.5+g.zip. I have an email into the maintainer to
see if this would be used instead. there is also a link for a nightly build
but I would assume this would be less stable. It may be that the +g file is
actually the latest "nightly" which was done back in July. I know for sure that
downloading the 0.9.5 file works; the adventurous may want to try the 0.9.5+g
file. Whichever file you choose, be sure to choose the link for the file that
actually has .zip on the end. this should download the zip file for you.
C. back in the installation guide for Mac, download the CLC-4-TTS Interface.
Hit enter on this link. We're going to use this link to do two downloads.
1. first you'll see a link back to the installation guide; ignore this. The
next link is actually for the firevox (note the v) suite bundle. You can go
ahead and download this, but to do so you need to do ctrl-numpad5 with
mousekeys enabled. this opens a menu and you want to download the linked file.
the resulting file should have a .xpi extension. trying to download by just
hitting enter will put you on a page in what appears to be a text file but it's
actually binary and saving it will result in a txt file which you don't want.
So be sure to use the menu accessed by ctrl-numpad5 instead.
when this has downloaded go back to the previous page which lists downloads;
you don't need to go all the way back to the installation guide.
2. the next link down from the link to the firevox file is actually the freetts
interface 9they really should have been in the opposite order on the web page
for clarity but as long as both are downloaded it doesn't matter). This will be
a .jar file and has the word installer in it. currently it is
clc4tts_freetts_installer1.2.jar. this will download just by hitting enter on
the link.
Download check
Make sure that you now have:
1. a firefox .dmg file.
2. a JavaEmbeddingPlugin .zip file.
3. An installer.jar file (a java archive).
4. A firefox add-on (extension) ending in .xpi.
Note that I'm not repeating the exact names here because they could change as
new releases are made available.
Installation
Installing firefox
the firefox installation is very straightforward. You open the .dmg file and
will click agree on the license agreement. You might then have to turn vo off
and on again to see the resulting window. select the firefox app (it's the only
selection) and copy it (cmf-c). go to /Applications (cmd-shift-a) and paste it.
Installing the Java embedding Plugin
Unzip the javaembeddingplugin zip file.
Here you have two choices:
terminal method
I recommend this method for those familiar with terminal use and Unix commands
because by doing this you can be sure that the timestamp of one of the files in
this plugin is the latest timestamp in the /Library/Internet Plugins directory
once you place it there. to do this, after unzipping the file, either use the
"su" command to become root or you will have to use "sudo in front of the
copying commands. Do the following:
cd JavaembeddingPlugin0.9.5/Binaries (including whatever path you need to get
there.
cp -R JavaEmbeddingPlugin.bundle /Library/Internet Plugins
cp -R MRJPlugin.plugin /Library/Internet Plugins
It's easiest to use completion to do this since these filenames have spaces.
remember that if you haven't used su to become root, you must use sudo in front
of the two cp commands and will probably be required to enter your password. It
is important to do the files in this order so that the MRJPlugin has the latest
timestamp of any in that Internet Plugins directory.
finder (copy and paste method)
for those who do not wish to use the terminal, do the following:
1. after unzipping the zip file, open the result (should be the same as the zip
file but without the .zip).
2. Open the binaries item.
3. Copy both files.
4. go to /Library/Internet Plugins and paste the files.
You might have problems with this if you don't have administrative permissions;
I'm not sure since I didn't do it this way.
4. If the timestamp on the MRJPlugin.plugin is not the latest in the
/Library/Internet Plugins directory, or if you are unsure, do the following
from terminal:
touch /Library/Internet Plugins/MRJPlugin.plugin
If you get a "permission denied" you are going to have to become root with su or
use sudo at the front of the command and enter a root password.
Note: if you use completion for the filename in theis command, you don't have
to put quotes around the filename though it is shown that way int the
Readme.txt that comes with the plugin.
The installer.jar file
1. Preparation: you will have to change the permissions of
/system/Library/Frameworks/JavaVM.fframework in order to use the installer.jar.
there may be another way to do this but using the terminal is the only way i
know. You will have to be able to use sudo or su to do this as root.
chmod -R 777 /System/Library/JavaVM.framework
If you haven't used su to become root, put sudo in front of this command and be
prepared to enter your password.
I believe you can later return these permissions to their normal state by
running "repair disk permissions" in disk utility.
2. After the permissions change, you can open the Installer.jar file and follow
the instructions.
innstalling the .xpi
this can be a little tricky since we won't be able to read much in the firefox
window with vo. the following seems to work best:
1. Open firefox.
2. Do ctrl-option-m to get into the menus and go over to files. If you can't
find the Files menu or if it is dimmed, try hitting enter in the window with
the menu closed. You may be in an initial "welcome to firefox" window and
hitting enter should get you out of this and into the startup page which I
believe is the firefox website. You can also tell where you are by doing
ctrl-option-f2 which will announce the window title.
3. If you've gotten into the Files menu, select open. You'll get the usual open
dialog.
4. Choose the location of your .xpi file using the popup; I think documents may
be the default but mine was in my home directory.
5. instead of trying to browse to find the file, type .xpi (note the period in
front) in the search filed and hit enter. then in the browser or outline you
should only have one file, so interacting with the outline or browser and then
stopping interacting should choose the file and you can click open.
6. when you open the file, you probably will hear voiceover say something about
"installation: two items". simply hit enter and this should install the .xpi.
You will probably then hear voiceover say "addons" because you are in the
addons window, having just installed the .xpi as an addon. again, you can use
ctrl-option-f2 to check the window you are in. You should then be able to quit
firefox.
6. Open firefox, quit firefox, and open it again. there may be a few seconds
gap between the voiceover announcement "firefox" and the beginning of speech
from Firevox.
tutorials
On the firevox webpage there are tutorials and I recommend working through
them.
Notes
1 remember that you can't use vokeys to navigate in firefox. You can use the
firevox key combinations, tabs and arrows but not vokeys. However, you can use
vokeys to navigate the menus but not to navigate or perform tasks once you
select a menu item.
2. If you have visiovoice turned on you may have some key conflicts. the
easiest way to fix this is just to quit visiovoice when using firefox. You can
change key assignments as you will read in the tutorial. I haven't tried to do
this yet.
3. This whole installation looks really complicated the first time you do it.
If you have to do more than one computer, though, it rapidly becomes much
easier after the first time.
--
Cheryl
"Where your treasure is, there will your heart be also."
