wxChecksums Shell Extension for Microsoft Windows > Manuel

Manuel de wxChecksums Shell Extension for Microsoft Windows 1.1.1

Ce programme est libre, vous pouvez le redistribuer et/ou le modifier selon les termes de la Licence Publique Générale GNU publiée par la Free Software Foundation (version 2 ou bien toute autre version ultérieure choisie par vous).

Ce programme est distribué car potentiellement utile, mais SANS AUCUNE GARANTIE, ni explicite ni implicite, y compris les garanties de commercialisation ou d'adaptation dans un but spécifique. Reportez-vous à la Licence Publique Générale GNU pour plus de détails.

Vous devez avoir reçu une copie de la Licence Publique Générale GNU en même temps que ce programme ; si ce n'est pas le cas, écrivez à la Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, États-Unis.

Introduction

wxChecksums Shell Extension for Microsoft Windows est une extension pour l'explorateur de Windows. Cette extension vous permet de gérer des fichiers de sommes de contrôle directement depuis l'explorateur. Si vous ne savez pas ce qu'est wxChecksums, veuillez vous reporter au site web de wxChecksums avant de poursuivre la lecture de ce manuel.

Note : L'expression fichier de sommes désignera fichier de sommes de contrôle.

Retour au sommaire.

Installation

Configuration requise

wxChecksums Shell Extension for Microsoft Windows 1.1.1 a besoin que wxChecksums 1.1.1 (ou supérieur) soit installé.

wxChecksums Shell Extension for Microsoft Windows a besoin de Windows NT avec Internet Explorer 5 (ou plus) ou Windows 2000/XP.

Une version qui devrait fonctionner avec Windows 98 (peut être 95 aussi ?) avec Internet Explorer 5 (ou plus) et Windows 98SE/ME est fournie mais vous devez l'installer manuellement. Je n'ai pas accès à une station de travail sous Windows 9x/ME je ne peux donc pas garantir que ça fonctionne vraiment. :(

Installation avec le programme d'installation

Le programme d'installation peut être utilisé uniquement avec Windows NT 4.0 (vérifiez bien que Internet Explorer 5 (ou plus) est installé) et Windows 2000/XP. Vous devez posséder les droits d'administration de la machine pour pouvoir lancer le programme d'installation. A la fin de l'installation, le programme d'installation peut vous demander de relancer votre machine.

N'installez pas cette extension dans le même répertoire que wxChecksums. Un bon emplacement pour l'installer est un sous-répertoire de celui où wxChecksums est installé. Par exemple, le programme d'installation de wxChecksums installe par défaut wxChecksums dans le répertoire C:\Program Files\wxChecksums et le programme d'installation de cette extension l'installe par défaut dans le répertoire C:\Program Files\wxChecksums\ShellExt.

Si vous mettez à jour l'extension et si vous avez modifié le fichier de configuration global (wxcksumsshellex.ini), faites une copie de celui-ci avant de lancer l'installation. Le fichier existant sera écrasé.

Installation depuis une archive ZIP

Notez que cette méthode est destinée aux utilisateurs avancés.

L'archive ZIP contient deux versions de l'extension :

Une version Ansi qui devrait fonctionner avec toutes les versions de Windows qui satisfont aux conditions requises énoncées dans la section Configuration requise ci-dessus.
Une version Unicode qui fonctionne seulement avec Windows NT avec Internet Explorer 5 (ou plus) ou Windows 2000/XP.

Pour installer l'extension, suivez les étapes suivantes :

Si une précédente version de l'extension est installée, désinstallez-la d'abord.
Créez un répertoire où les fichiers de l'extensions seront placés, par exemple C:\Program Files\wxChecksums\ShellExt.
Copiez les fichiers wxcksumsshellex.dll et wxcksumsshellex.ini depuis le répertoire Ansi ou Unicode (selon la version qui vous convient) dans le répertoire créé dans l'étape 2.
Ouvrez une invite de commande (DOS).
Allez dans le répertoire créé dans l'étape 2 :
cd "C:\Program Files\wxChecksums\ShellExt"
Enregistrez l'extension auprès de Windows :
regsvr32 wxcksumsshellex.dll
L'extension est maintenant installée.

Installation en compilant les sources

Cette méthode est destinée aux programmeurs, l'archive contenant les sources contient des indications sur la manière de compiler wxChecksums Shell Extension for Microsoft Windows. Suivez les instructions données dans la section Installation depuis une archive ZIP pour terminer l'installation.

Retour au sommaire.

Désinstallation

Désinstallation avec le programme de désinstallation

Si vous avez utilisé le programme d'installation, utilisez le programme de désinstallation pour désinstaller wxChecksums Shell Extension for Microsoft Windows. Vous aurez sûrement à relancer votre machine pour terminer la désinstallation.

Il est préférable de désinstaller wxChecksums Shell Extension for Microsoft Windows avant wxChecksums.

Désinstallation manuelle

Si vous avez installé wxChecksums Shell Extension for Microsoft Windows manuellement, voici les étapes à suivre pour la désinstallation :

Ouvrez une invite de commandes (DOS).
Placez-vous dans le répertoire où ont été installés les fichiers de l'extension :
cd "C:\Program Files\wxChecksums\ShellExt"
Supprimez l'enregistrement auprès de Windows de l'extension :
regsvr32 /u wxcksumsshellex.dll
Relancez votre ordinateur pour vous assurer que l'explorateur n'utilise plus l'extension.
Supprimez les fichiers de l'extension.
L'extension est maintenant désinstallée.

Problèmes connus

Lors de la désinstallation de l'extension, sur Windows NT or supérieur l'entrée dans la base de registre :
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Shell Extensions\Approved\{4651C3B8-1503-4edc-8C9A-D0D8DA796737} (avec comme valeur wxChecksums Shell Extension) n'est pas supprimée. Vous devez la supprimer manuellement mais si vous n'êtes pas sûr de ce que vous faites ou si vous ne savez pas comment faire, laisser cette entrée ne causera aucun dommage à votre système.

Retour au sommaire.

Utilisation

Sélectionnez un ou plusieurs fichier/répertoire/lecteur dans l'explorateur et ouvrez le menu contextuel. Une entrée wxChecksums devrait être affichée :

L'entrée Ajouter à... vous permet d'ajouter les fichiers sélectionnés à un fichier de sommes. Si le fichier de sommes n'existe pas, il est créé.

L'entrée Créer un fichier de sommes... vous permet de créer un fichier de sommes et de lui ajouter les fichiers sélectionnés. Si le fichier de sommes existe déjà, il est écrasé (sans aucun message d'avertissement). Préférez en général les entrées Ajouter.

L'extension fournit aussi d'autres entrées pour ajouter à ou créer rapidement un fichier de sommes. Le nom du fichier de sommes est généré en remplaçant l'extension du fichier sur lequel vous avez cliqué quand vous avez ouvert le menu contextuel.

Retour au sommaire.

Fichiers de configuration

L'extension utilise deux fichiers de configuration :

wxcksumsshellex.ini est le fichier de configuration global de l'extension. Il est placé dans le même répertoire que l'extension elle-même.
wxChecksumsShellExt.ini est le fichier de configuration de l'utilisateur. Il est placé dans le répertoire %APPDATA%\wxChecksums.

Fichier de configuration global

wxcksumsshellex.ini contient tous les paramètres globaux et les traductions de l'interface utilisateur. Ce fichier est encodé en UTF-8, soyez sûr d'utiliser un éditeur de texte capable d'éditer des fichiers textes encodés en UTF-8.

Section wxChecksums

Clé	Type	Valeur par défaut	Description
`Path`	string		Chemin où l'exécutable de wxChecksums executable peut être trouvé. Utilisez ce paramètre si l'extension n'arrive pas à trouver l'exécutable de wxChecksums toute seule.
`Command`	string	`wxChecksums.exe`	Nom du fichier exécutable de wxChecksums.
`AppendSwitch`	string	`-a`	Commutateur utilisé par wxChecksums pour ajouter des fichiers à un fichier de sommes.
`CreateSwitch`	string	`-c`	Commutateur utilisé par wxChecksums pour créer un fichier de sommes.
`DeleteTempListSwitch`	string	`--delete-temp-list`	Commutateur pour indiquer à wxChecksums d'effacer les listes de fichiers temporaires que l'extension lui fournit.
`CreateTypeSwitch`	string	`-ct`	Commutateur utilisé pour indiquer à wxChecksums quel type de fichier de sommes il doit créer.
`FilesListSwitch`	string	`-fl`	Commutateur utilisé pour donner à wxChecksums une liste de fichiers.
`CfgDir`	string	`wxChecksums`	Répertoire relatif à `%APPDATA%` où le fichier de configuration de wxChecksums est stocké.
`CfgFile`	string	`wxChecksums.ini`	Nom du fichier de configuration de wxChecksums.

Section wxChecksumsShellExt

Key	Type	Default value	Description
`UserCfgFile`	string	`wxChecksumsShellExt.ini`	Nom du fichier de configuration de l'utilisateur utilisé par l'extension.

Section Language aliases

Cette section est utilisée pour convertir les identifiants de langue de wxChecksums vers des identifiants de langue de wxChecksums Shell Extension for Microsoft Windows.

wxChecksums Shell Extension for Microsoft Windows utilise les identifiants de langue de Microsoft Windows. La liste de ces identifiants peut être trouvée à la page Table of Language Identifiers du site web de MSDN.

Utilisez la forme suivante pour créer une association :
<wxId>=<wxSEId>

Exemple :
fr=0x040c

Section Windows language aliases

Cette section est utilisée pour indiquer à l'extension d'utiliser un langage à la place d'un autre. Par exemple la ligne suivante :
0x080c=0x040c

Indique à l'extension d'utiliser la langue French (Standard) quand la langue de l'utilisateur est French (Belgian).

Sections des traductions

Les sections de traductions sont identifiées par le code du langage dans sa forme hexadécimale. Par exemple : 0x040c pour le français.

Si vous faites une nouvelle traduction, assurez-vous de laisser les séquences %s dans la chaîne traduite. %s sera utilisée pour afficher une information (un nom de fichier par exemple).

Fichier de configuration de l'utilisateur

Section	Clé	Type	Description
`SaveDialog`	`LastTypeUsed`	int	Dernier type de fichier de sommes choisi par l'utilisateur. 0 = SFV, 1 = MD5.
`Language`	`Id`	string	Identifiant de la langue à utiliser. Exemple : `0x04c` pour du français.

Retour au sommaire.

Foire aux questions (FAQ)

Q.	Comment l'extension choisit la langue à utiliser ?
A.	L'extension cherche l'entrée `Id` dans la section `Language` du fichier de configuration de l'utilisateur. Si une langue est trouvée, elle est utilisée. L'extension cherche dans le fichier de configuration de wxChecksums. Si une langue connue est trouvée, elle est utilisée. L'extension récupère la langue utilisée par Windows. Si une traduction est disponible, elle est utilisée. L'extension utilise l'anglais (par défaut).

Q.	L'extension fonctionne quand je sélectionne quelques fichiers, mais quand j'en sélectionne beaucoup, rien ne se passe. Pourquoi ?
A.	Quand vous sélectionnez beaucoup de fichiers, l'extension ne peut pas transmettre tous les fichiers à wxChecksums par la ligne de commande. L'extension crée une liste temporaire de fichiers dans le répertoire temporaire donné par Windows. Si rien ne se passe, il peut y avoir deux raisons : Le répertoire temporaire indiqué par les variables d'environnement `TMP` ou `TEMP` n'existe pas. Notez que ces variables d'environnement sont créées par le programme d'installation de Windows. Il n'y a pas assez d'espace sur le disque où se trouve le répertoire temporaire, ou vous n'avez pas les droits suffisants pour écrire dedans.

Retour au sommaire.

Licence

wxChecksums Shell Extension for Microsoft Windows est publié sous la GNU GENERAL PUBLIC LICENSE.
Consultez les fichiers LICENSE.txt et gpl.txt pour plus de détails.

Retour au sommaire.

Auteur

Julien Couot <jcouot@users.sourceforge.net>

Retour au sommaire.

Liens

http://wxchecksums.sourceforge.net/ShellExtForWindows/
- Site officiel de wxChecksums Shell Extension for Microsoft Windows.

http://wxchecksums.sourceforge.net/
- Site officiel de wxChecksums.

http://www.jrsoftware.org/
- Inno Setup homepage.

http://www.gnu.org/
- Site officiel du projet GNU.

Retour au sommaire.