theme-format.org

This file format is simpler than the PList format. See a self-explanatory example:

[XMPP]
FunnyFace.png  :)  :-)  =-)
TongueFace.png  :P  :-P  :-6
Other.png    :other-face:  :otherface: :etcetera:
# Coments and comments...
AnotherOne.png  :anotherone:

# Finish in the empty line.

For compatibility with pidgin and jabber we use XMPP section only, the others sections are ignored.

More technically, it consist in a group of emoticons definition called "sections". Sections names are written between square brackets.

[Section]

In pidgin, each sections represents a protocol, for example: ICQ, XMPP(Jabber protocol), etc.

Each sections has what we call entries, each entry has a PNG file name, and its emoticons text separated by spaces(usually more than one).

MyImage.png  :)  :-) =-)

For comments you can use the numeral("#") at the beginning of the line:

# this is my comment.

Emoicon-mode will finish reading this files when it finds an empty line or the end of file, so:

remember to don't leave empty lines between entries:

[XMPP]
One.png   1   :1:
Two.png   2   :2:

Three.png   3   :3:

Some pidgin themes has the "! " characters, this lines are considered as emoticons and loaded the PNG file as if the characters doesn't exists.

!  MyImage.png  :)  :-)  =-)

is the same as:

MyImage.png   :)  :-)  =-)

I do not recommend this file format, you should use the *Emoticons Pidgin File Format. The "Emoticons.plist" file is in XML format. This is done in this way just for compatibility.

The format is like this:

<?xml version="1.0" encoding="UTF-8"?>
<plist version="1.0">
<dict>
  <key>Theme's name</key>
  <integer>1</integer>
  <key>Emoticons</key>
  <dict>
    <key>Name of Image File.png</key>
    <dict>
      <key>Equivalents</key>
      <array>
        <string>Emoticon1 :) </string>
        <string>Emoticon2 :-) </string>
        <string>Emoticon3 ::-) </string>
        <string> ... </string>
      </array>
      <key>Name</key>
      <string>Name of the emoticon</string>      
    </dict>
    <key>Too_Angry.png</key>
    <dict>
      <key>Equivalents</key>
      <array>
        <string>&gt;:-(</string>
        <string>&gt;:(</string>
      </array>
      <key>Name</key>
      <string>Too Angry</string>
    </dict>
    <key>Nice.png</key>
    <dict>
      <key>Equivalents</key>
      <array>
        <string>:)</string>
        <string>:-)</string>
      </array>
      <key>Name</key>
      <string>Smile</string>
    </dict>
  </dict>
</plist>

Emoticon-iconous loads this files when is necessary, and just once for saving overhead.

If you want to load manually, for example when using jabber-emoticon.el functions, use the function

(emoicon-load-emoticon-theme)

This function can be called by M-x emoicon-load-emoticon-theme (or press Alt+x and write emoicon-load-emoticon-theme).

theme-format.org Copyright (C) 2011 Giménez, Christian N.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Miércoles 09 De Noviembre Del 2011