2.2 Considérations sur la ligne de commande
Ceci et les sections suivantes couvrent uniquement l’utilisation de
convert-ly
en ligne de commande. Les applications graphiques
telles que Frescobaldi disposent de leur propre interface avec
convert-ly
.
Par « ligne de commande », nous entendons l’interface de commande du système. Les utilisateurs de Windows seront certainement plus familiers des termes « fenêtre DOS » ou « invite de commande ». Quant aux utilisateurs de MacOS X, ils connaissent assurément les termes « console » et « terminal ».
Notre propos n’est pas ici d’expliquer ce qu’est l’interface de commande pour un système informatique ni comment elle fonctionne. Aussi, si vous ne savez de quoi il retourne, nous vous renvoyons aux nombreuses documentations que vous pourrez trouver sur ce sujet.
Consultez La variable d’environnement PATH
pour savoir comment
régler votre système d’exploitation afin de pouvoir utiliser
convert-ly
en ligne de commande sans avoir à en spécifier le
chemin d’accès.
Réglage supplémentaire pour Windows
Les utilisateurs non-Windowsiens peuvent sauter cette section, tout comme les utilisateurs de Windows disposant déjà d’un interpréteur Python (version 3.8 ou supérieure).
convert-ly
est en fait un script Python nommé
convert-ly.py. Dans l’archive de LilyPond pour Windows, il se
trouve dans le même répertoire que le binaire lilypond.exe et un
interpréteur Python, python.exe. Partant du principe que vous
avez déplié la version 2.25.20 dans un répertoire
C:\Utilisateurs\moi et que PATH
est correctement réglé, ill
faudrait taper
python C:\Utilisateurs\moi\lilypond-2.25.20\bin\convert-ly.py monfichier.ly
ce qui deviendrait vite fastidieux.
Trois étapes sont nécessaires avant de pouvoir omettre l’interpréteur Python (python.exe) et l’extension .py.2
- Sur la ligne de commande, tapez
assoc .py=PythonScript
pour associer l’extension .py au type de fichier « PythonScript ».
- Pour l’instruction suivante, tapez
ftype PythonScript=C:\Utilisateurs\moi\lilypond-2.25.20\bin\python.exe %1 %*
pour obtenir que les fichiers du type « PythonScript » soient gérés par le
python.exe
de LilyPond. Il vous faudra régler le chemin d’accès sur la localisation effective, et ne pas oublier ‘%1 %*’ en fin de ligne ! - Modifiez la variable d’environnement
PATHEXT
pour y ajouter .py aux valeurs déjà présentes. Ceci se fait de la même manière que pourPATH
.
Quittez alors l’invite de commande puis relancez la pour tester que
convert-ly --version
est opérationnel.
Footnotes
(2)
Notez que les étapes 1 et 2 doivent s’accomplir avec l’invite de commande cmd.exe, non pas en utilisant PowerShell !