MacOS X

Note : LilyPond travaille sur des fichiers textuels. Il s’apparente plus à un langage de programmation plutôt qu’à un éditeur de partition en mode graphique. Avant de télécharger LilyPond, veuillez lire Entrée sous forme de texte.

Paquetages

Téléchargement

Installation

Double-cliquez sur le fichier téléchargé, puis déplacez-le où vous voulez.

Désinstallation

Supprimez le répertoire LilyPond.app.

Utilisation en ligne de commande

Note : Si vous préférez l’interface graphique mentionnée plus avant, ne tenez pas compte de ce qui suit.

MacOS X et la ligne de commande

Le moyen le plus pratique d’utiliser les scripts LilyPond est de vous créer des « lanceurs ».

  1. Créez un répertoire pour stocker ces différents scripts :
    mkdir -p ~/bin
    cd ~/bin
    
  2. Créez un fichier lilypond qui contiendra
    #!/bin/bash
    exec RÉP/LilyPond.app/Contents/Resources/bin/lilypond "$@"
    

    Note : RÉP sera en règle générale /Applications/

  3. Créez de la même manière les fichiers lilypond-book, convert-ly, et autres scripts que vous souhaitez utiliser, en remplaçant bin/lilypond par bin/convert-ly ou autre nom de programme.
  4. Rendez ce fichier exécutable :
    chmod u+x lilypond
    
  5. Ajoutez ce répertoire à votre chemin de recherche (path). Modifiez, ou bien créez un fichier .profile à la racine de votre répertoire personnel de telle sorte qu’il contienne
    export PATH=$PATH:~/bin
    

    Ce fichier doit se terminer par une ligne vide.

Lancement des scripts

Les scripts – aussi bien lilypond-book, convert-ly, abc2ly, que lilypond lui-même – sont inclus dans un fichier .app pour MacOS X.

Ces scripts peuvent se lancer directement en ligne de commande :

chemin/vers/LilyPond.app/Contents/Resources/bin/lilypond

Il en va de même pour les autres scripts de ce répertoire, tels que lilypond-book et convert-ly.

Compilation d’un fichier

Note : Les instructions qui suivent concernent ceux qui utilisent le lanceur LilyPond. Si vous utilisez l’un des programmes mentionnés au chapitre Facilités d'édition, référez-vous à leur documentation respective en cas de problème.

Étape 1. Création d’un fichier ‘.ly

Lorsque vous faites un double clic sur LilyPond.app, un fichier exemple s’ouvre.

pictures/Learning_Macos_welcome

Dans le menu, en haut et à gauche de la fenêtre, sélectionnez Fichier > Enregistrer.

pictures/Learning_Macos_Save_menu

Attribuez un nom à votre fichier, par exemple ‘test.ly’.

pictures/Learning_Macos_Save_file_with_name

Étape 2. Compilation (avec LilyPad)

Dans le menu, sélectionnez Compiler > Typeset.

pictures/Learning_Macos_Typeset_menu

Une nouvelle fenêtre s’ouvre dans laquelle s’affiche le journal de compilation du fichier que vous venez de sauvegarder.

pictures/Learning_Macos_Compiling_log

Étape 3. Visualisation du résultat

La compilation s’achève par la création d’un fichier PDF portant le même nom que le fichier source ; ce nouveau fichier sera automatiquement ouvert par votre lecteur PDF par défaut et affiché à l’écran.

pictures/Learning_Macos_pdf_output

Autres commandes

Pour créer de nouveaux fichiers pour LilyPond, sélectionnez Fichier > Nouveau

pictures/Learning_Macos_New_menu

ou Fichier > Ouvrir pour reprendre un fichier précédemment enregistré.

pictures/Learning_Macos_Open_menu

Pensez à toujours enregistrer votre travail avant de lancer l’option Compile > Tyepset du menu. Si le PDF n’apparaît pas, vérifiez que la fenêtre « log » ne comporte pas d’erreur.

Si vous n’utilisez pas le lecteur de PDF par défaut de Mac OS et qu’un fichier résultant d’une précédente compilation est encore ouvert dans votre lecteur, la régénération de ce PDF peut bloquer tant que vous ne fermez pas le fichier ouvert.

Mention légale