|
4252
|
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 (SME: I'm doing this at 6:30AM; I'm tired, but I can't sleep. Someone make sure I fix this up to make sure it all makes sense when I'm not tired anymore. Right now it's mostly just unassembled thoughts)
|
|
|
8
|
|
|
9 Your theme should be contained in a single directory. This directory will be installed in the Gaim smiley theme directory (SME: There should probably be a $HOME/.gaim/smileys/ that the theme could go in too.). This directory will contain a file called `theme' that specifies the theme and image (SME: And possibly sound) files that are used by the theme. The format of the `theme' file is as follows.
|
|
|
10
|
|
|
11 The beginning of the file contains some metainformation about the theme in the format
|
|
|
12
|
|
|
13 Key=Value
|
|
|
14
|
|
|
15 Valid keys include:
|
|
|
16 Name - Name of the theme
|
|
|
17 Description - Description of the theme
|
|
|
18 Icon - An image used to represent the theme in the theme selector UI
|
|
|
19 Author - The author's name
|
|
|
20
|
|
|
21 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.
|
|
|
22 Each line of the group starts with a filename of the icon (SME: Or sound?) followed by a space-delimited list of the characters that represent it.
|
|
|
23
|
|
|
24 Example:
|
|
|
25 [AIM/ICQ]
|
|
|
26 smiley.png :) :-)
|
|
|
27
|
|
|
28 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.
|
