• Le dossier User Scripts
• Ajouter ou retirer un élément de menu
• Afficher des menus hiérarchisés
• Rassembler des éléments
• Utiliser des alias
• Définir des raccourcis clavier
• Définir des raccourcis clavier par script
• Désactiver, cocher et cacher des éléments de menu par script

Le menu User Scripts est le menu repéré par l'icône . Il affiche le contenu des dossiers User Scripts.

Vous pouvez utiliser deux dossiers User Scripts.

• En règle générale utilisez le dossier User Scripts situé dans le domaine utilisateur :

  /Users/<login>/Library/Application support/Smile/User Scripts/

  Smile crée automatiquement ce dossier.
• Pour rendre disponibles des éléments de menus pour tous les comptes de la machine, utilisez le dossier User Scripts local :

  /Library/Application support/Smile/User Scripts/

  Si le dossier n'existe pas, créez-le, puis quittez et relancez Smile.
• Les éléments pré-installés du menu user scripts sont enregistrés dans le dossier User Scripts de Smile, situé dans le même dossier que l'application, ou bien dans le package de l'application :

  /Applications/Smile/User Scripts/, ou bien :
  /Applications/Smile/Smile.app/Contents/Resources/User Scripts/

Le menu User Scripts liste le contenu de l'ensemble des dossiers User Scripts, en finissant par le domaine utilisateur. Si Smile ne trouve pas un dossier User Scripts à son démarrage, il ne crée pas de menu User Scripts.

• Les modifications des contenus des dossiers User Scripts sont pris en compte immédiatement dans le menu User Scripts.
• Pour rajouter un élément, copiez le fichier correspondant dans le dossier User Scripts.
• Pour retirer un élément, enlevez le fichier correspondant du dossier User Scripts.
• Pour ajouter ou retirer un sous-menu, ajoutez ou retirez le dossier correspondant du dossier User Scripts.

Vous exécutez un script utilisateur en le choisissant dans le menu User Scripts. Vous pouvez l'ouvrir en le choisissant tout en maintenant appuyée la touche option (⌥). Vous ouvre réellement un fichier script standard : il s'affichera dans une fenêtre de script (à fond coloré), dans laquelle vous pourez enregistrer vos modifications.

• Le menu User Scripts affiche tous les dossiers contenus dans le dossier User Scripts comme des sous-menus. Comme le dossier User Scripts lui-même, le sous-menu affiche par ordre alphabétique, la liste des fichiers contenus dans ce dossier.
• Tout sous-dossier d'un de ces dossiers est traité de la même façon, permettant un rangement hiérarchique de n'importe quelle profondeur.
• Le caractère espace " " en tant que premier caractère d'un nom de dossier contenu dans le dossier User Scripts, a une signification spéciale qui est décrite dans le paragraphe suivant.

• Les dossiers contenus dans le dossier User Scripts et dont le nom commence par un espace ont un traitement particulier : leur contenu est affiché directement dans le menu User Scripts, et non comme un sous-menu. Le nom du dossier n'apparaît pas.
• Un fichier ou un dossier, ou un alias vers ceux-ci, dont le nom commence par - (moins), est affiché dans le menu User Scripts comme une séparation de menu : vous pouvez utiliser cette fonctionnalité pour séparer des blocs de menus.

• Le dossier User Scripts peut contenir des alias vers des fichiers. Le menu User Scripts affiche le nom des fichiers originaux et non celui des alias. Copier l'alias d'une application ou d'un complément de pilotage dans le dossier User Scripts est un moyen pratique d'accéder à son dictionnaire.

• Si le nom d'un fichier dans le dossier User Scripts finit par le caractère slash / suivi d'un autre caractère, par exemple Envoyer un mail/@, le caractère final, @ dans cet exemple, peut être utilisé en combinaison avec la touche ⌘ comme raccourci clavier pour sélectionner ce menu.
• Le raccourci est sensible à la casse : si le caractère final est une majuscule, la combinaison du raccourci sera ⇧⌘ + 'touche' ; par exemple le raccourci de Just a Test /J sera ⇧⌘J.

Un slash dans un nom de fichier est légal sur un Macintosh ; il est en sous-main traduit par deux points : dans le système de fichier UNIX.

Par script vous pouvez personnaliser les raccourcis clavier à volonté, en éditant les propriétés modifiers et shortcut des menu items.

• L'exemple ci-dessous redéfinit le raccourci clavier pour User Scripts ▸ More Smile commands ▸ Edit ▸ Copy/Paste Style, (⇧⌘C et ⇧⌘V à l'origine) deviennent ⌥⌘C et ⌥⌘V comme dans TextEdit.

  set the_menu to menu item "Copy Style" of menu item "Edit" of menu item "More Smile commands" of menu "Scripts"
  set modifiers of the_menu to {option down}
  set the_menu to menu item "Paste Style" of menu item "Edit" of menu item "More Smile commands" of menu "Scripts"
  set modifiers of the_menu to {option down}

• Pour qu'un tel script soit exécuté à l'ouverture de Smile, installez un script compilé dans le dossier suivant :

  /Users/<login>/Library/Application support/Smile/More stuff/Initialization/

• Par script, vous pouvez éditer les autres menus tout aussi bien que le menu user scripts. L'exemple suivant assigne le raccourci ⇧⌘N de Fichier ▸ Nouveau script à Fichier ▸ Nouveau texte Unicode. Nous choisissons ici de nous référer aux menus par index plutôt que par nom.

  set shortcut of menu item 2 of menu 2 to ""
  set shortcut of menu item 4 of menu 2 to "N"
  set modifiers of menu item 4 of menu 2 to {shift down}

• Lorsque vous changez la propriété modifiers d'un élément de menu, Smile ajoute en plus command down à la liste : par défaut tous les raccourcis clavier incluent la touche ⌘. Pour forcer un raccourci clavier à ne pas avoir la touche ⌘ (ce qui n'est pas franchement recommandé) il faut spécifier "no command" dans la liste de la propriété modifiers.
  Vous pouvez utiliser cette fonctionnalité par exemple pour installer un ensemble de commandes personnalisées de remplissage automatique sur toutes les combinaisons de touche ctrl⇧-'lettre'. Sachez cependant que pour des raisons indépendantes de Smile, installer un tel ensemble de raccourcis clavier peut ralentir votre ordinateur dans certaines circonstances (par exemple dans les dialogues de navigation de fichiers).

Les propriétés suivantes vous permettent d'ajouter ou retirer une coche ✓ avant le nom de l'élément de menu, de désactiver (griser) et de réactiver l'élément de menu, ou encore de le cacher.

• checked
• enabled
• visible

La ligne suivante cache le menu User Scripts. Remplacez false par true pour le réafficher.

set visible of menu 7 to false