2005-12-30 [colin] 1.9.100cvs116
[claws.git] / manual / advanced.xml
1 <?xml version="1.0" encoding="utf-8"?>
2 <section id="ch_advanced">
3   <title>Advanced features</title>
4   <section id="adv_actions">
5     <title>Actions</title>
6     <para>
7     Actions allow you to use all the power of the Unix command-line with your emails. You can define various commands, taking parameters such as the current email file, a list of emails, the currently selected text, and so on. In this way, you'll be able to perform various tasks such as editing a raw mail in your text editor, "hide" what you mean using ROT-13, apply patches contained in emails directly, and so on. The only limit is your imagination. You can configure Actions via the Tools menu.
8     </para>
9     <blockquote>
10         <example><title>Simple <quote>Open With...</quote></title>
11                 <variablelist>
12                         <varlistentry><term>Menu name: <emphasis>Open with/kate</emphasis> Command Line: <emphasis>kate%p</emphasis></term>
13                                 <listitem><para>Opens the file of the selected decoded MIME part (<emphasis>%p</emphasis>) with the <emphasis>kate</emphasis> text editor.
14                                     </para></listitem>
15                     </varlistentry>
16                 </variablelist>
17         </example>
18         <example><title>Spam management using <ulink url="http://bogofilter.sourceforge.net/">Bogofilter</ulink></title>
19                 <variablelist>
20                         <varlistentry><term>Menu name: <emphasis>Bogofilter/Mark as Ham</emphasis> Command Line: <emphasis>bogofilter -n -v -B "%f"</emphasis></term>
21                                 <listitem><para>Marks the currently selected mails (<emphasis>%f</emphasis>) as 'not spam' using <emphasis>Bogofilter</emphasis>.
22                                     </para></listitem>
23                     </varlistentry>
24                     <varlistentry><term>Menu name: <emphasis>Bogofilter/Mark as Spam</emphasis> Command Line: <emphasis>bogofilter -s -v -B "%f"</emphasis></term>
25                             <listitem><para>Marks the currently selected mails (<emphasis>%f</emphasis>) as 'spam' using <emphasis>Bogofilter</emphasis>.
26                                     </para></listitem>
27                     </varlistentry>
28                 </variablelist>
29     </example>
30     <example><title>Search google using an external script</title>
31             <variablelist>
32                     <varlistentry><term>Menu name: <emphasis>Search/Google</emphasis> Command Line: <emphasis>|/path/to/google_search.pl</emphasis></term>
33                             <listitem><para>Searches google for the currently selected text (<emphasis>|</emphasis>) using the external script <emphasis><ulink url="http://claws.sylpheed.org/tools.php">google_search.pl</ulink></emphasis>.
34                                     </para></listitem>
35                     </varlistentry>
36             </variablelist>
37     </example>
38     </blockquote>
39   </section>
40   <section id="adv_templates">
41     <title>Templates</title>
42     <para>
43     Templates are used in Composition windows, and act as a model for emails. Templates can be filled with static text and dynamic parts, such as the original sender's name ("Dear %N, ..."), the date, ... When applying a template, the dynamic fields will be replaced with the relevant values. You can configure templates via the Tools menu.
44     </para>
45   </section>
46   <section id="adv_processing">
47     <title>Processing</title>
48     <para>
49     Processing rules are the same as Filtering rules, except that they are applied when entering a folder and apply only to this folder. You can use them to automatically move old mails into an archive folder, or for further dispatching of emails. You can set each folder's Processing rules by right-clicking on it.
50     </para>
51     <para>
52     Processing rules are accompanied by Pre-processing and Post-processing rules. Like Processing rules, they apply only when opening a folder, but like Filtering rules, they are shared accross all folders. You can configure them from the Tools menu. Pre-processing rules are executed before the folder's specific Processing rules, while Post-processing ones are executed after.
53     </para>
54   </section>
55   <section id="adv_plugins">
56     <title>Plugins</title>
57     <para>
58       Plugins are the mechanism of extending Sylpheed-Claws' capabilities. Imagine that you want to store your mails in a remote <acronym>SQL</acronym> database. In most mailers out there this is simply impossible without reworking the internals of the mailer. With Sylpheed-Claws you can simply write a plugin to achieve the task.
59     </para>
60     <para>
61             This is just an example of the possibilities. A good number of plugins developed for Sylpheed-Claws  already exist, and more are to come. The <link linkend="ch_plugins">Extending Sylpheed-Claws section</link> gives details of them.
62     </para>
63   </section>
64   <section id="adv_hidden">
65     <title>Hidden preferences</title>
66     <para>
67     There are a number of hidden preferences in Sylpheed-Claws, preferences that some users who we wanted to please couldn't live without, but which did not have a place in the GUI in our opinion. You can find the following, and change them while Sylpheed-Claws is not running in ~/.sylpheed-claws/sylpheedrc.
68     </para>
69     <variablelist>
70             <varlistentry><term>bold_unread</term>
71                     <listitem><para>show unread messages using bold font in summary view</para></listitem>
72             </varlistentry>
73             <varlistentry><term>color_new</term>
74                     <listitem><para>colour (as hex triplet) of folder name when indicating new messages</para></listitem>
75             </varlistentry>
76             <varlistentry><term>cache_max_mem_usage</term>
77                     <listitem><para>the maximum amount of memory to use to cache messages, in kB.</para></listitem>
78             </varlistentry>
79             <varlistentry><term>cache_min_keep_time</term>
80                     <listitem><para>the minimum time to keep a cache in memory, in minutes. Caches more recent than this time will not be freed, even if the memory usage is too high.</para></listitem>
81             </varlistentry>
82             <varlistentry><term>enable_hscrollbar</term>
83                     <listitem><para>enables horizontal scrollbar in summaryview</para></listitem>
84             </varlistentry>
85             <varlistentry><term>enable_rules_hint</term>
86                     <listitem><para>enable alternate lines in GtkTreeViews</para></listitem>
87             </varlistentry>
88             <varlistentry><term>enable_swap_from</term>
89                     <listitem><para>display sender's email address in To column in Sent folder instead of recipient's</para></listitem>
90             </varlistentry>
91             <varlistentry><term>folderview_vscrollbar_policy</term>
92                     <listitem><para>specify the policy of vertical scroll bar of folder view</para></listitem>
93             </varlistentry>
94             <varlistentry><term>hover_timeout</term>
95                     <listitem><para>time in milliseconds that will cause a folder tree to expand during drag 'n' drop when the mouse cover is held over it</para></listitem>
96             </varlistentry>
97             <varlistentry><term>statusbar_update_step</term>
98                     <listitem><para>update stepping in progress bars</para></listitem>
99             </varlistentry>
100             <varlistentry><term>textview_cursor_visible</term>
101                     <listitem><para>display the cursor in the message view</para></listitem>
102             </varlistentry>
103             <varlistentry><term>thread_by_subject_max_age</term>
104                     <listitem><para>number of days to include a message in a thread when using 'Thread using subject in addition to standard headers'</para></listitem>
105             </varlistentry>
106             <varlistentry><term>toolbar_detachable</term>
107                     <listitem><para>hide handles in the toolbars</para></listitem>
108             </varlistentry>
109             <varlistentry><term>utf8_instead_of_locale_for_broken_mail</term>
110                     <listitem><para>use UTF-8 encoding for broken mails instead of current locale</para></listitem>
111             </varlistentry>
112             <varlistentry><term>warn_dnd</term>
113                     <listitem><para>display a confirmation dialog on drag 'n' drop of folders</para></listitem>
114             </varlistentry>
115     </variablelist>
116   </section>
117 </section>