diff options
author | Patrick Totzke <patricktotzke@gmail.com> | 2011-08-26 10:24:41 +0100 |
---|---|---|
committer | Patrick Totzke <patricktotzke@gmail.com> | 2011-08-26 10:24:41 +0100 |
commit | 87f367406cf30f7c829b63b8e90a8d58794110da (patch) | |
tree | 644d3ce4ebc6a5ac0f4fa3fc01618d16a9cc48ab /USAGE | |
parent | f28cfdd29d265b02a74e44323145b7aac5a79fe8 (diff) |
markdown
Diffstat (limited to 'USAGE')
-rw-r--r-- | USAGE | 68 |
1 files changed, 35 insertions, 33 deletions
@@ -3,7 +3,7 @@ Usage In all views, arrows, page-up/down, j,k and space can be used to move the focus. Escape cancels prompts. You can hit ":" at any time and type in commands to the prompt. Any commandline can be mapped by using the "MODE-maps" sections -in the config file. These are the default keymaps\::: +in the config file. These are the default keymaps: [global-maps] $ = flush @@ -63,27 +63,27 @@ The default location for the config file is ~/.alot.rc. You can find a complete example config in data/example.full.rc. Here is a key for the interpreted sections: -[general] - global settings: set your editor etc - -[account X] - defines the account X: realname, email address, sendmail - -[X-maps] - defines keymaps for mode X. possible modes are: - envelope, search, thread, taglist, bufferlist and global. - global-maps are valid in all modes. - -[tag-translate] - defines a map from tagnames to strings that is used when - displaying tags. utf-8 symbols welcome. - -[Xc-theme] - define colour palette for colour mode. X is in {1, 16, 256}. + [general] + global settings: set your editor etc + + [account X] + defines the account X: realname, email address, sendmail + + [X-maps] + defines keymaps for mode X. possible modes are: + envelope, search, thread, taglist, bufferlist and global. + global-maps are valid in all modes. + + [tag-translate] + defines a map from tagnames to strings that is used when + displaying tags. utf-8 symbols welcome. + + [Xc-theme] + define colour palette for colour mode. X is in {1, 16, 256}. All configs are optional, but if you want to send mails you need to specify at least one account section. -A sample gmail section looks like this\::: +A sample gmail section looks like this: [account gmail] realname = Patrick Totzke @@ -93,7 +93,7 @@ A sample gmail section looks like this\::: sender_type = sendmail sendmail_command = msmtp --account=gmail -t -I use this for my uni-account\::: +I use this for my uni-account: [account uoe] realname = Patrick Totzke @@ -120,22 +120,24 @@ For every command X, the callable 'pre_X' will be called before X and 'post_X' a When a hook gets called, it receives instances of -1. `alot.ui.UI`, the main user interface object that can prompt etc. -2. `alot.db.DBManager`, the applications database manager -3. `alot.account.AccountManager`, can be used to look up account info -4. `alot.settings.config`, a configparser to access the users config +1. `alot.ui.UI`, the main user interface object that can prompt etc. +2. `alot.db.DBManager`, the applications database manager +3. `alot.account.AccountManager`, can be used to look up account info +4. `alot.settings.config`, a configparser to access the users config An autogenerated API doc for these can be found at http://pazz.github.com/alot/ , the sphinx sources live in the `docs` folder. As an example, consider this pre-hook for the exit command, -that logs a personalized goodby message\::: +that logs a personalized goodby message: - def pre_exit(ui, dbman, accountman, config): - accounts = accountman.get_accounts() - if accounts: - ui.logger.info('goodbye, %s!' % accounts[0].realname) - else: - ui.logger.info('goodbye!') +```python +def pre_exit(ui, dbman, accountman, config): + accounts = accountman.get_accounts() + if accounts: + ui.logger.info('goodbye, %s!' % accounts[0].realname) + else: + ui.logger.info('goodbye!') +``` Theming @@ -153,7 +155,7 @@ http://excess.org/urwid/browser/palette_test.py See `data/example.full.rc` for a complete list of widgets that can be themed. Moreover, keywords that start with "tag_" will be used to display specific tags. For instance, you -can use the following to always display the "todo" tag in white on red, when in 256c-mode. :: +can use the following to always display the "todo" tag in white on red, when in 256c-mode. [256c-theme] tag_todo_bg = #d66 @@ -163,7 +165,7 @@ You can translate tag strings before displaying them using the [tag-translate] s A key=value statement in this section is interpreted as: Always display the tag `key` as string `value`. Utf-8 symbols are welcome here. See e.g. http://panmental.de/symbols/info.htm -I personally display my maildir flags like this\::: +I personally display my maildir flags like this: [tag-translate] flagged = ⚑ |