C.A.F.E._README

C.A.F.E.

I - Association de fichiers :
Tant que C.A.F.E. est actif, il vous permet d'ouvrir vos documents avec les logiciels Portables (transportables) présents sur votre clef USB, sans toucher aux associations de fichiers du PC.
Ajouter ou modifier une association se fait d'un simple "Win+Clic Gauche" sur un fichier. Le logiciel vous demandera alors avec quel programme vous souhaitez ouvrir les fichiers de ce type. Ces associations seront utilisées lorsque vous ferez un double-clic sur un fichier ou en tapant le touche "Entrée" pour ouvrir un fichier déjà sélectionné.
De plus, vous pouvez définir des associations alternatives en utilisant la combinaison "Alt+Win+Clic Gauche" sur un fichier.
Lorsque C.AF.E. définit une association, il l'enregistre dans son fichier de configuration. Le chemin vers le logiciel y est écrit sous forme de chemin relatif.
Les associations de fichiers avec C.A.F.E. sont donc parfaitement discrètes et nomades.
- double clic gauche ( DCG ) ou Entrée => ouverture du fichier avec l'application principale
- Alt + DCG ou Alt + Entrée => ouverture du fichier avec l'application secondaire
- Win + DCG => pour associer le type de fichier avec son application principale
- Alt + Win + DCG => pour associer le type de fichier avec son application secondaire
II - Le menu contextuel :
Certains logiciels s'utilisent principalement au travers du menu contextuel de Windows. Pour ne pas perdre le simplicité d'utilisation de ces logiciels lorsqu'ils sont utilisés en version Portable, C.A.F.E. vous permet de transporter votre propre menu contextuel.
L'affichage du menu se fait par un "double clic droit", un "clic milieu/molette" ou par la combinaison de la touche Win et du Clic Droit.
Ce menu contextuel est enregistré dans des fichiers ini dans le dossier de C.A.F.E.
Le menu contextuel de C.A.F.E. est donc parfaitement discret et nomade.
- double clic droit ( DCD ), Win + DCD ou clic milieu (sur la molette) => ouverture du menu contextuel de C.A.F.E.
Pour la configuration du menu reportez vous au chapitre V :"Les fichiers de configuration" sous chapitre 2 :"Exemple de fichier de configuration pour le menu".
III - Les raccourcis clavier :
C.A.F.E. gère deux types de raccourcis clavier; ceux qui lui sont propres permettant un accès rapide à certaines de ses fonctions, et ceux que l'utilisateur peut créer.

1 - Les raccourcis clavier propre à C.A.F.E. :

i - Raccourcis clavier par défaut :

- Win + R => relance de C.A.F.E.
- Win + P => mise en pause de C.A.F.E.
- Win + M => configuration du double clic gauche
- Win + X => affichage de la fenêtre de configuration des extensions
- Win + A => affichage de la fenêtre de configuration des applications liées
- Esc + C => fermeture de C.A.F.E. (Esc = Echape ou Escape)
- Alt + Win + F => met en pause les associations de fichiers
- Alt + Win + M => met en pause le menu contextuel
- Alt + Win + H => met en pause les raccourcis claviers créés par l'utilisateur
Tous ces raccourcis claviers sont configurables avec des clés dans le fichier cafe.ini.

ii - Modifier les raccourcis clavier par défaut :

Pour modifier les raccourcis clavier par défaut, il faut utiliser dans le fichier cafe.ini, section "configuration".

Les clés sont :
- HK_Pause => raccourcis pour mettre ne pause CAFE
- HK_Reload => raccourcis pour relancer CAFE
- HK_MouseCong => raccourcis pour ouvrir la fenêtre de configuration du clic
- HK_AssoConf => raccourcis pour ouvrir la fenêtre de configuration des associations fichiers
- HK_AppsConf => raccourcis pour ouvrir la fenêtre de configuration des applications liées
- HK_FS_Pause => raccourcis pour mettre en pause les associations de fichiers
- HK_Menu_Pause => raccourcis pour mettre en pause le menu contextuel
- HK_HotKey_Pause => raccourcis pour mettre en pause les raccourcis clavier

Ces raccourcis clavier se configurent/s'écrivent de la même manière que les raccourcis claviers propres à l'utilisateur.

2 - Créer ses propres raccourcis clavier :

i – Principes :

Il est possible de créer ses propres raccourcis clavier ; pour cela il faut utiliser la section "HOTKEY".
Vous pouvez utiliser les touches Alt, Ctrl, Shift, AltGr et Win, plus toutes les lettres non accentuées et les touches F1 à F12.
Par exemple pour ouvrir le terminal avec la combinaison des touches Ctrl, Alt et T il suffit d'écrire

Ctrl+Alt+T=C:\WINDOWS\cmd.exe

Les chemins peuvent être absolus, ou relatifs par rapport au dossier de cafe.exe, voir le chapitre VI: "Explication sur les chemins relatifs utilisables avec C.A.F.E.".
Vous pouvez aussi seulement indiquer le nom de l'excutable si celui ci est dans le PATH, ce qui donne:

Ctrl+Alt+T=cmd.exe

Si vous souhaitez ouvrir un dossier, il suffit d'utiliser son chemin relatif ou absolu comme valeur.
Par exemple pour ouvrir la racine de la clé, sur une Framakey standard, dans laquelle la chemin de cafe.exe est "X:\Apps\PortableFramakeyApps\cafe\cafe.exe" avec la combinaison Win et R:

Win+R=..\..\..\

Si vous utilisez un raccourcis clavier qui est déjà utilisé par CA.F.E. c'est le votre qui sera prioritaire.

ii – Limitations :

Pour le moment il n'est pas possible de passer un argument à une application ou d'ouvrir un fichier avec l'application par défaut.
IV - Les commandes :
- /exit => pour fermer C.A.F.E.
- /appsconf => affiche la fenêtre de configuration des applications liées
- /extsconf => affiche la fenêtre de configuration des extensions
- /mouseconf => affiche la fenêtre de configuration du double clic gauche
- /pause => pour démarer en pause
V - Les fichiers de configuration :

1 - Le fichier principal "cafe.ini" :

Le fichier principal de configuration de C.A.F.E. est un fichier ini qui contient les sections suivantes :
[configuration]
auto= <= 1 pour associer automatiquement les nouvelles extensions
doubleclic= <= ic la vitesse du double clic (gauche et droit).
langue=lng\fr.lng <= le chemin vers le fichier de langue
fenetresAdditionnelles= <= ajoutez ici les noms des fenêtres séparées d'une virgule, sur lesquelles vous souhaitez que les associations de fichiers de C.A.F.E. soient actives. Vous pouvez utiliser le nom des fenêtres ou bien la classe de la fenêtre précedée de "ahk_class ". Par exemple pour la fenêtre du filemanager de 7-zip, la classe de celui-ci est FM ce qui donne : ahk_class FM.
appspath= <= chemin relatif vers le dossier des applications de votre clé. Il sert à ouvrir la fenêtre de sélection des applications directement dans le dossier qui les contient sur votre clé.
[TRAY]
file-1= <= cette section contient la liste des fichiers de configuration pour le menu contextuel de C.A.F.E. Vous pouvez ajouter des entrées dans ce menu entre "Préferences" et "Relancer C.A.F.E. (Win+R)".
[CONTEXT]
file-1= <= cette section contient la liste des fichiers de configuration pour le menu contextuel s'affichant sur des fichiers ou des dossiers
[CONTEXT2]
file-1= <= cette section contient la liste des fichiers de configuration pour le menu contextuel s'affichant ailleurs que sur des fichiers ou des dossiers
[GROUP] <= cette section contient la liste de vos groupes de fenêtres. Vous les utiliserez pour les raccourcis clavier. La clé est le nom du groupe, la valeur la liste des fenêtres appartenant à ce groupe. Ces listes sont comme celle de la clé "fenetresAdditionnelles" de la section "configuration", voir plus haut. Exemple : MyGroup=ahk_class ExploreWClass,ahk_class Progman,ahk_class CabinetWClass. Ceci permet de créer des raccourcis clavier qui ne sont actifs que sur ceiratines fenêtres.
[HOTKEY] <= cette section contient les raccourcis clavier. La clé est la valeur du raccourcis clavier, la valeur de la clé l'action à effectuer à l'appel du raccourcis. L'action peut être suivie d'un nom de fenêtre, de sa classe précedée de "ahk_class " ou d'un nom de groupe de fenêtres précedé de "ahk_group ". L'action et le nom de fenêtre sont séparés par un ~. Si vous indiquez un nom de fenêtre, sa classe ou le nom d'un groupe de fenêtre, le raccourcis clavier ne sera actif que sur cette fenêtre ou ce groupe de fenêtres.
[associations] <= cette section contient les associations principales
[alternative] <= cette section contient les associations alternatives

il ne faut pas éditer ces deux dernières sections à moins que vous sachiez ce que vous faites.

2 - Fichier de configuration pour le menu :

i - Description du fichier :

Le fichier de configuration du menu contextuel est un fichier ini qui contient quatres sections: GENERAL, TRAY, CONTEXT et CONTEXT2.
- GENERAL: sert exclusivement pour la clé url. Celle-ci permet d'affecter une valeur à la varable $URL. Sa valeur est un chemin relatif par rapport à l'emplacement de cafe.exe, elle peut être utilisée pour écrire les chemins dans le reste du fichier ini. Sa valeur n'est valable que pour le fichier courant.
- TRAY: cette section permet d'ajouter des entrées dans le menu de la zone de notification (system tray) qui apparait lors d'un clic sur l'icône de C.A.F.E. en bas à droit.
- CONTEXT: permet d'ajouter des entrées au menu contextuel de C.A.F.E. qui apparait sur les fichiers et les dossiers.
- CONTEXT2: permet d'ajouter des entrées au menu contextuel qui apparait dans les zones vides de l'explorer ou du Bureau.

ii - Utilisation du fichier :

Chaque entrée du menu possède un index dans le fichier de configuration qui est caractérisé par un "-" suivi de l'index à la fin du nom du type de la clé.
Ces types de clé sont au nombre de 6 : "type", "name", "app", "cmd", "filetype" et "hide".
Ils servent respectivement à indiquer le type d'entrée, le nom de l'entrée, le chemin vers une application, une suite d'arguments à passer à l'application, les types de fichiers sur lesquels est active l'entrée et la possibilité de lancer l'application en mode caché.
Il existe trois types d'entrées dans un menu :
- un séparateur
- un sous menu
- une entrée qui exécutera une action, lancer un logiciel par exemple

a – Séparateur :

Un séparateur ne nécessite que la clé "type" avec la valeur separator. Il n'est pas possible de créer un séparateur avec un texte.

b – Séparateur :

Deux clés sont nécessaires "type" avec la valeur submenu et "name" avec le nom que l'on souhaite donner au sous menu.
Ce nom sera utilisé pour créer une nouvelle section qui contiendra les clés pour les entrées de ce sous menu.

c – Entrée :

Cette fois on utilise au moins 5 des six clés. La clé "type" prendra la valeur menu, avec "name" donner un nom, une description à votre entrée, "app" servira à indiquer le chemin relatif ou absolu vers l'application à lancer, "cmd" permet de passer un argument à l'application, "filetype" vous permettra de ne rendre active l'entrée que sur certains types de fichier et "hide" servira à lancer l'application en mode caché, par exemple pour cacher une fenêtre de terminal si l'application s'utilise uniquement en ligne de commande.
Cette dernière clé pourra être remplacée par l'ajout de "*hide*" à la fin des arguments à passer à l'application.

d - La clé filetype : listes des extensions :

Il faut mettre les extensions des types de fichiers sans le point, séparées par un "|", par exemple: ahk|zip|.
Pour ajouter un dossier il faut utiliser l'antislash: "\" pour tous les types de fichiers : ".*".
Si la clé filetype n'existe pas ou est vide, l'entrée sera toujours utilisable ce qui est équivalent à la valeur "\|.*" .

e - Les variables :

Il est possible d'utliser différentes varibles :
- $F pour indiquer le où les fichiers/dossiers selectionnés.
- $P pour le dossier dans lequel il(s) se trouve(nt)
- $E pour indiquer le nom du fichier ou du dossier sans son chemin ni son extension pour les fichiers. Dans le cas d'une multi sélection celui du premier de la liste.
exemple:
si le chemin est celui-ci : C:\Documents and Settings\utilisateur\Bureau\mon_fichier.txt
$F = C:\Documents and Settings\utilisateur\Bureau\mon_fichier.txt
$P = C:\Documents and Settings\utilisateur\Bureau
$E = mon_fichier
pour un dossier : C:\Documents and Settings\utilisateur\Bureau\mon_dossier
$F = C:\Documents and Settings\utilisateur\Bureau\mon_dossier
$P = C:\Documents and Settings\utilisateur\Bureau
$E = mon_dossier

iii - Exemple de fichier de configuration :

[GENERAL]
url=..\..\..\..\Apps\7-Zip
[CONTEXT]
type-1=submenu
name-1=7-Zip
[7-Zip]
type-1=menu
name-1=Ouvrir avec le FileManager
app-1=$URL\7zFM.exe
cmd-1="$F"
type-2=separator
type-3=menu
name-3=Extraire ici
app-3=..\..\..\Apps\7zG.exe
cmd-3=x "$F" -o"$P"

VI - Explication sur les chemins relatifs utilisables avec C.A.F.E. :
Les chemins relatifs peuvent avoir les formes suivantes :
\ce\chemin
.\ce\chemin
..\ce\chemin
ou bien en utilisant le label du périphérique, entouré par des * :
*Le label de ma clé*\ce\chemin
ou en utilisant le numéro de série du périphérique, entouré par des * :
*145641324*\ce\chemin
ou les chemins commençant par une variable d'environnement :
%userprofile%\Mes documents
Par contre les chemins de cette forme ne sont pas acceptés et ne sont pas gérés par C.A.F.E. mais il se peut qu'ils fonctionnent :
F:\ce\..\..\chemin
VII - Informations légales :
Tous droits réservés à moi, moi et moi.
dépôt original: http://download.tuxfamily.org/nomadsofts/C.A.F.E./

AutoHotkey Version : | 1.0.48.3
C.A.F.E. Version: | 0.1.6.0
Langage : | Français
Plateforme : | WinXP
Auteurs : | - Yann Perrin <yann.perrin+clef@gmail.com> : auteur du projet - enigmatiqk a écrit la code à l'origine du menu contextuel - Lahire Biette <tuxmouraille@gmail.com> développeur actuel
License: | GNU GPL V3