Debian Codegraph @

help/C/commands_reading.page

raw
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>