@c -*- coding: utf-8; mode: texinfo;; documentlanguage: fr -*-

@ignore
    Translation of GIT committish: 70606224a69f3a7e96aeaf081cb0d1216c3f2cea

    When revising a translation, copy the HEAD committish of the
    version that you are working on.  For details, see the Contributors'
    Guide, node Updating translation committishes..
@end ignore

@c Translators: Jean-Charles Malahieude
@c Translation checkers:

@c \version "2.23.10"

@node Installation
@chapter Installation
@translationof Installing

Ce tutoriel vous guidera pas à pas dans l'installation et la création
d'une première partition musicale.

Les fichiers LilyPond ne contiennent que du simple texte. Vous pouvez
utiliser un éditeur de texte brut pour modifier un fichier LilyPond --
@strong{non pas} un logiciel de traitement de texte tel que Microsoft
Word -- ou l'un des éditeurs spécialement taillés pour LilyPond pour
plus de confort dans votre travail d'édition. Nous avons opté, dans les
paragraphes qui suivent, pour
@uref{https://frescobaldi.org,Frescobaldi}, l'un des éditeurs les plus
en vogue à ce jour. D'autres possibilités sont indiquées à la rubrique
@rweb{Facilités d'édition}.

Plusieurs options s'offrent à vous ; choisissez celle qui convient le
mieux à vos besoins. Si vous ne savez pas ce qu'est la « ligne de
commande », il vous faut une installation graphique.

@menu
* Installation en mode graphique sous GNU/Linux::
* Installation en mode graphique sous Windows::
* Installation en mode graphique sous macOS::
* Installation en ligne de commande::
@end menu

@node Installation en mode graphique sous GNU/Linux
@section Installation en mode graphique sous GNU/Linux
@translationof Graphical setup under GNU/Linux

Les instructions qui suivent sont opérationnelles dans un environnement
GNOME, installé par défaut chez Ubuntu et Fedora entre autres. Pour les
autres environnements de bureau, elles peuvent bien sur s'adapter. Pour
les distributions minimalistes de GNU/Linux, voir
@ref{Installation en ligne de commande}.

Commencez par lancer le programme GNOME Software -- francisé en
« Logiciels ».

@center @sourceimage{linux-1-search-gnome-software,10cm,}

Dans ce gestionnaire de paquetages, recherchez « Frescobaldi ».

@center @sourceimage{linux-2-search-frescobaldi,10cm,}

Installez Frescobaldi. Devrait automatiquement s'installer en complément
une version de LilyPond.

@center @sourceimage{linux-3-install-frescobaldi,10cm,}

Au lancement de Frescobaldi devrait s'ouvir un nouveau fichier avec du
texte pré-saisi et que nous verrons plus tard.

@center @sourceimage{linux-4-frescobaldi-start,10cm,}

Au-dessous de la ligne @code{\version}, saisissez une nouvelle ligne
contenant exactement :

@example
@{ c' @}
@end example

Cliquez alors sur l'icône LilyPond ou faîtes @kbd{Control-M}. Sur la
droite apparaît alors une partition simple.

@center @sourceimage{linux-5-frescobaldi-simple-file,10cm,}

Félicitations, vous venez de créer votre première partition avec
LilyPond. Si vous êtes déjà satisfait, vous pouvez passer ce qui suit.
Toutefois, il se peut que la version de LilylPond qui vient d'être
installée soit différente de celle sur laquelle se base cette
documentation. Si vous voulez une autre version de LilyPond, vous pouvez
l'indiquer dans Frescobaldi, sans pour autant perdre celle d'origine.
Pour ce faire, commencez par en récupérer l'archive à partir de la
@rwebnamed{Téléchargement, page de téléchargement}, puis faites un
double clic pour la déplier.

@center @sourceimage{linux-6-download-and-unpack-archive,10cm,}

Déplacez le dossier alors créé du répertoire de téléchargement à
l'endroit où vous voulez le garder. Par exemple, placez-le dans votre
répertoire personnel.

Accédez maintenant aux préférences de Frescobaldi.

@center @sourceimage{linux-7-frescobaldi-find-preferences,15cm,}

Sélectionnez « Préférences de LilyPond » et cliquez sur « Ajouter » pour
enregistrer une nouvelle version de LilyPond.

@center @sourceimage{linux-8-frescobaldi-add-lilypond-version,10cm,}

Cliquez sur l'icône d'exploration des fichiers.

@center @sourceimage{linux-9-frescobaldi-select-lilypond-executable,10cm,}

Naviguez jusqu'au dossier que vous avez extrait puis, à l'intérieur de
ce dossier, ouvrez le dossier @samp{bin} et enfin sélectionnez
@samp{lilypond}.

@center @sourceimage{linux-10-navigate-to-lilypond-executable,10cm,}

Vous pouvez alors cliquer sur @samp{OK}. Vous avez dorénavant deux
versions de LilyPond installées.

@center @sourceimage{linux-11-frescobaldi-new-version-added,10cm,}

Passez maintenant au @ref{Tutoriel} pour en apprendre plus sur la
syntaxe de LilyPond.


@node Installation en mode graphique sous Windows
@section Installation en mode graphique sous Windows
@translationof Graphical setup under Windows

Récupérez LilyPond pour Windows à partir de la
@rwebnamed{Téléchargement, page de téléchargement}. Le fichier est une
archive ZIP nommée
@file{lilypond-@var{x}.@var{y}.@var{z}-mingw-x86_64.zip} (où « mingw »
signifie que c'est pour Windows) qu'il faut dézipper dans l'explorateur
de fichiers. Placez le nouveau répertoire
@code{lilypond-@var{x}.@var{y}.@var{z}-mingw-x86_64} dans un endroit
permanent ; peu importe le dossier, il doit simplement ne pas être
modifié par la suite. Vous pourriez choisir de le placer dans votre
répertoire personnel.

Récupérez ensuite la dernière version de Frescobaldi à partir de la
@uref{https://github.com/frescobaldi/frescobaldi/releases, page de
téléchargement du projet}. Prenez le fichier @file{.exe}.

@center @sourceimage{windows-1-frescobaldi-download-github,10cm,}

Double-cliquez sur le fichier téléchargé, ce qui lance l'assistant
d'installation.

@center @sourceimage{windows-2-frescobaldi-installer,10cm,}

Acceptez la licence et installez Frescobaldi à l'aide de l'assistant.
Vous arriverez alor sur un écran de démarrage comme celui-ci :

@center @sourceimage{windows-3-frescobaldi-startup,10cm,}

Accédez aux préférences de Frescobaldi.

@center @sourceimage{windows-4-frescobaldi-find-preferences,10cm,}

Sélectionnez « Préférences de LilyPond » sur la gauche.

@center @sourceimage{windows-5-frescobaldi-find-lilypond-preferences,15cm,}

Cliquez « Éditer » sur la droite, ce qui ouvre une boîte de dialogue
pour choisir l'exécutable de LilyPond.

@center @sourceimage{windows-6-frescobaldi-select-lilypond-executable,10cm,}

Cliquez sur l'icône dossier et naviguez jusqu'au dossier
@code{lilypond-@var{x}.@var{y}.@var{z}-mingw-x86_64} que vous avez
précédemment créé. Dans ce répertoire, ouvrez le dossier
@file{lilypond-@var{x}.@var{y}.@var{z}}, puis @file{bin}, et enfin
sélectionnez @file{lilypond}.

@center @sourceimage{windows-7-frescobaldi-find-executable-from-explorer,10cm,}

Cliquez alors sur « OK ».

@center @sourceimage{windows-8-frescobaldi-ok,10cm,}

Cliquez à nouveau sur « OK ».

@center @sourceimage{windows-9-frescobaldi-ok-2,10cm,}

Saisissez ce simple fichier dans la fenêtre :

@example
\version "@version{}"

@{ c' @}
@end example

Compilez-le par un @kbd{Control-M} ou à l'aide de l'icône « LilyPond ».
Apparaît alors une partition minimale.

@center @sourceimage{windows-10-frescobaldi-done,10cm,}

Félicitations, vous venez de créer votre première partition avec
LilyPond. Passez maintenant au @ref{Tutoriel} pour en apprendre plus sur
la syntaxe de LilyPond.


@node Installation en mode graphique sous macOS
@section Installation en mode graphique sous macOS
@translationof Graphical setup under macOS

Récupérez LilyPond pour Windows à partir de la
@rwebnamed{Téléchargement, page de téléchargement}. Le fichier est une
archive nommée
@file{lilypond-@var{x}.@var{y}.@var{z}-darwin-x86_64.tar.gz} (où
« darwin » signifie que c'est pour macOS) qu'il faut déplier dans
l'explorateur de fichiers. Placez le nouveau répertoire
@code{lilypond-@var{x}.@var{y}.@var{z}-darwin-x86_64} dans un endroit
permanent ; peu importe le dossier, il doit simplement ne pas être
modifié par la suite. Vous pourriez choisir de le placer dans votre
répertoire personnel.

Récupérez ensuite la dernière version de Frescobaldi à partir de la
@uref{https://github.com/frescobaldi/frescobaldi/releases, page de
téléchargement du projet}. Prenez le fichier @file{.dmg}.

@center @sourceimage{macos-1-frescobaldi-download-github,10cm,}

Dans l'explorateur, double-cliquez sur lel fichier pour lancer
l'installateur. Vous pourriez, à ce moment rencontrer un problème :

@center @sourceimage{macos-2-frescobaldi-cant-be-opened,10cm,}

Ceci est du au fait que le développement de Frescobaldi est réalisé
indépendamment d'Apple. Ce logiciel est néanmoins sur, mais vous devez
le dire à Apple. Pour ce faire, commencez par cliquer « Annuler ».
@emph{Après avoir cliqué « Annuler »}, accédez à l'application
« Préférences système » et sélectionnez « Sécurité et vie privée ».

@center @sourceimage{macos-3-open-system-preferences-security,10cm,}

Cliquez alors sur « Ouvrir quand même » @emph{(Open Anyway)}.

@center @sourceimage{macos-4-allow-open-anyway,10cm,}

Ceci conduira à un nouvel avertissement de sécurité, mais vous aurez
cette fois la possibilité d'accepter. Sélectionnez « Ouvrir ». Encore
une fois, ne craignez rien, Frescobaldi est absolument inoffensif pour
votre système.

@center @sourceimage{macos-5-accept-security-warning,10cm,}

Maintenant que Frescobaldi est ouvert, accédez aux préférences.

@center @sourceimage{macos-6-frescobaldi-find-preferences,10cm,}

Sélectionnez « Préférences de LilyPond » sur la gauche.

@center @sourceimage{macos-7-frescobaldi-find-lilypond-preferences,15cm,}

Cliquez « Éditer » sur la droite, ce qui ouvre une nouvelle fenêtre :

@center @sourceimage{macos-8-frescobaldi-edit-lilypond-executable,10cm,}

Cliquez sur l'icône dossier et naviguez jusqu'au dossier
@code{lilypond-@var{x}.@var{y}.@var{z}-darwin-x86_64} que vous avez
précédemment créé. Dans ce répertoire, ouvrez le dossier
@file{lilypond-@var{x}.@var{y}.@var{z}}, puis @file{bin}, et enfin
sélectionnez @file{lilypond}.

@center @sourceimage{macos-9-frescobaldi-navigate-to-lilypond-executable,10cm,}

Un nouvel avertissement de sécurité est susceptible de se produire
lorsque vous cliquerez sur « OK ». De nouveau, commencez par cliquer sur
« Annuler », puis autorisez LilyPond dans les préférences et reprenez la
procédure de sélection de @file{lilypond} dans l'explorateur.

Répondez maintenant « OK » à tout jusqu'à ce que vous retrouviez la
fenêtre principale de Frescobaldi. Saisissez alors ce simple fichier
dans la vue des sources, à gauche :

@example
\version "@version{}"

@{ c' @}
@end example

Cliquez sur le bouton portant l'icône de LilyPond pour compiler le
fichier, ou bien utilisez le raccourci clavier @kbd{Control-M}. Pour la
troisième fois, le système vous préviendra d'un problème de sécurité,
concernant cette fois « gs » (Ghostscript). Une fois de plus, accédez
aux Préférences du système pour autoriser le programme à s'exécuter.

Finalement, la compilation suivante aboutira et apparaîtra une partition
minimale.

@center @sourceimage{macos-10-minimal-score,15cm,}

Félicitations, vous venez de créer votre première partition avec
LilyPond. Passez maintenant au @ref{Tutoriel} pour en apprendre plus sur
la syntaxe de LilyPond.


@node Installation en ligne de commande
@section Installation en ligne de commande
@translationof Command line setup

Sur de nombreuses distributions GNU/Linux, on peut installer LilyPond à
partir du gestionnaire de paquetages. C'est aussi le cas avec macOS à
partir de @uref{https://www.macports.org,MacPorts} ou
@uref{https://brew.sh,Homebrew}.

Dans tous les cas, on peut installer LilyPond en dépliant l'archive
récupérée à partir de la
@rwebnamed{Téléchargement, page de téléchargement}. Les binaires sont
utilisables dès leur expansion. Vous pouvez lancer

@example
/@var{...}/lilypond-@var{x}.@var{y}.@var{z}/bin/lilypond fichier.ly
@end example

@noindent
(sur Windows, remplacez les « slashes » @samp{/} par des
« antislashes » @samp{\}).

Ceci compilera @code{fichier.ly} et produira @code{fichier.pdf}. Pour
tester votre installation, vous pouvez utiliser ce fichier minimaliste :

@example
\version "@version{}"

@{ c' @}
@end example

Ceci produira un résultat dans @file{fichier.pdf} :

@lilypond[quote]
{ c' }
@end lilypond

Passez maintenant au @ref{Tutoriel} pour en apprendre plus sur
la syntaxe de LilyPond, ou consultez
@rprogram{Utilisation en ligne de commande} pour de plus amples
informations sur l'utilisation de LilyPond en ligne de commande.
