1<page xmlns="http://projectmallard.org/1.0/" type="topic" id="preferences">
2  <info>
3    <link type="guide" xref="index#advanced" />
4    <title type="sort">4. Preferences</title>
5    <!-- link type="next" xref="event_monitor_plugin" /-->
6    <desc>
7      Customizing <app>Accerciser</app>'s preferences
8    </desc>
9    <credit type="author">
10      <name>Eitan Isaacson</name>
11      <email>eitan@ascender.com</email>
12    </credit>
13    <credit type="author">
14      <name>Peter Parente</name>
15      <email>pparent@us.ibm.com</email>
16    </credit>
17    <credit type="author">
18      <name>Aline Bessa</name>
19      <email>alibezz@gmail.com</email>
20    </credit>
21    <license>
22      <p>Creative Commons Share Alike 3.0</p>
23    </license>
24  </info>
25  <title> Configuring <app>Accerciser</app></title>
26  <p>
27    To configure plugins, hotkeys, and highlighting, do either <keyseq><key>ctrl</key><key>p</key></keyseq> or <guiseq><gui>Edit</gui>
28    <gui>Preferences</gui></guiseq> to open a dialog.
29  </p>
30
31  <section id="plugin">
32    <title>Configuring plugins</title>
33    <p>
34      After opening the Preferences Dialog, you will find a list of all available plugins, with corresponding checkboxes,
35      under the "Plugins" tab. To enable or disable a plugin, toggle its checkbox. Only active plugins can be accessed via
36      <app>Accerciser</app>'s interface.
37    </p>
38    <p>
39      Right-clicking on any given plugin allows you to choose its location: "Top Panel", "Bottom Panel", and "New View". Selecting "New
40      View" creates a new window for the plugin.
41    </p>
42
43    <note style="tip">
44      <p>
45        You may bypass the Preferences dialog by using drag and drop to move a plugin from a location to another.
46      </p>
47    </note>
48  </section>
49
50  <section id="global_hotkey">
51    <title>Configuring global hotkeys</title>
52    <p>
53      Some elements in <app>Accerciser</app> may enable certain functionalities via hotkeys. An example is the
54      <link xref="quick_select_plugin">Quick Select Plugin</link>. The hotkey combination for each functionality
55      can be changed via the Preferences dialog, under the "Global Hotkeys" tab. Under this tab,  you will find a
56      list of all features for which hotkeys can be configured. Use the <cmd>ctrl</cmd>, <cmd>alt</cmd>, and
57      <cmd>shift</cmd> checkboxes to enable or disable these modifiers.
58    </p>
59
60   </section>
61
62   <section id="highlighting">
63     <title>Configuring widget's highlighting</title>
64     <p>
65       Some of <app>Accerciser</app>'s elements, such as the global hotkey <keyseq><key>ctrl</key><key>alt</key><key>/</key></keyseq>,
66       highlight a specific widget in a target application. The highlighting duration, border color, and fill color can
67       be customized via the Preferences dialog, under the "Highlighting" tab.
68     </p>
69   </section>
70</page>
71