This manual page is the ultimate reference to consult when writing themes for Swirc.
What | Hex | Octal | Appearance |
---|---|---|---|
Blink | 1d | 035 | ^] |
Bold | 02 | 002 | ^B |
Color | 03 | 003 | ^C |
Normal | 0f | 017 | ^O |
Reverse | 16 | 026 | ^V |
Underline | 1f | 037 | ^_ |
Example usage:
blabla ^Bbold text^B blabla blabla ^Vreversed text^V blabla blabla ^_underlined text^_ blabla
Always use the literal control characters because else it won't work!
Blink is a no operation because it's annoying.
Number | Name | |
---|---|---|
00 | white | |
01 | black | |
02 | blue | (navy) |
03 | green | |
04 | red | |
05 | brown | (maroon) |
06 | purple | |
07 | orange | (olive) |
08 | yellow | |
09 | lt.green | (lime) |
10 | teal | (a kinda green/blue cyan) |
11 | lt.cyan | (cyan ?) (aqua) |
12 | lt.blue | (royal) |
13 | pink | (light purple) (fuchsia) |
14 | grey | |
15 | lt.grey | (silver) |
For the colors 16-99 see the output of the command /colormap. Enough color pairs must've been initialized. (193 color pairs are too few for the colors 16-99 to be used as backgrounds.)
The syntax of the color attribute in text has the format ^CN[,M]. N will be the text (foreground) color and M the background color. A background color (M) is optional and is not always included.
N and M can maximally be two digits long. Although the colors {0,1,2,...,9} are supported you are highly encouraged to use {00,01,02,...,09}.
A plain ^C can be used to turn the color effect off. While typing ^O will make sure ALL the text effects gets reset. For example:
blabla ^C05,02red text on blue background^C blabla blabla ^C09green text^O blabla
Of course settings can start with colored text and a closing ^C is not essential.
term_background (int) |
Which background color (0-15) is this theme written for?
0 = white 1 = black |
term_enable_colors (bool) |
Enable colors (yes/no)? |
term_use_default_colors (bool) |
Use terminal's default colors? I.e. call use_default_colors(3). |
color3, color4 (string) |
Colors used in uncategorized contexts. Must begin with ^C. |
gfx_failure, gfx_success, gfx_warning (string) |
Used in contexts where to flag failures, successes and warnings respectively. |
left_bracket, right_bracket (string) |
Left and right bracket. Frequently used. |
logo_color (string) |
Swirc ASCII logo color displayed at startup. (Must begin with ^C.) |
nick_s1, nick_s2 (string) |
When you or another user types something the nickname will be enclosed by s1 and s2. |
nicklist_my_nick_color, nicklist_nick_color, nicklist_privilege_color, nicklist_vline_color (int) |
Nicklist decoration. All of these settings are of type int (0-99) thus ^C is not needed and should not be used. |
notice_color1, notice_color2 (string) |
Notice colors. ^C should be used. |
notice_lb, notice_rb, notice_sep (string) |
Notice left/right bracket and separator. |
notice_inner_b1, notice_inner_b2 (string) |
Notice inner bracket 1 and 2. (I.e. left and right.) |
primary_color, secondary_color (string) |
Primary and secondary color for the theme. Frequently used. (Begin with ^C.) |
slogan (string) |
Swirc slogan displayed in the statusbar. |
specifier1, specifier2, specifier3 (string) |
Specifiers used in various contexts. Number 1 is frequently used. |
statusbar_bg, statusbar_fg (string) |
Statusbar background and foreground. Valid values are black, red, green, yellow, blue, magenta, cyan, white. |
statusbar_leftBracket, statusbar_rightBracket, statusbar_spec (string) |
Statusbar left/right bracket and specifier. |
time_format (string) |
Time format passed to strftime(3). |
titlebar_bg, titlebar_fg (string) |
Titlebar background and foreground. Valid values are black, red, green, yellow, blue, magenta, cyan, white. |
whois_acc (string) |
whois_away (string) |
whois_bot (string) |
whois_cert (string) |
whois_channels (string) |
whois_conn (string) |
whois_host (string) |
whois_idle (string) |
whois_ircName (string) |
whois_ircOp (string) |
whois_modes (string) |
whois_server (string) |
whois_service (string) |
whois_ssl (string) |
If you want to give color to numbers be sure to use two digits for N nor M!