Fixes to the new meson/ninja build system. Pretty close to working... I think.
This commit is contained in:
Storm Dragon
@@ -1,7 +1,7 @@
|
||||
# Maintainer: Storm Dragon <storm_dragon@stormux.org>
|
||||
|
||||
pkgname=cthulhu
|
||||
pkgver=2025.08.10
|
||||
pkgver=2025.08.11
|
||||
pkgrel=1
|
||||
pkgdesc="Desktop-agnostic screen reader with plugin system, forked from Orca"
|
||||
url="https://git.stormux.org/storm/cthulhu"
|
||||
@@ -56,9 +56,9 @@ optdepends=(
|
||||
'espeak: Legacy TTS engine'
|
||||
|
||||
# AI Assistant providers (optional)
|
||||
'python-anthropic: Claude AI provider support'
|
||||
'python-openai: ChatGPT AI provider support'
|
||||
'python-google-generativeai: Gemini AI provider support'
|
||||
'claude-code: Claude AI provider support'
|
||||
'openai-codex: ChatGPT AI provider support'
|
||||
'gemini-cli: Gemini AI provider support'
|
||||
'ollama: Local AI model support'
|
||||
)
|
||||
makedepends=(
|
||||
@@ -84,7 +84,7 @@ pkgver() {
|
||||
|
||||
build() {
|
||||
cd cthulhu
|
||||
arch-meson _build -Dhelp=false
|
||||
arch-meson _build
|
||||
meson compile -C _build
|
||||
}
|
||||
|
||||
|
||||
@@ -1,34 +0,0 @@
|
||||
<page xmlns="http://projectmallard.org/1.0/" type="guide" id="commands">
|
||||
<info>
|
||||
<link type="next" xref="commands_controlling_cthulhu" />
|
||||
<link type="guide" xref="index#quick_reference" />
|
||||
<title type="sort">4. <app>Cthulhu</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>Cthulhu</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>
|
||||
@@ -1,57 +0,0 @@
|
||||
<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>Cthulhu</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>Cthulhu 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>Cthulhu Modifier</key><key>Alt</key><key>B</key></keyseq>
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
Go to a specific, numbered bookmark: <keyseq><key>Cthulhu 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>Cthulhu 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>Cthulhu Modifier</key><key>B</key></keyseq>
|
||||
</p>
|
||||
</item>
|
||||
</list>
|
||||
</page>
|
||||
@@ -1,40 +0,0 @@
|
||||
<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>Cthulhu</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>
|
||||
|
||||
|
||||
@@ -1,52 +0,0 @@
|
||||
<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>Cthulhu</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>Cthulhu 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>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -1,86 +0,0 @@
|
||||
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="commands_controlling_cthulhu">
|
||||
<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 Cthulhu</title>
|
||||
<title type="link">Controlling and Learning to Use Cthulhu</title>
|
||||
<desc>
|
||||
Commands for interacting with <app>Cthulhu</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 Cthulhu</title>
|
||||
<section id="controlling">
|
||||
<title>Commands for Controlling <app>Cthulhu</app></title>
|
||||
<p>
|
||||
The following commands can be used to get into <app>Cthulhu</app>'s
|
||||
Preferences dialogs, toggle <app>Cthulhu</app> on and off, and bypass
|
||||
<app>Cthulhu</app> commands to avoid shortcut conflicts within the
|
||||
application being accessed.
|
||||
</p>
|
||||
<list>
|
||||
<item>
|
||||
<p>
|
||||
Toggle <app>Cthulhu</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>Cthulhu</app> in another desktop environment in which
|
||||
there is no command to toggle <app>Cthulhu</app> on and off, you may find the
|
||||
command to quit <app>Cthulhu</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">Cthulhu Preferences</link> dialog:
|
||||
<keyseq><key>Cthulhu Modifier</key><key>Space</key></keyseq>.
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
Cthulhu's Preferences dialog for the focused application:
|
||||
<keyseq><key>Ctrl</key><key>Cthulhu Modifier</key><key>Space</key></keyseq>.
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
Pass the next command on to the current application:
|
||||
<keyseq><key>Cthulhu Modifier</key><key>BackSpace</key></keyseq>
|
||||
</p>
|
||||
</item>
|
||||
</list>
|
||||
</section>
|
||||
<section id="learning">
|
||||
<title>Commands for Learning to Use <app>Cthulhu</app></title>
|
||||
<p>
|
||||
In Learn Mode, <app>Cthulhu</app> will announce each keystroke you pressed
|
||||
along with any associated <app>Cthulhu</app> command that keystroke is bound
|
||||
to. In this mode, you can also get a list of shortcuts containing all the
|
||||
<app>Cthulhu</app> commands you can use.
|
||||
</p>
|
||||
<list>
|
||||
<item>
|
||||
<p>
|
||||
Enter Learn Mode:
|
||||
<keyseq><key>Cthulhu Modifier</key><key>H</key></keyseq>
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
Exit Learn Mode:
|
||||
<keyseq><key>Esc</key></keyseq>
|
||||
</p>
|
||||
</item>
|
||||
</list>
|
||||
</section>
|
||||
</page>
|
||||
@@ -1,29 +0,0 @@
|
||||
<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>
|
||||
@@ -1,76 +0,0 @@
|
||||
<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_cthulhu_find" />
|
||||
<title type="sort">2. Cthulhu Find</title>
|
||||
<title type="link">Cthulhu 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>Cthulhu Find Commands</title>
|
||||
<p>
|
||||
<app>Cthulhu</app>'s <link xref="howto_cthulhu_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>Cthulhu</app> Find dialog:</p>
|
||||
<list>
|
||||
<item>
|
||||
<p>Desktop: <keyseq><key>KP Delete</key></keyseq></p>
|
||||
</item>
|
||||
<item>
|
||||
<p>Laptop: <keyseq><key>Cthulhu 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>Cthulhu Modifier</key><key>KP Delete</key></keyseq>
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
Laptop:
|
||||
<keyseq><key>Cthulhu 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>Cthulhu Modifier</key><key>Shift</key><key>KP Delete</key>
|
||||
</keyseq>
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
Laptop:
|
||||
<keyseq>
|
||||
<key>Cthulhu Modifier</key><key>Ctrl</key><key>Right Bracket</key>
|
||||
</keyseq>
|
||||
</p>
|
||||
</item>
|
||||
</list>
|
||||
</item>
|
||||
</list>
|
||||
</page>
|
||||
@@ -1,199 +0,0 @@
|
||||
<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>
|
||||
Cthulhu'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>Cthulhu Modifier</key><key>KP 7</key></keyseq></p></item>
|
||||
<item><p>Laptop: <keyseq><key>Cthulhu 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>Cthulhu 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>Cthulhu 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>Cthulhu 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>Cthulhu 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>Cthulhu Modifier</key><key>O</key></keyseq></p></item>
|
||||
</list>
|
||||
</item>
|
||||
<item><p>Last line (The "end" position):</p>
|
||||
<list>
|
||||
<item><p>Desktop: <keyseq><key>Cthulhu Modifier</key><key>KP 9</key></keyseq></p></item>
|
||||
<item><p>Laptop: <keyseq><key>Cthulhu 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>Cthulhu Modifier</key><key>KP 4</key></keyseq></p></item>
|
||||
<item><p>Laptop: <keyseq><key>Cthulhu 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>Cthulhu 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>Cthulhu 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>Cthulhu 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>Cthulhu 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>Cthulhu Modifier</key><key>L</key></keyseq></p></item>
|
||||
</list>
|
||||
</item>
|
||||
<item><p>Word below:</p>
|
||||
<list>
|
||||
<item><p>Desktop: <keyseq><key>Cthulhu Modifier</key><key>KP 6</key></keyseq></p></item>
|
||||
<item><p>Laptop: <keyseq><key>Cthulhu 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>Cthulhu 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>Cthulhu 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>Cthulhu 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>Cthulhu 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>Cthulhu Modifier</key><key>Period</key></keyseq></p></item>
|
||||
</list>
|
||||
</item>
|
||||
<item><p>Last character on current line:</p>
|
||||
<list>
|
||||
<item><p>Desktop: <keyseq><key>Cthulhu Modifier</key><key>KP 1</key></keyseq></p></item>
|
||||
<item><p>Laptop: <keyseq><key>Cthulhu 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>Cthulhu Modifier</key><key>KP Subtract</key></keyseq></p></item>
|
||||
<item><p>Laptop: <keyseq><key>Cthulhu Modifier</key><key>P</key></keyseq></p></item>
|
||||
</list>
|
||||
</item>
|
||||
<item><p>Review current item/widget:</p>
|
||||
<list>
|
||||
<item><p>Desktop: <keyseq><key>Cthulhu Modifier</key><key>KP 5</key></keyseq></p></item>
|
||||
<item><p>Laptop: <keyseq><key>Cthulhu 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>Cthulhu 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>
|
||||
@@ -1,62 +0,0 @@
|
||||
<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>Cthulhu 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>Cthulhu Modifier</key><key>F1</key></keyseq> through <key>F9</key>
|
||||
</p>
|
||||
</item>
|
||||
</list>
|
||||
</page>
|
||||
@@ -1,72 +0,0 @@
|
||||
<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>Cthulhu</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>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>
|
||||
<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>Cthulhu 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>Cthulhu Modifier</key><key>8</key></keyseq></p></item>
|
||||
</list>
|
||||
</item>
|
||||
<item>
|
||||
<p>Route pointer to current item:</p>
|
||||
<list>
|
||||
<item><p>Desktop: <keyseq><key>Cthulhu Modifier</key><key>KP Divide</key></keyseq></p></item>
|
||||
<item><p>Laptop: <keyseq><key>Cthulhu 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>Cthulhu Modifier</key><key>KP Multiply</key></keyseq></p></item>
|
||||
<item><p>Laptop: <keyseq><key>Cthulhu Modifier</key><key>0</key></keyseq></p></item>
|
||||
</list>
|
||||
</item>
|
||||
<item>
|
||||
<p>Enable/disable mouse review mode: (Unbound)</p>
|
||||
</item>
|
||||
</list>
|
||||
</page>
|
||||
@@ -1,35 +0,0 @@
|
||||
<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>
|
||||
@@ -1,294 +0,0 @@
|
||||
<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>
|
||||
@@ -1,83 +0,0 @@
|
||||
<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>Cthulhu</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>Cthulhu</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>Cthulhu Modifier</key><key>S</key></keyseq>
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
Toggle between cell and row reading in a table:
|
||||
<keyseq><key>Cthulhu Modifier</key><key>F11</key></keyseq>
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
Toggle between verbose and brief verbosity levels:
|
||||
<keyseq><key>Cthulhu 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>
|
||||
|
||||
|
||||
@@ -1,443 +0,0 @@
|
||||
<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>Cthulhu</app>
|
||||
provides structural navigation support.
|
||||
</p>
|
||||
<list>
|
||||
<item>
|
||||
<p>
|
||||
Enable/disable Structural Navigation keys:
|
||||
<keyseq><key>Cthulhu 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>
|
||||
@@ -1,57 +0,0 @@
|
||||
<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>
|
||||
Cthulhu'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>Cthulhu Modifier</key><key>C</key></keyseq>
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
Set dynamic column headers to current row:
|
||||
<keyseq><key>Cthulhu Modifier</key><key>R</key></keyseq>
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
Clear dynamic row headers:
|
||||
<keyseq><key>Cthulhu Modifier</key><key>C</key></keyseq> (double-clicked)
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
Clear dynamic column headers:
|
||||
<keyseq><key>Cthulhu Modifier</key><key>R</key></keyseq> (double-clicked)
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
Toggle between cell and row reading in a table:
|
||||
<keyseq><key>Cthulhu Modifier</key><key>F11</key></keyseq>
|
||||
</p>
|
||||
</item>
|
||||
</list>
|
||||
</page>
|
||||
@@ -1,63 +0,0 @@
|
||||
<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>Cthulhu Modifier</key><key>T</key></keyseq>
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
Present the date: <keyseq><key>Cthulhu Modifier</key><key>T</key></keyseq>
|
||||
(double-clicked)
|
||||
</p>
|
||||
</item>
|
||||
</list>
|
||||
</section>
|
||||
<section id="notifications">
|
||||
<title>Reviewing Notification Messages</title>
|
||||
<p>
|
||||
Cthulhu 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>
|
||||
@@ -1,97 +0,0 @@
|
||||
<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>Cthulhu</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>Cthulhu</app> to present can be found in the
|
||||
<link xref="howto_whereami">Introduction to Where Am I</link>.
|
||||
</p>
|
||||
<p><app>Cthulhu</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>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>
|
||||
</list>
|
||||
<p>
|
||||
In addition to the dedicated Where Am I commands, <app>Cthulhu</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>Cthulhu Modifier</key><key>KP Enter</key></keyseq>
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
Laptop: <keyseq><key>Cthulhu Modifier</key><key>Slash</key></keyseq>
|
||||
</p>
|
||||
</item>
|
||||
</list>
|
||||
</item>
|
||||
<item>
|
||||
<p>Present the status bar:</p>
|
||||
<list>
|
||||
<item>
|
||||
<p>
|
||||
Desktop: <keyseq><key>Cthulhu Modifier</key><key>KP Enter</key></keyseq>
|
||||
(double-clicked)
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
Laptop: <keyseq><key>Cthulhu 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>
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 2.2 KiB |
@@ -1,54 +0,0 @@
|
||||
<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>Cthulhu</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 Cthulhu session to Cthulhu 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>
|
||||
@@ -1,112 +0,0 @@
|
||||
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_cthulhu_find">
|
||||
<info>
|
||||
<link type="guide" xref="index#reviewing"/>
|
||||
<link type="next" xref="howto_mouse_review" />
|
||||
<title type="sort">3. Cthulhu 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>Cthulhu Find</title>
|
||||
<p>
|
||||
<app>Cthulhu</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 Cthulhu Find</title>
|
||||
<p>
|
||||
To open the Cthulhu <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>Cthulhu 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">Cthulhu Find commands</link>
|
||||
</p>
|
||||
</note>
|
||||
<p>
|
||||
When you activate Cthulhu 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 Cthulhu 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">Cthulhu's Mouse/Pointer-Related Commands</link>.
|
||||
</p>
|
||||
</page>
|
||||
@@ -1,67 +0,0 @@
|
||||
<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>Cthulhu</app>
|
||||
will present your new location. As a result, you are likely already familiar with
|
||||
how to read a document using <app>Cthulhu</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>Cthulhu</app>'s <link xref="howto_flat_review">Flat
|
||||
Review feature</link>.
|
||||
</p>
|
||||
<p>
|
||||
Finally, in order to have <app>Cthulhu</app> speak the entire document from your
|
||||
present location, use the Say All command. It, along with a more complete
|
||||
listing of <app>Cthulhu</app>'s commands for accessing document text, can
|
||||
be found in the <link xref="commands_reading">Reading Commands</link> guide.
|
||||
</p>
|
||||
</page>
|
||||
@@ -1,46 +0,0 @@
|
||||
<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_cthulhu_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>Cthulhu</app>'s Flat Review feature allows you to spatially review the
|
||||
contents, both text and widgets, of the active window. In this mode,
|
||||
<app>Cthulhu</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_cthulhu_find">Cthulhu 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>Cthulhu</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>
|
||||
@@ -1,95 +0,0 @@
|
||||
<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>Cthulhu</app>,
|
||||
you are interacting with the document itself; not a buffered copy of that
|
||||
document. <app>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu
|
||||
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>Cthulhu</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>Cthulhu</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>Cthulhu
|
||||
Modifier</key><key>A</key></keyseq>.
|
||||
</p>
|
||||
</note>
|
||||
</section>
|
||||
</page>
|
||||
|
||||
@@ -1,141 +0,0 @@
|
||||
<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>
|
||||
Cthulhu has many commands, some of which are bound to a keystroke, others
|
||||
of which are unbound. You can bind, rebind, and unbind <app>Cthulhu</app>'s
|
||||
commands by following the steps below.</p>
|
||||
<steps>
|
||||
<title>Binding an Unbound Command</title>
|
||||
<item>
|
||||
<p>
|
||||
Get into the <link xref="preferences">Cthulhu Preferences</link> dialog
|
||||
by pressing <keyseq><key>Cthulhu 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">Cthulhu Preferences</link> dialog by
|
||||
pressing <keyseq><key>Cthulhu 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">Cthulhu Preferences</link> dialog by
|
||||
pressing <keyseq><key>Cthulhu 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">Cthulhu Preferences</link> dialog by
|
||||
pressing <keyseq><key>Cthulhu 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>
|
||||
@@ -1,62 +0,0 @@
|
||||
<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>
|
||||
Cthulhu has two keyboard layouts: Desktop (i.e. with a numeric keypad) and
|
||||
Laptop. The layout you choose impacts which key is used as the Cthulhu Modifier.
|
||||
</p>
|
||||
<list>
|
||||
<item>
|
||||
<p>
|
||||
If you are using the Laptop layout, the default Cthulhu Modifier will be
|
||||
<key>CapsLock</key>
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
If you are using the Desktop layout, the Cthulhu 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>Cthulhu</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">Cthulhu Preferences</link> dialog
|
||||
by pressing <keyseq><key>Cthulhu 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>
|
||||
@@ -1,69 +0,0 @@
|
||||
<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>Cthulhu</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>Cthulhu</app> will announce each keystroke you pressed
|
||||
along with any associated <app>Cthulhu</app> command that keystroke is bound
|
||||
to. In this mode, you can also get a list of shortcuts containing all the
|
||||
<app>Cthulhu</app> commands you can use.
|
||||
</p>
|
||||
<steps>
|
||||
<title>Using Learn Mode</title>
|
||||
<item>
|
||||
<p>
|
||||
Get into Learn Mode by pressing <keyseq><key>Cthulhu Modifier</key>
|
||||
<key>H</key></keyseq>.
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
Press any key or keystroke. <app>Cthulhu</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>Cthulhu Modifier</key>
|
||||
<key>H</key></keyseq>.
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
Press <key>F2</key> if you want a list of shortcuts that apply
|
||||
<app>Cthulhu</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>
|
||||
@@ -1,60 +0,0 @@
|
||||
<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="cthulhu_support">
|
||||
<title><app>Cthulhu</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>Cthulhu</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>
|
||||
@@ -1,50 +0,0 @@
|
||||
<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>Cthulhu</app>'s Mouse Review feature causes <app>Cthulhu</app> to present
|
||||
the object under the mouse pointer. Unlike <app>Cthulhu</app>'s
|
||||
<link xref="howto_flat_review">Flat Review</link> feature, Mouse Review
|
||||
is not limited to the active window; instead, <app>Cthulhu</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>Cthulhu</app> will present that object
|
||||
and its information to you.
|
||||
</p>
|
||||
<p>
|
||||
Because enabling Mouse Review causes <app>Cthulhu</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>Cthulhu</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>
|
||||
@@ -1,69 +0,0 @@
|
||||
<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>Cthulhu</app> will present these messages to you as they come in, it is
|
||||
far too easy to interrupt <app>Cthulhu</app>'s announcement accidentally by
|
||||
continuing to type or to change focus. For this reason, <app>Cthulhu</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>Cthulhu</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>
|
||||
@@ -1,116 +0,0 @@
|
||||
<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>
|
||||
Cthulhu'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">Cthulhu 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">Cthulhu 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">Cthulhu 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>Cthulhu</app>,
|
||||
the newly-selected profile will be used.
|
||||
</p>
|
||||
</item>
|
||||
</steps>
|
||||
</page>
|
||||
@@ -1,30 +0,0 @@
|
||||
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_setting_up_cthulhu">
|
||||
<info>
|
||||
<link type="seealso" xref="preferences" />
|
||||
<link type="guide" xref="index#getting_started" />
|
||||
<link type="next" xref="howto_the_cthulhu_modifier" />
|
||||
<title type="sort">4. Cthulhu Configuration</title>
|
||||
<title type="link">Configuration</title>
|
||||
<desc>
|
||||
Setting up <app>Cthulhu</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>Cthulhu Configuration</title>
|
||||
|
||||
<p>
|
||||
If you want to configure <app>Cthulhu</app>, get into the
|
||||
<link xref="preferences">Preferences</link> dialog by pressing
|
||||
<keyseq><key>Cthulhu Modifier</key><key>Space</key></keyseq> from
|
||||
within any accessible application. Alternatively, you can type
|
||||
<cmd>cthulhu</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>
|
||||
@@ -1,123 +0,0 @@
|
||||
<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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu Modifier</key><key>Z</key></keyseq>.
|
||||
When you are finished navigating and ready to resume writing, press
|
||||
<keyseq><key>Cthulhu 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>Cthulhu</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>Cthulhu</app> has
|
||||
Structural Navigation support.
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
Get into the <link xref="preferences">Cthulhu Preferences</link>
|
||||
dialog box for the current application by pressing
|
||||
<keyseq>
|
||||
<key>Ctrl</key><key>Cthulhu 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>
|
||||
@@ -1,148 +0,0 @@
|
||||
<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>Cthulhu</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 Cthulhu announce the sender, subject, date, and presence
|
||||
of attachments you would need <app>Cthulhu</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>Cthulhu</app>
|
||||
to only speak the cell with focus. Similar situations occur in document
|
||||
tables.
|
||||
</p>
|
||||
<p>
|
||||
<app>Cthulhu</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>Cthulhu</app>'s table reading preferences <app>Cthulhu</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>Cthulhu</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>Cthulhu</app> command which allows you to toggle
|
||||
cell versus row reading on the fly for the currently-active table:
|
||||
<keyseq><key>Cthulhu Modifier</key><key>F11</key></keyseq>.
|
||||
</p>
|
||||
</section>
|
||||
<section id="structural_navigation">
|
||||
<title>Structural Navigation</title>
|
||||
<p>
|
||||
<app>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu Modifier</key><key>R</key></keyseq> to tell
|
||||
<app>Cthulhu</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>Cthulhu Modifier</key><key>C</key></keyseq> to tell
|
||||
<app>Cthulhu</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>Cthulhu</app> will present each
|
||||
header that has changed. Or to put it another way, <app>Cthulhu</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>Cthulhu Modifier</key><key>R</key></keyseq>
|
||||
tells <app>Cthulhu</app> there are no column headers. Double-clicking
|
||||
<keyseq><key>Cthulhu Modifier</key><key>C</key></keyseq> tells <app>Cthulhu</app>
|
||||
there are no row headers.
|
||||
</p>
|
||||
</section>
|
||||
</page>
|
||||
@@ -1,71 +0,0 @@
|
||||
<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>Cthulhu Modifier</key><key>F</key>
|
||||
</keyseq>, <app>Cthulhu</app> will speak known text attribute
|
||||
information about an object. In addition, <app>Cthulhu</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>Cthulhu</app> will present in speech,
|
||||
along with the order in which they should be presented, and which ones
|
||||
<app>Cthulhu</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>Cthulhu</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>Cthulhu</app> will announce the
|
||||
presence of the spelling error.
|
||||
</p>
|
||||
</section>
|
||||
</page>
|
||||
@@ -1,75 +0,0 @@
|
||||
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="howto_the_cthulhu_modifier">
|
||||
<info>
|
||||
<link type="guide" xref="index#getting_started"/>
|
||||
<link type="next" xref="howto_learn_modes" />
|
||||
<title type="sort">3. The Cthulhu 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 Cthulhu Modifier</title>
|
||||
<p>
|
||||
Cthulhu 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>Cthulhu</app> commands and doing so without
|
||||
introducing conflicts with the commands of the applications you
|
||||
are accessing.
|
||||
</p>
|
||||
<p>
|
||||
Which key the "Cthulhu Modifier" is bound to will, by default, depend
|
||||
on whether you are using <app>Cthulhu</app>'s Laptop keyboard layout
|
||||
or its Desktop keyboard layout:
|
||||
</p>
|
||||
<list>
|
||||
<item>
|
||||
<p>
|
||||
If you are using the Laptop layout, the default Cthulhu Modifier
|
||||
will be <key>CapsLock</key>
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
If you are using the Desktop layout, the Cthulhu 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 Cthulhu Modifier</title>
|
||||
<item>
|
||||
<p>
|
||||
Get into the <link xref="preferences">Cthulhu Preferences</link> dialog by
|
||||
pressing <keyseq><key>Cthulhu Modifier</key><key>Space</key></keyseq>. Alternatively, you can start Cthulhu with the preferences dialog open from a terminal: type <cmd>cthulhu -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>
|
||||
@@ -1,37 +0,0 @@
|
||||
<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>Cthulhu 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>
|
||||
Cthulhu has two keyboard layouts: Desktop and Laptop. The layout you choose
|
||||
impacts which key is used as the Cthulhu Modifier. If you are using the Laptop
|
||||
layout, the default Cthulhu Modifier will be <key>CapsLock</key>. If you are
|
||||
using <app>Cthulhu</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>Cthulhu Modifier</key><key>BackSpace</key>
|
||||
</keyseq>, to tell <app>Cthulhu</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>
|
||||
@@ -1,110 +0,0 @@
|
||||
<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, Cthulhu 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>Cthulhu</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>Cthulhu</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>Cthulhu</app> to
|
||||
present the full details of the error.
|
||||
</p>
|
||||
</item>
|
||||
</list>
|
||||
<p>
|
||||
And so on. Again, the goal of <app>Cthulhu</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>
|
||||
@@ -1,47 +0,0 @@
|
||||
<page xmlns="http://projectmallard.org/1.0/"
|
||||
xmlns:its="http://www.w3.org/2005/11/its"
|
||||
type="guide"
|
||||
id="index">
|
||||
<info>
|
||||
<title type="text">Cthulhu Screen Reader</title>
|
||||
<title type="link">Introduction to the <app>Cthulhu</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>Cthulhu 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/cthulhu-logo.png" its:translate="no">
|
||||
<span its:translate="yes"><app>Cthulhu</app>'s logo</span>
|
||||
</media>
|
||||
<app>Cthulhu</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>
|
||||
@@ -1,138 +0,0 @@
|
||||
<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_cthulhu" />
|
||||
<title type="sort">1. Welcome to Cthulhu</title>
|
||||
<desc>
|
||||
Introducing the <app>Cthulhu</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 Cthulhu</title>
|
||||
<p>
|
||||
<app>Cthulhu</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>Cthulhu</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>Cthulhu</app></title>
|
||||
<p>To launch <app>Cthulhu</app>:</p>
|
||||
<list>
|
||||
<item>
|
||||
<p>
|
||||
The method for configuring <app>Cthulhu</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>Cthulhu</app> on and off in GNOME, press
|
||||
<keyseq><key>Super</key><key>Alt</key><key>S</key></keyseq>.
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
Type <cmd>cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</app> profile file
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
<cmd>-r</cmd>, <cmd>--replace</cmd>: Replace a currently-running <app>Cthulhu</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>
|
||||
@@ -1,21 +0,0 @@
|
||||
<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>Cthulhu</app>'s Preferences Dialogs</title>
|
||||
<section id="cthulhu" style="2column">
|
||||
<title>Cthulhu Preferences</title>
|
||||
</section>
|
||||
<section id="application" style="2column">
|
||||
<title>Application-Unique Preferences</title>
|
||||
</section>
|
||||
</page>
|
||||
@@ -1,183 +0,0 @@
|
||||
<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>Cthulhu</app>'s braille display support
|
||||
</desc>
|
||||
<link type="guide" xref="preferences#cthulhu" />
|
||||
<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>Cthulhu</app> will make
|
||||
use of a braille display. If BrlTTY is not running, <app>Cthulhu</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>Cthulhu</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>Cthulhu</app> will adjust the
|
||||
text so that only full words are shown on the braille display. If it is not
|
||||
checked, <app>Cthulhu</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>
|
||||
Cthulhu supports contracted braille via the liblouis project. Because many
|
||||
distros include liblouis, you will likely automatically have access to
|
||||
contracted braille support in <app>Cthulhu</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>Cthulhu</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>Cthulhu</app>'s behavior
|
||||
when displaying selected text and hyperlinks. By default, when you
|
||||
encounter either, <app>Cthulhu</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>Cthulhu</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>Cthulhu</app> will
|
||||
present messages to you in braille. If you prefer to only have
|
||||
<app>Cthulhu</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>Cthulhu</app> will
|
||||
present detailed messages to you in braille. For instance, if you
|
||||
use <app>Cthulhu</app>'s command to change echo, <app>Cthulhu</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>Cthulhu</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>
|
||||
@@ -1,79 +0,0 @@
|
||||
<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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</app> has sufficient
|
||||
information identifying that your buddy is typing, <app>Cthulhu</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>Cthulhu</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>Cthulhu</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>
|
||||
@@ -1,279 +0,0 @@
|
||||
<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>Cthulhu</app>'s fundamental behaviors
|
||||
</desc>
|
||||
<link type="guide" xref="preferences#cthulhu" />
|
||||
<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>Cthulhu</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>Cthulhu
|
||||
Modifier</key> as well as a number of keyboard shortcuts for performing
|
||||
<app>Cthulhu</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>Cthulhu</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>Cthulhu</app> to present
|
||||
information about the object under the mouse pointer as you move
|
||||
it around the screen using <app>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</app> only
|
||||
presenting updates for progress bars in the active window.
|
||||
</p>
|
||||
<p>
|
||||
Default value: <gui>Application</gui>
|
||||
</p>
|
||||
</section>
|
||||
</section>
|
||||
</page>
|
||||
@@ -1,59 +0,0 @@
|
||||
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="preferences_introduction">
|
||||
<info>
|
||||
<title type="sort">0. Introduction to <app>Cthulhu</app>'s Preferences</title>
|
||||
<title type="link">Introduction to <app>Cthulhu</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>Cthulhu</app>'s Preferences</title>
|
||||
<section id="cthulhu">
|
||||
<title>Cthulhu Preferences</title>
|
||||
<p>
|
||||
Cthulhu preferences allow you to customize functionality in <app>Cthulhu</app>
|
||||
which applies to all applications. An example of an Cthulhu preference is
|
||||
echo because echo is something that applies to all applications.
|
||||
</p>
|
||||
<p>
|
||||
Note that Cthulhu 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>Cthulhu</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>Cthulhu Modifier</key><key>Space</key></keyseq>:
|
||||
<app>Cthulhu</app>'s Preferences
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
<keyseq><key>Ctrl</key><key>Cthulhu Modifier</key><key>Space</key>
|
||||
</keyseq>: <app>Cthulhu</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 Cthulhu preferences, there are application-unique preferences.
|
||||
These preferences allow you to customize <app>Cthulhu</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>
|
||||
@@ -1,75 +0,0 @@
|
||||
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="preferences_key_bindings">
|
||||
<info>
|
||||
<link type="guide" xref="preferences#cthulhu"/>
|
||||
<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>Cthulhu</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="cthulhu_modifier_keys">
|
||||
<title>Cthulhu 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 Cthulhu 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>Cthulhu</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>Cthulhu</app> command to be performed.
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
The <gui>Key Binding</gui> column contains the keyboard shortcut currently
|
||||
assigned to the <app>Cthulhu</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>Cthulhu</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>
|
||||
@@ -1,183 +0,0 @@
|
||||
<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#cthulhu" />
|
||||
<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>
|
||||
Cthulhu'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>Cthulhu
|
||||
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 Cthulhu 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>Cthulhu</app> to announce what you just <em>
|
||||
pressed</em>.
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
Character echo causes <app>Cthulhu</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>Cthulhu</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>Cthulhu</app> to echo the word you just typed. Similarly,
|
||||
checking the <gui>Enable echo by sentence</gui> checkbox causes
|
||||
<app>Cthulhu</app> to echo the sentence you just typed.
|
||||
</p>
|
||||
<p>
|
||||
Default value: not checked
|
||||
</p>
|
||||
</section>
|
||||
</page>
|
||||
@@ -1,87 +0,0 @@
|
||||
<page xmlns="http://projectmallard.org/1.0/" type="topic"
|
||||
id="preferences_pronunciation">
|
||||
<info>
|
||||
<link type="guide" xref="preferences#cthulhu" />
|
||||
<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>Cthulhu</app> preferences
|
||||
dialog allows you to add, edit, and delete entries in <app>Cthulhu</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>
|
||||
@@ -1,348 +0,0 @@
|
||||
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="preferences_speech">
|
||||
<info>
|
||||
<link type="guide" xref="preferences#cthulhu" />
|
||||
<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>Cthulhu</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>Cthulhu</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>Cthulhu</app>
|
||||
will speak known mathematical symbols, currency symbols, and "^", "@",
|
||||
"/", "&", "#".
|
||||
</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>Cthulhu</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>Cthulhu</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>Cthulhu</app>'s System voice.
|
||||
</p>
|
||||
<section id="only_speak_displayed_text">
|
||||
<title>Only speak displayed text</title>
|
||||
<p>
|
||||
Checking this checkbox causes <app>Cthulhu</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>Cthulhu</app> will say "blank" each time you arrow to a blank
|
||||
line. If it is unchecked, <app>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</app> will
|
||||
present detailed messages to you in speech. For instance, if you use
|
||||
<app>Cthulhu</app>'s command to change echo, <app>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>
|
||||
@@ -1,65 +0,0 @@
|
||||
<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>Cthulhu</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>Cthulhu</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>Cthulhu</app>'s detailed <link xref="howto_whereami">Where Am I</link>
|
||||
command to have <app>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</app> will speak the sentence or
|
||||
line from the document in which the error is found.
|
||||
</p>
|
||||
<p>
|
||||
Default value: checked
|
||||
</p>
|
||||
</section>
|
||||
</page>
|
||||
@@ -1,69 +0,0 @@
|
||||
<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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</app> will skip blank cells when
|
||||
you are using <app>Cthulhu</app>'s table structural navigation commands to
|
||||
access the table.
|
||||
</p>
|
||||
<p>
|
||||
Default value: not checked
|
||||
</p>
|
||||
</section>
|
||||
</page>
|
||||
@@ -1,139 +0,0 @@
|
||||
<page xmlns="http://projectmallard.org/1.0/" type="topic"
|
||||
id="preferences_text_attributes">
|
||||
<info>
|
||||
<link type="guide" xref="preferences#cthulhu" />
|
||||
<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>Cthulhu</app>'s <gui>Text Attributes</gui> page allows you
|
||||
to customize which text attributes <app>Cthulhu</app> will present in speech,
|
||||
along with the order in which they should be presented, and which ones
|
||||
<app>Cthulhu</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>Cthulhu</app> to speak this attribute when you press
|
||||
<keyseq><key>Cthulhu Modifier</key><key>F</key></keyseq>.
|
||||
</p>
|
||||
</item>
|
||||
<item>
|
||||
<p>
|
||||
<gui>Mark in braille</gui>: Check this checkbox if you would
|
||||
like <app>Cthulhu</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>Cthulhu</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>
|
||||
@@ -1,138 +0,0 @@
|
||||
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="preferences_voice">
|
||||
<info>
|
||||
<link type="guide" xref="preferences#cthulhu" />
|
||||
<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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>
|
||||
@@ -1,223 +0,0 @@
|
||||
<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>Cthulhu</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>Cthulhu</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>Cthulhu</app>'s caret navigation on and off.
|
||||
When it is on, <app>Cthulhu</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>Cthulhu 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>Cthulhu</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, Cthulhu would switch to focus mode
|
||||
and subsequent presses of <key>Down</key> would be controlled by the web
|
||||
browser and not by Cthulhu. If this checkbox is not checked, <app>Cthulhu</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>Cthulhu 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>Cthulhu</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>Cthulhu 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>Cthulhu</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>Cthulhu</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>Cthulhu 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>Cthulhu</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>Cthulhu</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>Cthulhu 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>Cthulhu</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>Cthulhu</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>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. If this checkbox is not checked, <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>
|
||||
Default value: checked
|
||||
</p>
|
||||
</section>
|
||||
</section>
|
||||
<section id="table_options">
|
||||
<title>Table Options</title>
|
||||
<note>
|
||||
<p>
|
||||
To learn more about <app>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>Cthulhu</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>
|
||||
@@ -1,16 +0,0 @@
|
||||
# Languages with help documentation
|
||||
bg
|
||||
cs
|
||||
da
|
||||
de
|
||||
el
|
||||
es
|
||||
fr
|
||||
gl
|
||||
hu
|
||||
id
|
||||
pt_BR
|
||||
ru
|
||||
sl
|
||||
sv
|
||||
uk
|
||||
-533
@@ -1,533 +0,0 @@
|
||||
# Makefile.in generated by automake 1.18.1 from Makefile.am.
|
||||
# help/Makefile. Generated from Makefile.in by configure.
|
||||
|
||||
# Copyright (C) 1994-2025 Free Software Foundation, Inc.
|
||||
|
||||
# This Makefile.in is free software; the Free Software Foundation
|
||||
# gives unlimited permission to copy and/or distribute it,
|
||||
# with or without modifications, as long as this notice is preserved.
|
||||
|
||||
# This program is distributed in the hope that it will be useful,
|
||||
# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
|
||||
# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
|
||||
# PARTICULAR PURPOSE.
|
||||
|
||||
|
||||
|
||||
am__is_gnu_make = { \
|
||||
if test -z '$(MAKELEVEL)'; then \
|
||||
false; \
|
||||
elif test -n '$(MAKE_HOST)'; then \
|
||||
true; \
|
||||
elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \
|
||||
true; \
|
||||
else \
|
||||
false; \
|
||||
fi; \
|
||||
}
|
||||
am__make_running_with_option = \
|
||||
case $${target_option-} in \
|
||||
?) ;; \
|
||||
*) echo "am__make_running_with_option: internal error: invalid" \
|
||||
"target option '$${target_option-}' specified" >&2; \
|
||||
exit 1;; \
|
||||
esac; \
|
||||
has_opt=no; \
|
||||
sane_makeflags=$$MAKEFLAGS; \
|
||||
if $(am__is_gnu_make); then \
|
||||
sane_makeflags=$$MFLAGS; \
|
||||
else \
|
||||
case $$MAKEFLAGS in \
|
||||
*\\[\ \ ]*) \
|
||||
bs=\\; \
|
||||
sane_makeflags=`printf '%s\n' "$$MAKEFLAGS" \
|
||||
| sed "s/$$bs$$bs[$$bs $$bs ]*//g"`;; \
|
||||
esac; \
|
||||
fi; \
|
||||
skip_next=no; \
|
||||
strip_trailopt () \
|
||||
{ \
|
||||
flg=`printf '%s\n' "$$flg" | sed "s/$$1.*$$//"`; \
|
||||
}; \
|
||||
for flg in $$sane_makeflags; do \
|
||||
test $$skip_next = yes && { skip_next=no; continue; }; \
|
||||
case $$flg in \
|
||||
*=*|--*) continue;; \
|
||||
-*I) strip_trailopt 'I'; skip_next=yes;; \
|
||||
-*I?*) strip_trailopt 'I';; \
|
||||
-*O) strip_trailopt 'O'; skip_next=yes;; \
|
||||
-*O?*) strip_trailopt 'O';; \
|
||||
-*l) strip_trailopt 'l'; skip_next=yes;; \
|
||||
-*l?*) strip_trailopt 'l';; \
|
||||
-[dEDm]) skip_next=yes;; \
|
||||
-[JT]) skip_next=yes;; \
|
||||
esac; \
|
||||
case $$flg in \
|
||||
*$$target_option*) has_opt=yes; break;; \
|
||||
esac; \
|
||||
done; \
|
||||
test $$has_opt = yes
|
||||
am__make_dryrun = (target_option=n; $(am__make_running_with_option))
|
||||
am__make_keepgoing = (target_option=k; $(am__make_running_with_option))
|
||||
am__rm_f = rm -f $(am__rm_f_notfound)
|
||||
am__rm_rf = rm -rf $(am__rm_f_notfound)
|
||||
pkgdatadir = $(datadir)/cthulhu
|
||||
pkgincludedir = $(includedir)/cthulhu
|
||||
pkglibdir = $(libdir)/cthulhu
|
||||
pkglibexecdir = $(libexecdir)/cthulhu
|
||||
am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
|
||||
install_sh_DATA = $(install_sh) -c -m 644
|
||||
install_sh_PROGRAM = $(install_sh) -c
|
||||
install_sh_SCRIPT = $(install_sh) -c
|
||||
INSTALL_HEADER = $(INSTALL_DATA)
|
||||
transform = $(program_transform_name)
|
||||
NORMAL_INSTALL = :
|
||||
PRE_INSTALL = :
|
||||
POST_INSTALL = :
|
||||
NORMAL_UNINSTALL = :
|
||||
PRE_UNINSTALL = :
|
||||
POST_UNINSTALL = :
|
||||
build_triplet = x86_64-pc-linux-gnu
|
||||
host_triplet = x86_64-pc-linux-gnu
|
||||
subdir = help
|
||||
ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
|
||||
am__aclocal_m4_deps = $(top_srcdir)/m4/build-to-host.m4 \
|
||||
$(top_srcdir)/m4/gettext.m4 $(top_srcdir)/m4/host-cpu-c-abi.m4 \
|
||||
$(top_srcdir)/m4/iconv.m4 $(top_srcdir)/m4/intlmacosx.m4 \
|
||||
$(top_srcdir)/m4/lib-ld.m4 $(top_srcdir)/m4/lib-link.m4 \
|
||||
$(top_srcdir)/m4/lib-prefix.m4 $(top_srcdir)/m4/nls.m4 \
|
||||
$(top_srcdir)/m4/po.m4 $(top_srcdir)/m4/progtest.m4 \
|
||||
$(top_srcdir)/acinclude.m4 $(top_srcdir)/configure.ac
|
||||
am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
|
||||
$(ACLOCAL_M4)
|
||||
DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON)
|
||||
mkinstalldirs = $(install_sh) -d
|
||||
CONFIG_CLEAN_FILES =
|
||||
CONFIG_CLEAN_VPATH_FILES =
|
||||
AM_V_P = $(am__v_P_$(V))
|
||||
am__v_P_ = $(am__v_P_$(AM_DEFAULT_VERBOSITY))
|
||||
am__v_P_0 = false
|
||||
am__v_P_1 = :
|
||||
AM_V_GEN = $(am__v_GEN_$(V))
|
||||
am__v_GEN_ = $(am__v_GEN_$(AM_DEFAULT_VERBOSITY))
|
||||
am__v_GEN_0 = @echo " GEN " $@;
|
||||
am__v_GEN_1 =
|
||||
AM_V_at = $(am__v_at_$(V))
|
||||
am__v_at_ = $(am__v_at_$(AM_DEFAULT_VERBOSITY))
|
||||
am__v_at_0 = @
|
||||
am__v_at_1 =
|
||||
SOURCES =
|
||||
DIST_SOURCES =
|
||||
am__can_run_installinfo = \
|
||||
case $$AM_UPDATE_INFO_DIR in \
|
||||
n|no|NO) false;; \
|
||||
*) (install-info --version) >/dev/null 2>&1;; \
|
||||
esac
|
||||
am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP)
|
||||
am__DIST_COMMON = $(srcdir)/Makefile.in
|
||||
DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
|
||||
ACLOCAL = ${SHELL} '/home/storm/devel/cthulhu/missing' aclocal-1.18
|
||||
AMTAR = $${TAR-tar}
|
||||
AM_DEFAULT_VERBOSITY = 1
|
||||
ATKBRIDGE_CFLAGS = -I/usr/include/at-spi2-atk/2.0 -I/usr/include/at-spi-2.0 -I/usr/include/libmount -I/usr/include/blkid -I/usr/include/atk-1.0 -I/usr/include/dbus-1.0 -I/usr/lib/dbus-1.0/include -I/usr/include/glib-2.0 -I/usr/lib/glib-2.0/include -I/usr/include/sysprof-6 -pthread
|
||||
ATKBRIDGE_LIBS = -latk-bridge-2.0
|
||||
ATSPI2_CFLAGS = -I/usr/include/at-spi-2.0 -I/usr/include/dbus-1.0 -I/usr/lib/dbus-1.0/include -I/usr/include/glib-2.0 -I/usr/lib/glib-2.0/include -I/usr/include/libmount -I/usr/include/blkid -I/usr/include/sysprof-6 -pthread
|
||||
ATSPI2_LIBS = -latspi -ldbus-1 -lglib-2.0
|
||||
AUTOCONF = ${SHELL} '/home/storm/devel/cthulhu/missing' autoconf
|
||||
AUTOHEADER = ${SHELL} '/home/storm/devel/cthulhu/missing' autoheader
|
||||
AUTOMAKE = ${SHELL} '/home/storm/devel/cthulhu/missing' automake-1.18
|
||||
AWK = gawk
|
||||
CC = gcc
|
||||
CCDEPMODE = depmode=none
|
||||
CFLAGS = -g -O2
|
||||
CPP = gcc -E
|
||||
CPPFLAGS =
|
||||
CSCOPE = cscope
|
||||
CTAGS = ctags
|
||||
CYGPATH_W = echo
|
||||
DEFS = -DPACKAGE_NAME=\"cthulhu\" -DPACKAGE_TARNAME=\"cthulhu\" -DPACKAGE_VERSION=\"2025.08.06\" -DPACKAGE_STRING=\"cthulhu\ 2025.08.06\" -DPACKAGE_BUGREPORT=\"https://gitlab.gnome.org/GNOME/cthulhu/-/issues/\" -DPACKAGE_URL=\"\" -DPACKAGE=\"cthulhu\" -DVERSION=\"2025.08.06\" -DENABLE_NLS=1 -DHAVE_GETTEXT=1 -DHAVE_DCGETTEXT=1 -DGETTEXT_PACKAGE=\"cthulhu\"
|
||||
DEPDIR = .deps
|
||||
DESIRED_LINGUAS = $(ALL_LINGUAS)
|
||||
ECHO_C =
|
||||
ECHO_N = -n
|
||||
ECHO_T =
|
||||
ETAGS = etags
|
||||
EXEEXT =
|
||||
GETTEXT_MACRO_VERSION = 0.24
|
||||
GETTEXT_PACKAGE = cthulhu
|
||||
GMSGFMT = /usr/bin/msgfmt
|
||||
GMSGFMT_015 = /usr/bin/msgfmt
|
||||
GSTREAMER_CFLAGS = -I/usr/include/gstreamer-1.0 -I/usr/include/glib-2.0 -I/usr/lib/glib-2.0/include -I/usr/include/sysprof-6 -pthread
|
||||
GSTREAMER_LIBS = -lgstreamer-1.0 -lgobject-2.0 -lglib-2.0
|
||||
INSTALL = /usr/bin/install -c
|
||||
INSTALL_DATA = ${INSTALL} -m 644
|
||||
INSTALL_PROGRAM = ${INSTALL}
|
||||
INSTALL_SCRIPT = ${INSTALL}
|
||||
INSTALL_STRIP_PROGRAM = $(install_sh) -c -s
|
||||
INTLLIBS =
|
||||
INTL_MACOSX_LIBS =
|
||||
LDFLAGS =
|
||||
LIBICONV = -liconv
|
||||
LIBINTL =
|
||||
LIBOBJS =
|
||||
LIBPEAS_CFLAGS = -I/usr/include/libpeas-1.0 -I/usr/include/libmount -I/usr/include/blkid -I/usr/include/gobject-introspection-1.0 -I/usr/include/glib-2.0 -I/usr/lib/glib-2.0/include -I/usr/include/sysprof-6 -pthread
|
||||
LIBPEAS_LIBS = -lpeas-1.0 -Wl,--export-dynamic -lgio-2.0 -lgmodule-2.0 -pthread -lgirepository-1.0 -lgobject-2.0 -lglib-2.0
|
||||
LIBS =
|
||||
LOUIS_TABLE_DIR = /usr/share/liblouis/tables
|
||||
LTLIBICONV = -liconv
|
||||
LTLIBINTL =
|
||||
LTLIBOBJS =
|
||||
MAINT =
|
||||
MAKEINFO = ${SHELL} '/home/storm/devel/cthulhu/missing' makeinfo
|
||||
MKDIR_P = /usr/bin/mkdir -p
|
||||
MSGFMT = /usr/bin/msgfmt
|
||||
MSGMERGE = /usr/bin/msgmerge
|
||||
MSGMERGE_FOR_MSGFMT_OPTION = --for-msgfmt
|
||||
OBJEXT = o
|
||||
PACKAGE = cthulhu
|
||||
PACKAGE_BUGREPORT = https://gitlab.gnome.org/GNOME/cthulhu/-/issues/
|
||||
PACKAGE_NAME = cthulhu
|
||||
PACKAGE_STRING = cthulhu 2025.08.06
|
||||
PACKAGE_TARNAME = cthulhu
|
||||
PACKAGE_URL =
|
||||
PACKAGE_VERSION = 2025.08.06
|
||||
PATH_SEPARATOR = :
|
||||
PKG_CONFIG = /usr/bin/pkg-config
|
||||
PKG_CONFIG_LIBDIR =
|
||||
PKG_CONFIG_PATH =
|
||||
PLATFORM_PATH = :/usr/bin:/usr/sbin:/bin
|
||||
POSUB = po
|
||||
PYGOBJECT_CFLAGS = -I/usr/include/pygobject-3.0 -I/usr/include/glib-2.0 -I/usr/lib/glib-2.0/include -I/usr/include/sysprof-6 -pthread
|
||||
PYGOBJECT_LIBS = -lgobject-2.0 -lglib-2.0
|
||||
PYTHON = /home/storm/.pyenv/shims/python
|
||||
PYTHON_EXEC_PREFIX = ${exec_prefix}
|
||||
PYTHON_PLATFORM = linux
|
||||
PYTHON_PREFIX = ${prefix}
|
||||
PYTHON_VERSION = 3.13
|
||||
REVISION = 89df899
|
||||
SED = /usr/bin/sed
|
||||
SET_MAKE =
|
||||
SHELL = /bin/sh
|
||||
STRIP =
|
||||
USE_NLS = yes
|
||||
VERSION = 2025.08.06
|
||||
XGETTEXT = /usr/bin/xgettext
|
||||
XGETTEXT_015 = /usr/bin/xgettext
|
||||
XGETTEXT_EXTRA_OPTIONS =
|
||||
abs_builddir = /home/storm/devel/cthulhu/help
|
||||
abs_srcdir = /home/storm/devel/cthulhu/help
|
||||
abs_top_builddir = /home/storm/devel/cthulhu
|
||||
abs_top_srcdir = /home/storm/devel/cthulhu
|
||||
ac_ct_CC = gcc
|
||||
am__include = include
|
||||
am__leading_dot = .
|
||||
am__quote =
|
||||
am__rm_f_notfound =
|
||||
am__tar = tar --format=ustar -chf - "$$tardir"
|
||||
am__untar = tar -xf -
|
||||
am__xargs_n = xargs -n
|
||||
bindir = ${exec_prefix}/bin
|
||||
build = x86_64-pc-linux-gnu
|
||||
build_alias =
|
||||
build_cpu = x86_64
|
||||
build_os = linux-gnu
|
||||
build_vendor = pc
|
||||
builddir = .
|
||||
datadir = ${datarootdir}
|
||||
datarootdir = ${prefix}/share
|
||||
docdir = ${datarootdir}/doc/${PACKAGE_TARNAME}
|
||||
dvidir = ${docdir}
|
||||
exec_prefix = ${prefix}
|
||||
host = x86_64-pc-linux-gnu
|
||||
host_alias =
|
||||
host_cpu = x86_64
|
||||
host_os = linux-gnu
|
||||
host_vendor = pc
|
||||
htmldir = ${docdir}
|
||||
includedir = ${prefix}/include
|
||||
infodir = ${datarootdir}/info
|
||||
install_sh = ${SHELL} /home/storm/devel/cthulhu/install-sh
|
||||
libdir = ${exec_prefix}/lib
|
||||
libexecdir = ${exec_prefix}/libexec
|
||||
localedir = ${datarootdir}/locale
|
||||
localedir_c = "/home/storm/.local/share/locale"
|
||||
localedir_c_make = \"$(localedir)\"
|
||||
localstatedir = /home/storm/.local/var
|
||||
mandir = ${datarootdir}/man
|
||||
mkdir_p = $(MKDIR_P)
|
||||
oldincludedir = /usr/include
|
||||
pdfdir = ${docdir}
|
||||
pkgpyexecdir = ${pyexecdir}/cthulhu
|
||||
pkgpythondir = ${pythondir}/cthulhu
|
||||
prefix = /home/storm/.local
|
||||
program_transform_name = s,x,x,
|
||||
psdir = ${docdir}
|
||||
pyexecdir = ${PYTHON_EXEC_PREFIX}/lib/python3.13/site-packages
|
||||
pythondir = ${PYTHON_PREFIX}/lib/python3.13/site-packages
|
||||
runstatedir = ${localstatedir}/run
|
||||
sbindir = ${exec_prefix}/sbin
|
||||
sharedstatedir = ${prefix}/com
|
||||
srcdir = .
|
||||
sysconfdir = /home/storm/.local/etc
|
||||
target_alias =
|
||||
top_build_prefix = ../
|
||||
top_builddir = ..
|
||||
top_srcdir = ..
|
||||
HELP_ID = cthulhu
|
||||
HELP_MEDIA = \
|
||||
figures/cthulhu-logo.png
|
||||
|
||||
HELP_FILES = \
|
||||
commands_bookmarks.page \
|
||||
commands_braille.page \
|
||||
commands_chat.page \
|
||||
commands_controlling_cthulhu.page \
|
||||
commands_debugging.page \
|
||||
commands_find.page \
|
||||
commands_flat_review.page \
|
||||
commands_live_regions.page \
|
||||
commands_mouse.page \
|
||||
commands.page \
|
||||
commands_profiles.page \
|
||||
commands_reading.page \
|
||||
commands_speech_settings.page \
|
||||
commands_structural_navigation.page \
|
||||
commands_table.page \
|
||||
commands_time_date_notifications.page \
|
||||
commands_where_am_i.page \
|
||||
howto_bookmarks.page \
|
||||
howto_documents.page \
|
||||
howto_flat_review.page \
|
||||
howto_forms.page \
|
||||
howto_key_bindings.page \
|
||||
howto_keyboard_layout.page \
|
||||
howto_learn_modes.page \
|
||||
howto_live_regions.page \
|
||||
howto_mouse_review.page \
|
||||
howto_notifications.page \
|
||||
howto_cthulhu_find.page \
|
||||
howto_profiles.page \
|
||||
howto_setting_up_cthulhu.page \
|
||||
howto_structural_navigation.page \
|
||||
howto_tables.page \
|
||||
howto_text_attributes.page \
|
||||
howto_the_cthulhu_modifier.page \
|
||||
howto_toggling_caps_lock.page \
|
||||
howto_whereami.page \
|
||||
index.page \
|
||||
introduction.page \
|
||||
preferences_braille.page \
|
||||
preferences_chat.page \
|
||||
preferences_web.page \
|
||||
preferences_general.page \
|
||||
preferences_introduction.page \
|
||||
preferences_key_bindings.page \
|
||||
preferences_key_echo.page \
|
||||
preferences.page \
|
||||
preferences_pronunciation.page \
|
||||
preferences_speech.page \
|
||||
preferences_spellcheck.page \
|
||||
preferences_table_navigation.page \
|
||||
preferences_text_attributes.page \
|
||||
preferences_voice.page
|
||||
|
||||
HELP_LINGUAS = bg cs da de el es fr gl hu id pt_BR ru sl sv uk
|
||||
all: all-am
|
||||
|
||||
.SUFFIXES:
|
||||
$(srcdir)/Makefile.in: $(srcdir)/Makefile.am $(am__configure_deps)
|
||||
@for dep in $?; do \
|
||||
case '$(am__configure_deps)' in \
|
||||
*$$dep*) \
|
||||
( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \
|
||||
&& { if test -f $@; then exit 0; else break; fi; }; \
|
||||
exit 1;; \
|
||||
esac; \
|
||||
done; \
|
||||
echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu help/Makefile'; \
|
||||
$(am__cd) $(top_srcdir) && \
|
||||
$(AUTOMAKE) --gnu help/Makefile
|
||||
Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status
|
||||
@case '$?' in \
|
||||
*config.status*) \
|
||||
cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \
|
||||
*) \
|
||||
echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__maybe_remake_depfiles)'; \
|
||||
cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__maybe_remake_depfiles);; \
|
||||
esac;
|
||||
|
||||
$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES)
|
||||
cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
|
||||
|
||||
$(top_srcdir)/configure: $(am__configure_deps)
|
||||
cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
|
||||
$(ACLOCAL_M4): $(am__aclocal_m4_deps)
|
||||
cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
|
||||
$(am__aclocal_m4_deps):
|
||||
tags TAGS:
|
||||
|
||||
ctags CTAGS:
|
||||
|
||||
cscope cscopelist:
|
||||
|
||||
|
||||
distdir: $(BUILT_SOURCES)
|
||||
$(MAKE) $(AM_MAKEFLAGS) distdir-am
|
||||
|
||||
distdir-am: $(DISTFILES)
|
||||
@srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
|
||||
topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
|
||||
list='$(DISTFILES)'; \
|
||||
dist_files=`for file in $$list; do echo $$file; done | \
|
||||
sed -e "s|^$$srcdirstrip/||;t" \
|
||||
-e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \
|
||||
case $$dist_files in \
|
||||
*/*) $(MKDIR_P) `echo "$$dist_files" | \
|
||||
sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \
|
||||
sort -u` ;; \
|
||||
esac; \
|
||||
for file in $$dist_files; do \
|
||||
if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \
|
||||
if test -d $$d/$$file; then \
|
||||
dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \
|
||||
if test -d "$(distdir)/$$file"; then \
|
||||
find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
|
||||
fi; \
|
||||
if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \
|
||||
cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \
|
||||
find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
|
||||
fi; \
|
||||
cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \
|
||||
else \
|
||||
test -f "$(distdir)/$$file" \
|
||||
|| cp -p $$d/$$file "$(distdir)/$$file" \
|
||||
|| exit 1; \
|
||||
fi; \
|
||||
done
|
||||
check-am: all-am
|
||||
check: check-am
|
||||
all-am: Makefile
|
||||
installdirs:
|
||||
install: install-am
|
||||
install-exec: install-exec-am
|
||||
install-data: install-data-am
|
||||
uninstall: uninstall-am
|
||||
|
||||
install-am: all-am
|
||||
@$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
|
||||
|
||||
installcheck: installcheck-am
|
||||
install-strip:
|
||||
if test -z '$(STRIP)'; then \
|
||||
$(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
|
||||
install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
|
||||
install; \
|
||||
else \
|
||||
$(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
|
||||
install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
|
||||
"INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \
|
||||
fi
|
||||
mostlyclean-generic:
|
||||
|
||||
clean-generic:
|
||||
|
||||
distclean-generic:
|
||||
-$(am__rm_f) $(CONFIG_CLEAN_FILES)
|
||||
-test . = "$(srcdir)" || $(am__rm_f) $(CONFIG_CLEAN_VPATH_FILES)
|
||||
|
||||
maintainer-clean-generic:
|
||||
@echo "This command is intended for maintainers to use"
|
||||
@echo "it deletes files that may require special tools to rebuild."
|
||||
clean: clean-am
|
||||
|
||||
clean-am: clean-generic mostlyclean-am
|
||||
|
||||
distclean: distclean-am
|
||||
-rm -f Makefile
|
||||
distclean-am: clean-am distclean-generic
|
||||
|
||||
dvi: dvi-am
|
||||
|
||||
dvi-am:
|
||||
|
||||
html: html-am
|
||||
|
||||
html-am:
|
||||
|
||||
info: info-am
|
||||
|
||||
info-am:
|
||||
|
||||
install-data-am:
|
||||
|
||||
install-dvi: install-dvi-am
|
||||
|
||||
install-dvi-am:
|
||||
|
||||
install-exec-am:
|
||||
|
||||
install-html: install-html-am
|
||||
|
||||
install-html-am:
|
||||
|
||||
install-info: install-info-am
|
||||
|
||||
install-info-am:
|
||||
|
||||
install-man:
|
||||
|
||||
install-pdf: install-pdf-am
|
||||
|
||||
install-pdf-am:
|
||||
|
||||
install-ps: install-ps-am
|
||||
|
||||
install-ps-am:
|
||||
|
||||
installcheck-am:
|
||||
|
||||
maintainer-clean: maintainer-clean-am
|
||||
-rm -f Makefile
|
||||
maintainer-clean-am: distclean-am maintainer-clean-generic
|
||||
|
||||
mostlyclean: mostlyclean-am
|
||||
|
||||
mostlyclean-am: mostlyclean-generic
|
||||
|
||||
pdf: pdf-am
|
||||
|
||||
pdf-am:
|
||||
|
||||
ps: ps-am
|
||||
|
||||
ps-am:
|
||||
|
||||
uninstall-am:
|
||||
|
||||
.MAKE: install-am install-strip
|
||||
|
||||
.PHONY: all all-am check check-am clean clean-generic cscopelist-am \
|
||||
ctags-am distclean distclean-generic distdir dvi dvi-am html \
|
||||
html-am info info-am install install-am install-data \
|
||||
install-data-am install-dvi install-dvi-am install-exec \
|
||||
install-exec-am install-html install-html-am install-info \
|
||||
install-info-am install-man install-pdf install-pdf-am \
|
||||
install-ps install-ps-am install-strip installcheck \
|
||||
installcheck-am installdirs maintainer-clean \
|
||||
maintainer-clean-generic mostlyclean mostlyclean-generic pdf \
|
||||
pdf-am ps ps-am tags-am uninstall uninstall-am
|
||||
|
||||
.PRECIOUS: Makefile
|
||||
|
||||
@YELP_HELP_RULES@
|
||||
|
||||
# Tell versions [3.59,3.63) of GNU make to not export all variables.
|
||||
# Otherwise a system limit (for SysV at least) may be exceeded.
|
||||
.NOEXPORT:
|
||||
|
||||
# Tell GNU make to disable its built-in pattern rules.
|
||||
%:: %,v
|
||||
%:: RCS/%,v
|
||||
%:: RCS/%
|
||||
%:: s.%
|
||||
%:: SCCS/s.%
|
||||
@@ -1,533 +0,0 @@
|
||||
# Makefile.in generated by automake 1.18.1 from Makefile.am.
|
||||
# @configure_input@
|
||||
|
||||
# Copyright (C) 1994-2025 Free Software Foundation, Inc.
|
||||
|
||||
# This Makefile.in is free software; the Free Software Foundation
|
||||
# gives unlimited permission to copy and/or distribute it,
|
||||
# with or without modifications, as long as this notice is preserved.
|
||||
|
||||
# This program is distributed in the hope that it will be useful,
|
||||
# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
|
||||
# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
|
||||
# PARTICULAR PURPOSE.
|
||||
|
||||
@SET_MAKE@
|
||||
VPATH = @srcdir@
|
||||
am__is_gnu_make = { \
|
||||
if test -z '$(MAKELEVEL)'; then \
|
||||
false; \
|
||||
elif test -n '$(MAKE_HOST)'; then \
|
||||
true; \
|
||||
elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \
|
||||
true; \
|
||||
else \
|
||||
false; \
|
||||
fi; \
|
||||
}
|
||||
am__make_running_with_option = \
|
||||
case $${target_option-} in \
|
||||
?) ;; \
|
||||
*) echo "am__make_running_with_option: internal error: invalid" \
|
||||
"target option '$${target_option-}' specified" >&2; \
|
||||
exit 1;; \
|
||||
esac; \
|
||||
has_opt=no; \
|
||||
sane_makeflags=$$MAKEFLAGS; \
|
||||
if $(am__is_gnu_make); then \
|
||||
sane_makeflags=$$MFLAGS; \
|
||||
else \
|
||||
case $$MAKEFLAGS in \
|
||||
*\\[\ \ ]*) \
|
||||
bs=\\; \
|
||||
sane_makeflags=`printf '%s\n' "$$MAKEFLAGS" \
|
||||
| sed "s/$$bs$$bs[$$bs $$bs ]*//g"`;; \
|
||||
esac; \
|
||||
fi; \
|
||||
skip_next=no; \
|
||||
strip_trailopt () \
|
||||
{ \
|
||||
flg=`printf '%s\n' "$$flg" | sed "s/$$1.*$$//"`; \
|
||||
}; \
|
||||
for flg in $$sane_makeflags; do \
|
||||
test $$skip_next = yes && { skip_next=no; continue; }; \
|
||||
case $$flg in \
|
||||
*=*|--*) continue;; \
|
||||
-*I) strip_trailopt 'I'; skip_next=yes;; \
|
||||
-*I?*) strip_trailopt 'I';; \
|
||||
-*O) strip_trailopt 'O'; skip_next=yes;; \
|
||||
-*O?*) strip_trailopt 'O';; \
|
||||
-*l) strip_trailopt 'l'; skip_next=yes;; \
|
||||
-*l?*) strip_trailopt 'l';; \
|
||||
-[dEDm]) skip_next=yes;; \
|
||||
-[JT]) skip_next=yes;; \
|
||||
esac; \
|
||||
case $$flg in \
|
||||
*$$target_option*) has_opt=yes; break;; \
|
||||
esac; \
|
||||
done; \
|
||||
test $$has_opt = yes
|
||||
am__make_dryrun = (target_option=n; $(am__make_running_with_option))
|
||||
am__make_keepgoing = (target_option=k; $(am__make_running_with_option))
|
||||
am__rm_f = rm -f $(am__rm_f_notfound)
|
||||
am__rm_rf = rm -rf $(am__rm_f_notfound)
|
||||
pkgdatadir = $(datadir)/@PACKAGE@
|
||||
pkgincludedir = $(includedir)/@PACKAGE@
|
||||
pkglibdir = $(libdir)/@PACKAGE@
|
||||
pkglibexecdir = $(libexecdir)/@PACKAGE@
|
||||
am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
|
||||
install_sh_DATA = $(install_sh) -c -m 644
|
||||
install_sh_PROGRAM = $(install_sh) -c
|
||||
install_sh_SCRIPT = $(install_sh) -c
|
||||
INSTALL_HEADER = $(INSTALL_DATA)
|
||||
transform = $(program_transform_name)
|
||||
NORMAL_INSTALL = :
|
||||
PRE_INSTALL = :
|
||||
POST_INSTALL = :
|
||||
NORMAL_UNINSTALL = :
|
||||
PRE_UNINSTALL = :
|
||||
POST_UNINSTALL = :
|
||||
build_triplet = @build@
|
||||
host_triplet = @host@
|
||||
subdir = help
|
||||
ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
|
||||
am__aclocal_m4_deps = $(top_srcdir)/m4/build-to-host.m4 \
|
||||
$(top_srcdir)/m4/gettext.m4 $(top_srcdir)/m4/host-cpu-c-abi.m4 \
|
||||
$(top_srcdir)/m4/iconv.m4 $(top_srcdir)/m4/intlmacosx.m4 \
|
||||
$(top_srcdir)/m4/lib-ld.m4 $(top_srcdir)/m4/lib-link.m4 \
|
||||
$(top_srcdir)/m4/lib-prefix.m4 $(top_srcdir)/m4/nls.m4 \
|
||||
$(top_srcdir)/m4/po.m4 $(top_srcdir)/m4/progtest.m4 \
|
||||
$(top_srcdir)/acinclude.m4 $(top_srcdir)/configure.ac
|
||||
am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
|
||||
$(ACLOCAL_M4)
|
||||
DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON)
|
||||
mkinstalldirs = $(install_sh) -d
|
||||
CONFIG_CLEAN_FILES =
|
||||
CONFIG_CLEAN_VPATH_FILES =
|
||||
AM_V_P = $(am__v_P_@AM_V@)
|
||||
am__v_P_ = $(am__v_P_@AM_DEFAULT_V@)
|
||||
am__v_P_0 = false
|
||||
am__v_P_1 = :
|
||||
AM_V_GEN = $(am__v_GEN_@AM_V@)
|
||||
am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@)
|
||||
am__v_GEN_0 = @echo " GEN " $@;
|
||||
am__v_GEN_1 =
|
||||
AM_V_at = $(am__v_at_@AM_V@)
|
||||
am__v_at_ = $(am__v_at_@AM_DEFAULT_V@)
|
||||
am__v_at_0 = @
|
||||
am__v_at_1 =
|
||||
SOURCES =
|
||||
DIST_SOURCES =
|
||||
am__can_run_installinfo = \
|
||||
case $$AM_UPDATE_INFO_DIR in \
|
||||
n|no|NO) false;; \
|
||||
*) (install-info --version) >/dev/null 2>&1;; \
|
||||
esac
|
||||
am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP)
|
||||
am__DIST_COMMON = $(srcdir)/Makefile.in
|
||||
DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
|
||||
ACLOCAL = @ACLOCAL@
|
||||
AMTAR = @AMTAR@
|
||||
AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@
|
||||
ATKBRIDGE_CFLAGS = @ATKBRIDGE_CFLAGS@
|
||||
ATKBRIDGE_LIBS = @ATKBRIDGE_LIBS@
|
||||
ATSPI2_CFLAGS = @ATSPI2_CFLAGS@
|
||||
ATSPI2_LIBS = @ATSPI2_LIBS@
|
||||
AUTOCONF = @AUTOCONF@
|
||||
AUTOHEADER = @AUTOHEADER@
|
||||
AUTOMAKE = @AUTOMAKE@
|
||||
AWK = @AWK@
|
||||
CC = @CC@
|
||||
CCDEPMODE = @CCDEPMODE@
|
||||
CFLAGS = @CFLAGS@
|
||||
CPP = @CPP@
|
||||
CPPFLAGS = @CPPFLAGS@
|
||||
CSCOPE = @CSCOPE@
|
||||
CTAGS = @CTAGS@
|
||||
CYGPATH_W = @CYGPATH_W@
|
||||
DEFS = @DEFS@
|
||||
DEPDIR = @DEPDIR@
|
||||
DESIRED_LINGUAS = @DESIRED_LINGUAS@
|
||||
ECHO_C = @ECHO_C@
|
||||
ECHO_N = @ECHO_N@
|
||||
ECHO_T = @ECHO_T@
|
||||
ETAGS = @ETAGS@
|
||||
EXEEXT = @EXEEXT@
|
||||
GETTEXT_MACRO_VERSION = @GETTEXT_MACRO_VERSION@
|
||||
GETTEXT_PACKAGE = @GETTEXT_PACKAGE@
|
||||
GMSGFMT = @GMSGFMT@
|
||||
GMSGFMT_015 = @GMSGFMT_015@
|
||||
GSTREAMER_CFLAGS = @GSTREAMER_CFLAGS@
|
||||
GSTREAMER_LIBS = @GSTREAMER_LIBS@
|
||||
INSTALL = @INSTALL@
|
||||
INSTALL_DATA = @INSTALL_DATA@
|
||||
INSTALL_PROGRAM = @INSTALL_PROGRAM@
|
||||
INSTALL_SCRIPT = @INSTALL_SCRIPT@
|
||||
INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
|
||||
INTLLIBS = @INTLLIBS@
|
||||
INTL_MACOSX_LIBS = @INTL_MACOSX_LIBS@
|
||||
LDFLAGS = @LDFLAGS@
|
||||
LIBICONV = @LIBICONV@
|
||||
LIBINTL = @LIBINTL@
|
||||
LIBOBJS = @LIBOBJS@
|
||||
LIBPEAS_CFLAGS = @LIBPEAS_CFLAGS@
|
||||
LIBPEAS_LIBS = @LIBPEAS_LIBS@
|
||||
LIBS = @LIBS@
|
||||
LOUIS_TABLE_DIR = @LOUIS_TABLE_DIR@
|
||||
LTLIBICONV = @LTLIBICONV@
|
||||
LTLIBINTL = @LTLIBINTL@
|
||||
LTLIBOBJS = @LTLIBOBJS@
|
||||
MAINT = @MAINT@
|
||||
MAKEINFO = @MAKEINFO@
|
||||
MKDIR_P = @MKDIR_P@
|
||||
MSGFMT = @MSGFMT@
|
||||
MSGMERGE = @MSGMERGE@
|
||||
MSGMERGE_FOR_MSGFMT_OPTION = @MSGMERGE_FOR_MSGFMT_OPTION@
|
||||
OBJEXT = @OBJEXT@
|
||||
PACKAGE = @PACKAGE@
|
||||
PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@
|
||||
PACKAGE_NAME = @PACKAGE_NAME@
|
||||
PACKAGE_STRING = @PACKAGE_STRING@
|
||||
PACKAGE_TARNAME = @PACKAGE_TARNAME@
|
||||
PACKAGE_URL = @PACKAGE_URL@
|
||||
PACKAGE_VERSION = @PACKAGE_VERSION@
|
||||
PATH_SEPARATOR = @PATH_SEPARATOR@
|
||||
PKG_CONFIG = @PKG_CONFIG@
|
||||
PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@
|
||||
PKG_CONFIG_PATH = @PKG_CONFIG_PATH@
|
||||
PLATFORM_PATH = @PLATFORM_PATH@
|
||||
POSUB = @POSUB@
|
||||
PYGOBJECT_CFLAGS = @PYGOBJECT_CFLAGS@
|
||||
PYGOBJECT_LIBS = @PYGOBJECT_LIBS@
|
||||
PYTHON = @PYTHON@
|
||||
PYTHON_EXEC_PREFIX = @PYTHON_EXEC_PREFIX@
|
||||
PYTHON_PLATFORM = @PYTHON_PLATFORM@
|
||||
PYTHON_PREFIX = @PYTHON_PREFIX@
|
||||
PYTHON_VERSION = @PYTHON_VERSION@
|
||||
REVISION = @REVISION@
|
||||
SED = @SED@
|
||||
SET_MAKE = @SET_MAKE@
|
||||
SHELL = @SHELL@
|
||||
STRIP = @STRIP@
|
||||
USE_NLS = @USE_NLS@
|
||||
VERSION = @VERSION@
|
||||
XGETTEXT = @XGETTEXT@
|
||||
XGETTEXT_015 = @XGETTEXT_015@
|
||||
XGETTEXT_EXTRA_OPTIONS = @XGETTEXT_EXTRA_OPTIONS@
|
||||
abs_builddir = @abs_builddir@
|
||||
abs_srcdir = @abs_srcdir@
|
||||
abs_top_builddir = @abs_top_builddir@
|
||||
abs_top_srcdir = @abs_top_srcdir@
|
||||
ac_ct_CC = @ac_ct_CC@
|
||||
am__include = @am__include@
|
||||
am__leading_dot = @am__leading_dot@
|
||||
am__quote = @am__quote@
|
||||
am__rm_f_notfound = @am__rm_f_notfound@
|
||||
am__tar = @am__tar@
|
||||
am__untar = @am__untar@
|
||||
am__xargs_n = @am__xargs_n@
|
||||
bindir = @bindir@
|
||||
build = @build@
|
||||
build_alias = @build_alias@
|
||||
build_cpu = @build_cpu@
|
||||
build_os = @build_os@
|
||||
build_vendor = @build_vendor@
|
||||
builddir = @builddir@
|
||||
datadir = @datadir@
|
||||
datarootdir = @datarootdir@
|
||||
docdir = @docdir@
|
||||
dvidir = @dvidir@
|
||||
exec_prefix = @exec_prefix@
|
||||
host = @host@
|
||||
host_alias = @host_alias@
|
||||
host_cpu = @host_cpu@
|
||||
host_os = @host_os@
|
||||
host_vendor = @host_vendor@
|
||||
htmldir = @htmldir@
|
||||
includedir = @includedir@
|
||||
infodir = @infodir@
|
||||
install_sh = @install_sh@
|
||||
libdir = @libdir@
|
||||
libexecdir = @libexecdir@
|
||||
localedir = @localedir@
|
||||
localedir_c = @localedir_c@
|
||||
localedir_c_make = @localedir_c_make@
|
||||
localstatedir = @localstatedir@
|
||||
mandir = @mandir@
|
||||
mkdir_p = @mkdir_p@
|
||||
oldincludedir = @oldincludedir@
|
||||
pdfdir = @pdfdir@
|
||||
pkgpyexecdir = @pkgpyexecdir@
|
||||
pkgpythondir = @pkgpythondir@
|
||||
prefix = @prefix@
|
||||
program_transform_name = @program_transform_name@
|
||||
psdir = @psdir@
|
||||
pyexecdir = @pyexecdir@
|
||||
pythondir = @pythondir@
|
||||
runstatedir = @runstatedir@
|
||||
sbindir = @sbindir@
|
||||
sharedstatedir = @sharedstatedir@
|
||||
srcdir = @srcdir@
|
||||
sysconfdir = @sysconfdir@
|
||||
target_alias = @target_alias@
|
||||
top_build_prefix = @top_build_prefix@
|
||||
top_builddir = @top_builddir@
|
||||
top_srcdir = @top_srcdir@
|
||||
HELP_ID = cthulhu
|
||||
HELP_MEDIA = \
|
||||
figures/cthulhu-logo.png
|
||||
|
||||
HELP_FILES = \
|
||||
commands_bookmarks.page \
|
||||
commands_braille.page \
|
||||
commands_chat.page \
|
||||
commands_controlling_cthulhu.page \
|
||||
commands_debugging.page \
|
||||
commands_find.page \
|
||||
commands_flat_review.page \
|
||||
commands_live_regions.page \
|
||||
commands_mouse.page \
|
||||
commands.page \
|
||||
commands_profiles.page \
|
||||
commands_reading.page \
|
||||
commands_speech_settings.page \
|
||||
commands_structural_navigation.page \
|
||||
commands_table.page \
|
||||
commands_time_date_notifications.page \
|
||||
commands_where_am_i.page \
|
||||
howto_bookmarks.page \
|
||||
howto_documents.page \
|
||||
howto_flat_review.page \
|
||||
howto_forms.page \
|
||||
howto_key_bindings.page \
|
||||
howto_keyboard_layout.page \
|
||||
howto_learn_modes.page \
|
||||
howto_live_regions.page \
|
||||
howto_mouse_review.page \
|
||||
howto_notifications.page \
|
||||
howto_cthulhu_find.page \
|
||||
howto_profiles.page \
|
||||
howto_setting_up_cthulhu.page \
|
||||
howto_structural_navigation.page \
|
||||
howto_tables.page \
|
||||
howto_text_attributes.page \
|
||||
howto_the_cthulhu_modifier.page \
|
||||
howto_toggling_caps_lock.page \
|
||||
howto_whereami.page \
|
||||
index.page \
|
||||
introduction.page \
|
||||
preferences_braille.page \
|
||||
preferences_chat.page \
|
||||
preferences_web.page \
|
||||
preferences_general.page \
|
||||
preferences_introduction.page \
|
||||
preferences_key_bindings.page \
|
||||
preferences_key_echo.page \
|
||||
preferences.page \
|
||||
preferences_pronunciation.page \
|
||||
preferences_speech.page \
|
||||
preferences_spellcheck.page \
|
||||
preferences_table_navigation.page \
|
||||
preferences_text_attributes.page \
|
||||
preferences_voice.page
|
||||
|
||||
HELP_LINGUAS = bg cs da de el es fr gl hu id pt_BR ru sl sv uk
|
||||
all: all-am
|
||||
|
||||
.SUFFIXES:
|
||||
$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__configure_deps)
|
||||
@for dep in $?; do \
|
||||
case '$(am__configure_deps)' in \
|
||||
*$$dep*) \
|
||||
( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \
|
||||
&& { if test -f $@; then exit 0; else break; fi; }; \
|
||||
exit 1;; \
|
||||
esac; \
|
||||
done; \
|
||||
echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu help/Makefile'; \
|
||||
$(am__cd) $(top_srcdir) && \
|
||||
$(AUTOMAKE) --gnu help/Makefile
|
||||
Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status
|
||||
@case '$?' in \
|
||||
*config.status*) \
|
||||
cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \
|
||||
*) \
|
||||
echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__maybe_remake_depfiles)'; \
|
||||
cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__maybe_remake_depfiles);; \
|
||||
esac;
|
||||
|
||||
$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES)
|
||||
cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
|
||||
|
||||
$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps)
|
||||
cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
|
||||
$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps)
|
||||
cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
|
||||
$(am__aclocal_m4_deps):
|
||||
tags TAGS:
|
||||
|
||||
ctags CTAGS:
|
||||
|
||||
cscope cscopelist:
|
||||
|
||||
|
||||
distdir: $(BUILT_SOURCES)
|
||||
$(MAKE) $(AM_MAKEFLAGS) distdir-am
|
||||
|
||||
distdir-am: $(DISTFILES)
|
||||
@srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
|
||||
topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
|
||||
list='$(DISTFILES)'; \
|
||||
dist_files=`for file in $$list; do echo $$file; done | \
|
||||
sed -e "s|^$$srcdirstrip/||;t" \
|
||||
-e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \
|
||||
case $$dist_files in \
|
||||
*/*) $(MKDIR_P) `echo "$$dist_files" | \
|
||||
sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \
|
||||
sort -u` ;; \
|
||||
esac; \
|
||||
for file in $$dist_files; do \
|
||||
if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \
|
||||
if test -d $$d/$$file; then \
|
||||
dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \
|
||||
if test -d "$(distdir)/$$file"; then \
|
||||
find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
|
||||
fi; \
|
||||
if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \
|
||||
cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \
|
||||
find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
|
||||
fi; \
|
||||
cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \
|
||||
else \
|
||||
test -f "$(distdir)/$$file" \
|
||||
|| cp -p $$d/$$file "$(distdir)/$$file" \
|
||||
|| exit 1; \
|
||||
fi; \
|
||||
done
|
||||
check-am: all-am
|
||||
check: check-am
|
||||
all-am: Makefile
|
||||
installdirs:
|
||||
install: install-am
|
||||
install-exec: install-exec-am
|
||||
install-data: install-data-am
|
||||
uninstall: uninstall-am
|
||||
|
||||
install-am: all-am
|
||||
@$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
|
||||
|
||||
installcheck: installcheck-am
|
||||
install-strip:
|
||||
if test -z '$(STRIP)'; then \
|
||||
$(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
|
||||
install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
|
||||
install; \
|
||||
else \
|
||||
$(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
|
||||
install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
|
||||
"INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \
|
||||
fi
|
||||
mostlyclean-generic:
|
||||
|
||||
clean-generic:
|
||||
|
||||
distclean-generic:
|
||||
-$(am__rm_f) $(CONFIG_CLEAN_FILES)
|
||||
-test . = "$(srcdir)" || $(am__rm_f) $(CONFIG_CLEAN_VPATH_FILES)
|
||||
|
||||
maintainer-clean-generic:
|
||||
@echo "This command is intended for maintainers to use"
|
||||
@echo "it deletes files that may require special tools to rebuild."
|
||||
clean: clean-am
|
||||
|
||||
clean-am: clean-generic mostlyclean-am
|
||||
|
||||
distclean: distclean-am
|
||||
-rm -f Makefile
|
||||
distclean-am: clean-am distclean-generic
|
||||
|
||||
dvi: dvi-am
|
||||
|
||||
dvi-am:
|
||||
|
||||
html: html-am
|
||||
|
||||
html-am:
|
||||
|
||||
info: info-am
|
||||
|
||||
info-am:
|
||||
|
||||
install-data-am:
|
||||
|
||||
install-dvi: install-dvi-am
|
||||
|
||||
install-dvi-am:
|
||||
|
||||
install-exec-am:
|
||||
|
||||
install-html: install-html-am
|
||||
|
||||
install-html-am:
|
||||
|
||||
install-info: install-info-am
|
||||
|
||||
install-info-am:
|
||||
|
||||
install-man:
|
||||
|
||||
install-pdf: install-pdf-am
|
||||
|
||||
install-pdf-am:
|
||||
|
||||
install-ps: install-ps-am
|
||||
|
||||
install-ps-am:
|
||||
|
||||
installcheck-am:
|
||||
|
||||
maintainer-clean: maintainer-clean-am
|
||||
-rm -f Makefile
|
||||
maintainer-clean-am: distclean-am maintainer-clean-generic
|
||||
|
||||
mostlyclean: mostlyclean-am
|
||||
|
||||
mostlyclean-am: mostlyclean-generic
|
||||
|
||||
pdf: pdf-am
|
||||
|
||||
pdf-am:
|
||||
|
||||
ps: ps-am
|
||||
|
||||
ps-am:
|
||||
|
||||
uninstall-am:
|
||||
|
||||
.MAKE: install-am install-strip
|
||||
|
||||
.PHONY: all all-am check check-am clean clean-generic cscopelist-am \
|
||||
ctags-am distclean distclean-generic distdir dvi dvi-am html \
|
||||
html-am info info-am install install-am install-data \
|
||||
install-data-am install-dvi install-dvi-am install-exec \
|
||||
install-exec-am install-html install-html-am install-info \
|
||||
install-info-am install-man install-pdf install-pdf-am \
|
||||
install-ps install-ps-am install-strip installcheck \
|
||||
installcheck-am installdirs maintainer-clean \
|
||||
maintainer-clean-generic mostlyclean mostlyclean-generic pdf \
|
||||
pdf-am ps ps-am tags-am uninstall uninstall-am
|
||||
|
||||
.PRECIOUS: Makefile
|
||||
|
||||
@YELP_HELP_RULES@
|
||||
|
||||
# Tell versions [3.59,3.63) of GNU make to not export all variables.
|
||||
# Otherwise a system limit (for SysV at least) may be exceeded.
|
||||
.NOEXPORT:
|
||||
|
||||
# Tell GNU make to disable its built-in pattern rules.
|
||||
%:: %,v
|
||||
%:: RCS/%,v
|
||||
%:: RCS/%
|
||||
%:: s.%
|
||||
%:: SCCS/s.%
|
||||
-7913
File diff suppressed because it is too large
Load Diff
-8175
File diff suppressed because it is too large
Load Diff
-8202
File diff suppressed because it is too large
Load Diff
-8380
File diff suppressed because it is too large
Load Diff
-8673
File diff suppressed because it is too large
Load Diff
-10062
File diff suppressed because it is too large
Load Diff
-8393
File diff suppressed because it is too large
Load Diff
-6975
File diff suppressed because it is too large
Load Diff
-8437
File diff suppressed because it is too large
Load Diff
-9043
File diff suppressed because it is too large
Load Diff
@@ -1,61 +0,0 @@
|
||||
# Help documentation using GNOME's yelp-tools
|
||||
gnome.yelp(
|
||||
'cthulhu',
|
||||
sources: [
|
||||
'commands_bookmarks.page',
|
||||
'commands_braille.page',
|
||||
'commands_chat.page',
|
||||
'commands_controlling_cthulhu.page',
|
||||
'commands_debugging.page',
|
||||
'commands_find.page',
|
||||
'commands_flat_review.page',
|
||||
'commands_live_regions.page',
|
||||
'commands_mouse.page',
|
||||
'commands.page',
|
||||
'commands_profiles.page',
|
||||
'commands_reading.page',
|
||||
'commands_speech_settings.page',
|
||||
'commands_structural_navigation.page',
|
||||
'commands_table.page',
|
||||
'commands_time_date_notifications.page',
|
||||
'commands_where_am_i.page',
|
||||
'howto_bookmarks.page',
|
||||
'howto_documents.page',
|
||||
'howto_flat_review.page',
|
||||
'howto_forms.page',
|
||||
'howto_key_bindings.page',
|
||||
'howto_keyboard_layout.page',
|
||||
'howto_learn_modes.page',
|
||||
'howto_live_regions.page',
|
||||
'howto_mouse_review.page',
|
||||
'howto_notifications.page',
|
||||
'howto_cthulhu_find.page',
|
||||
'howto_profiles.page',
|
||||
'howto_setting_up_cthulhu.page',
|
||||
'howto_structural_navigation.page',
|
||||
'howto_tables.page',
|
||||
'howto_text_attributes.page',
|
||||
'howto_the_cthulhu_modifier.page',
|
||||
'howto_toggling_caps_lock.page',
|
||||
'howto_whereami.page',
|
||||
'index.page',
|
||||
'introduction.page',
|
||||
'preferences_braille.page',
|
||||
'preferences_chat.page',
|
||||
'preferences_web.page',
|
||||
'preferences_general.page',
|
||||
'preferences_introduction.page',
|
||||
'preferences_key_bindings.page',
|
||||
'preferences_key_echo.page',
|
||||
'preferences.page',
|
||||
'preferences_pronunciation.page',
|
||||
'preferences_speech.page',
|
||||
'preferences_spellcheck.page',
|
||||
'preferences_table_navigation.page',
|
||||
'preferences_text_attributes.page',
|
||||
'preferences_voice.page',
|
||||
],
|
||||
media: [
|
||||
'figures/cthulhu-logo.png',
|
||||
],
|
||||
)
|
||||
-9223
File diff suppressed because it is too large
Load Diff
-8296
File diff suppressed because it is too large
Load Diff
-6901
File diff suppressed because it is too large
Load Diff
-8456
File diff suppressed because it is too large
Load Diff
-8324
File diff suppressed because it is too large
Load Diff
@@ -112,9 +112,6 @@ gnome.post_install(
|
||||
summary += {'Install dir': python.find_installation('python3').get_install_dir()}
|
||||
|
||||
subdir('docs')
|
||||
if get_option('help')
|
||||
subdir('help')
|
||||
endif
|
||||
subdir('icons')
|
||||
subdir('po')
|
||||
subdir('src')
|
||||
|
||||
@@ -1,3 +1,2 @@
|
||||
option('help', type: 'boolean', value: true, description: 'Build help documentation')
|
||||
option('plugin-system', type: 'boolean', value: true, description: 'Enable plugin system support')
|
||||
option('d-bus-service', type: 'boolean', value: true, description: 'Enable D-Bus remote controller service')
|
||||
@@ -96,6 +96,9 @@ configure_file(
|
||||
'bindir': get_option('bindir'),
|
||||
'libdir': get_option('libdir'),
|
||||
'datadir': get_option('datadir'),
|
||||
'PYTHON': python3.full_path(),
|
||||
'PYTHON_PREFIX': python3.get_install_dir(),
|
||||
'pythondir': python3.get_install_dir(),
|
||||
}
|
||||
)
|
||||
|
||||
@@ -106,6 +109,7 @@ configure_file(
|
||||
'GETTEXT_PACKAGE': 'cthulhu',
|
||||
'prefix': get_option('prefix'),
|
||||
'datadir': get_option('datadir'),
|
||||
'localedir': get_option('datadir') / 'locale',
|
||||
}
|
||||
)
|
||||
|
||||
@@ -119,18 +123,13 @@ configure_file(
|
||||
'datadir': get_option('datadir'),
|
||||
'sysconfdir': get_option('sysconfdir'),
|
||||
'localstatedir': get_option('localstatedir'),
|
||||
'PACKAGE': 'cthulhu',
|
||||
'REVISION': run_command('git', 'rev-parse', '--short', 'HEAD', check: false).stdout().strip(),
|
||||
'LOUIS_TABLE_DIR': '/usr/share/liblouis/tables',
|
||||
}
|
||||
)
|
||||
|
||||
# Main executable script
|
||||
configure_file(
|
||||
input: 'cthulhu',
|
||||
output: 'cthulhu',
|
||||
copy: true,
|
||||
install: true,
|
||||
install_dir: get_option('bindir'),
|
||||
install_mode: 'rwxr-xr-x'
|
||||
)
|
||||
# Note: Main executable (cthulhu) is installed from src/cthulhu.py
|
||||
|
||||
# Install Python sources
|
||||
python3.install_sources(
|
||||
|
||||
@@ -1 +1,9 @@
|
||||
# Main executable script
|
||||
install_data(
|
||||
'cthulhu.py',
|
||||
rename: 'cthulhu',
|
||||
install_dir: get_option('bindir'),
|
||||
install_mode: 'rwxr-xr-x'
|
||||
)
|
||||
|
||||
subdir('cthulhu')
|
||||
Reference in New Issue
Block a user