cthulhu/help/C/howto_structural_navigation.page

124 lines
4.6 KiB
Plaintext
Raw Normal View History

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