Debian Codegraph @

help/C/howto_structural_navigation.page

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