Okay, couldn't get dropbox to give me a link, so I'll paste the ORG file below.
* Getting Emacspeak working on Linux
This tutorial will be about getting set up with Emacs, and Emacspeak,
on Linux systems. I encourage readers to share this tutorial
with any one, in any medium. The source file, a document in
the [[http://orgmode.org][Org mode]] markup style, is available on request, for
learning to use Org mode, or editing within Emacs.
** Downloading Emacs
In most distributions, Emacs comes pre installed. To check, press
alt+f2, type emacs, press enter. If an error occurs, or
nothing happened, you don’t have Emacs. If an Emacs window
pops up, press control+X, then control+C, and you’ll exit it,
knowing that you do have Emacs. This means that you
already have Emacs installed, and you can skip the next step
of installing Emacs. if you don’t have Emacs, look in your
package manager. In Ubuntu or Debian, do
sudo apt-get install emacs
and see what happens. In Fedora, do
sudo dnf install emacs
In Arch Linux, do
sudo pacman -S emacs
Note the capital S in the pacman command. After that, follow the
onscreen prompts to install Emacs, if it is not already
installed.
Now, we can get Emacspeak, which can be done in several ways. First,
you can try getting it from the package manager, but that
lends itself to one big problem, that package managers rarely
tell you where they place the installed files. Sure, you know
they’re installed, but you need to configure Emacs to work
with Emacspeak, and to do that, you must know where Emacspeak
is put. If your manager tells you, or you can figure it out,
it is safe to install from a package manager. If you don’t
feel so safe doing that, then we’ll go with the simpler route,
getting the package from the web site.
** Downloading Emacs
So, go to the Emacspeak web site, which is at
[[http://www.emacspeak.sourceforge.net][source forge]]
Now, head on over to the downloads section, get the latest release,
wait for it to download. While you wait, explore the Emacspeak
web site, to get your excitement up.
When you have the Emacspeak zip/tar file, just unpack it.
*** for experimenters! Regular users skip this section!
Here is where paths diverge somewhat. There is another way, a more
dangerous way, but an easier one, somewhat, than having to go
get the release version from the site. _This way is only for
experimentation. Try at your own risk._
Open a terminal, and type git clone
http://www.github.com/tvraman/emacspeak
For those who are following the safe route, continue reading after
this line.
** making Emacspeak
go to
the terminal, type in
cd emacspeak (tab)
hopefully that’ll give you something that ends in "/"
then type
make config
that will configure Emacspeak for your system.
Then type
make emacspeak
That will make the basic emacspeak package for you
then, choose your synthesizer! eSpeak is free and okay, but
doesn’t support the more advanced speech capabilities, like
showing formatting by adjusting the voice quality. Voxin is $5,
is Eloquence, and supports all of Emacspeak’s speech features.
Then, according to your choice, type
make espeak
or
make outloud
Outloud is Voxin’s name in Emacspeak. Now, type
cd ~/
which will put you right in your home directory.
** Configuring Emacspeak to start with Emacs
Emacspeak is an extension to Emacs, the customizable, extensible,
self-documenting text editor. Basically, that means that
Emacspeak enables people who rely on speech output to use the
most powerful editor in the world, according to me and other
Emacs lovers. To set up Emacs, we need to be in your user
directory, ~/. Before, we set our directory to that, with cd
~/. Now, let’s do a little more work, so that when we start
Emacs, Emacspeak starts with it, so we don’t have to load it
manually and silently.
For setting up our Emacs configuration file, our ".emacs"
file, we’ll use nano, although you can use gedit, pluma, but
not Vim! So, from the home directory, type nano .emacs.el
This will open a small editor for you to type a little bit of
text. What you’ll type will make sure that Emacs, the program
under Emacspeak, will load Emacspeak as it runs. Note that
you’ll have to copy each line separately to avoid putting in
the commentary, as that will confuse Emacs if there is plain
text in the middle.
(load-file "~/emacspeak/lisp/emacspeak-setup.el")
If you want, you can also set your speech synthesizer here, although
if you only made support for one of them, that one /should/ be
loaded.
(setq "dtk_program outloud")
or espeak, whichever one you use. I do recommend Voxin though, as it’s
snappy and can use Emacspeak’s full potential of speech
effects, which makes reading very fun and informative. It’s
like going from black and white with normal screen readers, to
approaching high definition with Emacspeak’s "Aural CSS,"
which is used in web/HTML content, and even in email articles
when text is italicized and such.
Then, press control+w to "write" the file, and control+q to quit
nano. Now, all you have to do is press alt+f2, type emacs, press
enter, and you should have Emacs, with Emacspeak, loaded.
Stay tuned for more on using Emacspeak with Emacs. for now, your
mission is to explore this new world!