configuration.html

mutt-1.5.12 源代码。linux 下邮件接受的工具。

equivalent.  An alternative form is to specify the key as a three digit
octal number prefixed with a ``\'' (for example <span class="emphasis"><em>\177</em></span> is
equivalent to <span class="emphasis"><em>\c?</em></span>).
</p><p>
In addition, <span class="emphasis"><em>key</em></span> may consist of:
</p><p>

</p><div class="table"><a id="id2680885"></a><p class="title"><b>Table聽3.1.聽Symbolic key names</b></p><table summary="Symbolic key names" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Symbolic name</th><th>Meaning</th></tr></thead><tbody><tr><td>\t</td><td>tab</td></tr><tr><td>&lt;tab&gt;</td><td>tab</td></tr><tr><td>&lt;backtab&gt;</td><td>backtab / shift-tab</td></tr><tr><td>\r</td><td>carriage return</td></tr><tr><td>\n</td><td>newline</td></tr><tr><td>\e</td><td>escape</td></tr><tr><td>&lt;esc&gt;</td><td>escape</td></tr><tr><td>&lt;up&gt;</td><td>up arrow</td></tr><tr><td>&lt;down&gt;</td><td>down arrow</td></tr><tr><td>&lt;left&gt;</td><td>left arrow</td></tr><tr><td>&lt;right&gt;</td><td>right arrow</td></tr><tr><td>&lt;pageup&gt;</td><td>Page Up</td></tr><tr><td>&lt;pagedown&gt;</td><td>Page Down</td></tr><tr><td>&lt;backspace&gt;</td><td>Backspace</td></tr><tr><td>&lt;delete&gt;</td><td>Delete</td></tr><tr><td>&lt;insert&gt;</td><td>Insert</td></tr><tr><td>&lt;enter&gt;</td><td>Enter</td></tr><tr><td>&lt;return&gt;</td><td>Return</td></tr><tr><td>&lt;home&gt;</td><td>Home</td></tr><tr><td>&lt;end&gt;</td><td>End</td></tr><tr><td>&lt;space&gt;</td><td>Space bar</td></tr><tr><td>&lt;f1&gt;</td><td>function key 1</td></tr><tr><td>&lt;f10&gt;</td><td>function key 10</td></tr></tbody></table></div><p>

</p><p>
<span class="emphasis"><em>key</em></span> does not need to be enclosed in quotes unless it contains a
space (`` '').
</p><p>
<span class="emphasis"><em>function</em></span> specifies which action to take when <span class="emphasis"><em>key</em></span> is pressed.
For a complete list of functions, see the <a href="reference.html#functions" title="4.聽Functions">reference</a>.  The special function <code class="literal">noop</code> unbinds the specified key
sequence.
</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="charset-hook"></a>4.聽Defining aliases for character sets </h2></div></div></div><p>
</p><div class="literallayout"><p><br />
Usage:聽<code class="literal">charset-hook</code>聽<span class="emphasis"><em>alias</em></span>聽<span class="emphasis"><em>charset</em></span><br />
Usage:聽<code class="literal">iconv-hook</code>聽<span class="emphasis"><em>charset</em></span>聽<span class="emphasis"><em>local-charset</em></span><br />
</p></div><p>
</p><p>
The <code class="literal">charset-hook</code> command defines an alias for a character set.
This is useful to properly display messages which are tagged with a
character set name not known to mutt.
</p><p>
The <code class="literal">iconv-hook</code> command defines a system-specific name for a
character set.  This is helpful when your systems character
conversion library insists on using strange, system-specific names
for character sets.
</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="folder-hook"></a>5.聽Setting variables based upon mailbox</h2></div></div></div><p>
Usage: <code class="literal">folder-hook</code> [!]<span class="emphasis"><em>regexp</em></span> <span class="emphasis"><em>command</em></span>
</p><p>
It is often desirable to change settings based on which mailbox you are
reading.  The folder-hook command provides a method by which you can execute
any configuration command.  <span class="emphasis"><em>regexp</em></span> is a regular expression specifying
in which mailboxes to execute <span class="emphasis"><em>command</em></span> before loading.  If a mailbox
matches multiple folder-hook's, they are executed in the order given in the
muttrc.
</p><p>
<span class="bold"><strong>Note:</strong></span> if you use the ``!'' shortcut for <a href="reference.html#spoolfile" title="3.264.聽spoolfile">$spoolfile</a> at the beginning of the pattern, you must place it
inside of double or single quotes in order to distinguish it from the
logical <span class="emphasis"><em>not</em></span> operator for the expression.
</p><p>
Note that the settings are <span class="emphasis"><em>not</em></span> restored when you leave the mailbox.
For example, a command action to perform is to change the sorting method
based upon the mailbox being read:
</p><p>

</p><pre class="screen">
folder-hook mutt set sort=threads
</pre><p>

</p><p>
However, the sorting method is not restored to its previous value when
reading a different mailbox.  To specify a <span class="emphasis"><em>default</em></span> command, use the
pattern ``.'':
</p><p>

</p><pre class="screen">
folder-hook . set sort=date-sent
</pre><p>

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="macro"></a>6.聽Keyboard macros</h2></div></div></div><p>
Usage: <code class="literal">macro</code> <span class="emphasis"><em>menu</em></span> <span class="emphasis"><em>key</em></span> <span class="emphasis"><em>sequence</em></span> [ <span class="emphasis"><em>description</em></span> ]
</p><p>
Macros are useful when you would like a single key to perform a series of
actions.  When you press <span class="emphasis"><em>key</em></span> in menu <span class="emphasis"><em>menu</em></span>, Mutt will behave as if
you had typed <span class="emphasis"><em>sequence</em></span>.  So if you have a common sequence of commands
you type, you can create a macro to execute those commands with a single
key.
</p><p>
<span class="emphasis"><em>menu</em></span> is the <a href="configuration.html#maps">map</a> which the macro will be bound.
Multiple maps may be specified by separating multiple menu arguments by
commas. Whitespace may not be used in between the menu arguments and the
commas separating them.
</p><p>
<span class="emphasis"><em>key</em></span> and <span class="emphasis"><em>sequence</em></span> are expanded by the same rules as the <a href="configuration.html#bind" title="3.聽Changing the default key bindings">key bindings</a>.  There are some additions however.  The
first is that control characters in <span class="emphasis"><em>sequence</em></span> can also be specified
as <span class="emphasis"><em>^x</em></span>.  In order to get a caret (`^'') you need to use
<span class="emphasis"><em>^^</em></span>.  Secondly, to specify a certain key such as <span class="emphasis"><em>up</em></span>
or to invoke a function directly, you can use the format
<span class="emphasis"><em>&lt;key name&gt;</em></span> and <span class="emphasis"><em>&lt;function name&gt;</em></span>.  For a listing of key
names see the section on <a href="configuration.html#bind" title="3.聽Changing the default key bindings">key bindings</a>.  Functions
are listed in the <a href="reference.html#functions" title="4.聽Functions">reference</a>.
</p><p>
The advantage with using function names directly is that the macros will
work regardless of the current key bindings, so they are not dependent on
the user having particular key definitions.  This makes them more robust
and portable, and also facilitates defining of macros in files used by more
than one user (eg. the system Muttrc).
</p><p>
Optionally you can specify a descriptive text after <span class="emphasis"><em>sequence</em></span>,
which is shown in the help screens.
</p><p>
<span class="bold"><strong>Note:</strong></span> Macro definitions (if any) listed in the help screen(s), are
silently truncated at the screen width, and are not wrapped.
</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="color"></a>7.聽Using color and mono video attributes</h2></div></div></div><p>
</p><div class="literallayout"><p><br />
Usage:聽<code class="literal">color</code>聽<span class="emphasis"><em>object</em></span>聽<span class="emphasis"><em>foreground</em></span>聽<span class="emphasis"><em>background</em></span>聽[聽<span class="emphasis"><em>regexp</em></span>聽]<br />
Usage:聽<code class="literal">color</code>聽index聽<span class="emphasis"><em>foreground</em></span>聽<span class="emphasis"><em>background</em></span>聽<span class="emphasis"><em>pattern</em></span><br />
Usage:聽<code class="literal">uncolor</code>聽index聽<span class="emphasis"><em>pattern</em></span>聽[聽<span class="emphasis"><em>pattern</em></span>聽...聽聽]<br />
</p></div><p>
</p><p>
If your terminal supports color, you can spice up Mutt by creating your own
color scheme.  To define the color of an object (type of information), you
must specify both a foreground color <span class="bold"><strong>and</strong></span> a background color (it is not
possible to only specify one or the other).
</p><p>
<span class="emphasis"><em>object</em></span> can be one of:
</p><p>

</p><div class="itemizedlist"><ul type="disc"><li><p>
attachment
</p></li><li><p>
body (match <span class="emphasis"><em>regexp</em></span> in the body of messages)
</p></li><li><p>
bold (hiliting bold patterns in the body of messages)
</p></li><li><p>
error (error messages printed by Mutt)
</p></li><li><p>
header (match <span class="emphasis"><em>regexp</em></span> in the message header)
</p></li><li><p>
hdrdefault (default color of the message header in the pager)
</p></li><li><p>
index (match <span class="emphasis"><em>pattern</em></span> in the message index)
</p></li><li><p>
indicator (arrow or bar used to indicate the current item in a menu)
</p></li><li><p>
markers (the ``+'' markers at the beginning of wrapped lines in the pager)
</p></li><li><p>
message (informational messages)
</p></li><li><p>
normal
</p></li><li><p>
quoted (text matching <a href="reference.html#quote-regexp" title="3.226.聽quote_regexp">$quote_regexp</a> in the body of a message)
</p></li><li><p>
quoted1, quoted2, ..., quoted<span class="bold"><strong>N</strong></span> (higher levels of quoting)
</p></li><li><p>
search (hiliting of words in the pager)
</p></li><li><p>
signature
</p></li><li><p>
status (mode lines used to display info about the mailbox or message)
</p></li><li><p>
tilde (the ``藴'' used to pad blank lines in the pager)
</p></li><li><p>
tree (thread tree drawn in the message index and attachment menu)
</p></li><li><p>
underline (hiliting underlined patterns in the body of messages)
</p></li></ul></div><p>

</p><p>
<span class="emphasis"><em>foreground</em></span> and <span class="emphasis"><em>background</em></span> can be one of the following:
</p><p>

</p><div class="itemizedlist"><ul type="disc"><li><p>
white
</p></li><li><p>
black
</p></li><li><p>
green
</p></li><li><p>
magenta
</p></li><li><p>
blue
</p></li><li><p>
cyan
</p></li><li><p>
yellow
</p></li><li><p>
red
</p></li><li><p>
default
</p></li><li><p>
color<span class="emphasis"><em>x</em></span>
</p></li></ul></div><p>

</p><p>
<span class="emphasis"><em>foreground</em></span> can optionally be prefixed with the keyword <code class="literal">bright</code> to make
the foreground color boldfaced (e.g., <code class="literal">brightred</code>).
</p><p>
If your terminal supports it, the special keyword <span class="emphasis"><em>default</em></span> can be
used as a transparent color.  The value <span class="emphasis"><em>brightdefault</em></span> is also valid.
If Mutt is linked against the <span class="emphasis"><em>S-Lang</em></span> library, you also need to set
the <span class="emphasis"><em>COLORFGBG</em></span> environment variable to the default colors of your
terminal for this to work; for example (for Bourne-like shells):
</p><p>

</p><pre class="screen">
set COLORFGBG="green;black"
export COLORFGBG
</pre><p>

</p><p>
<span class="bold"><strong>Note:</strong></span> The <span class="emphasis"><em>S-Lang</em></span> library requires you to use the <span class="emphasis"><em>lightgray</em></span>
and <span class="emphasis"><em>brown</em></span> keywords instead of <span class="emphasis"><em>white</em></span> and <span class="emphasis"><em>yellow</em></span> when
setting this variable.
</p><p>
<span class="bold"><strong>Note:</strong></span> The uncolor command can be applied to the index object only.  It
removes entries from the list. You <span class="bold"><strong>must</strong></span> specify the same pattern
specified in the color command for it to be removed.  The pattern ``*'' is
a special token which means to clear the color index list of all entries.
</p><p>
Mutt also recognizes the keywords <span class="emphasis"><em>color0</em></span>, <span class="emphasis"><em>color1</em></span>, 鈥