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

Side by Side 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 unified diff | Download patch
« no previous file with comments | « docs/accessibility/chromevox.md ('k') | docs/accessibility/overview.md » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
(Empty)
1 # ChromeVox on Desktop Linux
2
3 ## Starting ChromeVox
4
5 On Chrome OS, you can enable spoken feedback (ChromeVox) by pressing Ctrl+Alt+Z.
6
7 If you have a Chromebook, this gives you speech support built-in. If you're
8 building Chrome from source and running it on desktop Linux, speech and braille
9 won't be included by default. Here's how to enable it.
10
11 ## Compiling the Chrome OS version of Chrome
12
13 First follow the public instructions for
14 [Chrome checkout and build](https://www.chromium.org/developers/how-tos/get-the- code).
15
16 Create a GN configuration with "chromeos" as the target OS, for example:
17
18 ```> gn args out/ChromeOSRelease```
19
20 ...in editor, add this line:
21
22 ```
23 target_os = "chromeos"
24 is_component_build = true
25 is_debug = false
26 ```
27
28 Note: Only ```target_os = "chromeos"``` is required, the others are recommended
29 for a good experience but you can configure Chrome however you like otherwise.
30 Note that Native Client is required, so do not put enable_nacl = false in
31 your file anywhere!
32
33 Now build Chrome as usual, e.g.:
34
35 ```ninja -C out/cros chrome```
36
37 And run it as usual to see a mostly-complete Chrome OS desktop inside
38 of a window:
39
40 ```out/cros/chrome```
41
42 By default you'll be logged in as the default user. If you want to
43 simulate the login manager too, run it like this:
44
45 ```out/cros/chrome --login-manager```
46
47 You can run any of the above under it’s own X session (avoiding any
48 window manager key combo conflicts) by doing something like
49
50 ```startx out/cros/chrome```
51
52 ## Speech
53
54 If you want speech, you just need to copy the speech synthesis data
55 files to /usr/share like it would be on a Chrome OS device:
56
57 ```
58 git clone https://chromium.googlesource.com/chromiumos/platform/assets
59 sudo cp assets /usr/share/chromeos-assets
60 ```
61
62 Next, move to that directory and unzip the NaCl executables. You only need
63 to do the one for your host architecture:
64
65 ```
66 cd /usr/share/chromeos-assets/speech_synthesis/patts
67 unzip tts_service_x86-64.nexe.zip
68 ```
69
70 Finally, fix the permissions:
71
72 ```
73 sudo chmod oug+r -R /usr/share/chromeos-assets
74 ```
75
76 **Be sure to check permissions of /usr/share/chromeos-assets, some
77 users report they need to chmod or chown too, it really depends
78 on your system.**
79
80 After you do that, just run "chrome" as above
81 (e.g. out/cros/chrome) and press Ctrl+Alt+Z, and you should hear it
82 speak! If not, check the logs.
83
84 ## Braille
85
86 ChromeVox uses extension APIs to deliver braille to Brltty through
87 libbrlapi and uses Liblouis to perform translation and
88 backtranslation.
89
90 Once built, Chrome and ChromeVox will use your machine’s running
91 Brltty daemon to display braille if ChromeVox is running. Simply
92 ensure you have a display connected before running Chrome and that
93 Brltty is running.
94
95 Testing against the latest releases of Brltty (e.g. 5.4 at time of
96 writing) is encouraged.
97
98 For more general information, see [ChromeVox](chromevox.md)
99
100 # Using ChromeVox
101
102 ChromeVox keyboard shortcuts use Search. On Linux that's usually your
103 Windows key. If some shortcuts don't work, you may need to remove
104 Gnome keyboard shortcut bindings, or use "startx", as suggested above,
105 or remap it.
106
107 * Search+Space: Click
108 * Search+Left/Right: navigate linearly
109 * Search+Period: Open ChromeVox menus
110 * Search+H: jump to next heading on page
OLDNEW
« 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