| 1 |
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="commands_reading"> |
| 2 |
<info> |
| 3 |
<link type="next" xref="commands_structural_navigation" /> |
| 4 |
<link type="guide" xref="commands#reading_documents" /> |
| 5 |
<link type="seealso" xref="howto_documents" /> |
| 6 |
<link type="seealso" xref="howto_text_attributes" /> |
| 7 |
<link type="seealso" xref="howto_whereami" /> |
| 8 |
<title type="sort">1. Reading</title> |
| 9 |
<title type="link">Reading</title> |
| 10 |
<desc> |
| 11 |
Commands for accessing document content |
| 12 |
</desc> |
| 13 |
<credit type="author"> |
| 14 |
<name>Joanmarie Diggs</name> |
| 15 |
<email>[email protected]</email> |
| 16 |
</credit> |
| 17 |
<license> |
| 18 |
<p>Creative Commons Share Alike 3.0</p> |
| 19 |
</license> |
| 20 |
</info> |
| 21 |
<title>Reading Commands</title> |
| 22 |
<p> |
| 23 |
In addition to the caret navigation commands which are part of GNOME, |
| 24 |
<app>Orca</app> provides a number of commands which you can use to read a |
| 25 |
document. |
| 26 |
</p> |
| 27 |
<note style="tip"> |
| 28 |
<p> |
| 29 |
Below you will see several references to "KP". All |
| 30 |
"KP" keys are located on the numeric keypad. You will also notice that |
| 31 |
there are different keystrokes depending upon whether you are using a |
| 32 |
desktop or a laptop -- or more accurately, whether you are using |
| 33 |
<app>Orca</app>'s Desktop keyboard layout or its Laptop keyboard layout. |
| 34 |
For additional information, please see the |
| 35 |
<link xref="howto_keyboard_layout">Keyboard Layout</link> topic. |
| 36 |
</p> |
| 37 |
</note> |
| 38 |
<section id="flat_review"> |
| 39 |
<title>Reading Your Current Location</title> |
| 40 |
<p> |
| 41 |
The following <app>Orca</app> <link xref="commands_flat_review">Flat |
| 42 |
Review Commands</link> can be used to read your current location: |
| 43 |
</p> |
| 44 |
<list> |
| 45 |
<item> |
| 46 |
<p>Read the current line:</p> |
| 47 |
<list> |
| 48 |
<item> |
| 49 |
<p> |
| 50 |
Desktop: <keyseq><key>KP 8</key></keyseq> |
| 51 |
</p> |
| 52 |
</item> |
| 53 |
<item> |
| 54 |
<p> |
| 55 |
Laptop: <keyseq><key>Orca Modifier</key><key>I</key></keyseq> |
| 56 |
</p> |
| 57 |
</item> |
| 58 |
</list> |
| 59 |
</item> |
| 60 |
<item> |
| 61 |
<p>Read the current word:</p> |
| 62 |
<list> |
| 63 |
<item> |
| 64 |
<p> |
| 65 |
Desktop: <keyseq><key>KP 5</key></keyseq> |
| 66 |
</p> |
| 67 |
</item> |
| 68 |
<item> |
| 69 |
<p> |
| 70 |
Laptop: <keyseq><key>Orca Modifier</key><key>K</key></keyseq> |
| 71 |
</p> |
| 72 |
</item> |
| 73 |
</list> |
| 74 |
</item> |
| 75 |
<item> |
| 76 |
<p>Spell the current word:</p> |
| 77 |
<list> |
| 78 |
<item> |
| 79 |
<p> |
| 80 |
Desktop: <keyseq><key>KP 5</key></keyseq> (double-clicked) |
| 81 |
</p> |
| 82 |
</item> |
| 83 |
<item> |
| 84 |
<p> |
| 85 |
Laptop: <keyseq><key>Orca Modifier</key><key>K</key></keyseq> |
| 86 |
(double-clicked) |
| 87 |
</p> |
| 88 |
</item> |
| 89 |
</list> |
| 90 |
</item> |
| 91 |
<item> |
| 92 |
<p>Phonetically spell the current word:</p> |
| 93 |
<list> |
| 94 |
<item> |
| 95 |
<p> |
| 96 |
Desktop: <keyseq><key>KP 5</key></keyseq> (triple-clicked) |
| 97 |
</p> |
| 98 |
</item> |
| 99 |
<item> |
| 100 |
<p> |
| 101 |
Laptop: <keyseq><key>Orca Modifier</key><key>K</key></keyseq> |
| 102 |
(triple-clicked) |
| 103 |
</p> |
| 104 |
</item> |
| 105 |
</list> |
| 106 |
</item> |
| 107 |
<item> |
| 108 |
<p>Read the current character:</p> |
| 109 |
<list> |
| 110 |
<item> |
| 111 |
<p> |
| 112 |
Desktop: <keyseq><key>KP 2</key></keyseq> |
| 113 |
</p> |
| 114 |
</item> |
| 115 |
<item> |
| 116 |
<p> |
| 117 |
Laptop: <keyseq><key>Orca Modifier</key><key>Comma</key></keyseq> |
| 118 |
</p> |
| 119 |
</item> |
| 120 |
</list> |
| 121 |
</item> |
| 122 |
<item> |
| 123 |
<p>Phonetically speak the current character:</p> |
| 124 |
<list> |
| 125 |
<item> |
| 126 |
<p> |
| 127 |
Desktop: <keyseq><key>KP 2</key></keyseq> (double-clicked) |
| 128 |
</p> |
| 129 |
</item> |
| 130 |
<item> |
| 131 |
<p> |
| 132 |
Laptop: <keyseq><key>Orca Modifier</key><key>Comma</key></keyseq> |
| 133 |
(double-clicked) |
| 134 |
</p> |
| 135 |
</item> |
| 136 |
</list> |
| 137 |
</item> |
| 138 |
<item> |
| 139 |
<p>Speak the Unicode value of current character:</p> |
| 140 |
<list> |
| 141 |
<item> |
| 142 |
<p> |
| 143 |
Desktop: <keyseq><key>KP 2</key></keyseq> (triple-clicked) |
| 144 |
</p> |
| 145 |
</item> |
| 146 |
<item> |
| 147 |
<p> |
| 148 |
Laptop: <keyseq><key>Orca Modifier</key><key>Comma</key></keyseq> |
| 149 |
(triple-clicked) |
| 150 |
</p> |
| 151 |
</item> |
| 152 |
</list> |
| 153 |
</item> |
| 154 |
</list> |
| 155 |
</section> |
| 156 |
<section id="say_all"> |
| 157 |
<title>Say All</title> |
| 158 |
<p> |
| 159 |
Orca's Say All command will cause <app>Orca</app> to speak the |
| 160 |
entire document beginning from your current location. |
| 161 |
</p> |
| 162 |
<list> |
| 163 |
<item> |
| 164 |
<p>Desktop: <key>KP Plus</key></p> |
| 165 |
</item> |
| 166 |
<item> |
| 167 |
<p> |
| 168 |
Laptop: <keyseq><key>Orca Modifier</key><key>Semicolon</key></keyseq> |
| 169 |
</p> |
| 170 |
</item> |
| 171 |
</list> |
| 172 |
</section> |
| 173 |
<section id="attributes_and_selection"> |
| 174 |
<title>Text Attributes and Selected Text</title> |
| 175 |
<p> |
| 176 |
<app>Orca</app> has a dedicated command for obtaining the attributes of the |
| 177 |
text at the caret location. In addition, if you use <app>Orca</app>'s |
| 178 |
Where Am I commands from within a text object in which text has been |
| 179 |
selected, <app>Orca</app> will announce the selected text. <app>Orca</app>'s |
| 180 |
command to speak the current selection will also perform this function in a |
| 181 |
text object. |
| 182 |
</p> |
| 183 |
<list> |
| 184 |
<item> |
| 185 |
<p> |
| 186 |
Present the text attributes: |
| 187 |
<keyseq><key>Orca Modifier</key><key>F</key></keyseq> |
| 188 |
</p> |
| 189 |
</item> |
| 190 |
<item> |
| 191 |
<p>Perform basic Where Am I:</p> |
| 192 |
<list> |
| 193 |
<item> |
| 194 |
<p> |
| 195 |
Desktop: <key>KP Enter</key> |
| 196 |
</p> |
| 197 |
</item> |
| 198 |
<item> |
| 199 |
<p> |
| 200 |
Laptop: <keyseq><key>Orca Modifier</key><key>Return</key></keyseq> |
| 201 |
</p> |
| 202 |
</item> |
| 203 |
</list> |
| 204 |
</item> |
| 205 |
<item> |
| 206 |
<p>Perform detailed Where Am I:</p> |
| 207 |
<list> |
| 208 |
<item> |
| 209 |
<p> |
| 210 |
Desktop: <key>KP Enter</key> (double-clicked) |
| 211 |
</p> |
| 212 |
</item> |
| 213 |
<item> |
| 214 |
<p> |
| 215 |
Laptop: <keyseq><key>Orca Modifier</key><key>Return</key></keyseq> |
| 216 |
(double-clicked) |
| 217 |
</p> |
| 218 |
</item> |
| 219 |
</list> |
| 220 |
</item> |
| 221 |
<item> |
| 222 |
<p> |
| 223 |
Speak current selection: |
| 224 |
<keyseq><key>Orca Modifier</key><key>Shift</key><key>Up</key></keyseq> |
| 225 |
</p> |
| 226 |
</item> |
| 227 |
</list> |
| 228 |
</section> |
| 229 |
<section id="link_details"> |
| 230 |
<title>Link Details</title> |
| 231 |
<p> |
| 232 |
If you are on a link, <app>Orca</app>'s Basic Where Am I command can be |
| 233 |
used to announce the details associated with the link such as the link type, |
| 234 |
if the link is visited, the site description, and file size. If you would |
| 235 |
instead prefer a dedicated command for this purpose, you can bind <app>Orca</app>'s |
| 236 |
Speak Link Details command to a keystroke. Please see <link xref="howto_key_bindings"> |
| 237 |
Modifying Keybindings</link> for information on how to do so. |
| 238 |
</p> |
| 239 |
<list> |
| 240 |
<item> |
| 241 |
<p>Speak the link details: (Unbound)</p> |
| 242 |
</item> |
| 243 |
</list> |
| 244 |
</section> |
| 245 |
<section id="browse_and_focus_modes"> |
| 246 |
<title>Browse and Focus Modes</title> |
| 247 |
<p> |
| 248 |
<app>Orca</app>'s Browse and Focus modes let you switch between reading and |
| 249 |
interacting with web content. |
| 250 |
</p> |
| 251 |
<list> |
| 252 |
<item> |
| 253 |
<p> |
| 254 |
Switch between browse mode and focus mode: |
| 255 |
<keyseq><key>Orca Modifier</key><key>A</key></keyseq> |
| 256 |
</p> |
| 257 |
</item> |
| 258 |
<item> |
| 259 |
<p> |
| 260 |
Enable sticky focus mode: |
| 261 |
<keyseq><key>Orca Modifier</key><key>A</key></keyseq> (double-clicked) |
| 262 |
</p> |
| 263 |
</item> |
| 264 |
<item> |
| 265 |
<p> |
| 266 |
Enable sticky browse mode: |
| 267 |
<keyseq><key>Orca Modifier</key><key>A</key></keyseq> (triple-clicked) |
| 268 |
</p> |
| 269 |
</item> |
| 270 |
</list> |
| 271 |
</section> |
| 272 |
<section id="toggling_layout_mode"> |
| 273 |
<title>Toggling Layout Mode</title> |
| 274 |
<p> |
| 275 |
When Layout mode is enabled, <app>Orca</app>'s caret navigation will respect |
| 276 |
the on-screen layout of the content and present the full line, including any |
| 277 |
links or form fields on that line. When Layout mode is disabled, <app>Orca</app> |
| 278 |
will treat objects such as links and form fields as if they were on separate |
| 279 |
lines, both for presentation and navigation. |
| 280 |
</p> |
| 281 |
<p> |
| 282 |
<app>Orca</app> provides a command to switch between Layout mode and Object mode. |
| 283 |
This command is unbound by default. Please see <link xref="howto_key_bindings">Modifying |
| 284 |
Keybindings</link> for information on how to bind unbound commands. |
| 285 |
</p> |
| 286 |
<list> |
| 287 |
<item> |
| 288 |
<p> |
| 289 |
Switch between Layout mode and Object mode: (Unbound) |
| 290 |
</p> |
| 291 |
</item> |
| 292 |
</list> |
| 293 |
</section> |
| 294 |
</page> |