Mercurial > pidgin
annotate pixmaps/smileys/THEMES-HOWTO @ 13853:bbf0470cb348
[gaim-migrate @ 16312]
Improvement/fixing of GntTree. Do the scrolling and stuff without 'reliably'.
committer: Tailor Script <tailor@pidgin.im>
author | Sadrul Habib Chowdhury <imadil@gmail.com> |
---|---|
date | Fri, 23 Jun 2006 00:45:45 +0000 |
parents | 6fd7425133fc |
children |
rev | line source |
---|---|
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 | |
13820
6fd7425133fc
[gaim-migrate @ 16252]
Richard Laager <rlaager@wiktel.com>
parents:
4252
diff
changeset
|
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. |
4252 | 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. | |
13820
6fd7425133fc
[gaim-migrate @ 16252]
Richard Laager <rlaager@wiktel.com>
parents:
4252
diff
changeset
|
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. |
4252 | 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. | |
13820
6fd7425133fc
[gaim-migrate @ 16252]
Richard Laager <rlaager@wiktel.com>
parents:
4252
diff
changeset
|
27 |
6fd7425133fc
[gaim-migrate @ 16252]
Richard Laager <rlaager@wiktel.com>
parents:
4252
diff
changeset
|
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: |
6fd7425133fc
[gaim-migrate @ 16252]
Richard Laager <rlaager@wiktel.com>
parents:
4252
diff
changeset
|
29 |
6fd7425133fc
[gaim-migrate @ 16252]
Richard Laager <rlaager@wiktel.com>
parents:
4252
diff
changeset
|
30 [AIM/ICQ] |
6fd7425133fc
[gaim-migrate @ 16252]
Richard Laager <rlaager@wiktel.com>
parents:
4252
diff
changeset
|
31 think.png :-/ :-\\ |
6fd7425133fc
[gaim-migrate @ 16252]
Richard Laager <rlaager@wiktel.com>
parents:
4252
diff
changeset
|
32 |