[ Index des éléments ] - [ Manifest ] - [ Compatible droite à gauche (RTL) ] - [ Thèmes télécommande ] - [ Distribuer les thèmes ]

Créer des thèmes pour Shareaza

C'est très facile de créer un thème. Vous pouvez les faire complexes ou simples. Ces pages constituent un tutoriel et une référence pour les thèmes de Shareaza. Avec ce tutoriel, vous apprendrez comment les créer :

• Les thèmes visuels - Change le thème visuel et/ou personnalise les boutons ou l'apparence du logiciel.
• Thèmes de langue - Traduit les entrées textuelles.

Une bonne façon d'apprendre les thèmes est de considérer chaque élément systématiquement et construire votre propre thème !

• Les thèmes sont stockés dans le dossier C:\Program Files\Shareaza\Skins.
• Chaque thème a son propre dossier, comme C:\Program Files\Shareaza\Skins\MySkin.
• Chaque dossier contient le fichier thème xml principal, et les fichiers images ou icônes.

Chaque thème a un fichier de définitions, au format XML. XML est, comme le HTML, facile à lire et à écrire. C'est une bonne idée d'utiliser un traitement de texte avec le surlignage de la syntaxe XML. Par exemple, Notepad++ ou EmEditor. Le fichier xml d'un thème comprends des entrées pour qui a créé le thème, quelles composantes seront changées de leur valeur par défaut, et en quoi elles seront modifiées.

Voici un thème très simple, MySimpleSkin.xml:

<?xml version="1.0" encoding="UTF-8"?> <skin xmlns="http://www.shareaza.com/schemas/Skin.xsd" version="1.0"> <manifest name="My Simple Skin" author="Me" type="Skin"/> <watermarks> <watermark target="CCoolMenuBar" path="MyWatermark.bmp"/> </watermarks> </skin>

Ce thème nous dit son nom et auteur, et ajoute une image filigrane au main menu bar. Très simple ! Les thèmes sont comme ça : on peut changer ce qu'on veut : beaucoup, ou juste un peu.

Note : Les deux premières lignes ne doivent pas être modifiées. Les tag xmlns et version sont importants. Version et la version du Skinning Core de Shareaza ga; ce n'est pas la version de votre skin.

L'exemple inclus un élément <manifest>, qui donne le nom du thème. Il est important d'inclure les informations additionnelles (méta) pour que les autres utilisateurs puissent identifier votre thème parmi tous les autres qui circulent. Voici un sommaire des items dans l'élément <manifest> :

<manifest name="Le nom du thème" author="La personne ou l'organisation qui l'avait créé" updatedBy="La personne qui l'avait actualisé" description="Une description plus détaillée" link="Un url (ressource internet) pour le skin" email="L'adresse e-mail de l'auteur" version="1.5" type="Skin" dir="ltr" />

Tous ces attributs, sauf name sont optionnels:

• name - Le nom du thème.
• author - La personne qui a créé le thème
• updatedBy - Celui qui l'avait mis à jour ou amélioré.
• description - Un description plus détaillée.
• link - Un URL optionnel pour avoir plus d'informations.
• email - Une adresse e-mail.
• version - La nombre du révision du thème.
• type - La plupart des thèmes seront du type "skin". Mais les traductions seront du type "language" .
• language - Ajoutez ceci seulement si le type du thème et "language" . Il dit en quelle langue la traduction est écrite.
• dir - La plupart des thèmes peuvent omettre l'information de direction de texte. Les valeurs sont "rtl", pour les langues qui s'écrivent de droite-à-gauche, et "rtl" pour ceux qui s'écrivent de la gauche vers la droite.

Le guide visuel est une collection de captures d'écrans et d'autres éléments visuels montrant la correspondance entre les parties du thème par défaut et les ID associés.

Default.xml et Definitions.xml montrent une liste des icônes par défaut de Shareaza et leurs ID correspondants pour faciliter la modification d'une icône donnée. La documentation sur commandImages doit être consultée pour la syntaxe exacte à utiliser pour remplacer les icônes.

Ici sont listés tous les différents éléments qui peuvent être inclus dans un thème. Suivre les liens pour des descriptions détaillées.

Élément	Description	Utilisé pour
<colourScheme>	Spécifier le schéma de couleurs utilisé dans Shareaza.	Thèmes
<watermarks>	Ajouter une image watermark (filigrane) à certaines parties de l'interface.	Thèmes
<windowSkins>	Changer la forme des fenêtres.	Thèmes
<commandImages>	Changer les images dans les toolbars, menus et fenêtres.	Thèmes
<menus>	Définir les menus.	Thèmes
<toolbars>	Définir les toolbars	Thèmes
<fonts>	Changer les fonts (polices).	Thèmes
<documents>	Fournit le RichDoc affiché sur l'onglet Accueil	Thèmes
<tipMap>	ControlTip map, pour les infobulles.	Traduction
<controlTips>	Changer le texte affiché dans les tooltips (infobulles) des dialogues	Traduction
<dialogs>	Changer le texte affiché dans les dialogues	Traduction
<commandTips>	Changer la texte affiché dans les tooltips (infobulles) et les messages d'aide des commandes.	Traduction
<strings>	Changer le texte affiché dans tous les autres messages	Traduction
<listColumns>	Changer le texte affiché dans les lists (listes)	Traduction

Pour que votre skin soit employé par des gens autour du monde prenez du temps pour assurer qu'il est compatible RTL (droit-à-gauche), comme l'arabe et hébreu.

Une fois que vous avez compris les éléments skins, essayez de faire un thème télécommande !

Après avoir créé un skin chic, pourquoi le garder pour vous-même ? C'est facile de diffuser vos skins avec Shareaza, mais prenez note de ces astuces.

• Soyez certain que votre skin est prêt.
  Tester votre skin pour voir qu'il n'y a pas des résultats bizarres. Validez que le xml soit bien formé. Par exemple, Mozilla Firefox peut montrer q'un fichier xml est bien formé (mais pas valider contre le schéma). Si possible, testez votre thème sur des autres ordinateurs et OS supportés par Shareaza (Windows XP, Vista).
  
  
• Soyez certain que tout et bien nettoyé.
  Si vous avez créé des images bmp, soyez certain qu'ils sont des 8-bit, 256 couleurs bitmaps.
  
  
• Est-ce que l'élément manifest est correct ?
  Donner un nom pour le thème, son type, et toutes les autres informations que vous jugez utiles.

Pour distribuer un thème, ZIPPEZ tout les fichiers pour créer un fichier sks. Le logiciel d'installation skin inclus avec Shareaza peut donc installer le thème.

Pour faire ceci :

• ZIPPEZ le dossier de votre thème.
• Renommer votre .ZIP en .SKS.

Le logiciel skin.exe, inclus avec Shareaza, va installer le thème dans le répertoire skins, quand un utilisateur ouvre un fichier .sks.

Shareaza skin library - Finally, be sure to submit your skin here, and share it on Shareaza! Sharing skins on Shareaza is very important, as it will allow everyone to download them faster. After all, that's what we're about!

Need help with skinning? Want to talk to others about it, or make an announcement about your new skin? If so, visit the: Skinning Forum