Table of Contents
This DRAFT document defines how to make a theme of emoticons typically used in instant messaging applications
The basic scheme is very simple. The theme consists in one sub directory which contains all the pictures and an XML file that gives each picture ASCII symbols. A .directory file might be used.
Files involved in this specification are located according to the "desktop base directory specification" which can be found on www.freedesktop.org.
All the files of the theme must be placed in a sub directory of
The name of the directory must be equal to the name of the theme.
That directory must contains a file called
the format of that file is described below.
The theme directory may also contain a .directory file which contains translations of the theme name and/or an icon for that theme.
Emoticon map files must be well-formed XML files. Implementations should ignore unknown tag or unknown attributes.
- <messaging-emoticon-map> [version="0.1"]
The root element is <messaging-emoticon-map> all other elements are contained by it.
- <emoticon file="...">
This element represents one emoticon. The attribute file is the name of the image file which must be in the same directory. The extension may be omitted. In that case, the implementation look in that directory for a file with the same name in a supported format.
There are no order for emoticon in the map. But the first icon in the map is generally used to identify the theme graphically. By convention the this SHOULD be :-)
This element may only appear below <emoticon>. It represents the ASCII string which will be matched in the text, and replaced by the image specified by the file attribute of the emoticon.
There may be several strings per emoticon.
There is no order for string inside an emoticon. But the first one SHOULD be the default one, and will be taken if there is a GUI selector.
<messaging-emoticon-map> <emoticon file="smile.png"> <string>:-)</string> <string>:)</string> <string>:o)</string> </emoticon> <emoticon file="wink.png"> <string>;-)</string> <string>;)</string> </emoticon> <emoticon file="unhappy.png"> <string>:-(</string> <string>:(</string> </emoticon> </messaging-emoticon-map>