295 lines
8.8 KiB
Plaintext
295 lines
8.8 KiB
Plaintext
<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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu 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>Cthulhu 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>Cthulhu 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>Cthulhu 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>Cthulhu 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>Cthulhu 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>Cthulhu Modifier</key><key>Comma</key></keyseq>
|
|
(triple-clicked)
|
|
</p>
|
|
</item>
|
|
</list>
|
|
</item>
|
|
</list>
|
|
</section>
|
|
<section id="say_all">
|
|
<title>Say All</title>
|
|
<p>
|
|
Cthulhu's Say All command will cause <app>Cthulhu</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>Cthulhu Modifier</key><key>Semicolon</key></keyseq>
|
|
</p>
|
|
</item>
|
|
</list>
|
|
</section>
|
|
<section id="attributes_and_selection">
|
|
<title>Text Attributes and Selected Text</title>
|
|
<p>
|
|
<app>Cthulhu</app> has a dedicated command for obtaining the attributes of the
|
|
text at the caret location. In addition, if you use <app>Cthulhu</app>'s
|
|
Where Am I commands from within a text object in which text has been
|
|
selected, <app>Cthulhu</app> will announce the selected text. <app>Cthulhu</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>Cthulhu 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>Cthulhu 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>Cthulhu Modifier</key><key>Return</key></keyseq>
|
|
(double-clicked)
|
|
</p>
|
|
</item>
|
|
</list>
|
|
</item>
|
|
<item>
|
|
<p>
|
|
Speak current selection:
|
|
<keyseq><key>Cthulhu 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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu Modifier</key><key>A</key></keyseq>
|
|
</p>
|
|
</item>
|
|
<item>
|
|
<p>
|
|
Enable sticky focus mode:
|
|
<keyseq><key>Cthulhu Modifier</key><key>A</key></keyseq> (double-clicked)
|
|
</p>
|
|
</item>
|
|
<item>
|
|
<p>
|
|
Enable sticky browse mode:
|
|
<keyseq><key>Cthulhu 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>Cthulhu</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>Cthulhu</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>Cthulhu</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>
|