# Specifikation av smilisar

Version 0.1
2005-01-07
Olivier
Goffart

     ogoffart@tiscalinet.be

# Smilisar

## Inledning

Detta DOKUMENTUTKAST definierar hur ett tema med smilisar som typiskt används i program för direktmeddelanden kan skapas.

Grundmetoden är mycket enkel. Temat består av en underkatalog, som innehåller alla bilderna, och en &XML;-fil som ger ASCII-symbolen för varje bild. En .directory-fil kan användas.

### Filplatser

Filer som ingår i specifikationen är placerade enligt "desktop base directory specification" som finns på www.freedesktop.org.

Alla filer i temat måste placeras i en underkatalog till `$XDG_DATA_DIRS`/emoticons/. Katalogens namn måste vara lika med temats namn. Katalogen måste innehålla en fil som heter `emoticons.xml`. Filens format beskrivs nedan.

Temakatalogen kan också innehålla filen .directory, som innehåller översättningar av temanamnet och/eller en ikon för temat.

### Format på filen emoticons.xml

Avbildningsfiler för smilisar måste vara välformade XML-filer. Implementeringar ska ignorera okända taggar eller okända attribut.

#### Element

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

  Rotelementet är <messaging-emoticon-map>, alla andra element ingår i det.

<emoticon file="...">

  Detta element representerar en smilis. Egenskapen file är namnet på bildfilen som måste finnas i samma katalog. Filändelsen kan utelämnas. I detta fall letar implementeringen i katalogen efter en fil med samma namn och med ett format som stöds.

  Det finns ingen ordning på smilisarna i avbildningen, men den första ikonen i avbildningen används i allmänhet för att identifiera temat grafiskt. Enligt konvention MÅSTE den vara :-).

<string>

  Elementet kan bara finnas under <emoticon>. Det representerar ASCII-strängen som matchas i texten, och ersätts av bilden som anges av egenskapen file för smilisen.

  Det kan finnas flera strängar per smilis.

  Det finns igen ordning av strängarna inne i en smilis, men den första MÅSTE vara det förvalda värdet, och används om det finns en väljare i det grafiska användargränssnittet.

### Bildens format.

Alla bilder MÅSTE ha ett format som stöds: PNG, GIF eller MNG.

### Implementeringsanmärkningar

#### Smilistolk

Det finns inte någon verklig rekommendation om hur smilisar tolkas, men en smilis med en längre sträng ska ges prioritet över en med en kortare sträng (exempelvis om både :-() och :-( finns i ett tema, ska bilden för den första användas när :-() hittas).

### Exempel

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