From 3b2debb8797a7d888c896cb8b291354f742ec1bd Mon Sep 17 00:00:00 2001 From: Patrick Totzke Date: Mon, 19 Dec 2011 10:19:09 +0000 Subject: CUSTOMIZE.md love --- CUSTOMIZE.md | 25 ++++++++++++------------- 1 file changed, 12 insertions(+), 13 deletions(-) (limited to 'CUSTOMIZE.md') diff --git a/CUSTOMIZE.md b/CUSTOMIZE.md index f60e0c1b..14e646b0 100644 --- a/CUSTOMIZE.md +++ b/CUSTOMIZE.md @@ -172,18 +172,18 @@ The default is 256, which will be scaled down depending on how many colours your terminal supports. The interface will theme its widgets according to the palette defined in -section `[MODEc-theme]` where `MODE` denotes the integer indicating your mode. +section `[MODEc-theme]` where `MODE` is the integer indicating the colour mode. Have a look at the default config (`alot/defaults/alot.rc`) for a complete list of interpreted widget settings; the keys in this section should be self-explanatory. -Values can be colour names ('light red', 'dark green'..), RGB colour codes (e.g. '#868'), -font attributes ('bold', 'underline', 'blink', 'standout') or a comma separated combination of +Values can be colour names (`light red`, `dark green`..), RGB colour codes (e.g. `#868`), +font attributes (`bold`, `underline`, `blink`, `standout`) or a comma separated combination of colour and font attributes. In sections `[16c-theme]` and `[256c-theme]` you can define Y_fg and Y_bg for the foreground and background of each widget keyword Y, whereas the monochromatic (`[1c-theme]`) palette can only interpret font attributes for key Y without the suffix. -As an example, check the setting below, that makes the footer line appear as -underlined, bold red text on a bright green background: +As an example, check the setting below that makes the footer line appear as +underlined bold red text on a bright green background: [256c-theme] global_footer_bg = #8f6 @@ -199,19 +199,18 @@ Urwid provides a [neat colour picker script][urwid_colour_pick] that makes choos Custom Tagstring Formating -------------------------- -Keywords in the theme sections 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. +In theme sections you can use keys with prefix "tag_" to format specific tagstrings. For instance, +the following will make alot display the "todo" tag in white on red when in 256c-mode. [256c-theme] tag_todo_bg = #d66 tag_todo_fg = white -You can translate tag strings before displaying them using the [tag-translate] section. -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: +You can translate tag strings before displaying them using the `[tag-translate]` section. 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 for some fancy symbols. I personally display my maildir flags +like this: [tag-translate] flagged = ⚑ -- cgit v1.2.3