Skinning tutorial/fr: Difference between revisions

From Shareaza Wiki
Jump to navigation Jump to search
Line 98: Line 98:


[http://shareaza.sourceforge.net/?id=skindocs/xml-default Default.xml] et [http://shareaza.sourceforge.net/?id=skindocs/xml-definitions 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 [[Skinning.commandImages/fr|"Commandes & Images"]] devrait être consultée pour connaître la syntaxe exacte afin de remplacer des icônes.
[http://shareaza.sourceforge.net/?id=skindocs/xml-default Default.xml] et [http://shareaza.sourceforge.net/?id=skindocs/xml-definitions 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 [[Skinning.commandImages/fr|"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 ==
== Les éléments d'un thème ==

Revision as of 18:59, 29 April 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 du Skinning

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 [www.pspad.com/fr/‎ 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 :

  • <colourScheme> Spécifies les couleurs du plan. Skinning
  • <watermarks> Ajoute des images filigrane aux parties de l'interface.Skinning
  • <windowSkins> Change radicalement l'aspect des fenêtres. Skinning
  • <commandImages> Change des images affichées sur des barres outils, menus et fenêtres. Skinning.
  • <menus> Définit les menus dans le programme. Skinning
  • <toolbars> Définit les barres outils dans le programme. Skinning
  • <fonts> Change les fontes utilisées dans l'interface. Skinning
  • <documents> Fournit le RichDoc affiché sur l'onglet accueil. Skinning
  • <dialogs> Change le texte affiché dans les dialogues. Traduction
  • <commandTips> Change le texte affiché dans les tooltips et les messages d'aide. Traduction
  • <strings> Change le texte utilisé dans tout autres messages. Traduction
  • <listColumns> Change le texte affiché dans les colonnes. Traduction

Shareaza Remote Skinning

Maintenant que vous connaissez les éléments de skinning de shareaza, faites un essai !

Diffusez vos Skins

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

  • S'assurer que la skin est prête pour le prime time. Tester toutes les fonctions, vérifier qu'il n'y a pas de résultat étrange. Dans la mesure du possible, essayez-la sur un autre ordinateur, un autre OS...
  • 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 à la skin, son type, et toutes autres informations que vous jugez utile.

La meilleure façon de compacter et de distribuer une skin Shareaza est de Zipper tous les fichiers, et de tirer parti de l'installateur de skin de shareaza. Pour cela :

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

Ainsi les fichiers skin de Shareaza sont ouvert et installé au bon endroit par les utilisateurs.

Pour conclure, placez votre skin en partage dans la bibliothèque en ligne des skins de Shareaza, et partagez-la. Le partage des skins sur Shareaza est très important, car il permet à chacun de les télécharger. Après tout, ne sommes-nous pas là pour ça?

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:     ShareazaWiki > Skinning > Skinning tutorial/fr