Difference between revisions of "TalkingArch"

From ArchWiki
Jump to: navigation, search
(changed page to describe release 3 of the CD. Added a section about navigating menus in the installer.)
Line 6: Line 6:
  
 
Grub:
 
Grub:
[http://cmb.tysdomain.com/talkingarch-2009.02-ftp-i686.iso download]<br>
+
[http://cmb.tysdomain.com/TalkingArch-2009.03-ftp-i686.iso download]
MD5 sum: 932d49d5093e50d8c5fb14527afd17fa
+
[http://cmb.tysdomain.com/TalkingArch-2009.03-ftp-i686.iso.sig detached signature]<br>
 +
MD5 sum: e0854e63d59cea73b94ba0d5b46206d0
  
 
Isolinux:
 
Isolinux:
[http://cmb.tysdomain.com/talkingarch-2009.02-ftp-i686-isolinux.iso download]<br>
+
[http://cmb.tysdomain.com/TalkingArch-2009.03-ftp-i686-isolinux.iso download]
MD5 sum: 28fa806a745e26424596259a71fc9d64
+
[http://cmb.tysdomain.com/TalkingArch-2009.03-ftp-i686-isolinux.iso.sig detached signature]<br>
 +
MD5 sum: 23a40cb13455a8580cc04730e741d6eb
 +
 
 +
The detached signatures were made using the gpg key associated with the address
 +
cmbrannon79 at gmail dot com.  The key's fingerprint is CE8D2EE8.
  
 
== Credits ==
 
== Credits ==
Line 34: Line 39:
 
#You also need to save the state of the sound card, so that it will be retrieved on reboot. Execute the command <pre>alsactl store</pre> and copy the file <pre>/etc/asound.state</pre> to <pre>/mnt/etc/asound.state</pre>. Alternatively, <pre>alsactl -f /mnt/etc/asound.state store</pre>
 
#You also need to save the state of the sound card, so that it will be retrieved on reboot. Execute the command <pre>alsactl store</pre> and copy the file <pre>/etc/asound.state</pre> to <pre>/mnt/etc/asound.state</pre>. Alternatively, <pre>alsactl -f /mnt/etc/asound.state store</pre>
 
#When you boot the system from the hard disk, it should start speaking.
 
#When you boot the system from the hard disk, it should start speaking.
 +
 +
== Handling Dialogs with Speakup ==
 +
The ArchLinux installer, <pre>/arch/setup</pre>, makes extensive use of the '''dialog''' program. Users may experience some difficulties when navigating several of the menus and dialogs.  This is not specific to ArchLinux.  Other text-mode installers often have similar problems.
 +
 +
The following discussion was compiled from suggestions on the Speakup list,
 +
and it includes some advice from Chris Brannon.
 +
 +
First, enable highlight tracking.  Press the star key on the numeric keypad.
 +
If you use a laptop that lacks the numeric keypad, press the sequence
 +
capslock control 8.
 +
Speakup will say "highlight tracking".  This is sufficient to navigate
 +
most of the menus with the arrow keys, but there are a few notable exceptions, described in the following paragraphs.
 +
 +
=== Choosing a Filesystem ===
 +
The "choose filesystem" menu doesn't cooperate with highlight tracking.
 +
It is difficult to determine which of the entries is selected.
 +
There are two solutions.
 +
The first is suggested by Adam Myrow.
 +
 +
<blockquote>
 +
You can also use insert+period on the numeric keypad to check out the
 +
color of the text under the cursor.  By going from line to line, and
 +
checking the color, it should become apparent which item is selected.  For
 +
example, in Slackware, the highlighted option is bright red on blue, and
 +
the others are red on cyan.  In this example, highlight tracking gives
 +
improper feedback, listing the option above the one that is selected.
 +
</blockquote>
 +
 +
Note for laptop users: the equivalent key sequence is capslock slash.
 +
 +
The second solution is even easier, assuming that you want ext2, ext3, or ext4
 +
as your filesystem.  If you want ext2, just press enter after the menu
 +
is displayed.  If you want ext3, press down-arrow once, followed by enter.
 +
Two down-arrows from the top of the menu gives you ext4.
 +
This is Chris Brannon's preferred method.  Just count menu entries, and
 +
press down-arrow the requisite number of times.
 +
 +
=== Setting the Date and Time ===
 +
The "set timezone" menus are a joy to navigate, because the entries
 +
are numbered.  Just type the corresponding number and press enter.
 +
 +
The "set date and time" menus are problematic.  Ignore them, because there
 +
is a better way to set your system's clock.  Once you have booted ArchLinux
 +
from the hard drive, install the ntp package.  Next, execute the command
 +
<pre>ntpdate rolex.usg.edu</pre>
 +
You need to be logged in as root to perform both steps.
 +
Your system's clock will be synchronized with a time server located in
 +
the US state of Georgia.
 +
You may wish to find a time server that is closer to you.  Chris Brannon never
 +
manually sets a system's clock, since setting it with NTP is so much easier.
  
 
= Maintaining Your Speech-enabled ArchLinux Installation =
 
= Maintaining Your Speech-enabled ArchLinux Installation =
Line 50: Line 105:
 
Grab sources using git:
 
Grab sources using git:
 
<pre>
 
<pre>
git clone http://members.cox.net/cmbrannon/archiso.git
+
git clone http://members.cox.net/cmbrannon/archiso.git
cd archiso
+
cd archiso
git checkout --track -b talkinginst origin/talkinginst
+
git checkout --track -b talkinginst origin/talkinginst
 
</pre>
 
</pre>
  
Line 62: Line 117:
 
In order to create the image, pacman needs to be able to find the speakup
 
In order to create the image, pacman needs to be able to find the speakup
 
and espeakup packages.
 
and espeakup packages.
Add my custom "blind" package repository to <pre>/etc/pacman.conf</pre> on the host
+
Add my custom "blind" package repository to <pre>/etc/pacman.conf</pre> on the host system, as described in the instructions for installing from CD. Change to the configs/talkinginst directory, and type <pre>make ftp-iso</pre>.
system, as described in the instructions for installing from CD.
+
 
Change to the configs/talkinginst directory, and type <pre>make ftp-iso</pre>.
+
 
Alternatively,
 
Alternatively,
 
<pre>
 
<pre>
make BOOTLOADER=syslinux ftp-iso
+
make BOOTLOADER=syslinux ftp-iso
 
</pre>
 
</pre>
 
yields an image having Isolinux as its bootloader. There are several more targets for "make". For instance, ftp-usb produces an image suitable for a flash drive.
 
yields an image having Isolinux as its bootloader. There are several more targets for "make". For instance, ftp-usb produces an image suitable for a flash drive.
Line 73: Line 127:
 
= Additional Notes =
 
= Additional Notes =
 
Presently, this CD is only usable with English-language speech.
 
Presently, this CD is only usable with English-language speech.
 
= Known Problems =
 
The sound card may not be properly unmuted after boot.  The script on the
 
CD only unmutes the Master and PCM controls, but this is not sufficient
 
for all sound cards.  A fix is promised by March 27, 2009.
 
  
 
= Disclaimer =
 
= Disclaimer =
 
The author of this modified CD is in no way associated with ArchLinux. The product is not an official release.  It is not endorsed by anyone other than Chris Brannon.  It is provided solely for the convenience of its creator and other blind users, and it comes with absolutely no warranty.
 
The author of this modified CD is in no way associated with ArchLinux. The product is not an official release.  It is not endorsed by anyone other than Chris Brannon.  It is provided solely for the convenience of its creator and other blind users, and it comes with absolutely no warranty.

Revision as of 04:00, 24 March 2009

Introduction

This page describes the second release of a modified ArchLinux install CD that includes spoken output for blind users. The modified version is mostly equivalent to the official "ftp CD", but the system should start speaking as soon as you boot with it. Speech is provided via the sound card, using the eSpeak software synthesizer and the Speakup screenreader. It is only available for the i686 platform; x86-64 is not supported. There are two versions: an Isolinux version and a Grub version. One may obtain ".iso" images via HTTP.

Grub: download detached signature
MD5 sum: e0854e63d59cea73b94ba0d5b46206d0

Isolinux: download detached signature
MD5 sum: 23a40cb13455a8580cc04730e741d6eb

The detached signatures were made using the gpg key associated with the address cmbrannon79 at gmail dot com. The key's fingerprint is CE8D2EE8.

Credits

This CD was produced by Chris Brannon, and the downloadable images are hosted by Tyler Littlefield.

Installing from the CD

The following list of steps is a brief guide to installing ArchLinux using this CD. The instructions assume that your root partition will be mounted on /mnt.

  1. When booting, Grub provides a very long timeout. Press enter once the drive stops spinning.
  2. Use the installer on the CD, as per the Beginners Guide.
  3. Install the alsa-utils and espeak packages:
    pacman --root=/mnt -Sy alsa-utils espeak
  4. Install the speakup and espeakup packages. These are not yet available in the community repository. There are two ways to install them.
    1. Use the binary packages from Chris Brannon's custom package repository.
      I promise that the speakup package will always match the kernel version available from the official ArchLinux repositories. Append the following two lines to
      /etc/pacman.conf
      and
      /mnt/etc/pacman.conf
      :
      [blind]
      Server = http://members.cox.net/cmbrannon/blind/i686
      Install the packages from my custom repository:
      pacman --root=/mnt -Sy speakup espeakup
    2. Build the packages from source, using the PKGBUILDs available from the Arch User Repository. For convenience, the URLs are: speakup PKGBUILD espeakup PKGBUILD. If I were going to choose this option, I would probably chroot into the newly installed ArchLinux system in order to build the packages.
  5. Customize
    /mnt/etc/rc.conf
    : Add speakup and speakup_soft to the MODULES array. Add alsa and espeakup to the DAEMONS array.
  6. You also need to save the state of the sound card, so that it will be retrieved on reboot. Execute the command
    alsactl store
    and copy the file
    /etc/asound.state
    to
    /mnt/etc/asound.state
    . Alternatively,
    alsactl -f /mnt/etc/asound.state store
  7. When you boot the system from the hard disk, it should start speaking.

Handling Dialogs with Speakup

The ArchLinux installer,
/arch/setup
, makes extensive use of the dialog program. Users may experience some difficulties when navigating several of the menus and dialogs. This is not specific to ArchLinux. Other text-mode installers often have similar problems.

The following discussion was compiled from suggestions on the Speakup list, and it includes some advice from Chris Brannon.

First, enable highlight tracking. Press the star key on the numeric keypad. If you use a laptop that lacks the numeric keypad, press the sequence capslock control 8. Speakup will say "highlight tracking". This is sufficient to navigate most of the menus with the arrow keys, but there are a few notable exceptions, described in the following paragraphs.

Choosing a Filesystem

The "choose filesystem" menu doesn't cooperate with highlight tracking. It is difficult to determine which of the entries is selected. There are two solutions. The first is suggested by Adam Myrow.

You can also use insert+period on the numeric keypad to check out the color of the text under the cursor. By going from line to line, and checking the color, it should become apparent which item is selected. For example, in Slackware, the highlighted option is bright red on blue, and the others are red on cyan. In this example, highlight tracking gives improper feedback, listing the option above the one that is selected.

Note for laptop users: the equivalent key sequence is capslock slash.

The second solution is even easier, assuming that you want ext2, ext3, or ext4 as your filesystem. If you want ext2, just press enter after the menu is displayed. If you want ext3, press down-arrow once, followed by enter. Two down-arrows from the top of the menu gives you ext4. This is Chris Brannon's preferred method. Just count menu entries, and press down-arrow the requisite number of times.

Setting the Date and Time

The "set timezone" menus are a joy to navigate, because the entries are numbered. Just type the corresponding number and press enter.

The "set date and time" menus are problematic. Ignore them, because there is a better way to set your system's clock. Once you have booted ArchLinux from the hard drive, install the ntp package. Next, execute the command

ntpdate rolex.usg.edu

You need to be logged in as root to perform both steps. Your system's clock will be synchronized with a time server located in the US state of Georgia. You may wish to find a time server that is closer to you. Chris Brannon never manually sets a system's clock, since setting it with NTP is so much easier.

Maintaining Your Speech-enabled ArchLinux Installation

If you added my custom package repository to your pacman.conf file, then you will be able to receive upgrades to the speakup and espeakup packages whenever they happen. This is infrequent. I rebuild speakup whenever ArchLinux provides a major kernel upgrade. When kernel version 2.6.28 replaced version 2.6.27, a new speakup package was available several hours after the new kernel was made available on the Arch mirrors. Everything should seamlessly work.

Mastering Speech-enabled ISO Images

The ArchLinux developers build their CD images using a set of shell scripts and configuration files named archiso. I added a configuration to archiso that allows me to build accessible CDs. If someone wants to produce customized images containing Speakup, he can do the following.

Grab sources using git:

git clone http://members.cox.net/cmbrannon/archiso.git
cd archiso
git checkout --track -b talkinginst origin/talkinginst

All of my work is done on the "talkinginst" branch. The master branch

mirrors the master branch from
git://projects.archlinux.org/archiso.git

Install the scripts contained in the archiso/ subdirectory of the sources.

In order to create the image, pacman needs to be able to find the speakup and espeakup packages.

Add my custom "blind" package repository to
/etc/pacman.conf
on the host system, as described in the instructions for installing from CD. Change to the configs/talkinginst directory, and type
make ftp-iso
.

Alternatively,

make BOOTLOADER=syslinux ftp-iso

yields an image having Isolinux as its bootloader. There are several more targets for "make". For instance, ftp-usb produces an image suitable for a flash drive.

Additional Notes

Presently, this CD is only usable with English-language speech.

Disclaimer

The author of this modified CD is in no way associated with ArchLinux. The product is not an official release. It is not endorsed by anyone other than Chris Brannon. It is provided solely for the convenience of its creator and other blind users, and it comes with absolutely no warranty.