Commençons par un exemple simple qui affiche un message sur la console. Créez un fichier appelé luarc
dans le répertoire de configuration de Ansel (généralement $HOME/.config/Ansel/
) et ajoutez-y la ligne suivante :
1print("Hello World !")
Lancez Ansel et vous verrez la phrase « Hello World !
» s’afficher sur la console. Rien d’extraordinaire, mais c’est un début.
À ce stade, il n’y a rien de spécifique à Ansel dans le script. Nous utilisons simplement la fonction d’affichage standard de Lua, permettant d’afficher une chaîne de caractère. C’est bien beau, mais nous pouvons faire mieux. Ainsi pour accéder à l’API Ansel, vous devez d’abord la demander (require
) et enregistrer le résultat dans une variable. Depuis cette variable, vous pouvez accéder à toute l’API Ansel en appelant des sous-champs. Tout est documenté dans le manuel de l’
API Lua
Exécutez le script et… rien de ne s’affiche ! La fonction Ansel.print_error
est comme le print
classique mais affiche le message uniquement si vous avez activé les traces Lua en lançant Ansel avec la commande « Ansel -d lua
». C’est la méthode recommandée pour afficher des traces dans un script Lua de Ansel.