Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(249)

Unified Diff: docs/accessibility/chromevox_on_desktop_linux.md

Issue 2701603002: Update accessibility documentation. (Closed)
Patch Set: Created 3 years, 10 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « docs/accessibility/chromevox.md ('k') | docs/accessibility/overview.md » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: docs/accessibility/chromevox_on_desktop_linux.md
diff --git a/docs/accessibility/chromevox_on_desktop_linux.md b/docs/accessibility/chromevox_on_desktop_linux.md
new file mode 100644
index 0000000000000000000000000000000000000000..fc6850c2841aeeaad31dd1d64e27ec321d92fd62
--- /dev/null
+++ b/docs/accessibility/chromevox_on_desktop_linux.md
@@ -0,0 +1,110 @@
+# ChromeVox on Desktop Linux
+
+## Starting ChromeVox
+
+On Chrome OS, you can enable spoken feedback (ChromeVox) by pressing Ctrl+Alt+Z.
+
+If you have a Chromebook, this gives you speech support built-in. If you're
+building Chrome from source and running it on desktop Linux, speech and braille
+won't be included by default. Here's how to enable it.
+
+## Compiling the Chrome OS version of Chrome
+
+First follow the public instructions for
+[Chrome checkout and build](https://www.chromium.org/developers/how-tos/get-the-code).
+
+Create a GN configuration with "chromeos" as the target OS, for example:
+
+```> gn args out/ChromeOSRelease```
+
+...in editor, add this line:
+
+```
+target_os = "chromeos"
+is_component_build = true
+is_debug = false
+```
+
+Note: Only ```target_os = "chromeos"``` is required, the others are recommended
+for a good experience but you can configure Chrome however you like otherwise.
+Note that Native Client is required, so do not put enable_nacl = false in
+your file anywhere!
+
+Now build Chrome as usual, e.g.:
+
+```ninja -C out/cros chrome```
+
+And run it as usual to see a mostly-complete Chrome OS desktop inside
+of a window:
+
+```out/cros/chrome```
+
+By default you'll be logged in as the default user. If you want to
+simulate the login manager too, run it like this:
+
+```out/cros/chrome --login-manager```
+
+You can run any of the above under it’s own X session (avoiding any
+window manager key combo conflicts) by doing something like
+
+```startx out/cros/chrome```
+
+## Speech
+
+If you want speech, you just need to copy the speech synthesis data
+files to /usr/share like it would be on a Chrome OS device:
+
+```
+git clone https://chromium.googlesource.com/chromiumos/platform/assets
+sudo cp assets /usr/share/chromeos-assets
+```
+
+Next, move to that directory and unzip the NaCl executables. You only need
+to do the one for your host architecture:
+
+```
+cd /usr/share/chromeos-assets/speech_synthesis/patts
+unzip tts_service_x86-64.nexe.zip
+```
+
+Finally, fix the permissions:
+
+```
+sudo chmod oug+r -R /usr/share/chromeos-assets
+```
+
+**Be sure to check permissions of /usr/share/chromeos-assets, some
+ users report they need to chmod or chown too, it really depends
+ on your system.**
+
+After you do that, just run "chrome" as above
+(e.g. out/cros/chrome) and press Ctrl+Alt+Z, and you should hear it
+speak! If not, check the logs.
+
+## Braille
+
+ChromeVox uses extension APIs to deliver braille to Brltty through
+libbrlapi and uses Liblouis to perform translation and
+backtranslation.
+
+Once built, Chrome and ChromeVox will use your machine’s running
+Brltty daemon to display braille if ChromeVox is running. Simply
+ensure you have a display connected before running Chrome and that
+Brltty is running.
+
+Testing against the latest releases of Brltty (e.g. 5.4 at time of
+writing) is encouraged.
+
+For more general information, see [ChromeVox](chromevox.md)
+
+# Using ChromeVox
+
+ChromeVox keyboard shortcuts use Search. On Linux that's usually your
+Windows key. If some shortcuts don't work, you may need to remove
+Gnome keyboard shortcut bindings, or use "startx", as suggested above,
+or remap it.
+
+* Search+Space: Click
+* Search+Left/Right: navigate linearly
+* Search+Period: Open ChromeVox menus
+* Search+H: jump to next heading on page
« no previous file with comments | « docs/accessibility/chromevox.md ('k') | docs/accessibility/overview.md » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698