| |
1 Gaim Smiley Themes Documentation |
| |
2 Sean M. Egan |
| |
3 5 Jan 2003 |
| |
4 |
| |
5 Version 0.60 of Gaim brings up all themable smileys. In the preferences dialog, a user can choose from a selection of looks his smileys will take. This guide is to serve as a reference to those interested in creating third-party smiley themes. |
| |
6 |
| |
7 Your theme should be contained in a single directory. This directory will be installed in the Gaim smiley theme directory ($HOME/.gaim/smileys/). This directory will contain a file called `theme' that specifies the theme metadata and image files that are used by the theme. The format of the `theme' file is as follows. |
| |
8 |
| |
9 The beginning of the file contains some metainformation about the theme in the format |
| |
10 |
| |
11 Key=Value |
| |
12 |
| |
13 Valid keys include: |
| |
14 Name - Name of the theme |
| |
15 Description - Description of the theme |
| |
16 Icon - An image used to represent the theme in the theme selector UI |
| |
17 Author - The author's name |
| |
18 |
| |
19 Following this meta-information are "sml" groups. A "sml" group is a group of smileys that will be shown together. For example, each protocol has its own "sml" group (MSN, Yahoo, Gadu-Gadu, etc.). The name of the group is surrounded in square brackets, and each line beneath it (until the next sml group or the end of the file) defines a smiley. |
| |
20 Each line of the group starts with a filename of the icon followed by a space-delimited list of the characters that represent it. |
| |
21 |
| |
22 Example: |
| |
23 [AIM/ICQ] |
| |
24 smiley.png :) :-) |
| |
25 |
| |
26 In the smiley selector UI, each icon will only be shown once, and the first string representing it will be used. To keep a smiley out of the selector altogether, make the first two characters of the line "! " followed by the filename and emoticons. |
| |
27 |
| |
28 As of 2.0.0beta2, spaces and backslashes in the "list of characters" (see above) must be escaped by prepending them with a backslash. For example, to define a smiley that is represented by ":-/" and ":-\", use: |
| |
29 |
| |
30 [AIM/ICQ] |
| |
31 think.png :-/ :-\\ |
| |
32 |