| 1 |
<page xmlns="http://projectmallard.org/1.0/" |
| 2 |
type="topic" |
| 3 |
id="howto_structural_navigation"> |
| 4 |
<info> |
| 5 |
<link type="guide" xref="index#reading"/> |
| 6 |
<link type="next" xref="howto_tables" /> |
| 7 |
<title type="sort">3. Structural Navigation</title> |
| 8 |
<desc> |
| 9 |
Moving by heading and other elements |
| 10 |
</desc> |
| 11 |
<credit type="author"> |
| 12 |
<name>Joanmarie Diggs</name> |
| 13 |
<email>[email protected]</email> |
| 14 |
</credit> |
| 15 |
<license> |
| 16 |
<p>Creative Commons Share Alike 3.0</p> |
| 17 |
</license> |
| 18 |
</info> |
| 19 |
<title>Structural Navigation</title> |
| 20 |
<p> |
| 21 |
<app>Orca</app>'s Structural Navigation feature allows you to navigate |
| 22 |
amongst elements in a document. The types of elements by which you can |
| 23 |
navigate include: |
| 24 |
</p> |
| 25 |
<list> |
| 26 |
<item><p>Headings and other text blocks</p></item> |
| 27 |
<item><p>Form controls</p></item> |
| 28 |
<item><p>Links</p></item> |
| 29 |
<item><p>Lists and list items</p></item> |
| 30 |
<item><p>Landmarks, separators, and anchors</p></item> |
| 31 |
<item><p>Tables and table cells</p></item> |
| 32 |
</list> |
| 33 |
<p> |
| 34 |
A full list of individual elements and their associated keybindings can |
| 35 |
be found in <link xref="commands_structural_navigation">Structural |
| 36 |
Navigation Commands</link>. |
| 37 |
</p> |
| 38 |
<section id="applications"> |
| 39 |
<title>Supported Applications</title> |
| 40 |
<p> |
| 41 |
Currently, Structural Navigation is fully implemented for web content, |
| 42 |
including the help content you are reading now. <app>Orca</app>'s |
| 43 |
Structural Navigation support for table cells has also been implemented |
| 44 |
for <app>OpenOffice Writer</app> and <app>LibreOffice Writer</app>. |
| 45 |
Implementing the remainder of the Structural Navigation objects to |
| 46 |
these office suites requires changes to be made by their respective |
| 47 |
developers. Implementing any Structural Navigation features within |
| 48 |
<app>Evince</app> will require a similar effort on the part of its |
| 49 |
developers. |
| 50 |
</p> |
| 51 |
<note style="tip"> |
| 52 |
<title>Don't Forget To Toggle Structural Navigation On!</title> |
| 53 |
<p> |
| 54 |
Depending on where you are, it may be necessary for you to explicitly |
| 55 |
toggle Structural Navigation on before you can use it. |
| 56 |
</p> |
| 57 |
</note> |
| 58 |
<section id="toggling_required"> |
| 59 |
<title>When Toggling Structural Navigation On Is Required</title> |
| 60 |
<p> |
| 61 |
In web pages, explicitly toggling Structural Navigation on is |
| 62 |
generally unnecessary because your interaction with the document |
| 63 |
largely consists of reading its content. Thus there is no question |
| 64 |
as to whether the 'H' you just pressed was meant to be a writing |
| 65 |
command or a navigation command. |
| 66 |
</p> |
| 67 |
<p> |
| 68 |
On the other hand, in editable documents such as those found in |
| 69 |
<app>OpenOffice</app> and <app>LibreOffice</app>, it is far more |
| 70 |
difficult for <app>Orca</app> to accurately predict what you expect |
| 71 |
to have happen as a result of pressing 'H'. Therefore, before you |
| 72 |
can use any Structural Navigation command in an editable document, |
| 73 |
you must first toggle Structural Navigation on by pressing |
| 74 |
<keyseq><key>Orca Modifier</key><key>Z</key></keyseq>. |
| 75 |
When you are finished navigating and ready to resume writing, press |
| 76 |
<keyseq><key>Orca Modifier</key><key>Z</key></keyseq> again to toggle |
| 77 |
Structural Navigation off. |
| 78 |
</p> |
| 79 |
</section> |
| 80 |
</section> |
| 81 |
<section id="settings"> |
| 82 |
<title>Available Settings</title> |
| 83 |
<p> |
| 84 |
In addition to the aforementioned commands, <app>Orca</app> has a number |
| 85 |
of configurable options available specifically for applications in which |
| 86 |
there is structural navigation support. |
| 87 |
</p> |
| 88 |
<steps> |
| 89 |
<title>Configuring Structural Navigation</title> |
| 90 |
<item> |
| 91 |
<p> |
| 92 |
Give focus to an application for which <app>Orca</app> has |
| 93 |
Structural Navigation support. |
| 94 |
</p> |
| 95 |
</item> |
| 96 |
<item> |
| 97 |
<p> |
| 98 |
Get into the <link xref="preferences">Orca Preferences</link> |
| 99 |
dialog box for the current application by pressing |
| 100 |
<keyseq> |
| 101 |
<key>Ctrl</key><key>Orca Modifier</key><key>Space</key> |
| 102 |
</keyseq>. |
| 103 |
</p> |
| 104 |
</item> |
| 105 |
<item> |
| 106 |
<p> |
| 107 |
Navigate to the last page of the dialog box which should be |
| 108 |
named according to the name of your current application. |
| 109 |
</p> |
| 110 |
</item> |
| 111 |
<item> |
| 112 |
<p> |
| 113 |
Examine and change the settings as you see fit. |
| 114 |
</p> |
| 115 |
</item> |
| 116 |
<item> |
| 117 |
<p> |
| 118 |
Press the <gui>OK</gui> button. |
| 119 |
</p> |
| 120 |
</item> |
| 121 |
</steps> |
| 122 |
</section> |
| 123 |
</page> |