# Specificatie van emoticons

Versie 0.1

07 januari 2005

## Emoticons

## Inleiding

Dit CONCEPT document definieert hoe een thema emoticons te maken typisch gebruikt in "instant messaging" toepassingen

Het basis schema is erg eenvoudig. Het thema bestaat uit een submap die alle plaatjes bevat en een &XML;-bestand dat aan elk plaatje ASCII-symbolen toekent. Er kan een bestand .directory gebruikt worden.

### Bestand locaties

Bestanden die met deze specificatie te maken hebben een locatie die overeenkomt met de "desktop base directory specification" die u kunt vinden op www.freedesktop.org.

Alle bestanden van het thema moet u plaatsen in een submap van `$XDG_DATA_DIRS`/emoticons/ De naam van de map moet overeenkomen met de naam van het thema. In die map moet een bestand genaamd `emoticons.xml` aanwezig zijn, de indeling van dat bestand volgt hieronder.

In de thema map mag ook een .bestand aanwezig zijn met vertalingen van de thema-naam en/of een pictogram voor dat thema.

### Indeling van het emoticons.xml bestand

Emoticon bestanden moeten correct opgemaakte XML-bestanden zijn. implementaties moeten onbekende tags of onbekende attributen negeren.

#### Elementen

<messaging-emoticon-map> [version="0.1"]

- Het basis-element is <messaging-emoticon-map> alle andere elementen zijn er onderdeel daarvan.

<emoticon file="...">

- Dit element stelt een emoticon voor. Het attribuut file is de naam van het afbeelding-bestand die in dezelfde map moet zijn. De extensie mag u weglaten. In dat geval zal de implementatie in die map zoeken naar een bestand in een ondersteunt formaat met dezelfde naam.

  Er is geen volgorde voor de emoticon in de map. Maar het eerste icoon in de map is meestal gebruikt om het thema grafisch te identificeren. Voor de handigheid ZOU dit zo moeten zijn :-)

<string>

- Dit element mag alleen onder <emoticon> verschijnen. Het stelt de ASCII tekenreeks voor waarvoor in de tekst wordt gezocht, en vervangen door de afbeelding die is opgegeven in het file attribuut van de emoticon.

  Er zijn per emoticon meerdere tekenreeksen toegestaan.

  Er is geen volgorde voor de tekenreeksen in een emoticon. Maar de eerste ZOU de standaard moeten zijn, en zal worden genomen als er een GUI selectie is.

### Afbeeldingstype

Alle afbeeldingen MOETEN in een ondersteunt formaat zijn : PNG, GIF or MNG.

### implementatie opmerkingen

#### Emoticon toevoegen

Er zijn niet echt aanbevelingen voor hoe u emoticons moet toevoegen. Maar een emoticon met een langere tekenreeks moet prioriteit hebben tegenover een met een kortere tekenreeks. (Voorbeeld: als beide :-() en :-( in een thema aanwezig zijn, dan moet de afbeelding voor de eerste worden gebruikt als men :-() tegenkomt)

### Voorbeeld

    <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>