Précédent | Sommaire | Suivant

2.2 Fichiers de script

Pour créer une installation NSIS, vous devez tout d'abord écrire un script NSIS. Un script NSIS est un simple fichier texte avec une syntaxe spéciale. Vous pouvez éditer un script avec n'importe quel éditeur de texte. Il est recommandé d'utiliser un éditeur qui indique le nombre de ligne car NSIS se sert du numéro de ligne pour indiquer où se situe une erreur, et où il pourrait s'en produire. Un éditeur qui supporte le surlignement de texte est aussi recommandé. Vous pouvez télécharger des éditeurs spécialement conçus pour NSIS et des fichiers pour le surlignement de syntaxe à partir de Wiki NSIS.

Dans un script NSIS chaque ligne est traitée comme une commande. Si votre commande est trop longue pour être sur une ligne vous pouvez utiliser l'antislash - '\' - à la fin de celle-ci. Le compilateur traitera la nouvelle ligne comme étant la suite de la précédente et n'attendra pas de nouvelle commande. Par exemple:

Messagebox MB_OK|MB_ICONINFORMATION \
"Ceci est une exemple d'utilisation de saut de ligne pour une longue commande dans un script NSIS"

Si vous voulez utiliser la double-quote dans une chaîne vous pouvez soit utiliser \$" pour en faire un caractère soit mettre entre guillemets la chaîne avec différentes sortes de caractères d'échappement tel que ` ou '.

Pour plus de détails sur le format des fichiers de script, voir Format des fichiers de script.

L'extension par défaut pour le fichier de script est .nsi. Les fichiers d'en-têtes ont l'extension .nsh. Les fichiers d'en-têtes peuvent vous aidez à organiser votre script en le divisant en plus d'un unique bloc de code, vous pouvez aussi y mettre des fonctions ou des macros et inclure les fichiers d'en-têtes dans d'autres installations. La maintenance en est ainsi simplifiée et votre script sera plus facile à lire. Pour inclure un fichier d'en-têtes dans votre script utiliser !include. Les fichiers d'en-têtes se situent dans le répertoire Include de votre répertoire NSIS et peuvent être inclus simplement par leur nom. Par exemple:

!include Sections.nsh

Précédent | Sommaire | Suivant