Skinning tutorial/fr: Difference between revisions

From Shareaza Wiki
Jump to navigation Jump to search
Line 18: Line 18:
= Pour commencer =
= Pour commencer =


Ce guide est divisé en plusieurs parties. La meilleure façon d'apprendre est de passer par l'instruction "[[#Élément|Élément par élément]]" pour faire votre premier thème.
Ce guide est divisé en plusieurs parties. La meilleure façon d'apprendre est de passer par l'instruction "[[#Les éléments d'un thème |Élément par élément]]" pour faire votre premier thème.
* Les thèmes se trouvent dans le dossier : C:\Program Files\Shareaza\Skins (par défaut).
* Les thèmes se trouvent dans le dossier : C:\Program Files\Shareaza\Skins (par défaut).
* Chaque thème à son propre dossier, comme : C:\Program Files\Shareaza\Skins\"Ma Skin".
* Chaque thème à son propre dossier, comme : C:\Program Files\Shareaza\Skins\"Ma Skin".

Revision as of 07:12, 8 May 2014

  Updated:

This page has been updated on 29 avril 2014 for the release of Shareaza v2.7.x.0.

e
  Contenu stable

Les informations de cette page s'appliquent à toutes les versions de Shareaza tant qu'il n'y a pas de modification majeur.

e

Tutoriel de thématisation

Dans ces lignes vous allez apprendre à construire un thème (ou skin) pour la télécommande du média player de Shareaza. Le principe et les commande sont identique pour construire un thème complet pour Shareaza.

Créer des thème pour Shareaza

Créer un thème est facile. Les thèmes peuvent être simple ou complexe, au choix. Cette page fournie un didacticiel simple et des références détaillées pour la construction d'un thème pour Shareaza.

Avec ce guide vous pourrez faire des :

  1. Thèmes visuels - Changer le thème visuel ou le personnaliser les boutons/mise en page de programme.
  2. Thèmes linguistiques - Traduire le texte dans différents langages.

Pour commencer

Ce guide est divisé en plusieurs parties. La meilleure façon d'apprendre est de passer par l'instruction "Élément par élément" pour faire votre premier thème.

  • Les thèmes se trouvent dans le dossier : C:\Program Files\Shareaza\Skins (par défaut).
  • Chaque thème à son propre dossier, comme : C:\Program Files\Shareaza\Skins\"Ma Skin".
  • Chaque dossier contient les fichiers du thème, ainsi que les fichiers support tels que les images ou les icônes.

Chaque thème à son fichier de définition, qui est au format XML. Le format XML est un moyen facile de lire du format texte, ressemblant au HTML. Pour pouvoir écrire des fichier XML, il est fortement conseillé d'utiliser un éditeur XML à coloration syntaxique, tel que Notepad++, EmEditor ou PSPad. Le fichier de définition indique à shareaza, toutes les informations utiles tels que :

  • qui a fait le thème.
  • Quelles sont les parties de l'interface à modifier.
  • Comment le faire.
  • etc...

Petit exemple

Voici un thème très facile, appelez-le MonPetitTheme.xml. :

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<skin xmlns="http://shareaza.sourceforge.net/schemas/Skin.xsd " version="1.0">
<manifest name="MonPetitTheme" author="Moi" type="Skin"/>
<watermarks>
 <watermark target="CCoolMenuBar" path="MyWatermark.bmp"/>
</watermarks>
</skin>
</source>

Ce thème spécifie son nom et son auteur et ajoute une image en filigrane à la barre de menu principale, facile, non ? Un thème c'est juste cela, vous changez ce que vous voulez.


Important : Les deux premières lignes de cet exemple ne doivent pas être éditées, ce sont les lignes qui indiquent la version du noyau du thème et non la version de votre skin.



Astuce : Si vous souhaitez recharger votre thème rapidement, appuyez sur les touches Ctrl Shift Z


Le "Manifest"

L'exemple ci-dessus intègre un "manifest", qui indique le nom du thème. Il est important d'inclure de bonnes méta informations à de votre thème, de façon à ce que les utilisateurs puissent l'identifier et la rechercher.

Ci-dessous, une référence complète pour l'élément <manifest>.

Un manifeste complet comme il devrait l'être tout le temps : Signification des paramètres :
<source lang="xml">
<manifest
name="Mon Petit Thème"
author="Moi"
updatedBy="Lui"
description="Ceci est mon premier thème pour shareaza, 
il intègre une image ne filigrane dans la barre de menu principale"
link="http://une.adresse.internet/"
email="mon.adresse@email.com"
version="1.5"
type="Skin"
dir="ltr"
/>
</source> 
  • name = Le nom du thème.
  • author = La personne qui a créer le thème.
  • updatedBy = Éventuellement si une autre personne que l'auteur fait une mise à jour du thème.
  • description = Une (longue) description (est préférable).
  • link = Optionnel, votre site internet si vous en avez un, sinon l'adresse du site officiel de Shareaza fait l'affaire.
  • email = Optionnel, votre adresse mail, afin de vous contacter pour plus d'informations.
  • version = la version du thème.
  • type = La plupart des thèmes devraient avoir ce tag de rempli, excepté les thèmes de traduction.
  • language = Ne mettre seulement que si le paramètre "type="language"". Il indique le code de langage que la traduction fournit, exemple "en" pour english.
  • dir = La majorité des thèmes peuvent omettre ce paramètre, il est utilisé pour les langues. Les valeurs peuvent être :
    • ltr pour les langues qui s'écrivent de gauche vers la droite.
    • rlt pour les langues qui s'écrivent de droite vers la gauche.

Tous les attributs sont optionnels excepté le nom.


Guide Visuel

Le guide visuel est une collection de capture d'écran et d'autres démonstrations visuelles indiquant quelles sont les parties du thème par défaut correspondent aux ID (identifiants).

Default.xml et Definitions.xml présentent la liste des icônes par défaut de Shareaza ainsi que leurs identifiants correspondants afin d'aider à déterminer comment modifier certaines icônes. La documentation "Commandes & Images" devrait être consultée pour connaître la syntaxe exacte afin de remplacer des icônes.

Les éléments d'un thème

Cette section liste tous les éléments que l'on peut inclure dans un thème avec des liens pour plus de détails.

Description des éléments utiliser :

Élément Description Utiliser pour la
<colourScheme> Indique le schéma de couleurs de l'interface utilisateur utilisé dans le programme. Thématisation
<watermarks> Ajoute des images en filigrane à des parties de l'interface. Thématisation
<windowSkins> Change radicalement l'apparence des fenêtres. Thématisation
<commandImages> Change les images affichées sur les barres d'outils, les menus et les fenêtres. Thématisation
<menus> Définit les menus du programme. Thématisation
<toolbars> Définit les barres d'outils du programme. Thématisation
<fonts> Change la police d'écriture utilisée dans l'interface. Thématisation
<documents> Fourni RichDoc affiché sur l'accueil. Thématisation
<tipMap> ControlTip map, pour les infobulles. Traduction
<controlTips> Modifie le texte affiché dans les infobulles pour différentes boîtes de dialogue. Traduction
<dialogs> Modifie le texte affiché dans les boîtes de dialogue. Traduction
<commandTips> Modifie le texte affiché dans les infobulles et les messages de commande d'aide. Traduction
<strings> Modifie le texte utilisé dans tous les autres messages. Traduction
<listColumns> Modifie le texte affiché dans la liste des vues. Traduction

Compatibilité RTL (de droite à gauche)

Alors que les gens du monde entier peuvent profiter de votre thème, vous devriez vous assurer qu'il est (de droite à gauche) compatible RTL. C'est pour les langues qui s'écrivent et se lisent de la droite vers la gauche comme l'hébreu et l'arabe.

Thématisation de la télécommande de Shareaza

Maintenant que vous avez abordé les éléments de la thématisation de shareaza, faites un essai !


Diffusez vos thèmes

Vous venez de créer une skin toute fraîche, mais cela n'apportera rien de la garder pour vous, vrai ? Diffuser un thème Shareaza est très facile, mais quelques points sont à mentionner.

  • S'assurer que le thème est prête pour le prime-time. Testez toutes les fonctions, vérifiez qu'il n'y a pas de résultat étrange. Dans la mesure du possible, essayez-la sur un autre ordinateur...
  • S'assurer que tout est soigné et aussi petit que possible. Si vous avez créé des images, convertissez les en bitmaps 8 bits, 256 couleurs.
  • Contrôler le manifeste. Il doit fournir un nom précis du thème, son type, et toutes autres informations que vous jugez utile.

La meilleure façon de compacter et de distribuer un thème Shareaza est de zipper tous les fichiers et de tirer parti de l'installateur de thème de shareaza. Pour cela :

  • Compacter le dossier skin au format "ZIP".
  • Renommer l'extension de fichier ("*.Zip") en *.SKS.

De cette façon les fichiers thème de Shareaza seront ouvert et installé au bon endroit par les utilisateurs.

Pour conclure, placez votre thème en partage sur le forum officiel de Shareaza, et partagez-la. Le partage des thèmes sur Shareaza est très important, car il permet à chacun de les télécharger. Après tout, ne sommes-nous pas là partager ?

Obtenir de l'aide

Vous avez besoin d'aide. Vous voulez discuter de votre création, signaler sa "sortie". Si oui, faites un tour sur le forum.



Navigation:     Page d'accueil > Skinning tutorial/fr