Tutoriel sur les Thèmes

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

Commencer ici

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'Élément manifest

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.

Guide Visuel

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.

Les éléments thème

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 ajouter la compatibilité RTL (droite-à-gauche)...

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.

Thèmes pour la remote (télécommande) de Shareaza

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


Diffuser vos nouveaux Skins

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.

Pour que les autres utilisateurs aient connaissance de votre thème, soumettez-le au logithèque des skins, et partagez aussi votre thème dans Shareaza !

Aide

Avez-vous besoin d'aide avec votre thème ? Voulez-vous faire une annonce de votre nouveau thème ? Visitez le Skinning Forum.


  • en
  • es
  • fr
  • de
  • hr
  • it
  • lt
  • nl
  • nb
  • pl
  • pt
  • sl
  • tr
  • el
  • he
  • ja
  • zh-tw
  • en
  • ca
  • fa
  • ru
Beaucoup de personnes aident Shareaza de leur temps et leurs efforts. Merci de voir notre page de remerciements.
Visitez la page du projet Shareaza sur SourceForge.net

Logo de SourceForge.net
< Haut de la page | Contactez-nous >