gtk/pixmaps/smileys/THEMES-HOWTO

branch
cpw.khc.msnp14
changeset 20472
6a6d2ef151e6
parent 13822
5e5a3db9ce6c
parent 14253
b63ebf84c42b
equal deleted inserted replaced
13912:463b4fa9f067 20472:6a6d2ef151e6
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

mercurial