Format des fichiers de script

4.1 Format des fichiers de script

Un fichier de script (.nsi pour NSIS Script File) est simplement un fichier texte comprenant une série de commandes.

Commandes

Les lignes de commande sont dans le format 'commande [paramètres]'

File "monfichier"

Commentaires

Les lignes commençant par ; ou # sont des commentaires. Vous pouvez placer des commentaires après les commandes. Vous pouvez aussi utiliser les commentaires C pour commenter une ou plusieurs lignes.

; Commentaire
# Commentaire

/*
Commentaire
Commentaire
*/

Name /* comment */ mysetup

File "monfichier" ; Commentaire

Si un paramètre doit commencer par ; ou # mettez-le entre simple-guillemets.

Plug-ins

Pour appeler un plug-in, utilisez 'plugin::commande [paramètres]'. Pour plus d'informations, voir les DLLs plug-in.

nsExec::Exec "monfichier"

Nombres

Pour les paramètres à traiter comme des nombres, utilisez la notation décimale (le nombre) ou hexadécimale (préfixé par 0x, ex. 0x12345AB), voir même octale (les nombres commençant par 0 et sans x).

Les couleurs doivent être spécifiées au format RBGB hexadécimal, comme en HTML mais dans le #.

IntCmp 1 0x1 lbl_egual

SetCtlColors $HWND CCCCCC

Chaînes de caractères

Pour représenter les chaînes de caractères possédant un espace, utilisez les guillemets :

MessageBox MB_OK "Coucou vous !"

Les guillemets ont la propriété de contenir un paramètre s'il commence le paramètre. Il peut s'agit ou bien de simple-guillemets, de double-guillemets, ou bien d'une apostrophe.

Vous pouvez échapper les guillemets en utilisant $\.

          MessageBox MB_OK "Je vais être heureux" ; ceci place un ' dans une chaîne
          MessageBox MB_OK 'Et il me dit "Salut toi!"' ; ceci place un " dans une chaîne
          MessageBox MB_OK `Et il me dit "Je vais être heureux!"` ; ceci place un ' et un " dans une chaîne:
          MessageBox MB_OK "$\"Idée jetée par un homme sage$\" dit l'homme sage" ; montre l'échappement de guillemets

Il est aussi possible d'inclure des sauts de ligne, des tabulations etc. Dans une chaîne, utilisez $\r, $\n, $\t etc. Plus d'informations...

Variables

Les variables commencent par $. Les variables utilisateurs doivent être déclarée.

Var MAVAR

StrCpy $MAVAR "mavaleur"

Plus d'information...

Longues commande

Pour étendre une commande sur plusieurs lignes, utilisez l'antislash (\) à la fin de la ligne, et la ligne suivante sera effectivement concaténée à la fin de celle-ci. Par exemple :

CreateShortCut "$SMPROGRAMS\NSIS\Espace de travail du projet ZIP2EXE.lnk" \ "$INSTDIR\source\zip2exe\zip2exe.dsw" MessageBox MB_YESNO|MB_ICONQUESTION \ "Voulez-vous supprimer tous les fichiers dans le répertoire ? \ (Si vous y avez ajouté quelque chose que vous voulez \ garder, cliquez sur Non)" \ IDNO NoRemoveLabel

Fichier de configuration

Si un fichier nommé "nsisconf.nsh" existe dans le répertoire config, il sera inclus par défaut au début du script (à moins que le paramètre /NOCONFIG soit utilisé). Le répertoire config sous Windows est le même répertoire que celui où est makensis.exe. Sur d'autres plateformes il est défini au moment de l'instalaltion et est par défaut $PREFIX/etc/. Vous pouvez modifier cela au lancement, voir section 3.1.3 pour plus d'informations.

Précédent | Sommaire | Suivant