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

  1. Sur la ligne de commande, tapez
    assoc .py=PythonScript
    

    pour associer l’extension .py au type de fichier « PythonScript ».

  2. 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 !

  3. 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 pour PATH.

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 !


GNU LilyPond – Utilisation des programmes v2.25.20 (branche de développement).