storm/cthulhu
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit, very few changes from orca 45. Added xfce4-notification daemon support.

Browse Source
This commit is contained in:
Storm Dragon
2024-10-16 17:06:34 -04:00
parent cef8363cfd
commit a523205ac2
1447 changed files with 1537893 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
help/C/commands.page Normal file
View File

@ -0,0 +1,34 @@
<page xmlns="http://projectmallard.org/1.0/" type="guide" id="commands">
<info>
<link type="next" xref="commands_controlling_orca" />
<link type="guide" xref="index#quick_reference" />
<title type="sort">4. <app>Orca</app>'s Commands</title>
<title type="link">Commands</title>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title><app>Orca</app>'s Commands</title>
<section id="getting_started" style="2column">
<title>Getting Started</title>
</section>
<section id="speech_braille" style="2column">
<title>Speech and Braille</title>
</section>
<section id="reading_documents" style="2column">
<title>Reading Web Pages and Other Documents</title>
</section>
<section id="reviewing_screen_contents" style="2column">
<title>Reviewing and Interacting with Screen Contents</title>
</section>
<section id="accessing_dynamic_information" style="2column">
<title>Accessing Dynamic Information</title>
</section>
<section id="troubleshooting">
<title>Troubleshooting</title>
</section>
</page>

57
help/C/commands_bookmarks.page Normal file
View File

@ -0,0 +1,57 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="commands_bookmarks">
<info>
<link type="next" xref="commands_live_regions" />
<link type="guide" xref="commands#reviewing_screen_contents" />
<link type="seealso" xref="howto_bookmarks" />
<title type="sort">4. Bookmarks</title>
<title type="link">Bookmarks</title>
<desc>
Commands to bookmark and retrieve objects
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Bookmark Commands</title>
<p>
<app>Orca</app> provides several commands which can be used to "bookmark"
a given object for the purpose of navigating back to it later.
</p>
<list>
<item>
<p>
Save a bookmark to the numbered slot: <keyseq><key>Orca Modifier</key>
<key>Alt</key><key>1</key></keyseq>-<key>6</key>
</p>
</item>
<item>
<p>
Save the defined bookmarks for the application or page:
<keyseq><key>Orca Modifier</key><key>Alt</key><key>B</key></keyseq>
</p>
</item>
<item>
<p>
Go to a specific, numbered bookmark: <keyseq><key>Orca Modifier</key>
<key>1</key></keyseq>-<key>6</key>
</p>
</item>
<item>
<p>
Go to the previous bookmark for the application or page:
<keyseq><key>Orca Modifier</key><key>Shift</key><key>B</key>
</keyseq>
</p>
</item>
<item>
<p>
Go to the next bookmark for the application or page:
<keyseq><key>Orca Modifier</key><key>B</key></keyseq>
</p>
</item>
</list>
</page>

40
help/C/commands_braille.page Normal file
View File

@ -0,0 +1,40 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="commands_braille">
<info>
<link type="next" xref="commands_reading" />
<link type="guide" xref="commands#speech_braille" />
<link type="seealso" xref="preferences_braille" />
<title type="sort">2. Braille</title>
<title type="link">Braille</title>
<desc>
Commands executable on braille displays
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Braille Commands</title>
<p>
The following commands allow you to control <app>Orca</app> from your
refreshable braille display rather than your keyboard:
</p>
<list>
<item><p>Pan braille display to the left: Line Left</p></item>
<item><p>Pan braille display to the right: Line Right</p></item>
<item><p>Toggle flat review mode: Freeze</p></item>
<item><p>Review the word above: Line Up</p></item>
<item><p>Review the word below: Line Down</p></item>
<item><p>Review bottom left: Bottom Right</p></item>
<item><p>Review the home position: Top Left</p></item>
<item><p>Contracted braille: Six Dots</p></item>
<item><p>Marks the beginning of a text selection: Cut Begin</p></item>
<item><p>Marks the end of a text selection: Cut Line</p></item>
<item><p>Processes a cursor routing key: Cursor Routing</p></item>
<item><p>Returns to object with keyboard focus: Cursor Position</p></item>
</list>
</page>

52
help/C/commands_chat.page Normal file
View File

@ -0,0 +1,52 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="commands_chat">
<info>
<link type="next" xref="commands_debugging" />
<link type="guide" xref="commands#accessing_dynamic_information" />
<link type="seealso" xref="preferences_chat" />
<title type="sort">2. Chat</title>
<title type="link">Chat</title>
<desc>
Commands for use with IM and IRC clients
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Chat Commands</title>
<p>
The following commands can be used to access information in the
instant messaging and internet relay chat clients supported by
<app>Orca</app>. You will notice that several of these commands
are "unbound." Please see <link xref="howto_key_bindings">Modifying
Keybindings</link> for information on how to bind these commands to
keystrokes.
</p>
<list>
<item>
<p>
Present previous chat room messages:
<keyseq><key>Orca Modifier</key><key>F1</key></keyseq> through <key>F9</key>
</p>
</item>
<item>
<p>
Enable/disable announcement of room name with messages: (Unbound)
</p>
</item>
<item>
<p>Enable/disable announcement of buddy typing status: (Unbound)</p>
</item>
<item>
<p>Enable/disable room-specific histories: (Unbound)</p>
</item>
</list>
</page>

86
help/C/commands_controlling_orca.page Normal file
View File

@ -0,0 +1,86 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="commands_controlling_orca">
<info>
<link type="next" xref="commands_where_am_i" />
<link type="guide" xref="commands#getting_started" />
<title type="sort">1. Controlling and Learning to Use Orca</title>
<title type="link">Controlling and Learning to Use Orca</title>
<desc>
Commands for interacting with <app>Orca</app>
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Controlling and Learning to Use Orca</title>
<section id="controlling">
<title>Commands for Controlling <app>Orca</app></title>
<p>
The following commands can be used to get into <app>Orca</app>'s
Preferences dialogs, toggle <app>Orca</app> on and off, and bypass
<app>Orca</app> commands to avoid shortcut conflicts within the
application being accessed.
</p>
<list>
<item>
<p>
Toggle <app>Orca</app> on and off in GNOME:
<keyseq><key>Super</key><key>Alt</key><key>S</key></keyseq>.
</p>
<note style="tip">
<p>
If you are using <app>Orca</app> in another desktop environment in which
there is no command to toggle <app>Orca</app> on and off, you may find the
command to quit <app>Orca</app> helpful. This command is unbound by default.
Please see <link xref="howto_key_bindings">Modifying Keybindings</link> for
information on how to bind unbound commands.
</p>
</note>
</item>
<item>
<p>
<link xref="preferences">Orca Preferences</link> dialog:
<keyseq><key>Orca Modifier</key><key>Space</key></keyseq>.
</p>
</item>
<item>
<p>
Orca's Preferences dialog for the focused application:
<keyseq><key>Ctrl</key><key>Orca Modifier</key><key>Space</key></keyseq>.
</p>
</item>
<item>
<p>
Pass the next command on to the current application:
<keyseq><key>Orca Modifier</key><key>BackSpace</key></keyseq>
</p>
</item>
</list>
</section>
<section id="learning">
<title>Commands for Learning to Use <app>Orca</app></title>
<p>
In Learn Mode, <app>Orca</app> will announce each keystroke you pressed
along with any associated <app>Orca</app> command that keystroke is bound
to. In this mode, you can also get a list of shortcuts containing all the
<app>Orca</app> commands you can use.
</p>
<list>
<item>
<p>
Enter Learn Mode:
<keyseq><key>Orca Modifier</key><key>H</key></keyseq>
</p>
</item>
<item>
<p>
Exit Learn Mode:
<keyseq><key>Esc</key></keyseq>
</p>
</item>
</list>
</section>
</page>

29
help/C/commands_debugging.page Normal file
View File

@ -0,0 +1,29 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="commands_debugging">
<info>
<link type="guide" xref="commands#troubleshooting" />
<title type="sort">1. Debugging</title>
<title type="link">Debugging</title>
<desc>
Commands for troubleshooting
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Debugging Commands</title>
<p>
You may be asked by the developers to provide some debugging information in
order to help them identify the source of a problem you are experiencing.
The following command is not "bound" to a keystroke. If you need to bind it,
please see <link xref="howto_key_bindings">Modifying Keybindings</link>.
</p>
<list>
<item>
<p>Cycle to the next debug level: (Unbound)</p>
</item>
</list>
</page>

76
help/C/commands_find.page Normal file
View File

@ -0,0 +1,76 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="commands_find">
<info>
<link type="next" xref="commands_mouse" />
<link type="guide" xref="commands#reviewing_screen_contents" />
<link type="seealso" xref="howto_orca_find" />
<title type="sort">2. Orca Find</title>
<title type="link">Orca Find</title>
<desc>
Commands for searching window contents
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Orca Find Commands</title>
<p>
<app>Orca</app>'s <link xref="howto_orca_find">Find feature</link> allows
you to search the <link xref="howto_flat_review">Flat Review</link> context
for elements located within the current window.
</p>
<list>
<item>
<p>Open the <app>Orca</app> Find dialog:</p>
<list>
<item>
<p>Desktop: <keyseq><key>KP Delete</key></keyseq></p>
</item>
<item>
<p>Laptop: <keyseq><key>Orca Modifier</key><key>Left Bracket</key></keyseq></p>
</item>
</list>
</item>
<item>
<p>Move flat review to the next instance of a string:</p>
<list>
<item>
<p>
Desktop:
<keyseq><key>Orca Modifier</key><key>KP Delete</key></keyseq>
</p>
</item>
<item>
<p>
Laptop:
<keyseq><key>Orca Modifier</key><key>Right Bracket</key></keyseq>
</p>
</item>
</list>
</item>
<item>
<p>Move flat review to the previous instance of a string:</p>
<list>
<item>
<p>
Desktop:
<keyseq>
<key>Orca Modifier</key><key>Shift</key><key>KP Delete</key>
</keyseq>
</p>
</item>
<item>
<p>
Laptop:
<keyseq>
<key>Orca Modifier</key><key>Ctrl</key><key>Right Bracket</key>
</keyseq>
</p>
</item>
</list>
</item>
</list>
</page>

199
help/C/commands_flat_review.page Normal file
View File

@ -0,0 +1,199 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="commands_flat_review">
<info>
<link type="next" xref="commands_find" />
<link type="guide" xref="commands#reviewing_screen_contents" />
<link type="seealso" xref="howto_flat_review" />
<title type="sort">1. Flat Review</title>
<title type="link">Flat Review</title>
<desc>
Commands for spatially reviewing windows
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Flat Review Commands</title>
<p>
Orca's <link xref="howto_flat_review">Flat Review</link> commands are
designed for spatially reviewing elements displayed on the screen. They
also provide a means for reading the current line, word, and character
when navigating in the text of a document. Most of these commands are
"bound" to keystrokes. Please see <link xref="howto_key_bindings">Modifying
Keybindings</link> for information on how to bind unbound commands.
</p>
<section id="line">
<title>Commands for Reviewing by Line</title>
<list>
<item>
<p>First line (The "home" position):</p>
<list>
<item><p>Desktop: <keyseq><key>Orca Modifier</key><key>KP 7</key></keyseq></p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Ctrl</key><key>U</key></keyseq></p></item>
</list>
</item>
<item>
<p>Previous line:</p>
<list>
<item><p>Desktop: <keyseq><key>KP 7</key></keyseq></p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>U</key></keyseq></p></item>
</list>
</item>
<item>
<p>Current line:</p>
<list>
<item><p>Desktop: <keyseq><key>KP 8</key></keyseq></p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>I</key></keyseq></p></item>
</list>
</item>
<item><p>Spell current line:</p>
<list>
<item><p>Desktop: <keyseq><key>KP 8</key></keyseq> (double-clicked)</p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>I</key></keyseq> (double-clicked)</p></item>
</list>
</item>
<item><p>Phonetically spell current line:</p>
<list>
<item><p>Desktop: <keyseq><key>KP 8</key></keyseq> (triple-clicked)</p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>I</key></keyseq> (triple-clicked)</p></item>
</list>
</item>
<item><p>Next line:</p>
<list>
<item><p>Desktop: <keyseq><key>KP 9</key></keyseq></p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>O</key></keyseq></p></item>
</list>
</item>
<item><p>Last line (The "end" position):</p>
<list>
<item><p>Desktop: <keyseq><key>Orca Modifier</key><key>KP 9</key></keyseq></p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Ctrl</key><key>O</key></keyseq></p></item>
</list>
</item>
</list>
</section>
<section id="word">
<title>Commands for Reviewing by Word</title>
<list>
<item><p>Word above:</p>
<list>
<item><p>Desktop: <keyseq><key>Orca Modifier</key><key>KP 4</key></keyseq></p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Ctrl</key><key>J</key></keyseq></p></item>
</list>
</item>
<item><p>Previous word:</p>
<list>
<item><p>Desktop: <keyseq><key>KP 4</key></keyseq></p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>J</key></keyseq></p></item>
</list>
</item>
<item><p>Current word:</p>
<list>
<item><p>Desktop: <keyseq><key>KP 5</key></keyseq></p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>K</key></keyseq></p></item>
</list>
</item>
<item><p>Spell current word:</p>
<list>
<item><p>Desktop: <keyseq><key>KP 5</key></keyseq> (double-clicked)</p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>K</key></keyseq> (double-clicked)</p></item>
</list>
</item>
<item><p>Phonetically spell current word:</p>
<list>
<item><p>Desktop: <keyseq><key>KP 5</key></keyseq> (triple-clicked)</p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>K</key></keyseq> (triple-clicked)</p></item>
</list>
</item>
<item><p>Next word:</p>
<list>
<item><p>Desktop: <keyseq><key>KP 6</key></keyseq></p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>L</key></keyseq></p></item>
</list>
</item>
<item><p>Word below:</p>
<list>
<item><p>Desktop: <keyseq><key>Orca Modifier</key><key>KP 6</key></keyseq></p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Ctrl</key><key>L</key></keyseq></p></item>
</list>
</item>
</list>
</section>
<section id="character">
<title>Commands for Reviewing by Character</title>
<list>
<item><p>Previous character:</p>
<list>
<item><p>Desktop: <keyseq><key>KP 1</key></keyseq></p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>M</key></keyseq></p></item>
</list>
</item>
<item><p>Current character:</p>
<list>
<item><p>Desktop: <keyseq><key>KP 2</key></keyseq></p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Comma</key></keyseq></p></item>
</list>
</item>
<item><p>Phonetically speak current character:</p>
<list>
<item><p>Desktop: <keyseq><key>KP 2</key></keyseq> (double-clicked)</p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Comma</key></keyseq> (double-clicked)</p></item>
</list>
</item>
<item><p>Speak Unicode value of current character:</p>
<list>
<item><p>Desktop: <keyseq><key>KP 2</key></keyseq> (triple-clicked)</p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Comma</key></keyseq> (triple-clicked)</p></item>
</list>
</item>
<item><p>Next character:</p>
<list>
<item><p>Desktop: <keyseq><key>KP 3</key></keyseq></p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Period</key></keyseq></p></item>
</list>
</item>
<item><p>Last character on current line:</p>
<list>
<item><p>Desktop: <keyseq><key>Orca Modifier</key><key>KP 1</key></keyseq></p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Ctrl</key><key>M</key></keyseq></p></item>
</list>
</item>
</list>
</section>
<section id="other">
<title>Additional Commands</title>
<list>
<item><p>Toggle flat review (refreshes the flat review context):</p>
<list>
<item><p>Desktop: <keyseq><key>Orca Modifier</key><key>KP Subtract</key></keyseq></p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>P</key></keyseq></p></item>
</list>
</item>
<item><p>Review current item/widget:</p>
<list>
<item><p>Desktop: <keyseq><key>Orca Modifier</key><key>KP 5</key></keyseq></p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Ctrl</key><key>K</key></keyseq></p></item>
</list>
</item>
<item><p>Use Say All to review the current dialog or window:</p>
<list>
<item><p>Desktop: <key>KP Plus</key> (double-clicked)</p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>Semicolon</key></keyseq> (double-clicked)</p></item>
</list>
</item>
<item>
<p>
Copy the contents under flat review to the clipboard: (Unbound)
</p>
</item>
<item>
<p>
Append the contents under flat review to the clipboard: (Unbound)
</p>
</item>
</list>
</section>
</page>

62
help/C/commands_live_regions.page Normal file
View File

@ -0,0 +1,62 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="commands_live_regions">
<info>
<link type="next" xref="commands_chat" />
<link type="guide" xref="commands#accessing_dynamic_information" />
<link type="seealso" xref="howto_live_regions" />
<title type="sort">1. Live Regions</title>
<title type="link">Live Regions</title>
<desc>
Commands for accessing web live regions
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0
</p>
</license>
</info>
<title>Live Region Commands</title>
<p>
The following commands can be used to access dynamically-updated
content on web pages which have been made accessible through ARIA.
</p>
<list>
<item>
<p>
Monitor live regions:
<keyseq><key>Orca Modifier</key><key>Shift</key><key>Backslash</key></keyseq>
</p>
</item>
<item>
<p>
Advance live region politeness setting: <key>Backslash</key>
</p>
</item>
<item>
<p>
Set default politeness level to off:
<keyseq><key>Shift</key><key>Backslash</key></keyseq>
</p>
</item>
<item>
<p>
Go to next/previous live region:
<keyseq><key>D</key></keyseq>/<keyseq><key>Shift</key><key>D</key></keyseq>
</p>
</item>
<item>
<p>
Go to last live region which made an announcement:
<keyseq><key>Y</key></keyseq>
</p>
</item>
<item>
<p>
Review live region announcements:
<keyseq><key>Orca Modifier</key><key>F1</key></keyseq> through <key>F9</key>
</p>
</item>
</list>
</page>

72
help/C/commands_mouse.page Normal file
View File

@ -0,0 +1,72 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="commands_mouse">
<info>
<link type="next" xref="commands_bookmarks" />
<link type="guide" xref="commands#reviewing_screen_contents" />
<title type="sort">3. Mouse/Pointer-Related</title>
<title type="link">Mouse/Pointer-Related</title>
<link type="seealso" xref="howto_flat_review" />
<link type="seealso" xref="howto_mouse_review" />
<desc>
Commands for manipulating the pointer
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Mouse/Pointer-Related Commands</title>
<p>
<app>Orca</app> provides several commands which can be used to manipulate
the mouse pointer and read the contents under it. All of the commands are
"bound" to keystrokes with one exception: Toggling Mouse Review Mode.
Please see <link xref="howto_key_bindings">Modifying Keybindings</link>
for information on how to bind this command to a keystroke.
</p>
<note style="tip">
<p>
Below you will see several references to "KP". All
"KP" keys are located on the numeric keypad. You will also notice that
there are different keystrokes depending upon whether you are using a
desktop or a laptop -- or more accurately, whether you are using
<app>Orca</app>'s Desktop keyboard layout or its Laptop keyboard layout.
For additional information, please see the
<link xref="howto_keyboard_layout">Keyboard Layout</link> topic.
</p>
</note>
<list>
<item>
<p>Left-click on current item:</p>
<list>
<item><p>Desktop: <keyseq><key>KP Divide</key></keyseq></p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>7</key></keyseq></p></item>
</list>
</item>
<item>
<p>Right-click on current item:</p>
<list>
<item><p>Desktop: <keyseq><key>KP Multiply</key></keyseq></p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>8</key></keyseq></p></item>
</list>
</item>
<item>
<p>Route pointer to current item:</p>
<list>
<item><p>Desktop: <keyseq><key>Orca Modifier</key><key>KP Divide</key></keyseq></p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>9</key></keyseq></p></item>
</list>
</item>
<item>
<p>Move focus into or away from the current mouse over (web only):</p>
<list>
<item><p>Desktop: <keyseq><key>Orca Modifier</key><key>KP Multiply</key></keyseq></p></item>
<item><p>Laptop: <keyseq><key>Orca Modifier</key><key>0</key></keyseq></p></item>
</list>
</item>
<item>
<p>Enable/disable mouse review mode: (Unbound)</p>
</item>
</list>
</page>

35
help/C/commands_profiles.page Normal file
View File

@ -0,0 +1,35 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="commands_profiles">
<info>
<link type="next" xref="commands_speech_settings" />
<link type="guide" xref="commands#getting_started" />
<link type="seealso" xref="howto_profiles" />
<title type="sort">5. Profiles</title>
<title type="link">Profiles</title>
<desc>
Commands to access saved configurations
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Profile Commands</title>
<p>
Profiles allow you to save and load multiple configurations so that you
can quickly access the settings you need.
</p>
<p>
The following command is not "bound" to a keystroke. If you would like to
bind it, please see <link xref="howto_key_bindings">Modifying Keybindings</link>.
</p>
<list>
<item>
<p>
Cycle to the next profile: (Unbound)
</p>
</item>
</list>
</page>

294
help/C/commands_reading.page Normal file
View File

@ -0,0 +1,294 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="commands_reading">
<info>
<link type="next" xref="commands_structural_navigation" />
<link type="guide" xref="commands#reading_documents" />
<link type="seealso" xref="howto_documents" />
<link type="seealso" xref="howto_text_attributes" />
<link type="seealso" xref="howto_whereami" />
<title type="sort">1. Reading</title>
<title type="link">Reading</title>
<desc>
Commands for accessing document content
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Reading Commands</title>
<p>
In addition to the caret navigation commands which are part of GNOME,
<app>Orca</app> provides a number of commands which you can use to read a
document.
</p>
<note style="tip">
<p>
Below you will see several references to "KP". All
"KP" keys are located on the numeric keypad. You will also notice that
there are different keystrokes depending upon whether you are using a
desktop or a laptop -- or more accurately, whether you are using
<app>Orca</app>'s Desktop keyboard layout or its Laptop keyboard layout.
For additional information, please see the
<link xref="howto_keyboard_layout">Keyboard Layout</link> topic.
</p>
</note>
<section id="flat_review">
<title>Reading Your Current Location</title>
<p>
The following <app>Orca</app> <link xref="commands_flat_review">Flat
Review Commands</link> can be used to read your current location:
</p>
<list>
<item>
<p>Read the current line:</p>
<list>
<item>
<p>
Desktop: <keyseq><key>KP 8</key></keyseq>
</p>
</item>
<item>
<p>
Laptop: <keyseq><key>Orca Modifier</key><key>I</key></keyseq>
</p>
</item>
</list>
</item>
<item>
<p>Read the current word:</p>
<list>
<item>
<p>
Desktop: <keyseq><key>KP 5</key></keyseq>
</p>
</item>
<item>
<p>
Laptop: <keyseq><key>Orca Modifier</key><key>K</key></keyseq>
</p>
</item>
</list>
</item>
<item>
<p>Spell the current word:</p>
<list>
<item>
<p>
Desktop: <keyseq><key>KP 5</key></keyseq> (double-clicked)
</p>
</item>
<item>
<p>
Laptop: <keyseq><key>Orca Modifier</key><key>K</key></keyseq>
(double-clicked)
</p>
</item>
</list>
</item>
<item>
<p>Phonetically spell the current word:</p>
<list>
<item>
<p>
Desktop: <keyseq><key>KP 5</key></keyseq> (triple-clicked)
</p>
</item>
<item>
<p>
Laptop: <keyseq><key>Orca Modifier</key><key>K</key></keyseq>
(triple-clicked)
</p>
</item>
</list>
</item>
<item>
<p>Read the current character:</p>
<list>
<item>
<p>
Desktop: <keyseq><key>KP 2</key></keyseq>
</p>
</item>
<item>
<p>
Laptop: <keyseq><key>Orca Modifier</key><key>Comma</key></keyseq>
</p>
</item>
</list>
</item>
<item>
<p>Phonetically speak the current character:</p>
<list>
<item>
<p>
Desktop: <keyseq><key>KP 2</key></keyseq> (double-clicked)
</p>
</item>
<item>
<p>
Laptop: <keyseq><key>Orca Modifier</key><key>Comma</key></keyseq>
(double-clicked)
</p>
</item>
</list>
</item>
<item>
<p>Speak the Unicode value of current character:</p>
<list>
<item>
<p>
Desktop: <keyseq><key>KP 2</key></keyseq> (triple-clicked)
</p>
</item>
<item>
<p>
Laptop: <keyseq><key>Orca Modifier</key><key>Comma</key></keyseq>
(triple-clicked)
</p>
</item>
</list>
</item>
</list>
</section>
<section id="say_all">
<title>Say All</title>
<p>
Orca's Say All command will cause <app>Orca</app> to speak the
entire document beginning from your current location.
</p>
<list>
<item>
<p>Desktop: <key>KP Plus</key></p>
</item>
<item>
<p>
Laptop: <keyseq><key>Orca Modifier</key><key>Semicolon</key></keyseq>
</p>
</item>
</list>
</section>
<section id="attributes_and_selection">
<title>Text Attributes and Selected Text</title>
<p>
<app>Orca</app> has a dedicated command for obtaining the attributes of the
text at the caret location. In addition, if you use <app>Orca</app>'s
Where Am I commands from within a text object in which text has been
selected, <app>Orca</app> will announce the selected text. <app>Orca</app>'s
command to speak the current selection will also perform this function in a
text object.
</p>
<list>
<item>
<p>
Present the text attributes:
<keyseq><key>Orca Modifier</key><key>F</key></keyseq>
</p>
</item>
<item>
<p>Perform basic Where Am I:</p>
<list>
<item>
<p>
Desktop: <key>KP Enter</key>
</p>
</item>
<item>
<p>
Laptop: <keyseq><key>Orca Modifier</key><key>Return</key></keyseq>
</p>
</item>
</list>
</item>
<item>
<p>Perform detailed Where Am I:</p>
<list>
<item>
<p>
Desktop: <key>KP Enter</key> (double-clicked)
</p>
</item>
<item>
<p>
Laptop: <keyseq><key>Orca Modifier</key><key>Return</key></keyseq>
(double-clicked)
</p>
</item>
</list>
</item>
<item>
<p>
Speak current selection:
<keyseq><key>Orca Modifier</key><key>Shift</key><key>Up</key></keyseq>
</p>
</item>
</list>
</section>
<section id="link_details">
<title>Link Details</title>
<p>
If you are on a link, <app>Orca</app>'s Basic Where Am I command can be
used to announce the details associated with the link such as the link type,
if the link is visited, the site description, and file size. If you would
instead prefer a dedicated command for this purpose, you can bind <app>Orca</app>'s
Speak Link Details command to a keystroke. Please see <link xref="howto_key_bindings">
Modifying Keybindings</link> for information on how to do so.
</p>
<list>
<item>
<p>Speak the link details: (Unbound)</p>
</item>
</list>
</section>
<section id="browse_and_focus_modes">
<title>Browse and Focus Modes</title>
<p>
<app>Orca</app>'s Browse and Focus modes let you switch between reading and
interacting with web content.
</p>
<list>
<item>
<p>
Switch between browse mode and focus mode:
<keyseq><key>Orca Modifier</key><key>A</key></keyseq>
</p>
</item>
<item>
<p>
Enable sticky focus mode:
<keyseq><key>Orca Modifier</key><key>A</key></keyseq> (double-clicked)
</p>
</item>
<item>
<p>
Enable sticky browse mode:
<keyseq><key>Orca Modifier</key><key>A</key></keyseq> (triple-clicked)
</p>
</item>
</list>
</section>
<section id="toggling_layout_mode">
<title>Toggling Layout Mode</title>
<p>
When Layout mode is enabled, <app>Orca</app>'s caret navigation will respect
the on-screen layout of the content and present the full line, including any
links or form fields on that line. When Layout mode is disabled, <app>Orca</app>
will treat objects such as links and form fields as if they were on separate
lines, both for presentation and navigation.
</p>
<p>
<app>Orca</app> provides a command to switch between Layout mode and Object mode.
This command is unbound by default. Please see <link xref="howto_key_bindings">Modifying
Keybindings</link> for information on how to bind unbound commands.
</p>
<list>
<item>
<p>
Switch between Layout mode and Object mode: (Unbound)
</p>
</item>
</list>
</section>
</page>

83
help/C/commands_speech_settings.page Normal file
View File

@ -0,0 +1,83 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="commands_speech_settings">
<info>
<link type="next" xref="commands_braille" />
<link type="guide" xref="commands#speech_braille" />
<link type="seealso" xref="preferences_speech" />
<title type="sort">2. Speech Settings</title>
<title type="link">Speech</title>
<desc>
Commands for customizing <app>Orca</app>'s output
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Speech Settings Commands</title>
<p>
The following commands can be used to customize <app>Orca</app>'s
speech output. You will notice that a number of these commands are
"unbound." Please see <link xref="howto_key_bindings">Modifying
Keybindings</link> for information on how to bind these commands
to keystrokes.
</p>
<list>
<item>
<p>
Enable/disable speech: <keyseq><key>Orca Modifier</key><key>S</key></keyseq>
</p>
</item>
<item>
<p>
Toggle between cell and row reading in a table:
<keyseq><key>Orca Modifier</key><key>F11</key></keyseq>
</p>
</item>
<item>
<p>
Toggle between verbose and brief verbosity levels:
<keyseq><key>Orca Modifier</key><key>V</key></keyseq>
</p>
</item>
<item>
<p>
Enable/disable speaking of indentation and justification: (Unbound)
</p>
</item>
<item>
<p>Change the spoken number style: (Unbound)</p>
</item>
<item>
<p>Cycle to the next spoken punctuation level: (Unbound)</p>
</item>
<item>
<p>Cycle to the next key echo level: (Unbound)</p>
</item>
<item>
<p>Cycle to the next capitalization style: (Unbound)</p>
</item>
<item>
<p>Decrease the rate: (Unbound)</p>
</item>
<item>
<p>Increase the rate: (Unbound)</p>
</item>
<item>
<p>Decrease the pitch: (Unbound)</p>
</item>
<item>
<p>Increase the pitch: (Unbound)</p>
</item>
<item>
<p>Decrease the volume: (Unbound)</p>
</item>
<item>
<p>Increase the volume: (Unbound)</p>
</item>
</list>
</page>

443
help/C/commands_structural_navigation.page Normal file
View File

@ -0,0 +1,443 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="commands_structural_navigation">
<info>
<link type="next" xref="commands_table" />
<link type="guide" xref="commands#reading_documents" />
<link type="seealso" xref="howto_forms" />
<title type="sort">2. Structural Navigation</title>
<title type="link">Structural Navigation</title>
<desc>
Commands for navigating by elements
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Structural Navigation Commands</title>
<p>
The following commands can be used to navigate by headings, links,
and other elements found in applications for which <app>Orca</app>
provides structural navigation support.
</p>
<list>
<item>
<p>
Enable/disable Structural Navigation keys:
<keyseq><key>Orca Modifier</key><key>Z</key></keyseq>
</p>
</item>
</list>
<section id="headings">
<title>Headings</title>
<list>
<item>
<p>
Next and previous heading:
<keyseq><key>H</key></keyseq> and
<keyseq><key>Shift</key><key>H</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of headings:
<keyseq><key>Alt</key><key>Shift</key><key>H</key></keyseq>
</p>
</item>
<item>
<p>
Next and previous heading at level 1:
<keyseq><key>1</key></keyseq> and
<keyseq><key>Shift</key><key>1</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of headings at level 1:
<keyseq><key>Alt</key><key>Shift</key><key>1</key></keyseq>
</p>
</item>
<item>
<p>
Next and previous heading at level 2:
<keyseq><key>2</key></keyseq> and
<keyseq><key>Shift</key><key>2</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of headings at level 2:
<keyseq><key>Alt</key><key>Shift</key><key>2</key></keyseq>
</p>
</item>
<item>
<p>
Next and previous heading at level 3:
<keyseq><key>3</key></keyseq> and
<keyseq><key>Shift</key><key>3</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of headings at level 3:
<keyseq><key>Alt</key><key>Shift</key><key>3</key></keyseq>
</p>
</item>
<item>
<p>
Next and previous heading at level 4:
<keyseq><key>4</key></keyseq> and
<keyseq><key>Shift</key><key>4</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of headings at level 4:
<keyseq><key>Alt</key><key>Shift</key><key>4</key></keyseq>
</p>
</item>
<item>
<p>
Next and previous heading at level 5:
<keyseq><key>5</key></keyseq> and
<keyseq><key>Shift</key><key>5</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of headings at level 5:
<keyseq><key>Alt</key><key>Shift</key><key>5</key></keyseq>
</p>
</item>
<item>
<p>
Next and previous heading at level 6:
<keyseq><key>6</key></keyseq> and
<keyseq><key>Shift</key><key>6</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of headings at level 6:
<keyseq><key>Alt</key><key>Shift</key><key>6</key></keyseq>
</p>
</item>
</list>
</section>
<section id="forms">
<title>Forms</title>
<list>
<item>
<p>
Next and previous form field:
<keyseq><key>F</key></keyseq> and
<keyseq><key>Shift</key><key>F</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of form fields:
<keyseq><key>Alt</key><key>Shift</key><key>F</key></keyseq>
</p>
</item>
<item>
<p>
Next and previous button:
<keyseq><key>B</key></keyseq> and
<keyseq><key>Shift</key><key>B</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of buttons:
<keyseq><key>Alt</key><key>Shift</key><key>B</key></keyseq>
</p>
</item>
<item>
<p>
Next and previous combo box:
<keyseq><key>C</key></keyseq> and
<keyseq><key>Shift</key><key>C</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of combo boxes:
<keyseq><key>Alt</key><key>Shift</key><key>C</key></keyseq>
</p>
</item>
<item>
<p>
Next and previous entry:
<keyseq><key>E</key></keyseq> and
<keyseq><key>Shift</key><key>E</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of entries:
<keyseq><key>Alt</key><key>Shift</key><key>E</key></keyseq>
</p>
</item>
<item>
<p>
Next and previous radio button:
<keyseq><key>R</key></keyseq> and
<keyseq><key>Shift</key><key>R</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of radio buttons:
<keyseq><key>Alt</key><key>Shift</key><key>R</key></keyseq>
</p>
</item>
<item>
<p>
Next and previous checkbox:
<keyseq><key>X</key></keyseq> and
<keyseq><key>Shift</key><key>X</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of checkboxes:
<keyseq><key>Alt</key><key>Shift</key><key>X</key></keyseq>
</p>
</item>
</list>
</section>
<section id="links">
<title>Links</title>
<list>
<item>
<p>
Next and previous link:
<keyseq><key>K</key></keyseq> and
<keyseq><key>Shift</key><key>K</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of links:
<keyseq><key>Alt</key><key>Shift</key><key>K</key></keyseq>
</p>
</item>
<item>
<p>
Next and previous unvisited link:
<keyseq><key>U</key></keyseq> and
<keyseq><key>Shift</key><key>U</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of unvisited links:
<keyseq><key>Alt</key><key>Shift</key><key>U</key></keyseq>
</p>
</item>
<item>
<p>
Next and previous visited link:
<keyseq><key>V</key></keyseq> and
<keyseq><key>Shift</key><key>V</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of visited links:
<keyseq><key>Alt</key><key>Shift</key><key>V</key></keyseq>
</p>
</item>
</list>
</section>
<section id="lists">
<title>Lists</title>
<list>
<item>
<p>
Next and previous list:
<keyseq><key>L</key></keyseq> and
<keyseq><key>Shift</key><key>L</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of lists:
<keyseq><key>Alt</key><key>Shift</key><key>L</key></keyseq>
</p>
</item>
<item>
<p>
Next and previous list item:
<keyseq><key>I</key></keyseq> and
<keyseq><key>Shift</key><key>I</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of list items:
<keyseq><key>Alt</key><key>Shift</key><key>I</key></keyseq>
</p>
</item>
</list>
</section>
<section id="tables">
<title>Tables</title>
<list>
<item>
<p>
Next and previous table:
<keyseq><key>T</key></keyseq> and
<keyseq><key>Shift</key><key>T</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of tables:
<keyseq><key>Alt</key><key>Shift</key><key>T</key></keyseq>
</p>
</item>
<item>
<p>
Cell on left:
<keyseq><key>Alt</key><key>Shift</key><key>Left</key></keyseq>
</p>
</item>
<item>
<p>
Cell on right:
<keyseq><key>Alt</key><key>Shift</key><key>Right</key></keyseq>
</p>
</item>
<item>
<p>
Cell above:
<keyseq><key>Alt</key><key>Shift</key><key>Up</key></keyseq>
</p>
</item>
<item>
<p>
Cell below:
<keyseq><key>Alt</key><key>Shift</key><key>Down</key></keyseq>
</p>
</item>
<item>
<p>
First cell in table:
<keyseq><key>Alt</key><key>Shift</key><key>Home</key></keyseq>
</p>
</item>
<item>
<p>
Last cell in table:
<keyseq><key>Alt</key><key>Shift</key><key>End</key></keyseq>
</p>
</item>
</list>
</section>
<section id="text_blocks">
<title>Text Blocks</title>
<list>
<item>
<p>
Next and previous paragraph:
<keyseq><key>P</key></keyseq> and
<keyseq><key>Shift</key><key>P</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of paragraphs:
<keyseq><key>Alt</key><key>Shift</key><key>P</key></keyseq>
</p>
</item>
<item>
<p>
Next and previous blockquote:
<keyseq><key>Q</key></keyseq> and
<keyseq><key>Shift</key><key>Q</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of blockquotes:
<keyseq><key>Alt</key><key>Shift</key><key>Q</key></keyseq>
</p>
</item>
<item>
<p>
Next and previous "large object":
<keyseq><key>O</key></keyseq> and
<keyseq><key>Shift</key><key>O</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of "large objects":
<keyseq><key>Alt</key><key>Shift</key><key>O</key></keyseq>
</p>
</item>
</list>
</section>
<section id="other">
<title>Other Elements</title>
<list>
<item>
<p>
Next and previous landmark:
<keyseq><key>M</key></keyseq> and
<keyseq><key>Shift</key><key>M</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of landmarks:
<keyseq><key>Alt</key><key>Shift</key><key>M</key></keyseq>
</p>
</item>
<item>
<p>
Next and previous separator:
<keyseq><key>S</key></keyseq> and
<keyseq><key>Shift</key><key>S</key></keyseq>
</p>
</item>
<item>
<p>
Next and previous "clickable":
<keyseq><key>A</key></keyseq> and
<keyseq><key>Shift</key><key>A</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of "clickables":
<keyseq><key>Alt</key><key>Shift</key><key>A</key></keyseq>
</p>
</item>
<item>
<p>
Next and previous image:
<keyseq><key>G</key></keyseq> and
<keyseq><key>Shift</key><key>G</key></keyseq>
</p>
</item>
<item>
<p>
Display a list of images:
<keyseq><key>Alt</key><key>Shift</key><key>G</key></keyseq>
</p>
</item>
<item>
<p>
Start and end of current container:
<keyseq><key>Shift</key><key>Comma</key></keyseq> and
<keyseq><key>Comma</key></keyseq>
</p>
</item>
</list>
</section>
</page>

57
help/C/commands_table.page Normal file
View File

@ -0,0 +1,57 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="commands_table">
<info>
<link type="next" xref="commands_flat_review" />
<link type="guide" xref="commands#reading_documents" />
<link type="seealso" xref="howto_tables" />
<title type="sort">3. Table Navigation</title>
<title type="link">Table Navigation</title>
<desc>
Commands for accessing tabular information
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Table Navigation Commands</title>
<p>
Orca's support for navigation by table cell is part of its
<link xref="commands_structural_navigation#tables">Structural Navigation
commands</link>. In addition you can:
</p>
<list>
<item>
<p>
Set dynamic row headers to current column:
<keyseq><key>Orca Modifier</key><key>C</key></keyseq>
</p>
</item>
<item>
<p>
Set dynamic column headers to current row:
<keyseq><key>Orca Modifier</key><key>R</key></keyseq>
</p>
</item>
<item>
<p>
Clear dynamic row headers:
<keyseq><key>Orca Modifier</key><key>C</key></keyseq> (double-clicked)
</p>
</item>
<item>
<p>
Clear dynamic column headers:
<keyseq><key>Orca Modifier</key><key>R</key></keyseq> (double-clicked)
</p>
</item>
<item>
<p>
Toggle between cell and row reading in a table:
<keyseq><key>Orca Modifier</key><key>F11</key></keyseq>
</p>
</item>
</list>
</page>

63
help/C/commands_time_date_notifications.page Normal file
View File

@ -0,0 +1,63 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="commands_time_date_notifications">
<info>
<link type="next" xref="commands_profiles" />
<link type="guide" xref="commands#getting_started" />
<link type="seealso" xref="howto_notifications" />
<title type="sort">4. Time, Date, and Notification</title>
<title type="link">Time, Date, and Notification</title>
<desc>
Commands for getting the time, date, and notification messages
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Time, Date, and Notification Commands</title>
<p>
The following commands can be used to obtain the current time and date
and to review previously-displayed notification messages:
</p>
<section id="time_and_date">
<title>Obtaining the Time and Date</title>
<list>
<item>
<p>
Present the time: <keyseq><key>Orca Modifier</key><key>T</key></keyseq>
</p>
</item>
<item>
<p>
Present the date: <keyseq><key>Orca Modifier</key><key>T</key></keyseq>
(double-clicked)
</p>
</item>
</list>
</section>
<section id="notifications">
<title>Reviewing Notification Messages</title>
<p>
Orca has three unbound commands for accessing previously-displayed
<link xref="howto_notifications">notification messages</link>. Please
see <link xref="howto_key_bindings">Modifying Keybindings</link> for
information on how to bind these commands to keystrokes.
</p>
<list>
<item>
<p>Present the last (most recent) notification message: (Unbound)</p>
</item>
<item>
<p>Present the previous notification message: (Unbound)</p>
</item>
<item>
<p>Present the next notification message: (Unbound)</p>
</item>
<item>
<p>Present list of all notification messages: (Unbound)</p>
</item>
</list>
</section>
</page>

97
help/C/commands_where_am_i.page Normal file
View File

@ -0,0 +1,97 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="commands_where_am_i">
<info>
<link type="next" xref="commands_time_date_notifications" />
<link type="guide" xref="commands#getting_started" />
<link type="seealso" xref="howto_whereami" />
<title type="sort">3. Where Am I</title>
<title type="link">Where Am I</title>
<desc>
Commands to learn about your location
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Where Am I Commands</title>
<p>
<app>Orca</app>'s Where Am I feature gives you context-sensitive details
about your present location. For instance, in tables, Where Am I will give
you details about the table cell you are in, but in text it will present
the current line along with any text which happens to be selected. The full
list of what you can expect <app>Orca</app> to present can be found in the
<link xref="howto_whereami">Introduction to Where Am I</link>.
</p>
<p><app>Orca</app> provides the following Where Am I commands:</p>
<list>
<item>
<p>Perform basic Where Am I:</p>
<list>
<item>
<p>Desktop: <key>KP Enter</key></p>
</item>
<item>
<p>Laptop: <keyseq><key>Orca Modifier</key><key>Return</key></keyseq></p>
</item>
</list>
</item>
<item>
<p>Perform detailed Where Am I:</p>
<list>
<item>
<p>Desktop: <key>KP Enter</key> (double-clicked)</p>
</item>
<item>
<p>
Laptop: <keyseq><key>Orca Modifier</key><key>Return</key></keyseq>
(double-clicked)
</p>
</item>
</list>
</item>
</list>
<p>
In addition to the dedicated Where Am I commands, <app>Orca</app> has
additional commands related to obtaining information about your present location:
</p>
<list>
<item>
<p>Present the title bar:</p>
<list>
<item>
<p>
Desktop: <keyseq><key>Orca Modifier</key><key>KP Enter</key></keyseq>
</p>
</item>
<item>
<p>
Laptop: <keyseq><key>Orca Modifier</key><key>Slash</key></keyseq>
</p>
</item>
</list>
</item>
<item>
<p>Present the status bar:</p>
<list>
<item>
<p>
Desktop: <keyseq><key>Orca Modifier</key><key>KP Enter</key></keyseq>
(double-clicked)
</p>
</item>
<item>
<p>
Laptop: <keyseq><key>Orca Modifier</key><key>Slash</key></keyseq>
(double-clicked)
</p>
</item>
<item>
<p>Present size and location of current object in pixels: (Unbound)</p>
</item>
</list>
</item>
</list>
</page>

BIN
help/C/figures/orca-logo.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.2 KiB

54
help/C/howto_bookmarks.page Normal file
View File

@ -0,0 +1,54 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_bookmarks">
<info>
<link type="guide" xref="index#reviewing"/>
<title type="sort">6. Bookmarks</title>
<desc>Storing and retrieving objects</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Bookmarks</title>
<p>
<app>Orca</app>'s Bookmarks support allows you to indicate that an object
is of interest. It includes the following features:
</p>
<list>
<item>
<p>
You are not limited to a single object: You can set up to six bookmarks
per environment. You can also save bookmarks so that they will persist
from Orca session to Orca session.
</p>
</item>
<item>
<p>
Having set a bookmark you can navigate to it later, and do so regardless
of whether or not you have chosen to permanently save the bookmarks
associated with your current environment. Navigation can be based on the
number of the bookmark should you wish to jump directly to a specific
item. Alternatively, you can navigate to the next or previous bookmark
just like you can a <link xref="howto_structural_navigation">Structural
Navigation</link> object.
</p>
</item>
<item>
<p>
Bookmarkable objects can be widgets within an application or objects on
the web page you are reading. Which environment you are in determines
what happens as you navigate amongst bookmarks: If you are in web
content, the caret will be moved to the bookmark so that you can
continue reading; otherwise, <link xref="howto_flat_review">Flat
Review</link> will be activated with the bookmark becoming the current
review item.
</p>
</item>
</list>
<p>
The specific keybindings associated with each of the above tasks can be
found in <link xref="commands_bookmarks">Bookmark Commands</link>.
</p>
</page>

67
help/C/howto_documents.page Normal file
View File

@ -0,0 +1,67 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_documents">
<info>
<link type="guide" xref="index#reading"/>
<link type="next" xref="howto_text_attributes" />
<title type="sort">1. Documents</title>
<desc>
Reading content
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Documents</title>
<p>
To read the contents of any document, use the application's built-in caret
navigation mode. As you navigate within the text of the document, <app>Orca</app>
will present your new location. As a result, you are likely already familiar with
how to read a document using <app>Orca</app>. For instance:
</p>
<list>
<item>
<p>
Use <key>Left</key> and <key>Right</key> to move and read by character.
</p>
</item>
<item>
<p>
Use <keyseq><key>Ctrl</key><key>Left</key></keyseq> and
<keyseq><key>Ctrl</key><key>Right</key></keyseq> to move and read by word.
</p>
</item>
<item>
<p>
Use <key>Up</key> and <key>Down</key> to move and read by line.
</p>
</item>
<item>
<p>
Use <key>Shift</key> in combination with the above commands to select and
unselect text.
</p>
</item>
</list>
<note style="tip">
<title>Enabling Caret Navigation in an Application</title>
<p>
Not all applications have caret navigation enabled by default. For many GNOME
applications, caret navigation can be toggled on and off by pressing <key>F7</key>.
</p>
</note>
<p>
In addition to reading a document by caret navigation, you may find it helpful
to read, spell, and obtain the Unicode value for the current text. You can do
these things through <app>Orca</app>'s <link xref="howto_flat_review">Flat
Review feature</link>.
</p>
<p>
Finally, in order to have <app>Orca</app> speak the entire document from your
present location, use the Say All command. It, along with a more complete
listing of <app>Orca</app>'s commands for accessing document text, can
be found in the <link xref="commands_reading">Reading Commands</link> guide.
</p>
</page>

46
help/C/howto_flat_review.page Normal file
View File

@ -0,0 +1,46 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_flat_review">
<info>
<link type="guide" xref="index#reviewing"/>
<link type="next" xref="howto_orca_find" />
<title type="sort">2. Flat Review</title>
<desc>Examining a window spatially</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Flat Review</title>
<p>
<app>Orca</app>'s Flat Review feature allows you to spatially review the
contents, both text and widgets, of the active window. In this mode,
<app>Orca</app> treats the window as if it were a two-dimensional sheet of
text, eliminating any notion of widget hierarchy or other logical grouping
within the window.
</p>
<p>
The "flattened" contents, also known as the Flat Review context, can be
<link xref="commands_flat_review">navigated</link> by line, by word, by
character, and by object. In addition, you can perform a left-click or
right-click on the object being reviewed. Finally, you can use
<link xref="howto_orca_find">Orca Find</link>, a Flat-Review-based feature
to search the active window's contents.
</p>
<p>
Because the Flat Review context is a spatial representation of the active
window's contents, it is created when you first enter Flat Review and only
contains those objects which are visible. As a result, you will not be able
to use Flat Review to access items which are in the window but currently
off-screen. In addition, if the window's contents change of their own
accord, the Flat Review context will not automatically be updated. You can
cause a new context to be built by toggling Flat Review off and back on.
</p>
<p>
Finally, Flat Review by its nature is a mode that cannot be used at the same
time that <app>Orca</app> is tracking focus. Thus if you are in Flat Review
and then use the application's navigation commands to move the caret or to
give focus to another object, you will automatically leave Flat Review.
</p>
</page>

95
help/C/howto_forms.page Normal file
View File

@ -0,0 +1,95 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_forms">
<info>
<link type="guide" xref="index#reading"/>
<link type="next" xref="howto_live_regions" />
<title type="sort">5. Filling out forms</title>
<desc>
Accessing widgets embedded in documents
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Filling out forms</title>
<p>
When interacting with web pages and other documents using <app>Orca</app>,
you are interacting with the document itself; not a buffered copy of that
document. <app>Orca</app>'s browse and focus modes let you switch between
reading and filling out forms.
</p>
<section id="navigating_amongst_form_fields">
<title>Navigating Amongst Form Fields</title>
<p>
To navigate amongst form fields, you have several options:
</p>
<list>
<item>
<p>
Use <key>Tab</key> and <keyseq><key>Shift</key><key>Tab</key></keyseq>
to navigate amongst focusable objects, regardless of type.
</p>
</item>
<item>
<p>
Use <app>Orca</app>'s <link xref="commands_structural_navigation#forms">
structural navigation commands for forms</link>.
</p>
</item>
<item>
<p>
Depending on the form and the application, you may also be
able to use the arrow keys to navigate to a given form field.
</p>
</item>
</list>
<note style="tip">
<p>
In order to use <app>Orca</app>'s caret navigation or structural navigation
commands to navigate to a form field, you must be in browse mode. If you are
in focus mode, you can switch to browse mode by pressing <keyseq><key>Orca
Modifier</key><key>A</key></keyseq>.
</p>
</note>
</section>
<section id="exiting_form_fields">
<title>Exiting Form Fields</title>
<p>
To exit a form field, you have several options:
</p>
<list>
<item>
<p>
Use <key>Tab</key>/<keyseq><key>Shift</key><key>Tab</key></keyseq>
if you wish to leave the currently-focused form field and move to the
next/previous focusable object, regardless of type.
</p>
</item>
<item>
<p>
Use <app>Orca</app>'s <link xref="commands_structural_navigation#forms">
structural navigation commands for forms</link> to move to the next or
previous form field.
</p>
</item>
<item>
<p>
Depending on the form and the application, you may also be
able to use the arrow keys to navigate out of a given form field.
</p>
</item>
</list>
<note style="tip">
<p>
In order to use <app>Orca</app>'s caret navigation or structural navigation
commands to exit a form field, you must be in browse mode. If you are in
focus mode, you can switch to browse mode by pressing <keyseq><key>Orca
Modifier</key><key>A</key></keyseq>.
</p>
</note>
</section>
</page>

141
help/C/howto_key_bindings.page Normal file
View File

@ -0,0 +1,141 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_key_bindings">
<info>
<link type="guide" xref="index#getting_started"/>
<link type="next" xref="howto_profiles" />
<title type="sort">8. Keybindings</title>
<desc>Binding, rebinding, and unbinding commands</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Keybindings</title>
<p>
Orca has many commands, some of which are bound to a keystroke, others
of which are unbound. You can bind, rebind, and unbind <app>Orca</app>'s
commands by following the steps below.</p>
<steps>
<title>Binding an Unbound Command</title>
<item>
<p>
Get into the <link xref="preferences">Orca Preferences</link> dialog
by pressing <keyseq><key>Orca Modifier</key><key>Space</key></keyseq>.
</p>
</item>
<item>
<p>Move to the <gui>Key Bindings</gui> page.</p>
</item>
<item>
<p>
Arrow to the cell which contains the command you want to assign a
keystroke to.
</p>
</item>
<item>
<p>
Arrow once to the right. This will place focus in the <gui>Key
Binding</gui> column. Press <key>Return</key>.
</p>
</item>
<item>
<p>Press the desired key combination.</p></item>
<item>
<p>
Press <key>Return</key> to confirm the new combination. The new
keystroke will be saved and the check box in the last column (the
<gui>Modified</gui> column) will indicate that the key binding
has been modified.
</p>
</item>
<item>
<p>Press the <gui>Apply</gui> button.</p>
</item>
</steps>
<steps>
<title>Changing Existing Bindings</title>
<item>
<p>
Get into the <link xref="preferences">Orca Preferences</link> dialog by
pressing <keyseq><key>Orca Modifier</key><key>Space</key></keyseq>.
</p>
</item>
<item>
<p>Move to the <gui>Key Bindings</gui> page.</p>
</item>
<item>
<p>
Arrow to the cell which contains the binding you which to change and
press <key>Return</key>.
</p>
</item>
<item>
<p>Press the desired key combination.</p>
</item>
<item>
<p>
Press <key>Return</key> to confirm the new combination. The new
keystroke will be saved and the check box in the last column (the
<gui>Modified</gui> column) will indicate that the key binding has
been modified.
</p>
</item>
<item>
<p>Press the <gui>Apply</gui> button.</p>
</item>
</steps>
<steps>
<title>Restoring Original Bindings</title>
<item>
<p>
Get into the <link xref="preferences">Orca Preferences</link> dialog by
pressing <keyseq><key>Orca Modifier</key><key>Space</key></keyseq>.
</p>
</item>
<item>
<p>Move to the <gui>Key Bindings</gui> page.</p>
</item>
<item>
<p>Arrow to the modified column associated with the key binding.</p>
</item>
<item>
<p>Uncheck the checkbox by pressing <key>Space</key>.</p>
</item>
<item>
<p>Press the <gui>Apply</gui> button.</p>
</item>
</steps>
<steps>
<title>Unbinding Bound Commands</title>
<item>
<p>
Get into the <link xref="preferences">Orca Preferences</link> dialog by
pressing <keyseq><key>Orca Modifier</key><key>Space</key></keyseq>.
</p>
</item>
<item>
<p>Move to the <gui>Key Bindings</gui> page.</p>
</item>
<item>
<p>
Arrow to the cell which contains the binding you which to delete
and press <key>Return</key>.
</p>
</item>
<item>
<p>
When prompted for the new keybinding, press <key>Delete</key> or
<key>BackSpace</key>. You will be told that the key binding has
been removed.
</p>
</item>
<item>
<p>Press <key>Return</key> to confirm.</p>
</item>
<item>
<p>Press the <gui>Apply</gui> button.</p>
</item>
</steps>
</page>

62
help/C/howto_keyboard_layout.page Normal file
View File

@ -0,0 +1,62 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_keyboard_layout">
<info>
<link type="guide" xref="index#getting_started"/>
<link type="next" xref="howto_toggling_caps_lock" />
<title type="sort">6. Keyboard Layout</title>
<desc>Selecting the Desktop or Laptop layout</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Keyboard Layout</title>
<p>
Orca has two keyboard layouts: Desktop (i.e. with a numeric keypad) and
Laptop. The layout you choose impacts which key is used as the Orca Modifier.
</p>
<list>
<item>
<p>
If you are using the Laptop layout, the default Orca Modifier will be
<key>CapsLock</key>
</p>
</item>
<item>
<p>
If you are using the Desktop layout, the Orca Modifier will be both
<key>Insert</key> and <key>KP_Insert</key>, the latter being the
same key as <key>KP_0</key>.
</p>
</item>
</list>
<p>
The layout also determines the keystrokes associated with a number of
<app>Orca</app>'s commands, especially in the areas of Flat Review,
Where Am I, and Say All.
</p>
<steps>
<title>
Changing Your Keyboard Layout
</title>
<item>
<p>
Get into the <link xref="preferences">Orca Preferences</link> dialog
by pressing <keyseq><key>Orca Modifier</key><key>Space</key></keyseq>.
</p>
</item>
<item>
<p>
Move to the <gui>Keyboard Layout</gui> group of radio buttons.
</p>
</item>
<item>
<p>Arrow to the desired layout.</p>
</item>
<item>
<p>Press the <gui>Apply</gui> button.</p>
</item>
</steps>
</page>

69
help/C/howto_learn_modes.page Normal file
View File

@ -0,0 +1,69 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_learn_modes">
<info>
<link type="guide" xref="index#getting_started" />
<link type="next" xref="howto_keyboard_layout" />
<title type="sort">5. Learn Mode</title>
<desc>
Discovering <app>Orca</app>'s commands
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Learn Mode</title>
<p>
In Learn Mode, <app>Orca</app> will announce each keystroke you pressed
along with any associated <app>Orca</app> command that keystroke is bound
to. In this mode, you can also get a list of shortcuts containing all the
<app>Orca</app> commands you can use.
</p>
<steps>
<title>Using Learn Mode</title>
<item>
<p>
Get into Learn Mode by pressing <keyseq><key>Orca Modifier</key>
<key>H</key></keyseq>.
</p>
</item>
<item>
<p>
Press any key or keystroke. <app>Orca</app> will announce the keys and
any associated command.
</p>
</item>
<item>
<p>Press <key>Esc</key> to exit Learn Mode.</p>
</item>
</steps>
<steps>
<title>Getting a List of Shortcuts</title>
<item>
<p>
Get into Learn Mode by pressing <keyseq><key>Orca Modifier</key>
<key>H</key></keyseq>.
</p>
</item>
<item>
<p>
Press <key>F2</key> if you want a list of shortcuts that apply
<app>Orca</app>-wide, or press <key>F3</key> if you want a list
of shortcuts that are specifically for the application with focus.
</p>
</item>
<item>
<p>
Press <key>Up</key> or <key>Down</key> to examine the contents of the
list.
</p>
</item>
<item>
<p>
Press <key>Esc</key> to exit the list.
</p>
</item>
</steps>
</page>

60
help/C/howto_live_regions.page Normal file
View File

@ -0,0 +1,60 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_live_regions">
<info>
<link type="guide" xref="index#reading"/>
<link type="next" xref="howto_whereami" />
<title type="sort">6. Live Regions</title>
<desc>
Interacting with dynamic web content
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Live Regions</title>
<p>
A live region is a dynamically-updated portion of a web page, such as a
table of sports statistics, a list of current stock prices, a log from
a chat, or an alert displayed by the page you are reading. While live
regions appear quite frequently, fully accessible web pages with live
regions are encountered less often. This problem is actively being
addressed by a number of organizations.
</p>
<section id="politeness_levels">
<title>Live Region Politeness Levels</title>
<p>
Live regions have an associated "politeness" level which is set by the
author as a means to convey the importance of the information and to
suggest when users should be informed by their assistive technology of
updates made within that region. Live regions can be "off", "polite", or
"assertive" to the point of being "rude."
</p>
</section>
<section id="orca_support">
<title><app>Orca</app>'s Support for Live Regions</title>
<p>
Because you might not agree with the politeness level specified by the
author whose page you are viewing, <app>Orca</app> provides a number of
<link xref="commands_live_regions">live region commands</link> which
allow you to modify the level of any or all of the regions on a page.
In addition, you can:
</p>
<list>
<item>
<p>Turn live region support on or off</p>
</item>
<item>
<p>Jump to the next and previous live region spatially</p>
</item>
<item>
<p>Jump to the last live region which presented information</p>
</item>
<item>
<p>Review the last nine live region messages which were presented</p>
</item>
</list>
</section>
</page>

50
help/C/howto_mouse_review.page Normal file
View File

@ -0,0 +1,50 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_mouse_review">
<info>
<link type="guide" xref="index#reviewing"/>
<link type="next" xref="howto_notifications" />
<title type="sort">4. Mouse Review</title>
<desc>Using the pointer to examine the screen</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Mouse Review</title>
<p>
<app>Orca</app>'s Mouse Review feature causes <app>Orca</app> to present
the object under the mouse pointer. Unlike <app>Orca</app>'s
<link xref="howto_flat_review">Flat Review</link> feature, Mouse Review
is not limited to the active window; instead, <app>Orca</app> will attempt
to identify what accessible object, if any, is visually under the pointer
as you move the mouse. If you have moved the pointer over an accessible
object with information to present, <app>Orca</app> will present that object
and its information to you.
</p>
<p>
Because enabling Mouse Review causes <app>Orca</app> to listen for, and then
process, all changes in the position of the Mouse Pointer, this feature is
disabled by default. To have it always enabled, check the <gui>Speak object
under mouse</gui> checkbox found on the
<link xref="preferences_general">General page of <app>Orca</app>'s
Preferences dialog</link>. In addition, you will find an unbound command
named <gui>Toggle mouse review mode</gui> on the
<link xref="preferences_key_bindings">Key Bindings page</link> of that same
dialog box. By binding this command, as described in the
<link xref="howto_key_bindings">Introduction to Key Bindings</link>,
you can enable and disable Mouse Review on an as-needed basis.
</p>
<note style="tip">
<title>
Default Settings and Keybindings Are Independent of One Another
</title>
<p>
Note that you can choose to have Mouse Review always enabled or not and
still toggle it on and off by binding and using the <gui>Toggle mouse
review mode</gui> command. It is not necessary to enable it in order to
toggle it because settings and keybindings are independent of one another.
</p>
</note>
</page>

69
help/C/howto_notifications.page Normal file
View File

@ -0,0 +1,69 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_notifications">
<info>
<link type="guide" xref="index#reviewing"/>
<link type="next" xref="howto_bookmarks" />
<title type="sort">5. Notifications</title>
<desc>Reading previously-received messages</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Notifications</title>
<p>
The GNOME Desktop includes a "notification area" which can be used by
applications to present information to the user. Examples of notifications
include incoming chat messages, the details associated with the song your
media player is starting to play, and warnings that your battery level is
getting low.
</p>
<p>
Because notifications are intended to present information to users without
interrupting what the user is doing, these messages tend to appear and
disappear relatively quickly. They are also not focusable. While
<app>Orca</app> will present these messages to you as they come in, it is
far too easy to interrupt <app>Orca</app>'s announcement accidentally by
continuing to type or to change focus. For this reason, <app>Orca</app> has
three commands which you can use to access previously-displayed notification
messages:
</p>
<list>
<item>
<p>Present the last (most recent) notification message</p>
</item>
<item>
<p>Present the previous notification message</p>
</item>
<item>
<p>Present list of all notification messages</p>
</item>
</list>
<p>
The first two commands are designed mainly for quick access to a message
you just received. The last command is the most powerful as it stores your
notification message history.
</p>
<p>
When you enter the list of notification messages, you will be told the size
of the list and prompted with the following choices:
</p>
<list>
<item><p>Press H for help.</p></item>
<item><p>Use Up, Down, Home or End to navigate in the list.</p></item>
<item><p>Press Escape to exit.</p></item>
<item><p>Press Space to repeat the last message read.</p></item>
<item><p>Press one digit to read a specific message.</p></item>
</list>
<p>
Note that the most recently-received message is at the top of the list.
</p>
<p>
Each of <app>Orca</app>'s notification review commands is unbound by
default. You can bind any or all of them to the shortcut or shortcuts
you choose. How to do so is described in the
<link xref="howto_key_bindings">Introduction to Key Bindings</link>.
</p>
</page>

112
help/C/howto_orca_find.page Normal file
View File

@ -0,0 +1,112 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_orca_find">
<info>
<link type="guide" xref="index#reviewing"/>
<link type="next" xref="howto_mouse_review" />
<title type="sort">3. Orca Find</title>
<desc>Searching a window for objects</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Orca Find</title>
<p>
<app>Orca</app>'s Find feature is a
<link xref="howto_flat_review">Flat-Review</link>-based search designed to
help you quickly locate objects that are visible on-screen within the
current window.
</p>
<note style="tip">
<title>Activating Orca Find</title>
<p>
To open the Orca <gui>Find</gui> dialog, use the following command based
on your chosen <link xref="howto_keyboard_layout">keyboard layout</link>:
</p>
<list>
<item>
<p>Desktop: <keyseq><key>KP Delete</key></keyseq></p>
</item>
<item>
<p>Laptop:
<keyseq><key>Orca Modifier</key><key>Left Bracket</key></keyseq>
</p>
</item>
</list>
<p>
For a list of additional tasks you can perform, see the
<link xref="commands_find">Orca Find commands</link>
</p>
</note>
<p>
When you activate Orca Find, you will be placed in a dialog box.
</p>
<p>
Here you can specify the following items:
</p>
<list>
<item>
<p>The text to find</p>
</item>
<item>
<p>
The location from which to begin the search, which can either be
the current location or the top of the window
</p>
<p>
Default value of <gui>Start from</gui>: <gui>Current location</gui>
</p>
</item>
<item>
<p>
Whether or not capitalization should be taken into account when seeking
a match
</p>
<p>
Default value of <gui>Match case</gui>: not checked
</p>
</item>
<item>
<p>
Whether or not to limit matches to those which match the entire word
or phrase
</p>
<p>
Default value of <gui>Match entire word only</gui>: not checked
</p>
</item>
<item>
<p>
Whether Find should look down and/or to the right for the next
match or up and/or to the left.
</p>
<p>
Default value of <gui>Search backwards</gui>: not checked
</p>
</item>
<item>
<p>
Whether or not Find should wrap around to the top/bottom of the window
if there is no match found from the starting location in the direction
of the search.
</p>
<p>
Default value of <gui>Wrap around</gui>: checked
</p>
</item>
</list>
<p>
Having performed a search, you can quickly search for the next or previous
match without having to return to the Orca Find dialog box.
</p>
<p>
Because it is a <link xref="howto_flat_review">Flat Review</link> feature,
when there is a match, Flat Review will automatically be activated and the
matching item or text will become the current review item. Note that focus
within the application will not be modified, nor will the caret be
repositioned. If you need to accomplish either, please see
<link xref="commands_mouse">Orca's Mouse/Pointer-Related Commands</link>.
</p>
</page>

116
help/C/howto_profiles.page Normal file
View File

@ -0,0 +1,116 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_profiles">
<info>
<link type="guide" xref="index#getting_started"/>
<link type="next" xref="howto_documents" />
<title type="sort">9. Profiles</title>
<desc>Maintaining multiple configurations</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Profiles</title>
<p>
Orca's profiles allow you to save and load multiple configurations so
that you can quickly access the settings you need.
</p>
<steps>
<title>Saving a New Profile</title>
<item>
<p>
Get into the <link xref="preferences">Orca Preferences</link> dialog box.
</p>
</item>
<item>
<p>Change whatever settings you wish.</p>
</item>
<item>
<p>
On the <gui>General</gui> page, press the <gui>Save As</gui> button.
</p>
</item>
<item>
<p>
Type the new profile name in the resulting <gui>Save Profile As</gui>
dialog box.
</p>
</item>
<item>
<p>
Press the <gui>OK</gui> button in the <gui>Save Profile As</gui>
dialog box.
</p>
</item>
</steps>
<steps>
<title>Loading an Existing Profile</title>
<item>
<p>
Get into the <link xref="preferences">Orca Preferences</link> dialog box.
</p>
</item>
<item>
<p>
On the <gui>General</gui> page, select the profile to load from the
<gui>Active Profile</gui> combo box.
</p>
</item>
<item>
<p>Press the <gui>Load</gui> button.</p>
</item>
<item>
<p>
You will be asked to confirm. Press the <gui>Yes</gui> button.
</p>
</item>
<item>
<p>Press the <gui>OK</gui> button.</p>
</item>
</steps>
<steps>
<title>Changing an Existing Profile</title>
<item>
<p>
Follow the steps described above to load the profile you wish to change.
</p>
</item>
<item>
<p>Follow the steps described above to save a new profile.</p>
</item>
<item>
<p>
When prompted for the new profile name, type the same name as current
profile. When you press the <gui>OK</gui> button, you will be told there
is a name conflict.
</p>
</item>
<item>
<p>
Press the <gui>Yes</gui> button to confirm you wish to overwrite the
existing profile with the new settings.
</p>
</item>
</steps>
<steps>
<title>Changing the <gui>Start-up Profile</gui></title>
<item>
<p>
Get into the <link xref="preferences">Orca Preferences</link> dialog box.
</p>
</item>
<item>
<p>
On the <gui>General</gui> page, select the profile to load from the
<gui>Start-up Profile</gui> combo box.
</p>
</item>
<item>
<p>Press the <gui>OK</gui> button. The next time you launch <app>Orca</app>,
the newly-selected profile will be used.
</p>
</item>
</steps>
</page>

30
help/C/howto_setting_up_orca.page Normal file
View File

@ -0,0 +1,30 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_setting_up_orca">
<info>
<link type="seealso" xref="preferences" />
<link type="guide" xref="index#getting_started" />
<link type="next" xref="howto_the_orca_modifier" />
<title type="sort">4. Orca Configuration</title>
<title type="link">Configuration</title>
<desc>
Setting up <app>Orca</app>
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Orca Configuration</title>
<p>
If you want to configure <app>Orca</app>, get into the
<link xref="preferences">Preferences</link> dialog by pressing
<keyseq><key>Orca Modifier</key><key>Space</key></keyseq> from
within any accessible application. Alternatively, you can type
<cmd>orca</cmd> followed by either <cmd>-s</cmd> or <cmd>--setup</cmd>
in a terminal window or within the <gui>Run</gui> dialog and then press
<key>Return</key>.
</p>
</page>

123
help/C/howto_structural_navigation.page Normal file
View File

@ -0,0 +1,123 @@
<page xmlns="http://projectmallard.org/1.0/"
type="topic"
id="howto_structural_navigation">
<info>
<link type="guide" xref="index#reading"/>
<link type="next" xref="howto_tables" />
<title type="sort">3. Structural Navigation</title>
<desc>
Moving by heading and other elements
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Structural Navigation</title>
<p>
<app>Orca</app>'s Structural Navigation feature allows you to navigate
amongst elements in a document. The types of elements by which you can
navigate include:
</p>
<list>
<item><p>Headings and other text blocks</p></item>
<item><p>Form controls</p></item>
<item><p>Links</p></item>
<item><p>Lists and list items</p></item>
<item><p>Landmarks, separators, and anchors</p></item>
<item><p>Tables and table cells</p></item>
</list>
<p>
A full list of individual elements and their associated keybindings can
be found in <link xref="commands_structural_navigation">Structural
Navigation Commands</link>.
</p>
<section id="applications">
<title>Supported Applications</title>
<p>
Currently, Structural Navigation is fully implemented for web content,
including the help content you are reading now. <app>Orca</app>'s
Structural Navigation support for table cells has also been implemented
for <app>OpenOffice Writer</app> and <app>LibreOffice Writer</app>.
Implementing the remainder of the Structural Navigation objects to
these office suites requires changes to be made by their respective
developers. Implementing any Structural Navigation features within
<app>Evince</app> will require a similar effort on the part of its
developers.
</p>
<note style="tip">
<title>Don't Forget To Toggle Structural Navigation On!</title>
<p>
Depending on where you are, it may be necessary for you to explicitly
toggle Structural Navigation on before you can use it.
</p>
</note>
<section id="toggling_required">
<title>When Toggling Structural Navigation On Is Required</title>
<p>
In web pages, explicitly toggling Structural Navigation on is
generally unnecessary because your interaction with the document
largely consists of reading its content. Thus there is no question
as to whether the 'H' you just pressed was meant to be a writing
command or a navigation command.
</p>
<p>
On the other hand, in editable documents such as those found in
<app>OpenOffice</app> and <app>LibreOffice</app>, it is far more
difficult for <app>Orca</app> to accurately predict what you expect
to have happen as a result of pressing 'H'. Therefore, before you
can use any Structural Navigation command in an editable document,
you must first toggle Structural Navigation on by pressing
<keyseq><key>Orca Modifier</key><key>Z</key></keyseq>.
When you are finished navigating and ready to resume writing, press
<keyseq><key>Orca Modifier</key><key>Z</key></keyseq> again to toggle
Structural Navigation off.
</p>
</section>
</section>
<section id="settings">
<title>Available Settings</title>
<p>
In addition to the aforementioned commands, <app>Orca</app> has a number
of configurable options available specifically for applications in which
there is structural navigation support.
</p>
<steps>
<title>Configuring Structural Navigation</title>
<item>
<p>
Give focus to an application for which <app>Orca</app> has
Structural Navigation support.
</p>
</item>
<item>
<p>
Get into the <link xref="preferences">Orca Preferences</link>
dialog box for the current application by pressing
<keyseq>
<key>Ctrl</key><key>Orca Modifier</key><key>Space</key>
</keyseq>.
</p>
</item>
<item>
<p>
Navigate to the last page of the dialog box which should be
named according to the name of your current application.
</p>
</item>
<item>
<p>
Examine and change the settings as you see fit.
</p>
</item>
<item>
<p>
Press the <gui>OK</gui> button.
</p>
</item>
</steps>
</section>
</page>

148
help/C/howto_tables.page Normal file
View File

@ -0,0 +1,148 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_tables">
<info>
<link type="guide" xref="index#reading"/>
<link type="next" xref="howto_forms" />
<title type="sort">4. Tables</title>
<desc>
Navigating and setting dynamic headers
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Tables</title>
<p>
<app>Orca</app> provides several features specifically designed to improve
access to tables found in web pages and other documents: configurable cell
versus row reading, <link xref="howto_structural_navigation">Structural
Navigation</link> and Dynamic Headers.
</p>
<section id="cell_row">
<title>Cell Versus Row Reading</title>
<p>
Consider the process of examining the list of messages in your Inbox.
In order to have Orca announce the sender, subject, date, and presence
of attachments you would need <app>Orca</app> to speak the row. On the
other hand, when navigating amongst rows in a spreadsheet, hearing the
full row may not be desired if for no other reason than the sheer number
of cells in each row. Thus in that case, you would want <app>Orca</app>
to only speak the cell with focus. Similar situations occur in document
tables.
</p>
<p>
<app>Orca</app> allows you to customize whether only the cell should be
read, or if the full row should be, for GUI tables, document tables,
and spreadsheets. Because these settings are independent of one another,
you do not have to choose one table reading mode to fit multiple types of
tables.
</p>
<p>
You can set each of <app>Orca</app>'s table reading preferences <app>Orca</app>
wide as well as on an application-by-application basis. How to do each is
described in the guide on <link xref="preferences"><app>Orca</app>'s preferences
dialogs</link>. The settings can be found on the <link xref="preferences_speech">
<gui>Speech</gui> page</link>.
</p>
<p>
Lastly, there is also an <app>Orca</app> command which allows you to toggle
cell versus row reading on the fly for the currently-active table:
<keyseq><key>Orca Modifier</key><key>F11</key></keyseq>.
</p>
</section>
<section id="structural_navigation">
<title>Structural Navigation</title>
<p>
<app>Orca</app>'s <link xref="commands_structural_navigation#tables">table
Structural Navigation commands</link> make it possible for you to quickly
locate tables, jump immediately to a table's first or last cell, and
move to the next cell in any direction.
</p>
<p>
As you navigate amongst and within tables using Structural Navigation,
<app>Orca</app> will announce additional details to help you understand
your position, such as the dimensions of the table you just entered and
the fact that you have reached the edge of the table in the direction you
are moving.
</p>
<p>
In addition, <app>Orca</app> provides configurable
<link xref="preferences_table_navigation">presentation options</link>
which work in conjunction with Structural Navigation and allow you to
control whether or not cell coordinates are presented, multiple cell spans
are indicated, and cell headers are announced.
</p>
<note style="tip">
<title>Don't Forget To Toggle Structural Navigation On!</title>
<p>
Depending on where you are, it may be necessary for you to explicitly
toggle Structural Navigation on before you can use it. To learn more, read
<link xref="howto_structural_navigation#toggling_required">
when toggling Structural Navigation on is required.</link>
</p>
</note>
</section>
<section id="dynamic_headers">
<title>Dynamic Headers</title>
<p>
Many of the tables you will encounter while reading have cells which serve
as the header for a row or a column. Whether or not the creator of that
table correctly marked those cells as headers is hard to say. In many
cases, the text was simply formatted to be larger and/or bold. And even if
the table is correctly marked up, that is no guarantee that the application
or toolkit exposes that text as header information to assistive technologies.
<app>Orca</app>'s Dynamic Header support makes it possible to overcome these
challenges.
</p>
<steps>
<title>Setting Column Headers</title>
<item>
<p>
Move to the row which contains all of the column headers.
</p>
</item>
<item>
<p>
Press <keyseq><key>Orca Modifier</key><key>R</key></keyseq> to tell
<app>Orca</app> that the current row is the one with the headers.
</p>
</item>
</steps>
<steps>
<title>Setting Row Headers</title>
<item>
<p>
Move to the column which contains all of the row headers.
</p>
</item>
<item>
<p>
Press <keyseq><key>Orca Modifier</key><key>C</key></keyseq> to tell
<app>Orca</app> that the current column is the one with the headers.
</p>
</item>
</steps>
<p>
Having set either the column headers or the row headers, you should find
that as you navigate amongst the cells, <app>Orca</app> will present each
header that has changed. Or to put it another way, <app>Orca</app> will
not present the column header over and over again as you move up or down
within the current column. Likewise, it will not present the row header
over and over again as you move left or right within the current row.
However, if you change rows and there are row headers, the header
associated with the new row will be presented. And if you change columns
and there are column headers, the header associated with the new column
will be presented.
</p>
<p>
To clear headers, simply double-click the command you used to set them.
Thus double-clicking <keyseq><key>Orca Modifier</key><key>R</key></keyseq>
tells <app>Orca</app> there are no column headers. Double-clicking
<keyseq><key>Orca Modifier</key><key>C</key></keyseq> tells <app>Orca</app>
there are no row headers.
</p>
</section>
</page>

71
help/C/howto_text_attributes.page Normal file
View File

@ -0,0 +1,71 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_text_attributes">
<info>
<link type="guide" xref="index#reading"/>
<link type="next" xref="howto_structural_navigation" />
<title type="sort">2. Text Attributes</title>
<desc>
Examining text formatting
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Text Attributes</title>
<p>
The term "text attributes" refers to all of the font, style, alignment,
and other formatting associated with a given character or series of
characters.
</p>
<section id="obtaining">
<title>Obtaining Formatting Information</title>
<p>
When you press <keyseq><key>Orca Modifier</key><key>F</key>
</keyseq>, <app>Orca</app> will speak known text attribute
information about an object. In addition, <app>Orca</app>
will optionally indicate text attributes in braille by
"underlining" them as you navigate a document.
</p>
<p>
Because the number of text attributes is large, and not everyone cares
about every attribute, the <link xref="preferences_text_attributes">
Text Attributes page of the preferences dialog</link> allows you to
customize which text attributes <app>Orca</app> will present in speech,
along with the order in which they should be presented, and which ones
<app>Orca</app> will indicate in braille.
</p>
<p>
Because the <link xref="preferences_text_attributes">Text Attributes
page</link> is also part of the application-specific settings, you can
customize text attribute presentation on an as-needed basis for each
application you use.
</p>
</section>
<section id="identifying_misspelled_words">
<title>Identifying Misspelled Words</title>
<p>
Most applications and toolkits indicate that a word is misspelled by
underlining that word with a red, squiggly line. The presence of this line
is typically exposed to assistive technologies as a text attribute. As a
result, you will find spelling errors amongst the text attributes you can
choose. By default, the spelling error attribute is enabled for both
speech and braille and will therefore be presented along with any other
attributes whose indication you have enabled.
</p>
<p>
In addition to accessing the presence of spelling errors as a text
attribute, if you have key echo and/or word echo enabled and type a
word which is misspelled, when the spelling error indication appears,
<app>Orca</app> will announce "misspelled" so that you can immediately go
back and correct the error.
</p>
<p>
Finally, when you are navigating within a document and the caret moves
into a word which is misspelled, <app>Orca</app> will announce the
presence of the spelling error.
</p>
</section>
</page>

75
help/C/howto_the_orca_modifier.page Normal file
View File

@ -0,0 +1,75 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_the_orca_modifier">
<info>
<link type="guide" xref="index#getting_started"/>
<link type="next" xref="howto_learn_modes" />
<title type="sort">3. The Orca Modifier</title>
<desc>
A key that works like <key>Shift</key>, <key>Ctrl</key>,
and <key>Alt</key>
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>The Orca Modifier</title>
<p>
Orca has a special modifier key that works like <key>Shift</key>,
<key>Ctrl</key>, and <key>Alt</key>. It is designed specifically
for performing <app>Orca</app> commands and doing so without
introducing conflicts with the commands of the applications you
are accessing.
</p>
<p>
Which key the "Orca Modifier" is bound to will, by default, depend
on whether you are using <app>Orca</app>'s Laptop keyboard layout
or its Desktop keyboard layout:
</p>
<list>
<item>
<p>
If you are using the Laptop layout, the default Orca Modifier
will be <key>CapsLock</key>
</p>
</item>
<item>
<p>
If you are using the Desktop layout, the Orca Modifier will
be both <key>Insert</key> and <key>KP_Insert</key>, the
latter being the same key as <key>KP_0</key>.
</p>
</item>
</list>
<p>
If you want to maintain your current keyboard layout but select a different
modifier key, you can do so by performing the following steps:
</p>
<steps>
<title>Changing the Orca Modifier</title>
<item>
<p>
Get into the <link xref="preferences">Orca Preferences</link> dialog by
pressing <keyseq><key>Orca Modifier</key><key>Space</key></keyseq>. Alternatively, you can start Orca with the preferences dialog open from a terminal: type <cmd>orca -s</cmd> and press <key>Return</key>.
</p>
</item>
<item>
<p>Move to the <gui>Key Bindings</gui> page.</p>
</item>
<item>
<p>Move to the <gui>Screen Reader Modifier Key(s)</gui> combobox.</p>
</item>
<item>
<p>Arrow to the desired modifier. The available options are:</p>
<list>
<item><p>Insert, KP_Insert</p></item>
<item><p>KP_Insert</p></item>
<item><p>Insert</p></item>
<item><p>Caps_Lock</p></item>
</list>
</item>
<item><p>Press the <gui>Apply</gui> button.</p></item>
</steps>
</page>

37
help/C/howto_toggling_caps_lock.page Normal file
View File

@ -0,0 +1,37 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_toggling_caps_lock">
<info>
<link type="guide" xref="index#getting_started"/>
<link type="next" xref="howto_key_bindings" />
<title type="sort">7. CapsLock in Laptop Layout</title>
<desc>Toggling it when it is the <key>Orca Modifier</key></desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>CapsLock in Laptop Layout</title>
<p>
Orca has two keyboard layouts: Desktop and Laptop. The layout you choose
impacts which key is used as the Orca Modifier. If you are using the Laptop
layout, the default Orca Modifier will be <key>CapsLock</key>. If you are
using <app>Orca</app>'s Laptop Layout and want to lock or unlock
<key>CapsLock</key>, you can do so by either pressing <key>CapsLock</key>
twice (requires at-spi2 version 2.32 or later), or by performing the
following steps:
</p>
<steps>
<title>Toggling CapsLock in Laptop Layout</title>
<item>
<p>
Press the Bypass command, <keyseq><key>Orca Modifier</key><key>BackSpace</key>
</keyseq>, to tell <app>Orca</app> that the next command should be ignored.
</p>
</item>
<item>
<p>Press <key>CapsLock</key> to toggle its locked state.</p>
</item>
</steps>
</page>

110
help/C/howto_whereami.page Normal file
View File

@ -0,0 +1,110 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_whereami">
<info>
<link type="guide" xref="index#reviewing"/>
<link type="next" xref="howto_flat_review" />
<title type="sort">1. Where Am I</title>
<desc>
Learning about your location
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Where Am I</title>
<p>
In addition to dedicated commands for reading the title bar and the
status bar, Orca provides two context-sensitive Where Am I commands:
Basic Where Am I and Detailed Where Am I. Basic Where Am I is implemented
for all objects. Detailed Where Am I is implemented just for those objects
for which there is a significant amount of information you may wish to know,
but likely will not wish to know all of the time.
</p>
<p>
The best way to become familiar with what Where Am I will present is to
give the <link xref="commands_where_am_i">Where Am I commands</link> a
try. However, to give you a better idea of the context-sensitive nature
of <app>Orca</app>'s Where Am I feature, consider the following:
</p>
<p>
For most widgets, you will at least be told the label and/or name, the
type or role of the widget, and the mnemonic and/or accelerator key if
they happen to exist. In addition:
</p>
<list>
<item>
<p>
If the widget is text, and you perform a basic Where Am I, you will be
told the current line if no text is selected. If text is selected,
however, a basic Where Am I will tell you what text is selected. A
detailed Where Am I within the text will also include the text
attributes.
</p>
</item>
<item>
<p>
If the widget can be checked, as is the case with checkboxes and
radio buttons, the checked state will be included.
</p>
</item>
<item>
<p>
If the widget is a list or list-like object, such as a combo box, radio
button group, or page tab list, the position of the current item will be
included.
</p>
</item>
<item>
<p>
If the widget is hierarchical, such as a tree, and you are on an
expandable node, you will be told if that node is expanded or not.
And if it is expanded, you will also be told how many children it
contains. In addition, the nesting level will also be provided.
</p>
</item>
<item>
<p>
If the widget is a progress bar or a slider, you will be told the
current percent.
</p>
</item>
<item>
<p>
If the widget is an icon within an icon group, a basic Where Am I
will include the object you are in, the item you are on, and the
number of items which are selected. In a detailed Where Am I, you
will also be told which items are selected.
</p>
</item>
<item>
<p>
If you are on a link, the type of link (same site, different site,
FTP link, etc.) will be included.
</p>
</item>
<item>
<p>
If you are in a table cell, the coordinates of that cell and the cell
headers will be included.
</p>
</item>
<item>
<p>
If you are in the spell checker of an application where <app>Orca</app>
provides enhanced support, a basic Where Am I will repeat the error
respecting your <link xref="preferences_spellcheck">spell check
preferences</link>. A detailed Where Am I will cause <app>Orca</app> to
present the full details of the error.
</p>
</item>
</list>
<p>
And so on. Again, the goal of <app>Orca</app>'s Where Am I is to provide
you with the details you are most likely interested in knowing about the
object you are currently in. To give Where Am I a try, see the list of
<link xref="commands_where_am_i">Where Am I commands</link>.
</p>
</page>

47
help/C/index.page Normal file
View File

@ -0,0 +1,47 @@
<page xmlns="http://projectmallard.org/1.0/"
xmlns:its="http://www.w3.org/2005/11/its"
type="guide"
id="index">
<info>
<title type="text">Orca Screen Reader</title>
<title type="link">Introduction to the <app>Orca</app> Screen Reader</title>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
<desc>Orca is a free, open source, flexible, and extensible screen reader
that provides access to the graphical desktop via speech and refreshable
braille.</desc>
</info>
<title>
<media type="image" mime="image/png" src="figures/orca-logo.png" its:translate="no">
<span its:translate="yes"><app>Orca</app>'s logo</span>
</media>
<app>Orca</app> Screen Reader
</title>
<note style="important">
<title>Before You Begin</title>
<p>
If you are not yet familiar with the navigation commands provided by
your desktop environment, you are encouraged to read that documentation
first.
</p>
</note>
<section id="getting_started" style="2column">
<title>Getting Started</title>
</section>
<section id="reading" style="2column">
<title>Reading Documents and Web Pages</title>
</section>
<section id="reviewing" style="2column">
<title>Reviewing and Interacting with Screen Contents</title>
</section>
<section id="quick_reference" style="2column">
<title>Quick Reference</title>
</section>
</page>

138
help/C/introduction.page Normal file
View File

@ -0,0 +1,138 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="introduction">
<info>
<link type="guide" xref="index#getting_started" />
<link type="next" xref="howto_setting_up_orca" />
<title type="sort">1. Welcome to Orca</title>
<desc>
Introducing the <app>Orca</app> screen reader
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Welcome to Orca</title>
<p>
<app>Orca</app> is a free, open source, flexible, and extensible
screen reader that provides access to the graphical desktop via
speech and refreshable braille.
</p>
<p>
<app>Orca</app> works with applications and toolkits that support
the Assistive Technology Service Provider Interface (AT-SPI), which
is the primary assistive technology infrastructure for Linux and
Solaris. Applications and toolkits supporting the AT-SPI include
Gtk+, Qt, Java Swing, LibreOffice, Gecko, WebKitGtk, and Chrome/Chromium.
</p>
<section id="launching">
<title>Launching <app>Orca</app></title>
<p>To launch <app>Orca</app>:</p>
<list>
<item>
<p>
The method for configuring <app>Orca</app> to be launched
automatically as your preferred screen reader will depend upon
which desktop environment you use.
</p>
</item>
<item>
<p>
To toggle <app>Orca</app> on and off in GNOME, press
<keyseq><key>Super</key><key>Alt</key><key>S</key></keyseq>.
</p>
</item>
<item>
<p>
Type <cmd>orca</cmd>, along with any optional parameters, in a
terminal window or within the <gui>Run</gui> dialog and then press
<key>Return</key>.
</p>
</item>
</list>
</section>
<section id="loadtime">
<title>Load-Time Options</title>
<p>
The following options can be specified when launching <app>Orca</app>
in a terminal window or within the <gui>Run</gui> dialog:
</p>
<list>
<item>
<p><cmd>-h</cmd>, <cmd>--help</cmd>: Show the help message</p>
</item>
<item>
<p>
<cmd>-v</cmd>, <cmd>--version</cmd>: Show the version of
<app>Orca</app>
</p>
</item>
<item>
<p>
<cmd>-s</cmd>, <cmd>--setup</cmd>: Set up user preferences
</p>
</item>
<item>
<p>
<cmd>-u</cmd>, <cmd>--user-prefs=<em>dirname</em></cmd>:
Use <em>dirname</em> as the alternate directory for user
preferences
</p>
</item>
<item>
<p>
<cmd>-e</cmd>, <cmd>--enable=<em>option</em></cmd>: Force use
of option, where the <em>option</em> can be one of the following:
</p>
<list>
<item><p><cmd>speech</cmd></p></item>
<item><p><cmd>braille</cmd></p></item>
<item><p><cmd>braille-monitor</cmd></p></item>
</list>
</item>
<item>
<p>
<cmd>-d</cmd>, <cmd>--disable=<em>option</em></cmd>: Prevent the
use of an option, where the <em>option</em> can be one of the
following:
</p>
<list>
<item><p><cmd>speech</cmd></p></item>
<item><p><cmd>braille</cmd></p></item>
<item><p><cmd>braille-monitor</cmd></p></item>
</list>
</item>
<item>
<p>
<cmd>-p</cmd>, <cmd>--profile=<em>filename</em></cmd>:
Import a profile from a given <app>Orca</app> profile file
</p>
</item>
<item>
<p>
<cmd>-r</cmd>, <cmd>--replace</cmd>: Replace a currently-running <app>Orca</app>
</p>
</item>
<item>
<p>
<cmd>-l</cmd>, <cmd>--list-apps</cmd>: Print the known running
applications
</p>
</item>
<item>
<p>
<cmd>--debug</cmd>: Send debug output to debug-YYYY-MM-DD-HH:MM:SS.out
</p>
</item>
<item>
<p>
<cmd>--debug-file=<em>filename</em></cmd>: Send debug output to
the specified file
</p>
</item>
</list>
</section>
</page>

21
help/C/preferences.page Normal file
View File

@ -0,0 +1,21 @@
<page xmlns="http://projectmallard.org/1.0/" type="guide" id="preferences">
<info>
<link type="next" xref="preferences_introduction" />
<link type="guide" xref="index#quick_reference" />
<title type="link">Preferences</title>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title><app>Orca</app>'s Preferences Dialogs</title>
<section id="orca" style="2column">
<title>Orca Preferences</title>
</section>
<section id="application" style="2column">
<title>Application-Unique Preferences</title>
</section>
</page>

183
help/C/preferences_braille.page Normal file
View File

@ -0,0 +1,183 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="preferences_braille">
<info>
<title type="sort">3. Braille</title>
<title type="link">Braille</title>
<desc>
Configuring <app>Orca</app>'s braille display support
</desc>
<link type="guide" xref="preferences#orca" />
<link type="next" xref="preferences_key_echo" />
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Braille Preferences</title>
<section id="braillesupport">
<title>Enable Braille Support</title>
<p>
This check box toggles whether or not <app>Orca</app> will make
use of a braille display. If BrlTTY is not running, <app>Orca</app>
will recover gracefully and will not communicate with the braille
display.
</p>
<p>
Default value: not checked
</p>
<note style="tip">
<p>
If you configure BrlTTY later on, you need to restart <app>Orca</app>
in order to use braille.
</p>
</note>
</section>
<section id="braillewordwrap">
<title>Enable word wrap</title>
<p>
If <gui>Enable word wrap</gui> is checked, <app>Orca</app> will adjust the
text so that only full words are shown on the braille display. If it is not
checked, <app>Orca</app> will use all of the cells on the display so that
more text can be shown at once.
</p>
<p>
Default value: not checked
</p>
</section>
<section id="contractedbraille">
<title>Enable Contracted Braille</title>
<p>
Orca supports contracted braille via the liblouis project. Because many
distros include liblouis, you will likely automatically have access to
contracted braille support in <app>Orca</app>.
</p>
<p>
To enable contracted braille on a system where liblouis has been installed,
be sure that the <gui>Enable Contracted Braille</gui> checkbox is checked.
Then choose your desired translation table from the <gui>Contraction
Table</gui> combo box.
</p>
<p>
Default value: not checked
</p>
</section>
<section id="rolenames">
<title>Abbreviated Role Names</title>
<p>
This check box determines the manner in which role names are
displayed and can be used to help conserve real estate on the
braille display. For instance, if a slider had focus, the word
"slider" would be displayed if abbreviated role names is not
checked; if it were checked, "sldr" would be displayed instead.
</p>
<p>
Default value: not checked
</p>
</section>
<section id="eolindicator">
<title>Disable end of line symbol</title>
<p>
Checking this checkbox tells <app>Orca</app> to not present the
"$l" string at the end of a line of text.
</p>
<p>
Default value: not checked
</p>
</section>
<section id="verbosity">
<title>Verbosity</title>
<p>
This radio button group determines the amount of information that
will be brailled in certain situations. For example, if it is set
to verbose, keyboard shortcut and role name information is displayed.
This information is not displayed in brief mode.
</p>
<p>
Default value: <gui>Verbose</gui>
</p>
</section>
<section id="selectionandhyperlink">
<title>Selection and Hyperlink Indicators</title>
<p>
The <gui>Selection Indicator</gui> and <gui>Hyperlink Indicator</gui>
radio button groups allow you to configure <app>Orca</app>'s behavior
when displaying selected text and hyperlinks. By default, when you
encounter either, <app>Orca</app> will "underline" that text on
your braille display with Dots 7 and 8. If you would prefer, you
can change the indicator to only be Dot 7, only be Dot 8, or not
be present at all.
</p>
<p>
Default value: <gui>Dots 7 and 8</gui>
</p>
<note style="tip">
<title>Text Attribute Indicators</title>
<p>
You can also optionally have text attributes indicated in braille.
Enabling this feature and choosing which attributes are of
interest is done on the <link xref="preferences_text_attributes">
<gui>Text Attributes</gui> page</link> of the preferences dialog.
</p>
</note>
</section>
<section id="flashMessageSettings">
<title>Flash Message Settings</title>
<p>
Flash messages are similar in nature to notifications or announcements:
They are shown on your refreshable braille display for a brief time,
after which the original contents of the braille display are restored.
<app>Orca</app> has several settings you can use to control flash message
presentation.
</p>
<section id="flashMessageSettings_enable">
<title>Enable flash messages</title>
<p>
If <gui>Enable flash messages</gui> is checked, <app>Orca</app> will
present messages to you in braille. If you prefer to only have
<app>Orca</app>'s messages spoken, you should uncheck this checkbox.
</p>
<p>
Default value: checked
</p>
</section>
<section id="flashMessageSettings_detailed">
<title>Messages are detailed</title>
<p>
If <gui>Messages are detailed</gui> is checked, <app>Orca</app> will
present detailed messages to you in braille. For instance, if you
use <app>Orca</app>'s command to change echo, <app>Orca</app> might
display "Echo set to word." If you would prefer shorter messages,
such as simply "word," you should uncheck this checkbox.
</p>
<p>
Default value: checked
</p>
</section>
<section id="flashMessageSettings_persistent">
<title>Messages are persistent</title>
<p>
As stated above, flash messages are only shown for a brief period of time.
If you would prefer messages remain displayed until you perform an action
which causes your display to be updated, you should check the <gui>Messages
are persistent</gui> checkbox.
</p>
<p>
Default value: not checked
</p>
</section>
<section id="flashMessageSettings_duration">
<title>Duration (secs)</title>
<p>
The amount of time <app>Orca</app> will wait before removing the message and
restoring the original contents of your display can be set in the <gui>
Duration (secs)</gui> spin button. Note that the value of this
setting will be ignored if you have enabled persistent flash messages.
</p>
<p>
Default value: 5
</p>
</section>
</section>
</page>

79
help/C/preferences_chat.page Normal file
View File

@ -0,0 +1,79 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="preferences_chat">
<info>
<link type="guide" xref="preferences#application" />
<link type="next" xref="preferences_spellcheck" />
<title type="sort">3. Chat</title>
<title type="link">Chat</title>
<desc>
Configuring <app>Orca</app>'s support for IM and IRC
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Chat Preferences</title>
<p>
The following options allow you to customize how <app>Orca</app>
behaves when providing access to instant messaging and internet
relay chat clients.
</p>
<section id="speak_name">
<title>Speak Chat Room name</title>
<p>
If this checkbox is checked, <app>Orca</app> will prefix incoming messages
with the name of the room or buddy they came from, unless they came from
the currently-focused conversation.
</p>
<p>
Default value: not checked
</p>
</section>
<section id="announce_typing">
<title>Announce when your buddies are typing</title>
<p>
If this checkbox is checked, and if <app>Orca</app> has sufficient
information identifying that your buddy is typing, <app>Orca</app> will
announce changes in typing status.
</p>
<p>
Default value: not checked
</p>
</section>
<section id="message_histories">
<title>Provide chat room specific message histories</title>
<p>
If this checkbox is checked, <app>Orca</app>'s commands for reviewing
recent messages will only apply to the currently-focused conversation.
Otherwise, the history will contain the most recent messages regardless
of which conversation they came from.
</p>
<p>
Default value: not checked
</p>
</section>
<section id="speak_messages_from">
<title>Speak messages from</title>
<p>
This group of radio buttons allows you to control under what circumstances
<app>Orca</app> will present an incoming message to you. Your choices are:
</p>
<list>
<item>
<p><gui>All channels</gui></p>
</item>
<item>
<p><gui>A channel only if its window is active</gui></p>
</item>
<item>
<p><gui>All channels when any chat window is active</gui></p>
</item>
</list>
<p>
Default value: all channels
</p>
</section>
</page>

279
help/C/preferences_general.page Normal file
View File

@ -0,0 +1,279 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="preferences_general">
<info>
<title type="sort">1. General</title>
<title type="link">General</title>
<desc>
Configuring <app>Orca</app>'s fundamental behaviors
</desc>
<link type="guide" xref="preferences#orca" />
<link type="next" xref="preferences_voice" />
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>General Preferences</title>
<section id="keyboardlayout">
<info>
<desc>
Preferences dialog box option to select which <app>Orca</app> keyboard
layout to use, desktop or laptop.
</desc>
</info>
<title>Keyboard Layout</title>
<p>
The <gui>Keyboard Layout</gui> radio button group allows you to specify if
you will be working on a desktop (i.e. with a numeric keypad) or laptop
keyboard. Which layout you choose will determine both the <key>Orca
Modifier</key> as well as a number of keyboard shortcuts for performing
<app>Orca</app> commands.</p>
<p>
Default value: <gui>Desktop</gui>
</p>
</section>
<section id="presenttooltips">
<info>
<desc>
Preferences dialog box option to enable presentation of tooltips which
appear as the result of mouse hovering.
</desc>
</info>
<title>Present Tooltips</title>
<p>
When checked, this option will tell <app>Orca</app> to present information
about tooltips when they appear as the result of mouse hovering. Specific
actions to force tooltips to appear, such as pressing <keyseq>
<key>Ctrl</key><key>F1</key></keyseq> when an object has focus, will
always result in tooltips being presented, regardless of this setting.
</p>
<p>
Default value: not checked
</p>
</section>
<section id="objectundermouse">
<info>
<desc>
Preferences dialog box option to enable presentation of the object
under the mouse pointer.
</desc>
</info>
<title>Speak Object Under Mouse</title>
<p>
When checked, this option will tell <app>Orca</app> to present
information about the object under the mouse pointer as you move
it around the screen using <app>Orca</app>'s
<link xref="howto_mouse_review">Mouse Review</link> feature.
</p>
<p>
Default value: not checked
</p>
</section>
<section id="timeanddate">
<info>
<desc>
Preferences dialog box options for customizing the time and date
formats used by <app>Orca</app>.
</desc>
</info>
<title>Time Format and Date Format</title>
<p>
The <gui>Time Format</gui> and <gui>Date Format</gui> combo boxes allow
you to specify how <app>Orca</app> will speak and braille the time and the
date.
</p>
<p>
Default value: use the system locale's format for each
</p>
</section>
<section id="navigation_in_say_all">
<info>
<desc>
Preferences dialog box options for enabling rewind, fast forward,
and structural navigation during Say All.
</desc>
</info>
<title>Navigation in Say All</title>
<p>
<app>Orca</app>'s Say All feature speaks document content from your
present location to the end of the document. By default, pressing any
key will interrupt Say All's presentation. However, if you check the
<gui>Enable rewind and fast forward in Say All</gui> checkbox,
<key>Up</key> and <key>Down</key> can be used during Say All to quickly
move within the document in order to re-hear something which was just
read or skip past text of no interest without having to restart Say All.
</p>
<p>
If you are reading a document within an application that has structural
navigation support, and you have checked the <gui>Enable structural navigation
in Say All</gui> checkbox, you can use the supported structural navigation
commands in a similar fashion: <key>H</key>/<keyseq><key>Shift</key>
<key>H</key></keyseq> continues reading from the next/previous heading,
<key>P</key>/<keyseq><key>Shift</key><key>P</key></keyseq> continues reading
from the next/previous paragraph, <key>T</key>/<keyseq><key>Shift</key>
<key>T</key></keyseq> continues reading from the next/previous table, and
so on.
</p>
<p>
Default value: not checked
</p>
</section>
<section id="say_all_announce_context">
<title>Announce Contextual Information in Say All</title>
<p>
<app>Orca</app> can optionally provide more information about the document
content being spoken, such as announcing when you are entering and leaving
a blockquote, list, table, or other container. Whether or not these
announcements are made can be configured independently through the following
checkboxes:
</p>
<list>
<item><p>Announce blockquotes in Say All</p></item>
<item><p>Announce forms in Say All</p></item>
<item><p>Announce landmarks in Say All</p></item>
<item><p>Announce lists in Say All</p></item>
<item><p>Announce panels in Say All</p></item>
<item><p>Announce tables in Say All</p></item>
</list>
<p>
Default value: checked
</p>
<note style="note">
<p>
Whether or not <app>Orca</app> makes these announcements during
navigation is also configurable. You will find similar checkboxes
on the <gui>Speech</gui> page. For more information, see
<link xref="preferences_speech#spoken_context">Spoken Context</link>.
</p>
</note>
</section>
<section id="say_all_by">
<info>
<desc>
Preferences dialog box option for customizing <app>Orca</app>'s
Say All presentation.
</desc>
</info>
<title>Say All By</title>
<p>
The <gui>Say All By</gui> combo box allows you to specify whether
<app>Orca</app> speaks a sentence at a time or a line at a time when
doing a "Say All" of a document.
</p>
<p>
Default value: <gui>Sentence</gui>
</p>
</section>
<section id="profiles">
<info>
<desc>
Preferences dialog box options for managing settings profiles.
</desc>
</info>
<title>Profiles</title>
<p>
The <gui>Profiles</gui> group of controls, which appear at the bottom
of the <gui>General</gui> page, make it possible for you to maintain
and use multiple configurations.
</p>
<list>
<item>
<p>
The <gui>Active Profile</gui> combo box displays the current profile
and allows you to select a different profile to load.
</p>
</item>
<item>
<p>
The <gui>Load</gui> button will cause <app>Orca</app> to load the
profile indicated in the <gui>Active Profile</gui> combo box.
</p>
</item>
<item>
<p>
The <gui>Save As</gui> button allows you to save the current set of
options from the preferences dialog box to a named profile.
</p>
</item>
<item>
<p>
The <gui>Start-up Profile</gui> combo box allows you to select the
profile which should be automatically loaded each time you launch
<app>Orca</app>.
</p>
</item>
</list>
</section>
<section id="progress_bar_updates">
<title>Progress Bar Updates</title>
<section id="progress_bar_updates_speak">
<title>Speak updates</title>
<p>
If the <gui>Speak updates</gui> checkbox is checked <app>Orca</app> will
periodically speak the status of progress bars.
</p>
<p>
Default value: checked
</p>
</section>
<section id="progress_bar_updates_braille">
<title>Braille updates</title>
<p>
If the <gui>Braille updates</gui> checkbox is checked <app>Orca</app> will
periodically display the status of progress bars on your refreshable braille
display.
</p>
<p>
Default value: not checked
</p>
</section>
<section id="progress_bar_updates_beep">
<title>Beep updates</title>
<p>
If the <gui>Beep updates</gui> checkbox is checked <app>Orca</app> will
periodically emit beeps which increase in pitch as the value of the progress
bar increases.
</p>
<p>
Default value: not checked
</p>
</section>
<section id="progress_bar_updates_frequency">
<title>Frequency (secs)</title>
<p>
This spin button determines how often updates are presented.
</p>
<p>
Default value: 10
</p>
</section>
<section id="progress_bar_updates_restrict">
<title>Applies to</title>
<p>
This combo box allows you to control which progress bars should be
presented, assuming the presentation of progress bar updates has been
enabled. The choices are <gui>All</gui>, <gui>Application</gui>, and
<gui>Window</gui>.
</p>
<p>
Choosing <gui>All</gui> will result in <app>Orca</app> presenting
updates for all progress bars, regardless of where the progress bars
are located.
</p>
<p>
Choosing <gui>Application</gui> will result in <app>Orca</app>
presenting updates from progress bars in the active application, even
if they are not in the active window.
</p>
<p>
Choosing <gui>Window</gui> will result in <app>Orca</app> only
presenting updates for progress bars in the active window.
</p>
<p>
Default value: <gui>Application</gui>
</p>
</section>
</section>
</page>

59
help/C/preferences_introduction.page Normal file
View File

@ -0,0 +1,59 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="preferences_introduction">
<info>
<title type="sort">0. Introduction to <app>Orca</app>'s Preferences</title>
<title type="link">Introduction to <app>Orca</app>'s Preferences</title>
<link type="guide" xref="preferences" />
<link type="next" xref="preferences_general" />
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Introduction to <app>Orca</app>'s Preferences</title>
<section id="orca">
<title>Orca Preferences</title>
<p>
Orca preferences allow you to customize functionality in <app>Orca</app>
which applies to all applications. An example of an Orca preference is
echo because echo is something that applies to all applications.
</p>
<p>
Note that Orca preferences can be customized on an application-by-application
basis. For instance you can set the default echo to words and then
set the echo for Pidgin to be none. Having done so, <app>Orca</app>
would always echo each word that you typed, unless you were in Pidgin.
</p>
<note style="tip">
<title>Keyboard Shortcuts for Getting Into the Preferences Dialogs</title>
<list>
<item>
<p>
<keyseq><key>Orca Modifier</key><key>Space</key></keyseq>:
<app>Orca</app>'s Preferences
</p>
</item>
<item>
<p>
<keyseq><key>Ctrl</key><key>Orca Modifier</key><key>Space</key>
</keyseq>: <app>Orca</app>'s Preferences for the current
application
</p>
</item>
</list>
</note>
</section>
<section id="application_unique">
<title>Application-Unique Preferences</title>
<p>
In contrast to Orca preferences, there are application-unique preferences.
These preferences allow you to customize <app>Orca</app> functionality
that only applies in certain environments, such as on web pages or in
chat applications. As a result, you will only find these options
available in the application-specific preferences dialogs and only for
those applications to which these options apply.
</p>
</section>
</page>

75
help/C/preferences_key_bindings.page Normal file
View File

@ -0,0 +1,75 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="preferences_key_bindings">
<info>
<link type="guide" xref="preferences#orca"/>
<link type="next" xref="preferences_pronunciation" />
<link type="seealso" xref="howto_key_bindings" />
<title type="sort">6. Key Bindings</title>
<title type="link">Key Bindings</title>
<desc>
Configuring <app>Orca</app>'s keyboard shortcuts
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Key Bindings Preferences</title>
<section id="orca_modifier_keys">
<title>Orca Modifier Keys</title>
<p>
The <gui>Screen Reader Modifier Key(s)</gui> combo box allows you to select which
key or keys will serve as the Orca Modifier. The available options are:
</p>
<list>
<item>
<p>
<gui>KP_Insert</gui> (the same key as the <key>0</key> on the
numeric keypad)
</p></item>
<item><p><gui>Insert</gui></p></item>
<item><p><gui>Insert, KP_Insert</gui></p></item>
<item><p><gui>Caps_Lock</gui></p></item>
</list>
</section>
<section id="key_bindings_table">
<title>The Key Bindings Table</title>
<p>
The key bindings table provides a list of <app>Orca</app> operations
and the keys that are bound to them.
</p>
<list>
<item>
<p>
The <gui>Command</gui> column contains a description of the
<app>Orca</app> command to be performed.
</p>
</item>
<item>
<p>
The <gui>Key Binding</gui> column contains the keyboard shortcut currently
assigned to the <app>Orca</app> command. You can modify the value of
this column by pressing <key>Return</key>, pressing the keys for the
new binding, and pressing <key>Return</key> again.
</p>
</item>
<item>
<p>
The <gui>Modified</gui> column serves both as an indicator to what
has been changed and as a way to restore the default bindings
associated with that command.
</p>
</item>
</list>
<p>
Beneath the list of <app>Orca</app> keybindings, you will find a group
of "unbound" commands. These are commands which we feel will be very
useful for some users, but not needed by most users. Rather than "use
up" a keystroke for such commands, we have left them unassigned by
default. At the end of the list are the braille bindings, for use with
a refreshable braille display.
</p>
</section>
</page>

183
help/C/preferences_key_echo.page Normal file
View File

@ -0,0 +1,183 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="preferences_key_echo">
<info>
<title type="link">Echo</title>
<title type="sort">4. Echo</title>
<desc>
Configuring what is spoken as you type
</desc>
<link type="guide" xref="preferences#orca" />
<link type="next" xref="preferences_key_bindings" />
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Echo Preferences</title>
<section id="keyecho">
<title>Enable key echo</title>
<p>
Orca's key echo setting controls what happens each time you press
a key. To enable key echo, check the "Enable key echo" checkbox.
Doing so causes additional checkboxes to become available through
which you can choose exactly which keys should and should not be
echoed to best suit your needs.
</p>
<p>
Default value: checked
</p>
<section id="keyecho_enable_alphanumeric">
<title>Enable alphabetic keys</title>
<p>
This option controls whether or not keys like <key>a</key>,
<key>b</key>, and <key>c</key> should be spoken when pressed.
</p>
<p>
Default value: checked
</p>
</section>
<section id="keyecho_enable_numeric">
<title>Enable numeric keys</title>
<p>
This option controls whether or not keys like <key>1</key>,
<key>2</key>, and <key>3</key> should be spoken when pressed.
</p>
<p>
Default value: checked
</p>
</section>
<section id="keyecho_enable_punctuation">
<title>Enable punctuation keys</title>
<p>
This option controls whether or not keys like <key>%</key>,
<key>;</key>, and <key>?</key> should be spoken when pressed.
</p>
<p>
Default value: checked
</p>
</section>
<section id="keyecho_enable_space">
<title>Enable space</title>
<p>
This option controls whether or not <key>Space</key> should be
spoken when pressed.
</p>
<p>
Default value: checked
</p>
</section>
<section id="keyecho_enable_modifier">
<title>Enable modifier keys</title>
<p>
This option controls whether or not <key>Shift</key>, <key>Ctrl</key>,
<key>Alt</key> and <key>Meta</key> should be spoken when pressed.
</p>
<p>
Default value: checked
</p>
</section>
<section id="keyecho_enable_function">
<title>Enable function keys</title>
<p>
This option controls whether or not <key>F1</key> through <key>F12</key>
should be spoken when pressed.
</p>
<p>
Default value: checked
</p>
</section>
<section id="keyecho_enable_action">
<title>Enable action keys</title>
<p>
This option controls whether or not <key>BackSpace</key>, <key>Delete
</key>, <key>Return</key>, <key>Esc</key>, <key>Tab</key>, <key>Page
Up</key>, <key>Page Down</key>, <key>Home</key>, and <key>End</key>
should be spoken when pressed.
</p>
<p>
Default value: checked
</p>
</section>
<section id="keyecho_enable_navigation">
<title>Enable navigation keys</title>
<p>
This option controls whether or not <key>Left</key>, <key>Right</key>,
<key>Up</key>, and <key>Down</key> should be spoken when pressed. This
option also applies to any key combination in which <key>Orca
Modifier</key> is being held down, for instance when flat review is
being used.
</p>
<p>
Default value: not checked
</p>
</section>
<section id="keyecho_enable_diacritical">
<title>Enable non-spacing diacritical keys</title>
<p>
This option controls whether or not "dead keys" used to generate
accented letters should be spoken when pressed.
</p>
<p>
Default value: not checked
</p>
</section>
</section>
<section id="characterecho">
<title>Enable echo by character</title>
<p>
Enabling this option causes Orca to echo the character
you just typed.
</p>
<p>
While echo by character seems quite similar to the key echo of
alphabetic, numeric, and punctuation keys, there are important differences,
especially with respect to accented letters and other symbols for which
there is no dedicated key:
</p>
<list>
<item>
<p>
Key echo causes <app>Orca</app> to announce what you just <em>
pressed</em>.
</p>
</item>
<item>
<p>
Character echo causes <app>Orca</app> to announce what was just
<em>inserted</em>.
</p>
</item>
</list>
<p>
Thus to have accented characters spoken as you type them, you should
enable character echo.
</p>
<p>
Default value: not checked
</p>
<note style="tip">
<title>Enabling both key echo and character echo</title>
<p>
If you like key echo and you frequently type accented characters,
consider enabling both. <app>Orca</app>'s character echo logic
attempts to filter out characters which were spoken as a result
of key echo, thus minimizing the likelihood of "double speaking"
as you type.
</p>
</note>
</section>
<section id="wordandsentenceecho">
<title>Enable echo by word and Enable echo by sentence</title>
<p>
Checking the <gui>Enable echo by word</gui> checkbox causes
<app>Orca</app> to echo the word you just typed. Similarly,
checking the <gui>Enable echo by sentence</gui> checkbox causes
<app>Orca</app> to echo the sentence you just typed.
</p>
<p>
Default value: not checked
</p>
</section>
</page>

87
help/C/preferences_pronunciation.page Normal file
View File

@ -0,0 +1,87 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic"
id="preferences_pronunciation">
<info>
<link type="guide" xref="preferences#orca" />
<link type="next" xref="preferences_text_attributes" />
<title type="sort">7. Pronunciation</title>
<title type="link">Pronunciation</title>
<desc>
Defining how specific words get pronounced
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Pronunciation Preferences</title>
<p>
Sometimes your speech synthesizer just doesn't say the right thing
for a given string. You might prefer to hear "laughing out loud"
rather than "LOL," or "accessibility" rather than "a11y". Or there
may be a name or a technical term which the synthesizer mispronounces.
</p>
<p>
The <gui>Pronunciation</gui> page of the <app>Orca</app> preferences
dialog allows you to add, edit, and delete entries in <app>Orca</app>'s
pronunciation dictionary.
</p>
<p>
Because the <gui>Pronunciation</gui> page is also part of the
application-specific settings, you can customize your entries on an
as-needed basis for each application you use.
</p>
<steps>
<title>Adding a new dictionary entry</title>
<item>
<p>
Press the <gui>New Entry</gui> button (<keyseq><key>Alt</key><key>N</key></keyseq>)
</p>
</item>
<item>
<p>
Type the text of the new entry and press <key>Return</key> to finish
editing the actual string.
</p>
</item>
<item>
<p>
Move to the <gui>Replacement String</gui> column and press <key>Return
</key> to begin editing.
</p>
</item>
<item>
<p>
Type the text that you would like to have spoken instead and press <key>
Return</key> to finish editing the replacement string.
</p>
</item>
</steps>
<steps>
<title>Editing an existing dictionary entry</title>
<item>
<p>
Move to the cell you wish to edit and press <key>Return</key> to begin
editing.
</p>
</item>
<item>
<p>
Make your changes and then press <key>Return</key> to finish editing.
</p>
</item>
</steps>
<steps>
<title>Deleting an existing dictionary entry</title>
<item>
<p>Move to the entry you wish to delete.</p>
</item>
<item>
<p>
Press the <gui>Delete</gui> button or <keyseq><key>Alt</key><key>D</key></keyseq>.
</p>
</item>
</steps>
</page>

348
help/C/preferences_speech.page Normal file
View File

@ -0,0 +1,348 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="preferences_speech">
<info>
<link type="guide" xref="preferences#orca" />
<link type="next" xref="preferences_braille" />
<title type="sort">2.1 Speech</title>
<title type="link">Speech</title>
<desc>
Configuring what gets spoken
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Speech Preferences</title>
<section id="enable_speech">
<title>Enable speech</title>
<p>
The <gui>Enable speech</gui> check box controls whether or not
<app>Orca</app> will make use of a speech synthesizer.
Braille-only users will likely want to uncheck this checkbox.
</p>
<p>
Default value: checked
</p>
</section>
<section id="verbosity">
<title>Verbosity</title>
<p>
The <gui>Verbosity</gui> setting determines the amount of information
that will be spoken in various situations. For example, if it is set
to verbose, and you arrow into a word that is misspelled, <app>Orca</app>
will announce that the word is misspelled. When the level is set to brief,
this announcement will not be made.
</p>
<p>
Default value: <gui>Verbose</gui>
</p>
</section>
<section id="punctuation_level">
<title>Punctuation Level</title>
<p>
The <gui>Punctuation Level</gui> radio button group is used to
adjust the amount of punctuation spoken by the synthesizer. The
available levels are <gui>None</gui>, <gui>Some</gui>, <gui>Most</gui>,
and <gui>All</gui>.
</p>
<p>
Default value: <gui>Most</gui>
</p>
<section id="punctuation_level_none">
<title>None</title>
<p>
Choosing a punctuation level of <gui>None</gui> would, as you expect,
cause no punctuation to be spoken. Note, however, that special symbols
such as subscripted and superscripted numbers, Unicode fractions, and
bullets are still spoken at this level, even though some might consider
these types of symbols punctuation.
</p>
</section>
<section id="punctuation_level_some">
<title>Some</title>
<p>
Choosing a punctuation level of <gui>Some</gui> causes all of the
previously-mentioned symbols to be spoken. In addition, <app>Orca</app>
will speak known mathematical symbols, currency symbols, and "^", "@",
"/", "&amp;", "#".
</p>
</section>
<section id="punctuation_level_most">
<title>Most</title>
<p>
Choosing a punctuation level of <gui>Most</gui> causes all of the
previous-mentioned symbols to be spoken. In addition, <app>Orca</app>
will speak all other known punctuation symbols <em>other than</em> "!",
"'", ",", ".", "?".
</p>
</section>
<section id="punctuation_level_all">
<title>All</title>
<p>
Choosing a punctuation level of <gui>All</gui>, as expected, causes
<app>Orca</app> to speak all known punctuation symbols.
</p>
</section>
</section>
<section id="spoken_context">
<title>Spoken Context</title>
<p>
The following items control the presentation of a variety of
supplemental, "system" information about the item with focus.
Because the associated text does not appear on screen, this
information is presented in <app>Orca</app>'s System voice.
</p>
<section id="only_speak_displayed_text">
<title>Only speak displayed text</title>
<p>
Checking this checkbox causes <app>Orca</app> to only speak actual
text displayed on screen. This option is intended primarily for low
vision users and users with a visual learning disability.
</p>
<p>
Default value: not checked
</p>
<note style="note">
<p>
The following items will not be available for configuration if
the <gui>Only speak displayed text</gui> checkbox is checked.
</p>
</note>
</section>
<section id="speak_blank_lines">
<title>Speak blank lines</title>
<p>
If the <gui>Speak blank lines</gui> checkbox is checked,
<app>Orca</app> will say "blank" each time you arrow to a blank
line. If it is unchecked, <app>Orca</app> will say nothing when
you move to a blank line.
</p>
<p>
Default value: checked
</p>
</section>
<section id="indentation_and_justification">
<title>Speak indentation and justification</title>
<p>
When working with code or editing other documents it is often
desirable to be aware of justification and indentation. Checking
the <gui>Speak indentation and justification</gui> checkbox will
cause <app>Orca</app> to announce this information.
</p>
<p>
Default value: not checked
</p>
</section>
<section id="speak_misspelled_word_indicator">
<title>Speak misspelled-word indicator</title>
<p>
The misspelled-word indicator is the red squiggly line that appears
underneath misspelled words in editable text fields. If <gui>Speak
misspelled-word indicator</gui> is checked, when you navigate into
a word with this indicator, or type a word incorrectly causing this
indicator to appear, <app>Orca</app> will speak "misspelled."
</p>
<p>
Default value: checked
</p>
</section>
<section id="mnemonics">
<title>Speak object mnemonics</title>
<p>
If the <gui>Speak object mnemonics</gui> checkbox is checked,
<app>Orca</app> will announce the mnemonic associated with the
object with focus (such as <keyseq><key>Alt</key><key>O</key>
</keyseq> for an <gui>OK</gui> button).
</p>
<p>
Default value: not checked
</p>
</section>
<section id="child_position">
<title>Speak child position</title>
<p>
Checking the <gui>Speak child position</gui> checkbox will cause
<app>Orca</app> to announce the position of the focused item in
menus, lists, and trees (e.g. "9 of 16").
</p>
<p>
Default value: not checked
</p>
</section>
<section id="speak_tutorial_messages">
<title>Speak tutorial messages</title>
<p>
If the <gui>Speak tutorial messages</gui> checkbox is checked, as
you move amongst objects in an interface, <app>Orca</app> will
provide additional information, such as how to interact with the
currently-focused object.
</p>
<p>
Default value: not checked
</p>
</section>
<section id="speak_description">
<title>Speak description</title>
<p>
If the <gui>Speak description</gui> checkbox is checked, as
you move amongst objects in an interface, <app>Orca</app> will
speak the accessible description in addition to the accessible
name of the object.
</p>
<p>
Default value: checked
</p>
</section>
<section id="system_messages_are_detailed">
<title>System messages are detailed</title>
<p>
If <gui>System messages are detailed</gui> is checked, <app>Orca</app> will
present detailed messages to you in speech. For instance, if you use
<app>Orca</app>'s command to change echo, <app>Orca</app> might
speak "Echo set to word." If you would prefer shorter messages,
such as simply "word," you should uncheck this checkbox.
</p>
<p>
Default value: checked
</p>
</section>
<section id="speak_colors_as_names">
<title>Speak colors as names</title>
<p>
If <gui>Speak colors as names</gui> is checked, <app>Orca</app> will
describe colors, looking for the closest approximate. For instance,
RGB 0, 27, 51 would be spoken as "midnight blue." If you would prefer
to hear the exact RGB value, you should uncheck this checkbox.
</p>
<p>
Default value: checked
</p>
</section>
<section id="announce_blockquotes_during_navigation">
<title>Announce blockquotes during navigation</title>
<p>
If <gui>Announce blockquotes during navigation</gui> is checked,
<app>Orca</app> will tell you when you navigate into or out of a
blockquote. Note that this setting is independent of whether or not
this announcement is made during Say All. See
<link xref="preferences_general#say_all_announce_context">Announce
Contextual Information in Say All</link> for more information.
</p>
<p>
Default value: checked
</p>
</section>
<section id="announce_forms_during_navigation">
<title>Announce forms during navigation</title>
<p>
If <gui>Announce forms during navigation</gui> is checked,
<app>Orca</app> will tell you when you navigate into or out of a
form. Note that this setting is specific to forms which are not
ARIA landmarks. You can configure the presentation of ARIA landmarks
through the <gui>Announce landmarks during navigation</gui> checkbox.
In addition, note that this setting is independent of whether or not
this announcement is made during Say All. See
<link xref="preferences_general#say_all_announce_context">Announce
Contextual Information in Say All</link> for more information.
</p>
<p>
Default value: checked
</p>
</section>
<section id="announce_landmarks_during_navigation">
<title>Announce landmarks during navigation</title>
<p>
If <gui>Announce landmarks during navigation</gui> is checked,
<app>Orca</app> will tell you when you navigate into or out of an
ARIA landmark. Note that this setting is independent of whether or not
this announcement is made during Say All. See
<link xref="preferences_general#say_all_announce_context">Announce
Contextual Information in Say All</link> for more information.
</p>
<p>
Default value: checked
</p>
</section>
<section id="announce_lists_during_navigation">
<title>Announce lists during navigation</title>
<p>
If <gui>Announce lists during navigation</gui> is checked,
<app>Orca</app> will tell you when you navigate into or out of a
list. Note that this setting is independent of whether or not
this announcement is made during Say All. See
<link xref="preferences_general#say_all_announce_context">Announce
Contextual Information in Say All</link> for more information.
</p>
<p>
Default value: checked
</p>
</section>
<section id="announce_panels_during_navigation">
<title>Announce panels during navigation</title>
<p>
If <gui>Announce panels during navigation</gui> is checked,
<app>Orca</app> will tell you when you navigate into or out of a
panel. Note that this setting is independent of whether or not
this announcement is made during Say All. See
<link xref="preferences_general#say_all_announce_context">Announce
Contextual Information in Say All</link> for more information.
</p>
<p>
Default value: checked
</p>
</section>
<section id="announce_tables_during_navigation">
<title>Announce tables during navigation</title>
<p>
If <gui>Announce tables during navigation</gui> is checked,
<app>Orca</app> will tell you when you navigate into or out of a
table. Note that this setting is independent of whether or not
this announcement is made during Say All. See
<link xref="preferences_general#say_all_announce_context">Announce
Contextual Information in Say All</link> for more information.
</p>
<p>
Default value: checked
</p>
</section>
<section id="speak_full_row_in_gui_tables">
<title>Speak full row in GUI tables</title>
<p>
If <gui>Speak full row in GUI tables</gui> is checked, as you arrow up
and down in application tables such as the list of messages in your
Inbox, <app>Orca</app> will speak the entire row. If you would prefer
to hear only the cell with focus, you should uncheck this checkbox.
</p>
<p>
Default value: checked
</p>
</section>
<section id="speak_full_row_in_document_tables">
<title>Speak full row in document tables</title>
<p>
If <gui>Speak full row in document tables</gui> is checked, as you arrow
up and down in tables such as those found in <app>Writer</app> and web
documents, <app>Orca</app> will speak the entire row. If you would prefer
to hear only the cell with focus, you should uncheck this checkbox.
</p>
<p>
Default value: checked
</p>
</section>
<section id="speak_full_row_in_spreadsheets">
<title>Speak full row in spreadsheets</title>
<p>
If <gui>Speak full row in spreadsheets</gui> is checked, as you arrow
up and down in spreadsheets, <app>Orca</app> will speak the entire
row. If you would prefer to hear only the cell with focus, you should
uncheck this checkbox.
</p>
<p>
Default value: not checked
</p>
</section>
</section>
</page>

65
help/C/preferences_spellcheck.page Normal file
View File

@ -0,0 +1,65 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="preferences_spellcheck">
<info>
<link type="guide" xref="preferences#application" />
<title type="sort">4. Spell Check</title>
<title type="link">Spell Check</title>
<desc>
Configuring <app>Orca</app>'s support for Spell Check
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Spell Check Preferences</title>
<p>
<app>Orca</app> tries to provide a consistent user experience when interacting
with application spell checkers. For applications where this enhanced support
has been provided, you will find several options which you can adjust to get
the verbosity level that works best for you.
</p>
<note style="tip">
<title>You can have both brief and verbose spell check information</title>
<p>
If you normally want very little verbosity when using a spell checker,
but occasionally need detailed information about a given error, you can
disable these options. When you need additional details, just use
<app>Orca</app>'s detailed <link xref="howto_whereami">Where Am I</link>
command to have <app>Orca</app> present the current error as if all of these
options were enabled.
</p>
</note>
<section id="spell_error">
<title>Spell error</title>
<p>
If this checkbox is checked, <app>Orca</app> will spell out the misspelled
word after speaking it.
</p>
<p>
Default value: checked
</p>
</section>
<section id="spell_suggestion">
<title>Spell suggestion</title>
<p>
If this checkbox is checked, <app>Orca</app> will spell out the suggested
correction after speaking it.
</p>
<p>
Default value: checked
</p>
</section>
<section id="error_context">
<title>Present context of error</title>
<p>
If this checkbox is checked, <app>Orca</app> will speak the sentence or
line from the document in which the error is found.
</p>
<p>
Default value: checked
</p>
</section>
</page>

69
help/C/preferences_table_navigation.page Normal file
View File

@ -0,0 +1,69 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic"
id="preferences_table_navigation">
<info>
<link type="guide" xref="preferences#application" />
<link type="next" xref="preferences_chat" />
<link type="seealso" xref="commands_structural_navigation" />
<link type="seealso" xref="commands_table" />
<title type="sort">2. Table Navigation</title>
<title type="link">Table Navigation</title>
<desc>
Configuring <app>Orca</app>'s navigation within tables
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Table Navigation Preferences</title>
<p>
The following options allow you to customize how <app>Orca</app>
behaves when navigating within a table in
<link xref="howto_structural_navigation">Structural-Navigation</link>-enabled
applications.
</p>
<section id="speak_cell_coordinates">
<title>Speak cell coordinates</title>
<p>
If this checkbox is checked, <app>Orca</app> will announce the coordinates
of each cell you navigate to.
</p>
<p>
Default value: checked
</p>
</section>
<section id="speak_multiple_cell_spans">
<title>Speak multiple cell spans</title>
<p>
If this checkbox is checked, <app>Orca</app> will announce how many rows
and/or columns a cell spans when it spans more than one.
</p>
<p>
Default value: checked
</p>
</section>
<section id="announce_cell_header">
<title>Announce cell header</title>
<p>
If this checkbox is checked, <app>Orca</app> will announce changes in the
header if the headers for the current cell can be determined.
</p>
<p>
Default value: checked
</p>
</section>
<section id="skip_blank_cells">
<title>Skip blank cells</title>
<p>
If this checkbox is checked, <app>Orca</app> will skip blank cells when
you are using <app>Orca</app>'s table structural navigation commands to
access the table.
</p>
<p>
Default value: not checked
</p>
</section>
</page>

139
help/C/preferences_text_attributes.page Normal file
View File

@ -0,0 +1,139 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic"
id="preferences_text_attributes">
<info>
<link type="guide" xref="preferences#orca" />
<link type="next" xref="preferences_web" />
<link type="seealso" xref="howto_text_attributes" />
<title type="sort">8. Text Attributes</title>
<title type="link">Text Attributes</title>
<desc>
Configuring what formatting is presented
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Text Attributes Preferences</title>
<p>
The term "text attributes" refers to all of the font, style, alignment,
and other formatting associated with a given character or series of
characters. <app>Orca</app>'s <gui>Text Attributes</gui> page allows you
to customize which text attributes <app>Orca</app> will present in speech,
along with the order in which they should be presented, and which ones
<app>Orca</app> will indicate in braille.
</p>
<section id="table">
<title>The text attributes table</title>
<p>
The text attributes table is where you specify what attributes will
and will not be presented and under what conditions. Each row consists
of four columns.
</p>
<list>
<item>
<p>
<gui>Attribute Name</gui>: The name of the text attribute.
</p>
</item>
<item>
<p>
<gui>Speak</gui>: Check this checkbox if you would like
<app>Orca</app> to speak this attribute when you press
<keyseq><key>Orca Modifier</key><key>F</key></keyseq>.
</p>
</item>
<item>
<p>
<gui>Mark in braille</gui>: Check this checkbox if you would
like <app>Orca</app> to "underline" this attribute on your
braille display.
</p>
</item>
<item>
<p>
<gui>Present Unless</gui>: This editable field allows you to
specify when an enabled attribute is not of interest.
</p>
<p>
For example, by default the "underline" text attribute has a
value of "none". This causes <app>Orca</app> to inform you
about underlined text as long as the text is actually underlined.
If you always want this attribute to be spoken irrespective of
whether or not the text is underlined, the <gui>Present unless</gui>
column should be empty for underline. In addition, you should be sure
that the <gui>Speak</gui> column for underline is checked.
</p>
</item>
</list>
</section>
<section id="reset">
<title>Undoing changes</title>
<p>
Beneath the list of text attributes, there is a <gui>Reset</gui> button
(<keyseq><key>Alt</key><key>R</key></keyseq>) which will restore
the values of the table to what they were when the dialog was
first displayed.
</p>
</section>
<section id="rearranging">
<title>Rearranging the order of presentation</title>
<p>
When you initially display the <gui>Text Attributes</gui> page, all of your enabled
attributes are placed at the top of the table in the order in which they
will be spoken. There are four buttons which can be used to rearrange
the order of presentation.
</p>
<list>
<item>
<p>
<gui>Move to top</gui> (<keyseq><key>Alt</key><key>T</key></keyseq>):
moves the selected attribute to the top of the list.
</p>
</item>
<item>
<p>
<gui>Move up</gui> (<keyseq><key>Alt</key><key>U</key></keyseq>):
moves the selected attribute up one row.
</p>
</item>
<item>
<p>
<gui>Move down</gui> (<keyseq><key>Alt</key><key>D</key></keyseq>):
moves the selected attribute down one row.
</p>
</item>
<item>
<p>
<gui>Move to bottom</gui> (<keyseq><key>Alt</key><key>B</key></keyseq>):
moves the selected attribute to the bottom of the list.
</p>
</item>
</list>
</section>
<section id="braille_indicator">
<title>Options for Configuring Braille "Underlining" for Formatting</title>
<p>
Beneath the push buttons is the <gui>Braille Indicator</gui> group
of radio buttons. Here you can select the cell or cells to be used
to indicate text which has at least one of the specified attributes.
</p>
<list>
<item>
<p><gui>None</gui>: Do not underline text attributes in braille (the default)</p>
</item>
<item>
<p><gui>Dot 7</gui>: Underline text attributes with only Dot 7</p>
</item>
<item>
<p><gui>Dot 8</gui>: Underline text attributes with only Dot 8</p>
</item>
<item>
<p><gui>Dots 7 and 8</gui>: Underline text attributes with both Dots 7 and Dots 8</p>
</item>
</list>
</section>
</page>

138
help/C/preferences_voice.page Normal file
View File

@ -0,0 +1,138 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="preferences_voice">
<info>
<link type="guide" xref="preferences#orca" />
<link type="next" xref="preferences_speech" />
<title type="sort">2.0 Voice</title>
<title type="link">Voice</title>
<desc>
Configuring the voice used by <app>Orca</app>
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Voice Preferences</title>
<section id="voice_type_settings">
<title>Voice Type Settings</title>
<section id="voice_type">
<title>Voice type</title>
<p>
This combo box makes it possible for you to use different voices so that
you can better distinguish uppercase and linked text from other text,
and on-screen text from text added by <app>Orca</app>.
</p>
<note style="tip">
<title>Configuring Multiple Voices</title>
<p>
For each voice you wish to configure, first select the
voice in the <gui>Voice type</gui> combo box. Then
configure the person, rate, pitch, and volume to be used
for that voice.
</p>
</note>
</section>
<section id="speech_system">
<title>Speech system</title>
<p>
This combo box allows you to select your preferred speech system from
those you have installed, such as Speech Dispatcher.
</p>
</section>
<section id="speech_synthesizer">
<title>Speech synthesizer</title>
<p>
This combo box allows you to select the speech synthesizer to be used
with your chosen Speech system.
</p>
</section>
<section id="person">
<title>Person</title>
<p>
This combo box allows you to choose which "person" or "speaker" should
be used with the selected voice. For instance, you might wish to have
David speak by default, but have hyperlinks spoken by Alice. Note that
what you find in the <gui>Person</gui> combo box will depend on which
speech synthesizers you have installed.
</p>
</section>
<section id="capitalization_style">
<title>Capitalization style</title>
<p>
This combo box allows you to choose which Speech Dispatcher capitalization
indication styles you wish to use in addition to <app>Orca</app>'s
capitalization voice. The options, which are named using Speech Dispatcher's
terminology, are:
</p>
<list>
<item><p><gui>Icon</gui>: Plays a tone</p></item>
<item><p><gui>Spell</gui>: Speaks the word "capital"</p></item>
<item><p><gui>None</gui></p></item>
</list>
<note style="tip">
<title>This setting can be toggled on the fly</title>
<p>
<app>Orca</app> also has a command to cycle through the available
capitalization styles. See <link xref="commands_speech_settings">
Speech Settings Commands</link> for more information.
</p>
</note>
<p>
Default value: none
</p>
</section>
<section id="rate_pitch_and_volume">
<title>Rate, Pitch, and Volume</title>
<p>
These three left-right sliders allow you to further customize the sound
of the person you have just selected.
</p>
</section>
</section>
<section id="global_voice_settings">
<title>Global Voice Settings</title>
<section id="pauses">
<title>Break speech into chunks between pauses</title>
<p>
Depending on the enabled speech settings, <app>Orca</app> may have quite
a bit to say about a particular object such as its name, its role, its
state, its mnemonic, its tutorial message, and so on. Checking the
<gui>Break speech into chunks between pauses</gui> checkbox will cause
<app>Orca</app> to insert brief pauses in between each of these pieces
of information.
</p>
<p>
Default value: checked
</p>
</section>
<section id="multicase_strings">
<title>Speak multicase strings as words</title>
<p>
In some text, and especially when working with code, one often comes
across a "word" consisting of several words with alternating case, such
as "MultiCaseString." Speech synthesizers do not always pronounce such
multicase strings correctly. Checking the <gui>Speak multicase strings
as words</gui> checkbox will cause <app>Orca</app> to break a word like
"MultiCaseString" into separate words ("Multi," "Case," and "String")
prior to passing it along to the speech synthesizer.
</p>
<p>
Default value: not checked
</p>
</section>
<section id="numbers_as_digits">
<title>Speak numbers as digits</title>
<p>
Checking the <gui>Speak numbers as digits</gui> checkbox will cause
<app>Orca</app> to break a number like "123" into separate digits
("1," "2," and "3") prior to passing it along to the speech synthesizer.
</p>
<p>
Default value: not checked
</p>
</section>
</section>
</page>

223
help/C/preferences_web.page Normal file
View File

@ -0,0 +1,223 @@
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="preferences_web">
<info>
<link type="guide" xref="preferences#application" />
<link type="next" xref="preferences_table_navigation" />
<title type="sort">1. Web Navigation</title>
<title type="link">Web Navigation</title>
<desc>
Configuring <app>Orca</app>'s support for <app>Firefox</app>,
<app>Thunderbird</app>, and <app>Chrome</app>/<app>Chromium</app>
</desc>
<credit type="author">
<name>Joanmarie Diggs</name>
<email>joanied@gnome.org</email>
</credit>
<license>
<p>Creative Commons Share Alike 3.0</p>
</license>
</info>
<title>Web Navigation Preferences</title>
<section id="page_navigation">
<title>Page Navigation</title>
<p>
The <gui>Page Navigation</gui> group of controls make it possible for you
to customize how <app>Orca</app> presents, and allow you to interact with,
text and other content.
</p>
<section id="page_navigation_control_caret">
<title>Control caret navigation</title>
<p>
This checkbox toggles <app>Orca</app>'s caret navigation on and off.
When it is on, <app>Orca</app> takes control of the caret as you arrow
around within a page; when it is off, the browser's native caret navigation is
active.
</p>
<p>
Default value: checked
</p>
<note style="tip">
<title>This setting can be toggled on the fly</title>
<p>
To toggle this setting on the fly without saving it, use
<keyseq><key>Orca Modifier</key><key>F12</key></keyseq>.
</p>
</note>
</section>
<section id="page_navigation_focus_caret">
<title>Automatic focus mode during caret navigation</title>
<p>
If this checkbox is checked, <app>Orca</app> will automatically turn on
focus mode when you use caret navigation commands to navigate to a form
field. For example, pressing <key>Down</key> would allow you to move
into an entry but once you had done so, Orca would switch to focus mode
and subsequent presses of <key>Down</key> would be controlled by the web
browser and not by Orca. If this checkbox is not checked, <app>Orca</app>
would continue to control what happens when you press <key>Down</key>,
thus making it possible to arrow out of the entry and continue reading.
</p>
<p>
Default value: not checked
</p>
<note style="tip">
<title>Manually switching between browse mode and focus mode</title>
<p>
In order to start or stop interacting with the focused form field,
use <keyseq><key>Orca Modifier</key><key>A</key></keyseq> to switch
between browse mode and focus mode.
</p>
</note>
</section>
<section id="page_navigation_structural">
<title>Enable structural navigation</title>
<p>
This checkbox toggles <app>Orca</app>'s
<link xref="howto_structural_navigation">Structural Navigation</link>
on and off. Structural Navigation allows you to navigate by elements
such as headings, links, and form fields.
</p>
<p>
Default value: checked
</p>
<note style="tip">
<title>This setting can be toggled on the fly</title>
<p>
To toggle this setting on the fly without saving it, use
<keyseq><key>Orca Modifier</key><key>Z</key></keyseq>.
</p>
</note>
</section>
<section id="page_navigation_focus_structural">
<title>Automatic focus mode during structural navigation</title>
<p>
If this checkbox is checked, <app>Orca</app> will automatically turn on
focus mode when you use structural navigation commands to navigate to a
form field. For example, pressing <key>E</key> to move to the next entry
would move focus there and also turn focus mode on so that your next press
of <key>E</key> would type an "e" into that entry. If this checkbox is not
checked, then <app>Orca</app> will leave you in browse mode and your next
press of <key>E</key> would move you to the next entry on the page.
</p>
<p>
Default value: not checked
</p>
<note style="tip">
<title>Manually switching between browse mode and focus mode</title>
<p>
In order to start or stop interacting with the focused form field,
use <keyseq><key>Orca Modifier</key><key>A</key></keyseq> to switch
between browse mode and focus mode.
</p>
</note>
</section>
<section id="page_navigation_focus_native">
<title>Automatic focus mode during native navigation</title>
<p>
If this checkbox is checked, <app>Orca</app> will automatically turn on
focus mode when you use native browser navigation commands to navigate to a
form field. For example, pressing <key>Tab</key> to move to the next entry
would move focus there and also turn focus mode on so that your next press
of <key>E</key> would type an "e" into that entry. If this checkbox is not
checked, then <app>Orca</app> will leave you in browse mode and your next
press of <key>E</key> would move you to the next entry on the page.
</p>
<p>
Default value: checked
</p>
<note style="tip">
<title>Manually switching between browse mode and focus mode</title>
<p>
In order to start or stop interacting with the focused form field,
use <keyseq><key>Orca Modifier</key><key>A</key></keyseq> to switch
between browse mode and focus mode.
</p>
</note>
</section>
<section id="page_navigation_speak">
<title>Automatically start speaking a page when it is first loaded</title>
<p>
If this checkbox is checked, <app>Orca</app> will perform a Say All on
the newly opened web page or email.
</p>
<p>
Default value: checked for Firefox; not checked for Thunderbird
</p>
</section>
<section id="page_navigation_summary">
<title>Present summary of a page when it is first loaded</title>
<p>
If this checkbox is checked, <app>Orca</app> will summarize details about the
newly opened web page or email, such as the number of headings, landmarks,
and links.
</p>
<p>
Default value: checked for Firefox; not checked for Thunderbird
</p>
</section>
<section id="page_navigation_layout_mode">
<title>Enable layout mode for content</title>
<p>
If this checkbox is checked, <app>Orca</app>'s caret navigation will respect
the on-screen layout of the content and present the full line, including any
links or form fields on that line. If this checkbox is not checked, <app>Orca</app>
will treat objects such as links and form fields as if they were on separate
lines, both for presentation and navigation.
</p>
<p>
Default value: checked
</p>
</section>
</section>
<section id="table_options">
<title>Table Options</title>
<note>
<p>
To learn more about <app>Orca</app>'s options for navigating within
tables, please see <link xref="preferences_table_navigation">Table
Navigation Preferences</link>.
</p>
</note>
</section>
<section id="find_options">
<title>Find Options</title>
<p>
The <gui>Find Options</gui> group of controls make it possible for you to
customize how <app>Orca</app> presents the results of a search conducted
using the application's built-in search functionality.
</p>
<section id="find_options_speak_during_find">
<title>Speak results during find</title>
<p>
If this checkbox is checked, <app>Orca</app> will read the line which
matches your current search query.
</p>
<p>
Default value: checked
</p>
</section>
<section id="find_options_speak_changed_lines_during_find">
<title>Only speak changed lines during find</title>
<p>
If this checkbox is checked, <app>Orca</app> will not present the
matching line if it is the same line as the previous match. This
option is designed to prevent "chattiness" on a line with multiple
instances of the string for which you are searching.
</p>
<p>
Default value: not checked
</p>
</section>
<section id="find_options_minimum_match_length">
<title>Minimum length of matched text</title>
<p>
This editable spin button is where you can specify the number of
characters which must match before <app>Orca</app> announces the
matching line. This option is also designed to prevent "chattiness"
as there are many matches when you first begin typing the string
for which you are searching.
</p>
<p>
Default value: 4
</p>
</section>
</section>
</page>