@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+
@ignore
- Translation of GIT committish: 1dea8bf1d7182f3d1a1c70bb2010f4585f56b3e6
+ Translation of GIT committish: 8df40d45e4366f4e9baa2cec3b7eb38b6482150f
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
* Dernières précisions::
@end menu
+
@node Notation sur une seule portée
@section Notation sur une seule portée
@translationof Single staff notation
@subsection Contrôle de mesure
@translationof Bar checks
-
Les contrôles de barre de mesure -- @emph{bar checks} en anglais -- ne
sont à priori pas strictement nécessaires. Ils permettent cependant
d'indiquer directement dans le code saisi -- à l'aide d'une barre
@warning{Si, comme nombre de nouveaux utilisateurs, ce qui suit vous
paraît déroutant, lisez cette partie jusqu'au bout, à plus forte raison
-si vous n'avez jamais fait de solfège@tie{}!}
+si vous n'avez jamais fait de solfège !}
@subheading Altérations
comme l'allemand ou le hollandais.
@c DIV specific
-Cependant, si vous utilisez la commande
-@w{@code{@w{\language@tie{}"italiano"}}} pour entrer les noms de note
-français au lieu des noms hollandais, il faudra ajouter un @code{d} pour
-obtenir un dièse, et un @code{b} pour un bémol. Le double dièse et le
-double bémol s'obtiennent en ajoutant respectivement @code{dd} et
-@code{bb}. Pour en savoir plus sur les autres langues disponibles,
-consultez @ruser{Nom des notes dans d'autres langues}.
+Cependant, si vous utilisez la commande @code{\language "italiano"} pour
+entrer les noms de note français au lieu des noms hollandais, il faudra
+ajouter un @code{d} pour obtenir un dièse, et un @code{b} pour un bémol.
+Le double dièse et le double bémol s'obtiennent en ajoutant
+respectivement @code{dd} et @code{bb}. Pour en savoir plus sur les
+autres langues disponibles, consultez
+@ruser{Nom des notes dans d'autres langues}.
@c END DIV
@lilypond[verbatim,quote,relative=2]
cis1 ees fisis, aeses
@end lilypond
+
@subheading Armures
@cindex armure, définition de l'
@smallspace
+
@subheading Attention aux armures et aux hauteurs
Glossaire musicologique :
compris les altérations -- permet à LilyPond de déterminer dans quel
cas imprimer des @notation{altérations accidentelles}. L'armure
n'affecte que les altérations @emph{imprimées}, et non les hauteurs
-réelles@tie{}! Cette fonctionnalité est souvent source de confusion pour
+réelles ! Cette fonctionnalité est souvent source de confusion pour
les nouveaux utilisateurs, aussi expliquons-la en détail.
LilyPond fait une distinction nette entre le contenu musical et la
note correspondante est une question qui relève de la mise en forme.
La gravure d'une partition suit des règles, en particulier des règles
d'indication des altérations accidentelles. Les hauteurs de note, en
-revanche, relèvent de ce que vous voulez entendre@tie{}; et, dans la
+revanche, relèvent de ce que vous voulez entendre ; et, dans la
mesure où la musique que vous entrez est censée être celle que vous
voulez entendre, LilyPond, qui n'est chargé que de la gravure, ne les
choisira pas à votre place.
entrer le @code{is} pour les notes @code{cis} et @code{fis}.
Le code @code{b} ne veut pas dire @qq{Imprimez-moi un point noir sur
-la troisième ligne de la portée.} Cela signifie plutôt@tie{}: @qq{Ici se
+la troisième ligne de la portée.} Cela signifie plutôt : @qq{Ici se
trouve une note dont la hauteur est un si naturel.} Avec une armure
de la bémol majeur, ce @code{si} est flanqué d'un bécarre
-accidentel@tie{}:
+accidentel :
@lilypond[verbatim,quote,relative=2]
\key aes \major
aes4 c b c
@end lilypond
-Prenons un autre exemple@tie{}: imaginez-vous devant un piano@tie{}; dès
+Prenons un autre exemple : imaginez-vous devant un piano ; dès
lors que vous voulez enfoncer l'une des touches noires, il vous faudra
@strong{ajouter} un @code{is} ou un @code{es} au nom de la note.
peuvent être imprimées, consultez
@ruser{Altérations accidentelles automatiques}.
-
@seealso
Manuel de notation :
@ruser{Nom des notes dans d'autres langues},
@funindex ( ... )
@funindex \( ... \)
+
@subheading Liaisons de prolongation
Glossaire musicologique :
g4~ g c2~ | c4 ~ c8 a8 ~ a2 |
@end lilypond
+
@cindex liaisons d'articulation
@cindex articulation, liaisons d'
-
@subheading Liaisons d'articulation
@c Le terme de "slur" a deux sens en français : articulation et phrasé.
d4( c16) cis( d e c cis d) e( d4)
@end lilypond
+
@cindex liaisons de phrasé
@cindex phrasé, liaisons de
@cindex legato
@smallspace
+
@cindex liaisons d'articulation et de prolongation, différences
@subheading Attention aux types de liaison
c4~( c8 d~ d4 e)
@end lilypond
-
@seealso
Manuel de notation :
@ruser{Liaisons de prolongation},
@rglos{articulation}.
Des @notation{articulations} peuvent être ajoutées à une note, au moyen
-d'un tiret @code{-} suivi d'un caractère@tie{}:
+d'un tiret @code{-} suivi d'un caractère :
@lilypond[verbatim,quote,relative=2]
c4-^ c-+ c-- c-|
c4-> c-. c2-_
@end lilypond
-@subheading Doigtés
+@subheading Doigtés
@cindex doigtés
@funindex ^
@rglosnamed{fingering,doigté}.
De même, des indications de doigté peuvent être ajoutées à une note en
-utilisant un tiret (@samp{-}) et le chiffre à écrire@tie{}:
+utilisant un tiret (@samp{-}) et le chiffre à écrire :
@lilypond[verbatim,quote,relative=2]
c4-3 e-5 b-2 a-1
c4_-^1 d^. f^4_2-> e^-_+
@end lilypond
+
@subheading Nuances
@cindex nuances
@rglos{decrescendo}.
On obtient un signe de @notation{nuance} en ajoutant à la note les
-lettres du signe, précédées d'un anti-slash @code{\}@tie{}:
+lettres du signe, précédées d'un anti-slash @code{\} :
@lilypond[verbatim,quote,relative=2]
c4\ff c\mf c\p c\pp
@notation{Crescendos} et @notation{decrescendos} débutent avec les
commandes @code{\<} et @code{\>}. Ils se terminent soit par une
nuance d'arrivée, par exemple @code{\f}, soit par la commande
-@code{\!}@tie{}:
+@code{\!} :
@lilypond[verbatim,quote,relative=2]
c4\< c\ff\> c c\!
@end lilypond
-
@seealso
Manuel de notation :
@ruser{Articulations et ornements},
c2^"espr" a_"legato"
@end lilypond
-Pour mettre en forme du texte, on utilise la commande
-@code{\markup}@tie{}:
+Pour mettre en forme du texte, on utilise la commande @code{\markup} :
@lilypond[verbatim,quote,relative=2]
c2^\markup{ \bold espr}
}
@end lilypond
-
@seealso
Manuel de notation :
@ruser{Ajout de texte}.
Glossaire musicologique :
@rglosnamed{beam,ligature}.
-Toutes les barres de ligature sont dessinées automatiquement@tie{}:
+Toutes les barres de ligature sont dessinées automatiquement :
@lilypond[verbatim,quote,relative=2]
a8 ais d ees r d c16 b a8
a8 c b4 d8. c16 b4 |
@end lilypond
-
@seealso
Manuel de notation :
@ruser{Barres de ligature automatiques},
Glossaire musicologique : @rglosnamed{anacrusis,anacrouse}.
On crée une levée (ou anacrouse) avec la commande @code{\partial},
-suivie d'une durée@tie{}: @code{\partial@tie{}4} produit une levée d'une
-noire et @code{\partial@tie{}8} d'une croche.
+suivie d'une durée : @code{\partial 4} produit une levée d'une
+noire et @code{\partial 8} d'une croche.
@lilypond[verbatim,quote,relative=2]
\partial 8 f8 |
c2 d |
@end lilypond
+
@subheading Nolets
@cindex nolets
@rglosnamed{triplet,triolet}.
Les @notation{nolets} sont créés avec la commande @code{\times}, qui
-prend deux arguments@tie{}: une fraction et une expression musicale. La
+prend deux arguments : une fraction et une expression musicale. La
durée des notes de l'expression musicale est multipliée par la
fraction. Par exemple les notes d'un @notation{triolet} durent les
deux tiers de la durée de leur notation réelle, cette fraction est
-donc de 2/3 pour les triolets@tie{}:
+donc de 2/3 pour les triolets :
@lilypond[verbatim,quote,relative=2]
\times 2/3 { f8 g a }
\times 2/3 { d4 a8 }
@end lilypond
+
@subheading Notes d'ornement
@cindex notes d'ornement
@funindex acciaccatura
Glossaire musicologique :
-@rglosnamed{grace notes,ornements}, @rglosnamed{acciaccatura,acciacature},
+@rglosnamed{grace notes,ornements},
+@rglosnamed{acciaccatura,acciaccature},
@rglosnamed{appoggiatura,appogiature}.
Des @notation{notes d'ornement} s'obtiennent en appliquant la commande
@code{\grace}, @code{\appoggiatura} ou @code{\acciaccatura} à une
-expression musicale@tie{}:
+expression musicale :
@lilypond[verbatim,quote,relative=2]
c2 \grace { a32[ b] } c2 |
c2 \acciaccatura b16 c2 |
@end lilypond
-
@seealso
Manuel de notation :
@ruser{Notes d'ornement},
@translationof Multiple notes at once
Cette section traite de situations où l'on a plus d'une note à la
-fois@tie{}: plusieurs instruments, plusieurs voix ou portées pour un
+fois : plusieurs instruments, plusieurs voix ou portées pour un
même instrument (le piano, par exemple), et les accords.
En théorie musicale, la polyphonie désigne une musique constituée de
-plusieurs voix@tie{}; dans LilyPond, ce terme désigne les situations où
+plusieurs voix ; dans LilyPond, ce terme désigne les situations où
il y a plus d'une voix sur une même portée.
@menu
Dans les fichiers source LilyPond, la musique est représentée par ce
qu'on appelle des @emph{expressions musicales}. En soi, une seule note
-peut constituer une expression musicale@tie{}:
+peut constituer une expression musicale :
@lilypond[verbatim,quote,relative=2]
a4
Mettre un groupe de notes entre accolades crée une nouvelle expression
musicale, appelée @emph{expression musicale composée}. En voici un
-exemple avec deux notes@tie{}:
+exemple avec deux notes :
@lilypond[verbatim,quote,relative=2]
{ a4 g4 }
successivement, les unes après les autres. Le résultat est une
expression, qui peut elle-même être regroupée séquentiellement avec
d'autres expressions. Ici, l'expression de l'exemple précédent est
-combinée à deux notes@tie{}:
+combinée à deux notes :
@lilypond[verbatim,quote,relative=2]
{ { a4 g } f g }
@end lilypond
+
@subheading Analogie avec les expressions mathématiques
@cindex expression
-Ce mécanisme est similaire aux formules mathématiques@tie{}: une grosse
+Ce mécanisme est similaire aux formules mathématiques : une grosse
formule est créée en assemblant plusieurs petites formules. De telles
formules sont appelées expressions, elles ont une définition
récursive, de telle sorte que vous pouvez fabriquer des expressions
-arbitrairement longues et complexes. Par exemple@tie{}:
+arbitrairement longues et complexes. Par exemple :
@example
1
Cette technique est utile pour de la musique @notation{polyphonique}.
Pour entrer une musique avec plusieurs voix ou plusieurs portées, nous
-pouvons aussi combiner @emph{en parallèle} les expressions@tie{}: deux
+pouvons aussi combiner @emph{en parallèle} les expressions : deux
voix qui doivent être jouées en même temps, sont entrées comme une
combinaison simultanée de deux expressions. Une expression musicale
@qq{simultanée} est formée en entourant les expressions entre @code{<<}
Pour déterminer le nombre de portées, LilyPond regarde le début
de la première expression. Si c'est une seule note, une seule portée
-est produite@tie{}; si c'est une expression simultanée, plusieurs
+est produite ; si c'est une expression simultanée, plusieurs
portées sont produites. Nous avons dans l'exemple ci-dessous une
-expression complexe@tie{}; dans la mesure où elle débute par une note
+expression complexe ; dans la mesure où elle débute par une note
seule, elle sera produite sur une unique portée.
@lilypond[verbatim,quote]
}
@end lilypond
-
La commande @code{\new} introduit un @qq{contexte de notation}. Un
contexte de notation est un environnement dans lequel les événements
musicaux -- comme les notes ou les commandes @code{\clef} -- sont
@notation{accolade}. La gravure de ce type de portée est semblable à
l'exemple de musique polyphonique de @ref{Plusieurs portées}, mais
maintenant cette expression entière est interprétée dans un contexte
-@code{PianoStaff}@tie{}:
+@code{PianoStaff} :
@example
\new PianoStaff <<
@end lilypond
Vous pouvez générer d'autres formes de regroupement, avec
-@w{@code{\new GrandStaff}} pour une partition d'orchestre, ou
-@w{@code{\new ChoirStaff}} qui sied particulièrement aux partitions
+@code{\new GrandStaff} pour une partition d'orchestre, ou
+@code{\new ChoirStaff} qui sied particulièrement aux partitions
chorales. Chacun de ces regroupements constitue un contexte à part
entière, avec ses particularités, tant au niveau du signe qui regroupe
les portées au sein d'un @notation{système} qu'au niveau de l'étendue
des barres de mesure.
-
@seealso
Manuel de notation :
@ruser{Instruments utilisant des portées multiples},
Beaucoup d'éléments de notation que l'on peut attacher à une note
simple, comme une liaison, un crochet indiquant un début ou une fin de
lien, un signe d'articulation, peuvent être également attachés à un
-accord@tie{}: il faut ajouter ces indications après les hauteurs et la
+accord : il faut ajouter ces indications après les hauteurs et la
durée, donc @emph{à l'extérieur} des chevrons.
@lilypond[verbatim,quote,relative=2]
Des @notation{paroles} peuvent être associées à ces notes, en les
combinant avec la commande @code{\addlyrics}. On entre les paroles en
-séparant chaque syllable par une espace@tie{}:
+séparant chaque syllable par une espace :
@lilypond[verbatim,quote]
<<
au risque de voir apparaître une
@rprogram{Erreur renvoyant à ../ly/init.ly}.}
-
Notez les doubles chevrons @w{@code{<< ... >>}} encadrant
-toute la pièce@tie{}; ils indiquent simplement que la musique et les
+toute la pièce ; ils indiquent simplement que la musique et les
paroles se produisent en même temps.
+
@node Alignement des paroles sur une mélodie
@subsection Alignement des paroles sur une mélodie
@translationof Aligning lyrics to a melody
>>
@end lilypond
-Si vous compilez ce code en l'état, vous verrez apparaître@tie{}:
+Si vous compilez ce code en l'état, vous verrez apparaître :
@example
song.ly:12:29: Avertissement : échec du contrôle de mesure (barcheck) à : 5/8
|
@end example
-Voici qui illustre bien l'utilité des contrôles de barre de
-mesure@tie{}! Remarquez que les paroles ajoutées ne s'alignent pas bien
-avec les notes. Le mot @emph{shine} devrait être chanté sur deux notes
-au lieu d'une. On appelle ceci un @notation{mélisme}@tie{}: il s'agit
-d'une seule syllabe chantée sur plus d'une note. Il existe plusieurs
-façons d'étaler une sylabe sur plusieurs notes, la plus simple étant de
-lier les notes du mélisme. Pour les détails, consultez @ref{Liaisons}.
+Voici qui illustre bien l'utilité des contrôles de barre de mesure !
+Remarquez que les paroles ajoutées ne s'alignent pas bien avec les
+notes. Le mot @emph{shine} devrait être chanté sur deux notes au lieu
+d'une. On appelle ceci un @notation{mélisme} : il s'agit d'une seule
+syllabe chantée sur plus d'une note. Il existe plusieurs façons
+d'étaler une syllabe sur plusieurs notes, la plus simple étant de lier
+les notes du mélisme. Pour les détails, consultez @ref{Liaisons}.
@lilypond[verbatim,quote]
<<
Les paroles sont maintenant correctement alignées, mais les liens de
croche automatiques ne conviennent pas pour les notes au-dessus de
@emph{shine as}. On peut les corriger en ajoutant des liens de croche
-manuels@tie{}; pour ceci consultez
+manuels ; pour ceci consultez
@ref{Barres de ligature automatiques et manuelles}.
@lilypond[verbatim,quote]
@end lilypond
Avec certaines paroles, en particulier en italien, il se produit la
-situation inverse@tie{}: il peut y avoir plusieurs syllabes sur une
-seule note. On réalise ceci avec LilyPond grâce à un caractère souligné
+situation inverse : il peut y avoir plusieurs syllabes sur une seule
+note. On réalise ceci avec LilyPond grâce à un caractère souligné
@code{_} sans espace entre les syllabes, ou alors en groupant les
-syllabes avec des guillemets. L'exemple suivant est extrait de l'air
-de Figaro @emph{Largo al factotum}, dans @notation{Figaro} de Rossini, où
+syllabes avec des guillemets. L'exemple suivant est extrait de l'air de
+Figaro @emph{Largo al factotum}, dans @notation{Figaro} de Rossini, où
la syllabe @emph{al} est chantée sur la même note que @emph{go}.
@c no ragged-right here because otherwise the hyphens get lost,
>>
@end lilypond
-
@seealso
Manuel de notation :
@ruser{Musique vocale}.
@subsection Paroles pour plusieurs portées
@translationof Lyrics to multiple staves
-@cindex paroles et portées mutiples
+@cindex paroles et portées multiples
@cindex portées multiples et paroles
La méthode simple d'ajout de paroles avec @code{\addlyrics} peut être
Pour produire des partitions plus complexes ou plus longues que cet
exemple simple, il est vivement conseillé de séparer la structure de
la partition des notes et paroles, grâce à des variables. Ceci sera
-détaillé plus loin dans @ref{Organisation du code source avec des variables}.
-
+détaillé plus loin dans
+@ref{Organisation du code source avec des variables}.
@seealso
Manuel de notation :
En utilisant des variables, parfois appelées identificateurs ou
macros, on peut scinder des expressions musicales complexes en des
-expressions plus simples. Une variable se définit comme suit@tie{}:
+expressions plus simples. Une variable se définit comme suit :
@example
musiqueToto = @{ @dots{} @}
alphabétiques non accentués, aucun nombre ni tiret ne sont autorisés.
On peut utiliser une variable déjà définie autant de fois que l'on
-veut, y compris dans la définition d'une nouvelle variable@tie{}; par
+veut, y compris dans la définition d'une nouvelle variable ; par
exemple, cela peut servir à saisir un motif qu'une seule fois, même
s'il se répète un grand nombre de fois dans la pièce.
Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour
définir les hauteurs de notes. Si c'est souvent le moyen le plus
simple de saisir la musique au clavier, il existe une autre façon de
-procéder@tie{}: le mode de hauteurs absolues.
+procéder : le mode de hauteurs absolues.
Si vous omettez la commande @code{\relative}, LilyPond considérera
toutes les hauteurs comme des hauteurs absolues. Un @code{c'} désigne
}
@end lilypond
-Voici une gamme sur 4 octaves :
+Voici une gamme sur quatre octaves :
@lilypond[verbatim,quote]
{
@end lilypond
Si d'aventure vous faites une erreur d'octaviation, le mode
-@code{\relative} la mettra en évidence@tie{}: toutes les notes suivantes
+@code{\relative} la mettra en évidence : toutes les notes suivantes
seront placées à la mauvaise octave. En mode de hauteurs absolues,
une erreur isolée ne serait pas autant visible, et serait donc plus
difficile à dénicher.
Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5
du manuel d'initiation. Rien ne s'oppose à ce que vous consultiez dès
-à présent ces chapitres, bien sûr@tie{}! Néanmoins, le reste du manuel
+à présent ces chapitres, bien sûr ! Néanmoins, le reste du manuel
d'initiation part du principe que vous avez déjà bien assimilé la
syntaxe de base de LilyPond. Vous pouvez toujours survoler ces
chapitres 3 à 5, et y revenir plus tard après avoir acquis de
Dans ce tutoriel comme dans le reste de ce manuel, se trouve à chaque
section un paragraphe @strong{Voir aussi} contenant des références
-vers d'autres sections@tie{}: il est conseillé de ne pas les suivre en
-première lecture@tie{}; lorsque vous aurez lu l'ensemble du manuel
+vers d'autres sections : il est conseillé de ne pas les suivre en
+première lecture ; lorsque vous aurez lu l'ensemble du manuel
d'initiation, vous pourrez en relisant certaines sections suivre ces
références pour approfondir certains aspects.
Si vous ne l'avez pas encore fait, lisez
@ref{Vue d'ensemble des manuels}. Les sources de documentation et
d'information sur LilyPond sont vastes, il est normal pour un débutant
-de ne pas savoir où chercher@tie{}; si vous passez quelques minutes à
+de ne pas savoir où chercher ; si vous passez quelques minutes à
lire attentivement cette section, vous vous épargnerez certainement la
frustration causée par des heures de recherches infructueuses.
@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+
@ignore
- Translation of GIT committish: 952705bbbb000581a13836e6a733df04511e93c5
+ Translation of GIT committish: 8df40d45e4366f4e9baa2cec3b7eb38b6482150f
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
* Extension des modèles::
@end menu
+
@node Organisation des fichiers LilyPond
@section Organisation des fichiers LilyPond
@translationof How LilyPond input files work
* Non-imbrication des crochets et liaisons::
@end menu
+
@node Introduction à la structure de fichier LilyPond
@subsection Introduction à la structure de fichier LilyPond
@translationof Introduction to the LilyPond file structure
@cindex format d'entrée
@cindex structure de ficher
-Un fichier d'entrée LilyPond ressemble à@tie{}:
+Un fichier d'entrée LilyPond ressemble à :
@example
\version @w{"@version{}"}
@end example
@noindent
-Dès lors que tout cela est entre accolades@tie{}: @code{@{ @dots{} @}},
+Dès lors que tout cela est entre accolades : @code{@{ @dots{} @}},
LilyPond le considère comme une et une seule expression musicale.
Comme nous l'avons vu précédemment, un bloc @code{\score} peut contenir
-d'autres informations@tie{}:
+d'autres informations :
@example
\score @{
@noindent
Gardez à l'esprit que ces trois commandes -- @code{\header},
-@code{\layout} et @code{\midi} -- sont spécifiques@tie{}: à l'inverse de
+@code{\layout} et @code{\midi} -- sont spécifiques : à l'inverse de
toutes les commandes débutant par une oblique inversée @code{\}
(@emph{backslash} en anglais), @strong{elles ne constituent pas} des
expressions musicales et ne peuvent pas faire partie d'expressions
(@emph{recueil} ou @emph{ouvrage}) n'est pas obligatoire -- elle sera
créée implicitement. Néanmoins, le recours à la commande @code{\book}
vous permettra d'obtenir des fichiers résultants distincts à partir
-d'un même fichier source @file{.ly} -- par exemple un fichier par pupitre.
+d'un même fichier source @file{.ly} -- par exemple un fichier par
+pupitre.
En résumé :
-Dès que LilyPond rencontre un bloc @code{\book}, il crée un
-fichier distinct (@file{.pdf} par exemple). Dans le cas où il n'est pas
+Dès que LilyPond rencontre un bloc @code{\book}, il crée un fichier
+distinct (@file{.pdf} par exemple). Dans le cas où il n'est pas
mentionné explicitement, LilyPond regroupera l'intégralité du code dans
un bloc @code{\book}.
@cindex layout, effets selon l'emplacement
Tout bloc @code{\layout} affecte le bloc @code{\score} ou @code{\book}
-au sein duquel il intervient@tie{}: si c'est à l'intérieur d'un bloc
+au sein duquel il intervient : si c'est à l'intérieur d'un bloc
@code{\score}, seul celui-ci en sera affecté. Dans le cas où le bloc
@code{\layout} se trouve à l'extérieur du bloc @code{\score}, que le
bloc @code{\book} soit explicite ou non, il affectera chacun des
Un autre raccourci pratique est la possibilité de définir
des variables, également appelées @qq{identificateurs} -- voir
@ref{Organisation du code source avec des variables} à ce sujet. Dans
-tous les modèles, vous trouverez@tie{}:
+tous les modèles, vous trouverez :
@example
melodie = \relative c' @{
@end example
Lorsque LilyPond examinera ce fichier, il va prendre la valeur de la
-variable @code{melodie}, c'est-à-dire tout ce qui suit le signe @code{=},
-et l'insérer partout où il rencontrera @code{\melodie}. Vous êtes
-libre de choisir comment dénommer vos variables@footnote{Les noms de
-variables sont sensibles à la casse, et ne peuvent contenir ni
-chiffre, ni ponctuation, ni caractère accentué, ni espace.}@tie{}; ce
-peut être @code{melodie}, @code{global}, @code{maindroitepiano}, ou
+variable @code{melodie}, c'est-à-dire tout ce qui suit le signe
+@code{=}, et l'insérer partout où il rencontrera @code{\melodie}. Vous
+êtes libre de choisir comment dénommer vos variables@footnote{Les noms
+de variables sont sensibles à la casse, et ne peuvent contenir ni
+chiffre, ni ponctuation, ni caractère accentué, ni espace.} ; ce peut
+être @code{melodie}, @code{global}, @code{maindroitepiano}, ou
@code{laTeteAToto}, tant qu'il ne s'agit pas de @qq{mot réservé}. Pour
plus de détails, voir
@ref{Économie de saisie grâce aux identificateurs et fonctions}.
-
@seealso
Pour une description complète du format des fichiers d'entrée, voir
@ruser{Structure de fichier}.
Dans la section précédente,
@ref{Introduction à la structure de fichier LilyPond}, nous
avons vu l'organisation générale des fichiers d'entrée de LilyPond.
-Mais c'est comme si nous avions éludé la question essentielle@tie{}:
-comment diable peut-on savoir quoi mettre après @code{\score}@tie{}?
+Mais c'est comme si nous avions éludé la question essentielle :
+comment diable peut-on savoir quoi mettre après @code{\score} ?
-En fait, nous ne l'avons pas éludée du tout@tie{}: le grand mystère est
+En fait, nous ne l'avons pas éludée du tout : le grand mystère est
tout simplement qu'@strong{il n'y a pas} de mystère. Allez,
-expliquons-le en une ligne@tie{}:
+expliquons-le en une ligne :
@quotation
@emph{Un bloc @code{\score} doit commencer par une et une seule
Peut-être serait-il judicieux de relire la section
@ref{Les expressions musicales en clair}, dans laquelle vous avez
appris à construire de grandes expressions musicales petit bout
-par petit bout -- nous avons vu les notes, puis les accords, etc.
+par petit bout -- nous avons vu les notes, puis les accords, etc.
Maintenant, nous allons partir d'une grande expression musicale,
et remonter la pente. Pour rester simple, nous nous contenterons d'un
chanteur accompagné au piano. On n'a pas besoin d'une partition
Nous avons ici attribué des noms aux portées -- @qq{chanteur} et
@qq{piano}. Bien que cela ne soit pas primordial, c'est une
-habitude qu'il est bon d'adopter dès le départ@tie{}: vous saurez au
+habitude qu'il est bon d'adopter dès le départ : vous saurez au
premier coup d'œil à quoi correspond chaque portée.
Vous vous souvenez que nous avons recours à @code{<<} et @code{>>}
-en lieu et place de @code{@{ @dots{} @}} pour gérer des musiques
+en lieu et place de @code{@{ @dots{} @}} pour gérer des musiques
simultanées. Et, pour le coup, on aimerait @emph{vraiment} que la
partie vocale et l'accompagnement soient imprimés ensemble@dots{} Bien
-que faire appel à @code{<< ... >>} ne soit pas réellement nécessaire
+que faire appel à @code{<< @dots{} >>} ne soit pas réellement nécessaire
pour la portée du chanteur, dans la mesure où elle ne contient qu'une
seule expression musicale, nous vous recommandons de prendre l'habitude
de l'encadrer ainsi plutôt que par de simples accolades -- une portée
partie du chanteur, qui contient un ensemble @code{Voice}, ce qui dans
LilyPond correspond à une voix, au sens de voix d'une polyphonie plutôt
que de voix chantée -- ce pourrait être une partie de violon par
-exemple --, et des paroles.
-Nous avons également une partie de piano, qui contient deux
-portées@tie{}: une pour la main droite, une autre pour la main gauche.
-Il nous faudra d'ailleurs ajouter une clef de fa à cette dernière.
+exemple --, et des paroles. Nous avons également une partie de piano,
+qui contient deux portées : une pour la main droite, une autre pour la
+main gauche. Il nous faudra d'ailleurs ajouter une clef de fa à cette
+dernière.
À ce point, on pourrait commencer à ajouter les notes. Dans les
-accolades qui suivent @code{\new Voice = "chant"}, on pourrait
+accolades qui suivent @code{\new Voice = "chant"}, on pourrait
commencer à écrire
@example
différents types de données -- voir @ruser{Modes de saisie} pour plus de
détails.
-Avec quelques notes de plus et une clef de fa, nous pourrions
-avoir@tie{}:
+Avec quelques notes de plus et une clef de fa, nous pourrions avoir :
@lilypond[verbatim,quote,ragged-right]
melody = \relative c'' { r4 d8\noBeam g, c4 r }
Quand on écrit ou que l'on lit une section @code{\score}, mieux vaut
y aller lentement et soigneusement. Commencez par le niveau le plus
large, puis travaillez sur chaque niveau plus détaillé. À ce propos,
-une indentation stricte et propre est vraiment d'une aide
-précieuse@tie{}: assurez-vous que chaque élément d'un même niveau a le
-même décalage horizontal dans votre éditeur de texte@tie{}!
-
+une indentation stricte et propre est vraiment d'une aide précieuse :
+assurez-vous que chaque élément d'un même niveau a le même décalage
+horizontal dans votre éditeur de texte !
@seealso
Manuel de notation :
@cindex ossias
Déclarer toutes les portées dès le départ n'est pas une
-obligation@tie{}; elles peuvent intervenir temporairement n'importe où
+obligation ; elles peuvent intervenir temporairement n'importe où
dans la partition. Ceci est tout à fait indiqué pour créer des sections
@rglos{ossia}. L'exemple suivant illustre la manière de créer
-temporairement une nouvelle portée, l'espace de trois notes@tie{}:
+temporairement une nouvelle portée, l'espace de trois notes :
@lilypond[verbatim,quote,ragged-right]
\new Staff {
@cindex portée, positionnement
-Une section ossia se placera au dessus de la portée en procédant
-ainsi@tie{}:
+Une section ossia se placera au dessus de la portée en procédant ainsi :
@lilypond[verbatim,quote,ragged-right]
\new Staff = "main" {
placer au-dessus de la portée @qq{principal} plutôt qu'en dessous, ce
qui est le comportement par défaut.
-
@seealso
Les ossias apparaissent souvent sans clef ni métrique, et dans une
taille plus petite. Ceci requiert des commandes dont nous n'avons pas
Nous avons déjà rencontré plusieurs types de crochets au fil de nos
fichiers LilyPond. Ils obéissent à des règles différentes qui peuvent
paraître déroutantes de prime abord. Avant d'examiner ces règles, voici
-une liste des différents types de crochet@tie{}:
+une liste des différents types de crochet :
@c attempt to force this onto a new page
@need 50
@end multitable
D'autres constructions permettent d'obtenir des lignes regroupant ou en
-travers des notes@tie{}: les liaisons de prolongation indiquées par un
-tilde (@code{~}), les marques de nolet avec
-@w{@code{\times x/y @{..@}}}, ou
+travers des notes : les liaisons de prolongation indiquées par un tilde
+(@code{~}), les marques de nolet avec @code{\times x/y @{..@}}, ou
encore les notes d'ornement avec @code{\grace@{..@}}.
En dehors de LilyPond, l'imbrication correcte de différents types de
crochets exige un strict respect des conventions, telles que
-@code{<<@tie{}[@tie{}@{@tie{}(@tie{}..@tie{})@tie{}@}@tie{}]@tie{}>>},
-où les marques de fermeture interviennent
+@code{<< [ @{ ( .. ) @} ] >>}, où les marques de fermeture interviennent
obligatoirement dans l'ordre exactement inverse à celles d'ouverture.
-Ceci @strong{doit} être rigoureusement respecté pour les trois
-types de crochets utilisés pour @strong{délimiter} comme l'indique le
-tableau ci-dessus.
-Une telle rigueur dans l'imbrication n'est @strong{pas} requise pour les
-types de crochets dont la fonction est de @strong{marquer}, selon le
-tableau ci-dessus, lorsqu'il sont utilisés en combinaison avec des
-liaisons de prolongation ou des nolets. En effet, il ne s'agit pas
-de crochets ayant pour fonction de borner quelque chose@tie{}; ils
-agissent plutôt comme marquant le début de quelque chose et sa fin.
+Ceci @strong{doit} être rigoureusement respecté pour les trois types de
+crochets utilisés pour @strong{délimiter} comme l'indique le tableau
+ci-dessus. Une telle rigueur dans l'imbrication n'est @strong{pas}
+requise pour les types de crochets dont la fonction est de
+@strong{marquer}, selon le tableau ci-dessus, lorsqu'il sont utilisés en
+combinaison avec des liaisons de prolongation ou des nolets. En effet,
+il ne s'agit pas de crochets ayant pour fonction de borner quelque
+chose ; ils agissent plutôt comme marquant le début de quelque chose et
+sa fin.
Ainsi, et bien que ce ne soit pas très musical, une liaison de phrasé
peut débuter avant l'insertion d'une ligature manuelle et s'arrêter
-avant la fin de la ligature@tie{}:
+avant la fin de la ligature :
@lilypond[quote,verbatim,ragged-right,relative=2]
g8\( a b[ c b\) a] g4
@section Les voix contiennent la musique
@translationof Voices contain music
-Les chanteurs utilisent leur voix pour chanter@tie{}; il en va de même
+Les chanteurs utilisent leur voix pour chanter ; il en va de même
pour LilyPond. En fait, la musique de chacun des instruments d'une
partition est contenue dans des voix (@emph{Voices} en anglais), qui
se trouvent être le concept fondamental de LilyPond.
* Voix et paroles::
@end menu
+
@node J'entends des Voix
@subsection J'entends des Voix
@translationof I'm hearing Voices
Dans une partition gérée par LilyPond, le niveau le plus bas, ou bien
élémentaire ou fondamental, est le @qq{contexte de voix} -- @emph{Voice
-context} en anglais --. Pour d'autres logiciels, on fait tantôt
-référence à la notion de @qq{couche} ou de @qq{calque}.
+context} en anglais. Pour d'autres logiciels, on fait tantôt référence
+à la notion de @qq{couche} ou de @qq{calque}.
En réalité, le contexte de voix est le seul à pouvoir contenir de la
musique. S'il n'est pas déclaré explicitement, il sera créé
Si une voix unique peut tout à fait contenir plusieurs notes dans un
accord, à partir de quand aurons-nous vraiment besoin de plusieurs
-voix@tie{}? Considérons déjà ces quatre accords@tie{}:
+voix ? Considérons déjà ces quatre accords :
@lilypond[quote,verbatim,ragged-right,relative=1]
\key g \major
@end lilypond
Nous exprimons ici chacun des accords par l'utilisation de
-chevrons gauche et droite simples, @w{@code{< ... >}}, puisque nous
+chevrons gauche et droite simples, @code{< @dots{} >}, puisque nous
n'avons besoin que d'une seule voix. Supposons maintenant que le fa
dièse soit une croche, suivie d'un sol croche -- une note de passage
-vers le la@tie{}? Nous avons alors deux notes qui débutent au même
-moment, mais dont la durée est différente@tie{}: un ré noire et un fa
-dièse croche. Comment coder cela@tie{}? Dans la mesure où toutes les
-notes d'un accord doivent avoir la même durée, nous ne pouvons pas
-écrire un accord. Nous ne pouvons pas non plus écrire deux notes
-séparées, puisqu'elles débutent en même temps. Nous avons alors besoin
-de deux voix.
+vers le la ? Nous avons alors deux notes qui débutent au même moment,
+mais dont la durée est différente : un ré noire et un fa dièse croche.
+Comment coder cela ? Dans la mesure où toutes les notes d'un accord
+doivent avoir la même durée, nous ne pouvons pas écrire un accord. Nous
+ne pouvons pas non plus écrire deux notes séparées, puisqu'elles
+débutent en même temps. Nous avons alors besoin de deux voix.
Voyons comment cela se pratique selon la grammaire de LilyPond.
polyphonie.
Voici comment éclater les accords en deux voix, avec la note de passage
-et la liaison@tie{}:
+et la liaison :
@lilypond[quote,verbatim,ragged-right,relative=2]
\key g \major
Le recours à une construction @code{<< \\ >>} particulière à chaque
mesure n'est pas nécessaire. Bien qu'on y gagne en lisibilité si chaque
mesure ne contient que quelques notes, il est plus judicieux de
-carrément séparer chaque voix@tie{}:
+carrément séparer chaque voix :
@lilypond[quote,verbatim,ragged-right,relative=2]
\key d \minor
} >>
@end lilypond
-
@cindex voix, nommage
@cindex voix et constructions simultanées
@cindex liaisons et constructions simultanées
traiter trois voix ou plus en ajoutant autant de séparateurs @code{\\}
que de besoin.
-Les contextes @code{Voice} portent les noms @code{"1"}, @code{"2"}, etc.
+Les contextes @code{Voice} portent les noms @code{"1"}, @code{"2"}, etc.
Les premiers contextes définissent les voix @emph{extrêmes}, la plus
haute au contexte @code{"1"}, le plus basse au contexte @code{"2"}. Les
voix intermédiaires seront affectées aux contextes @code{"3"} et
@code{"4"}. Pour chacun de ces contextes, le positionnement et
-l'orientation des liaisons, hampes, nuances, etc. est définie
+l'orientation des liaisons, hampes, nuances, etc. est définie
automatiquement.
@lilypond[quote,verbatim]
notes en dehors de la construction @code{<<...>>} -- que nous
appellerons @emph{construction simultanée}. Les liaisons, de
prolongation ou non, ne peuvent relier des notes que si elles
-appartiennent à la même voix@tie{}; elles ne peuvent ni pénétrer une
+appartiennent à la même voix ; elles ne peuvent ni pénétrer une
construction simultanée, ni en sortir. Inversement, les voix parallèles
issues de constructions simultanées apparaissant sur une même portée
appartiennent à la même voix. Les autres propriétés liées au contexte
permettre une meilleure distinction entre les différentes voix. La
première voix comporte des têtes en losange rouge, la deuxième en
triangle bleu, la troisième en cercle barré vert, la quatrième (non
-utilisée ici) en croix magenta@tie{}; @code{\voiceNeutralStyle} (non
-utilisé ici) revient au style par défaut. Nous verrons plus tard
-comment créer de telles commandes.
-Voir @ref{Visibilité et couleur des objets} et
+utilisée ici) en croix magenta ; @code{\voiceNeutralStyle} (non utilisé
+ici) revient au style par défaut. Nous verrons plus tard comment créer
+de telles commandes. Voir @ref{Visibilité et couleur des objets} et
@ref{Utilisation de variables dans les retouches}.
@cindex polyphonie et mode relatif
Une méthode alternative, et qui peut simplifier les choses si les notes
des différentes voix sont espacées, consiste à placer une commande
-@code{\relative} au début de chacune des voix@tie{}:
+@code{\relative} au début de chacune des voix :
@example
\relative c' @{ noteA ... @}
Mais le réel besoin de multiples voix se fait sentir dès lors que
plusieurs notes qui débutent en même temps ont des durées différentes.
-C'est évident au troisième temps de la première mesure@tie{}: le la
-bémol est une noire pointée, le fa une noire, et le ré bémol une
-blanche. On ne peut les grouper dans un accord, puisque toutes les
-notes composant un accord doivent être de même durée. On ne peut non
-plus les écrire séquentiellement, puisqu'elles débutent toutes au même
-instant. Ce fragment de mesure nécessite trois voix, et une bonne
-pratique voudrait que l'intégralité de la mesure soit sur trois voix,
-comme ci-dessous où nous avons une allure et une couleur différentes aux
-notes de chacune d'entre elles. Une fois de plus, nous reviendrons plus
-tard sur le code que vous ne comprendriez pas.
+C'est évident au troisième temps de la première mesure : le la bémol est
+une noire pointée, le fa une noire, et le ré bémol une blanche. On ne
+peut les grouper dans un accord, puisque toutes les notes composant un
+accord doivent être de même durée. On ne peut non plus les écrire
+séquentiellement, puisqu'elles débutent toutes au même instant. Ce
+fragment de mesure nécessite trois voix, et une bonne pratique voudrait
+que l'intégralité de la mesure soit sur trois voix, comme ci-dessous où
+nous avons une allure et une couleur différentes aux notes de chacune
+d'entre elles. Une fois de plus, nous reviendrons plus tard sur le code
+que vous ne comprendriez pas.
@c The following should appear as music without code
@c The three voice styles should be defined in -init
Essayons à présent de coder cette musique en partant de zéro. Comme
nous le verrons, certaines difficultés vont se présenter. Partons de ce
-que nous avons appris@tie{}: utilisons la construction
-@code{<<@tie{}\\@tie{}>>} pour saisir la première mesure dans trois
-voix@tie{}:
+que nous avons appris : utilisons la construction @code{<< \\ >>} pour
+saisir la première mesure dans trois voix :
@lilypond[quote,verbatim,ragged-right]
\new Staff \relative c'' {
@cindex voix et direction des hampes
@cindex direction des hampes et voix
-La direction des hampes est attribuée automatiquement@tie{}: les voix
+La direction des hampes est attribuée automatiquement : les voix
impaires portent des hampes vers le haut, les voix paires des hampes
vers le bas. Les hampes des voix 1 et 2 sont orientées comme il faut
mais celles de la voix 3 devraient, dans le cas qui nous occupe, aller
vers le bas. Nous pouvons corriger cela en sautant la voix 3 et en
-plaçant la musique dans la voix 4 grâce à un @code{\\}
-supplémentaire@tie{}:
+plaçant la musique dans la voix 4 grâce à un @code{\\} supplémentaire :
@lilypond[quote,verbatim,ragged-right]
\new Staff \relative c'' {
viendrait à chevaucher celles des voix extrêmes. Bien entendu, ce n'est
pas souhaitable dans le cas d'une partition pour piano. Dans d'autres
situations, les décalages que LilyPond applique peuvent ne pas éviter
-certaines collisions. LilyPond met à notre disposition plusieurs
-moyens d'ajuster le positionnement horizontal des notes. Nous ne sommes
-pas encore tout à fait prêts pour voir comment corriger cela, aussi nous
+certaines collisions. LilyPond met à notre disposition plusieurs moyens
+d'ajuster le positionnement horizontal des notes. Nous ne sommes pas
+encore tout à fait prêts pour voir comment corriger cela, aussi nous
examinerons ce problème dans un autre chapitre (voir la propriété
@code{force-hshift} dans @ref{Correction des collisions d'objets}).
-@warning{Paroles et objets étendus (liaisons, soufflets etc.) ne peuvent
+@warning{Paroles et objets étendus (liaisons, soufflets, etc.) ne peuvent
passer d'une voix à l'autre.}
-
@seealso
Manuel de notation :
@ruser{Plusieurs voix}.
@cindex Voice, création de contextes
Les contextes @rinternals{Voice} peuvent être déclarés manuellement
-dans un bloc @code{@w{<< >>}} pour créer de la musique polyphonique, en
-utilisant @code{\voiceOne}, @dots{} jusqu'à @code{\voiceFour} pour
+dans un bloc @code{<< >>} pour créer de la musique polyphonique, en
+utilisant @code{\voiceOne}@dots{} jusqu'à @code{\voiceFour} pour
assigner des directions de hampes et un déplacement horizontal pour
chaque partie. Cette méthode apporte de la clarté pour des partitions
plus importantes puisqu'elle permet de bien séparer les voix et de leur
affecter un nom plus parlant.
En particulier, la construction @code{<< \\ >>} que nous avons vue
-précédemment@tie{}:
+précédemment :
@example
\new Staff @{
polyphonique, à partir d'un exemple de la section précédente. Chacune
d'elles aura ses avantages selon les circonstances.
-Une expression séquentielle qui apparaît en premier dans un @code{<< >>}
--- attention, @strong{pas} dans une construction @code{<< \\ >>} --
+Une expression séquentielle qui apparaît en premier dans un @code{<< >>}
+-- attention, @strong{pas} dans une construction @code{<< \\ >>} --
appartient à la voix principale. Ceci est utile lorsque des voix
supplémentaires apparaissent pendant que la voix principale est jouée.
-Voici une meilleure réalisation de notre exemple.
-Les notes colorées et en croix mettent en évidence le fait que la
-mélodie principale est maintenant dans un seul contexte de voix, ce qui
-permet d'ajouter une liaison de phrasé à l'ensemble.
+Voici une meilleure réalisation de notre exemple. Les notes colorées et
+en croix mettent en évidence le fait que la mélodie principale est
+maintenant dans un seul contexte de voix, ce qui permet d'ajouter une
+liaison de phrasé à l'ensemble.
@lilypond[quote,ragged-right,verbatim]
\new Staff \relative c' {
{ g4 f e | d2 e) | }
% Initiate second voice
\new Voice {
- % Set stems, etc., down
+ % Set stems, etc., down
\voiceTwo
r8 e4 d c8~ | c8 b16 a b8 g~ g2 |
}
@cindex voix temporaires
@cindex voix, imbrication
-
Dans certaines circonstances de polyphonie complexe, vous pourrez être
amené à recourir à une voix temporaire, ce qui peut être une manière
-plus naturelle de saisir la musique@tie{}:
+plus naturelle de saisir la musique :
@lilypond[quote,ragged-right,verbatim]
\new Staff \relative c' {
>>
@end lilypond
+
@subsubheading Empilement des notes
@translationof Note columns
l'attribution d'un décalage à une voix en particulier s'appliquera à
l'empilement en question s'il y avait risque de collision.
Nous en avons une illustration à la deuxième mesure de l'exemple
-ci-dessus@tie{}: le do de la deuxième voix est décalé à droite du ré de
+ci-dessus : le do de la deuxième voix est décalé à droite du ré de
la première voix et, dans l'accord final, le do de la troisième voix est
lui aussi décalé à droite des autres notes.
-Les commandes @code{\shiftOn}, @code{\shiftOnn}, @code{\shiftOnnn}, et
+Les commandes @code{\shiftOn}, @code{\shiftOnn}, @code{\shiftOnnn} et
@code{\shiftOff} spécifient le degré nécessaire de décalage qui sera
appliqué aux notes ou accords de la voix en question afin d'éviter une
collision. Par défaut, les voix extérieures -- normalement les
identiques, LilyPond vous le signalera par le message @qq{Trop
d'empilements en conflit}.
-
@seealso
Manuel de notation :
@ruser{Plusieurs voix}.
@subsection Voix et paroles
@translationof Voices and vocals
-La musique vocale est une gageure en soi@tie{}: il nous faut combiner
+La musique vocale est une gageure en soi : il nous faut combiner
deux expressions différentes -- des notes et des paroles.
@funindex \new Lyrics
gérer des partitions simples. Cette technique est cependant
relativement limitée. Pour de la musique un peu plus compliquée, il
vous faudra contenir les paroles dans un contexte @code{Lyrics}, créé
-par la commande @code{\new Lyrics}@tie{}; vous relierez ensuite ces
-paroles aux notes grâce à la commande @code{\lyricsto@{@}} et au nom
-assigné à la voix en question.
+par la commande @code{\new Lyrics} ; vous relierez ensuite ces paroles
+aux notes grâce à la commande @code{\lyricsto@{@}} et au nom assigné à
+la voix en question.
@lilypond[quote,verbatim]
<<
@funindex \autoBeamOff
@funindex autoBeamOff
-Si la ligature automatique que LilyPond applique par défaut
-est pleinement adaptée en matière de musique instrumentale, il
-n'en va pas de même dans le cas d'une musique associée à des paroles,
-et pour laquelle soit les ligatures sont carrément absentes, soit elles
-servent à indiquer un mélisme -- plusieurs notes pour une même syllabe.
+Si la ligature automatique que LilyPond applique par défaut est
+pleinement adaptée en matière de musique instrumentale, il n'en va pas
+de même dans le cas d'une musique associée à des paroles, et pour
+laquelle soit les ligatures sont carrément absentes, soit elles servent
+à indiquer un mélisme -- plusieurs notes pour une même syllabe.
Dans l'exemple qui suit, nous utilisons la commande @code{\autoBeamOff}
afin de désactiver les ligatures automatiques.
}
@end lilypond
-
@seealso
Manuel de notation :
@ruser{Musique vocale}.
@translationof Contexts and engravers
Nous avons évoqué rapidement les contextes et graveurs dans les
-chapitres précédents@tie{}; examinons en détail ces concepts essentiels
+chapitres précédents ; examinons en détail ces concepts essentiels
à la maîtrise de LilyPond.
@menu
* Ajout et suppression de graveurs::
@end menu
+
@node Tout savoir sur les contextes
@subsection Tout savoir sur les contextes
@translationof Contexts explained
Imprimer de la musique impose d'ajouter un certain nombre d'éléments de
notation. Par exemple, voici un fragment de partition, précédé du code
-qui l'engendre@tie{}:
+qui l'engendre :
@lilypond[quote,verbatim,relative=2]
cis4 cis2. | a4 a2. |
Si le code est assez austère, dans la partition ont été ajoutés un
chiffre de mesure, des barres de mesure, des altérations et une clé.
-Pour une bonne raison@tie{}: LilyPond @emph{interprète} le code. Il le
+Pour une bonne raison : LilyPond @emph{interprète} le code. Il le
compulse dans l'ordre chronologique, de même qu'on lit une partition de
-gauche à droite@tie{}; et pendant ce traitement, le logiciel garde en
+gauche à droite ; et pendant ce traitement, le logiciel garde en
mémoire les limites des mesures, ou encore quelles hauteurs de note
demandent des altérations accidentelles. Ces informations se présentent
-à plusieurs niveaux@tie{}: ainsi, une altération n'a d'effet que sur une
+à plusieurs niveaux : ainsi, une altération n'a d'effet que sur une
seule portée, tandis qu'une barre de mesure doit être synchronisée sur
toute l'étendue verticale de la partition.
@emph{Contextes}. Certains contextes sont les voix (contexte
@code{Voice}), les portées (contexte @code{Staff}), ou la partition dans
son ensemble (contexte @code{Score}). Ils sont ordonnés
-hiérarchiquement@tie{}: ainsi un contexte @code{Staff} peut contenir
+hiérarchiquement : ainsi un contexte @code{Staff} peut contenir
plusieurs contextes @code{Voice}, et un contexte @code{Score} peut
contenir plusieurs contextes @code{Staff}.
dans la suite de la mesure.
Les barres de mesure, quant à elles, sont alignées verticalement grâce
-au contexte @code{Score} par défaut.
-En revanche, dans une musique polymétrique, par exemple mêlant une
-portée à 3/4 et une autre à 4/4, les barres de mesures n'ont plus à être
-alignées@tie{}: il faut alors modifier les comportement par défaut des
-contextes @code{Score} et @code{Staff}.
+au contexte @code{Score} par défaut. En revanche, dans une musique
+polymétrique, par exemple mêlant une portée à 3/4 et une autre à 4/4,
+les barres de mesures n'ont plus à être alignées : il faut alors
+modifier les comportement par défaut des contextes @code{Score} et
+@code{Staff}.
Dans une partition très simple, les contextes sont créés implicitement
et peuvent être ignorés. Mais lorsqu'il s'agit de morceaux plus amples
@code{PianoStaff} ou @code{ChoirStaff}. Vous disposez aussi d'autres
contextes de portée ou de voix alternatifs, ainsi que des contextes
spécifiques pour les paroles, les percussions, les diagrammes pour
-instruments frettés, la basse chiffrée, etc.
+instruments frettés, la basse chiffrée, etc.
Le nom de chacun des contextes est formé d'un ou plusieurs mots aux
initiales en capitale et directement accolés les uns aux autres sans
ponctuation, comme par exemple @code{GregorianTranscriptionStaff}.
-
@seealso
Manuel de notation :
@ruser{Tout savoir sur les contextes}.
@cindex nouveaux contextes
@cindex contextes, création de
-Il en va des contextes comme de toute hiérarchie@tie{}: il faut un
-sommet -- le contexte @code{Score} en l'occurrence. La commande
-@code{\score} est chargée de le créer, mais pour des partitions simples,
-il le sera automatiquement. Le bloc @code{\score} contient donc une
-expression musicale unique ainsi que la définition des supports à
-produire -- @code{\layout} pour du visuel ou @code{\midi} pour de
-l'acoustique.
+Il en va des contextes comme de toute hiérarchie : il faut un sommet --
+le contexte @code{Score} en l'occurrence. La commande @code{\score} est
+chargée de le créer, mais pour des partitions simples, il le sera
+automatiquement. Le bloc @code{\score} contient donc une expression
+musicale unique ainsi que la définition des supports à produire --
+@code{\layout} pour du visuel ou @code{\midi} pour de l'acoustique.
Lorsqu'une partition ne comporte qu'une voix et une seule portée, vous
pouvez laisser LilyPond créer automatiquement les contextes @code{Voice}
-et @code{Staff}@tie{}; mais leur présence explicite devient
-indispensable dès que la situation se complique.
-Le moyen le plus simple est d'utiliser la commande @code{\new}. Elle
-doit intervenir avant une expression musicale, ainsi@tie{}:
+et @code{Staff} ; mais leur présence explicite devient indispensable dès
+que la situation se complique. Le moyen le plus simple est d'utiliser
+la commande @code{\new}. Elle doit intervenir avant une expression
+musicale, ainsi :
@example
\new @var{type} @var{expression-musicale}
Nous avons déjà vu au cours des chapitres précédents de nombreux
exemples où des contextes @code{Staff} ou @code{Voice} étaient créés au
besoin. Dans un but didactique, voici maintenant une application
-complète et abondamment commentée@tie{}:
+complète et abondamment commentée :
@lilypond[quote,verbatim,ragged-right]
\score { % start of single compound music expression
} % end of single compound music expression
@end lilypond
-Notez que toute déclaration qui ouvre un bloc par une
-accolade, @code{@{}, ou un double chevron gauche, @code{<<}, est
-indentée de deux espaces supplémentaires, et de deux autres pour sa
-marque de fermeture. Bien que ceci ne soit pas obligatoire, nous vous
-invitons à adopter cette pratique qui vous évitera nombre d'erreurs
-@qq{accolades non appariées}. La structure de la musique apparaît ainsi
-au premier coup d'œil, et les défauts de parité sont plus facilement
-repérables. Vous remarquerez que la portée MG est créée à l'aide d'un
-double chevron gauche -- nécessaire pour gérer ses deux voix -- alors
-que la portée MD ne contient qu'une seule expression musicale -- il n'y
-a qu'une voix -- bornée par des accolades simples.
+Notez que toute déclaration qui ouvre un bloc par une accolade,
+@code{@{}, ou un double chevron gauche, @code{<<}, est indentée de deux
+espaces supplémentaires, et de deux autres pour sa marque de fermeture.
+Bien que ceci ne soit pas obligatoire, nous vous invitons à adopter
+cette pratique qui vous évitera nombre d'erreurs @qq{accolades non
+appariées}. La structure de la musique apparaît ainsi au premier coup
+d'œil, et les défauts de parité sont plus facilement repérables. Vous
+remarquerez que la portée MG est créée à l'aide d'un double chevron
+gauche -- nécessaire pour gérer ses deux voix -- alors que la portée MD
+ne contient qu'une seule expression musicale -- il n'y a qu'une voix --
+bornée par des accolades simples.
@cindex contexte, nommage
@cindex nommage des contextes
La commande @code{\new} peut aussi permettre de nommer le contexte créé,
-et ainsi le distinguer des autres contextes déjà existants@tie{}:
+et ainsi le distinguer des autres contextes déjà existants :
@example
\new @var{type} = @var{"UnNom"} @var{expression-musicale}
@end example
Vous noterez la distinction entre le nom du type de contexte,
-@code{Staff}, @code{Voice}, etc. et le nom -- une simple suite de
+@code{Staff}, @code{Voice}, etc. et le nom -- une simple suite de
lettres au bon gré de l'utilisateur -- permettant d'identifier une
instance particulière du type en question. Vous pouvez utiliser des
chiffres et espaces, à la stricte condition d'englober le tout dans des
-guillemets@tie{}; l'identificateur suivant est tout à fait valide@tie{}:
-@w{@code{\new Staff = "MaPortee 1" @var{expression-musicale}}}.
+guillemets ; l'identificateur suivant est tout à fait valide :
+@code{\new Staff = "MaPortee 1" @var{expression-musicale}}.
Comme nous l'avons déjà vu dans le chapitre consacré aux paroles
(@ref{Voix et paroles}), cet identifiant permettra ensuite de se
référer à ce contexte particulier.
-
@seealso
Manuel de notation :
@ruser{Création d'un contexte}.
Tout point qui compose une partition générée par LilyPond est
produit par un graveur (@emph{engraver} en anglais). Ainsi, il y en a
un qui imprime les portées, un autre les têtes de note, un autre les
-hampes, un autre encore pour les ligatures, etc. LilyPond dispose de
-plus de 120 graveurs@tie{}! La plupart des partitions ne requièrent de
+hampes, un autre encore pour les ligatures, etc. LilyPond dispose de
+plus de 120 graveurs ! La plupart des partitions ne requièrent de
s'intéresser qu'à quelques-uns seulement, et pour des partitions
simples, vous n'aurez même pas à vous en préoccuper.
contexte de plus haut niveau -- le contexte @code{Score}.
Les graveurs @code{Clef_engraver} et @code{Key_engraver} seront logés
-dans chacun des contextes @code{Staff}@tie{}; deux portées peuvent
+dans chacun des contextes @code{Staff} ; deux portées peuvent
requérir des clefs et des armures différentes.
Les graveurs @code{Note_heads_engraver} et @code{Stem_engraver} résident
@headitem Graveur
@tab Fonction
@item Accidental_engraver
- @tab Crée les altérations, y compris de précaution, accidentelles ou suggérées
+ @tab Crée les altérations, y compris de précaution, accidentelles ou
+ suggérées
@item Beam_engraver
@tab Grave les ligatures (@emph{beams})
@item Clef_engraver
Nous verrons plus avant comment le résultat de LilyPond peut changer
lorsqu'on modifie l'action des graveurs.
-
@seealso
Référence des propriétés internes :
@rinternals{Engravers and Performers}.
@emph{propriétés} qui leur sont attachées. Beaucoup d'entre elles
sont susceptibles d'être modifiées afin d'influer sur l'interprétation
de l'input et ainsi changer l'apparence du résultat. On les modifie
-grâce à la commande @code{\set}, qui s'utilise ainsi@tie{}:
+grâce à la commande @code{\set}, qui s'utilise ainsi :
@example
\set @emph{ContexteNommé}.@emph{propriétéNommée} = #@emph{valeur}
@tab @code{50}
@item doubleSlurs
@tab Booléen
- @tab Si vrai, imprime les liaisons au-dessous @strong{et} au-dessus des notes
+ @tab Si vrai, imprime les liaisons au-dessous @strong{et} au-dessus
+ des notes
@tab @code{#t}, @code{#f}
@item instrumentName
@tab Texte
un nombre entier positif, un réel est un nombre décimal positif ou
négatif, et texte correspond à une suite de caractères encadrée par des
apostrophes doubles. Attention à la présence des signes dièse
-(@code{#}) dans deux cas particuliers@tie{}: ils sont partie intégrante
+(@code{#}) dans deux cas particuliers : ils sont partie intégrante
des valeurs booléennes et précèdent les @code{t} ou @code{f}, mais
doivent aussi précéder @emph{valeur} dans le libellé de la commande
@code{\set}. Il faudra donc, dans le cas d'une valeur booléenne, ne pas
@rinternals{Tunable context properties}, ou @rinternals{Contexts}.
La propriété @code{instrumentName} ne sera prise en compte que si elle
-est définie dans un contexte @code{Staff}@tie{}; d'autres propriétés
+est définie dans un contexte @code{Staff} ; d'autres propriétés
peuvent par contre être définies dans plusieurs contextes différents.
C'est le cas de la propriété @code{extraNatural} qui est définie par
défaut à @code{##t} (vrai) pour toutes les portées. Si vous lui
attribuez la valeur @code{##f} (faux) dans un contexte @code{Staff}
particulier, elle ne s'appliquera qu'aux altérations de la portée en
-question@tie{}; si vous lui attribuez la valeur @qq{faux} au niveau du
+question ; si vous lui attribuez la valeur @qq{faux} au niveau du
contexte @code{Score}, cela s'appliquera alors à toutes les portées.
-Voici comment supprimer les bécarres supplémentaires pour une
-portée@tie{}:
+Voici comment supprimer les bécarres supplémentaires pour une portée :
@lilypond[quote,verbatim,ragged-right]
<<
Autre exemple, si la propriété @code{clefOctavation} est déterminée au
niveau du contexte @code{Score}, elle modifiera la valeur de l'octave en
-cours pour toutes les portées actives@tie{}; cette valeur sera considérée
+cours pour toutes les portées actives ; cette valeur sera considérée
comme étant la nouvelle valeur par défaut pour toutes les portées à
venir.
-La commande opposée, @code{\unset}, efface la propriété du
-contexte@tie{}; la plupart des propriétés reviennent de ce fait à leur
-valeur par défaut. En règle générale, la commande @code{\unset} n'est
-pas nécessaire dès lors que vous faites appel à une nouvelle commande
-@code{\set} pour modifier le réglage.
+La commande opposée, @code{\unset}, efface la propriété du contexte ; la
+plupart des propriétés reviennent de ce fait à leur valeur par défaut.
+En règle générale, la commande @code{\unset} n'est pas nécessaire dès
+lors que vous faites appel à une nouvelle commande @code{\set} pour
+modifier le réglage.
Les commandes @code{\set} et @code{\unset} peuvent intervenir n'importe
où dans votre fichier source. Elles seront effectives dès leur
apparition et jusqu'à la fin de la partition, à moins d'être affectées
par un @code{\unset} ou un nouveau @code{\set}. À titre d'exemple, nous
-allons jouer avec la taille des fontes, ce qui affecte entre
-autres la grosseur des têtes de note. Les modifications s'appliquent
-toujours par rapport à la valeur par défaut, non par rapport à la
-dernière valeur définie.
+allons jouer avec la taille des fontes, ce qui affecte entre autres la
+grosseur des têtes de note. Les modifications s'appliquent toujours par
+rapport à la valeur par défaut, non par rapport à la dernière valeur
+définie.
@lilypond[quote,verbatim,ragged-right,relative=1]
c4 d
être précédés d'un signe dièse (@code{#}) et les valeurs vrai ou faux de
deux signes dièse -- respectivement @code{##t} et @code{##f} --. Une
valeur textuelle doit être encadrée de guillemets anglais,
-@code{"@dots{ }"}, bien que, comme nous le constaterons plus tard, la
+@code{"@dots{}"}, bien que, comme nous le constaterons plus tard, la
commande @code{\markup} permet aussi de spécifier du texte.
+
@subsubheading Définition des propriétés de contexte avec @code{\with}
@translationof Setting context properties with @code{\with}
de spécifier les valeurs d'une propriété pour la durée de vie du
contexte. Lorsque vous créez un contexte à l'aide de la commande
@code{\new}, vous pouvez la faire suivre immédiatement d'un bloc
-@w{@code{\with @{ .. @}}} qui contiendra les réglages des différentes
+@code{\with @{ .. @}} qui contiendra les réglages des différentes
propriétés. Ainsi, si nous voulions par exemple annuler l'impression
des bécarres supplémentaires sur la durée d'une portée, nous
-écririons@tie{}:
+écririons :
@example
\new Staff \with @{ extraNatural = ##f @}
@end lilypond
Les propriétés réglées de cette manière peuvent néanmoins être modifiées
-de façon dynamique grâce à @code{\set}@tie{}; un @code{\unset} les
-ramènera à leur valeur initialisée par @code{\with}.
+de façon dynamique grâce à @code{\set} ; un @code{\unset} les ramènera à
+leur valeur initialisée par @code{\with}.
@cindex fontSize, valeur par défaut et réglage
-La propriété @code{fontSize} constitue une exception@tie{}: lorsqu'elle
+La propriété @code{fontSize} constitue une exception : lorsqu'elle
est déterminée au sein d'un bloc @code{\with}, cela redéfinit la valeur
par défaut de la taille de fonte. Une modification est possible par la
commande @code{\set}, mais la commande @code{\unset fontSize} fera
revenir à la nouvelle valeur par défaut.
+
@subsubheading Définition des propriétés de contexte avec @code{\context}
@translationof Setting context properties with @code{\context}
@code{\context} inclus dans un bloc @code{\layout}. Chaque bloc
@code{\context} affectera tous les contextes concernés par le bloc
@code{\score} ou @code{\book} au sein duquel apparaît ce bloc
-@code{\layout}. Voici comment le mettre en place@tie{}:
+@code{\layout}. Voici comment le mettre en place :
@lilypond[verbatim,quote]
\score {
@end lilypond
Dans le cas où ces ajustements de propriété doivent affecter
-toutes les portées de la partition, nous utiliserons alors@tie{}:
+toutes les portées de la partition, nous utiliserons alors :
@lilypond[quote,verbatim]
\score {
chacun des contextes en particulier grâce à un bloc @code{\with} ou bien
une commande @code{\set} au fil des notes.
-
@seealso
Manuel de notation :
@ruser{Modification des réglages par défaut d'un contexte},
Nous avons vu que chaque contexte met en œuvre plusieurs graveurs, et
que chacun de ces graveurs est chargé de générer une composante
particulière du fichier de sortie, qui les barres de mesure, qui la
-portée, qui les têtes de note, les hampes, etc. Le fait de supprimer un
+portée, qui les têtes de note, les hampes, etc. Le fait de supprimer un
graveur d'un contexte éliminera sa contribution au fichier de sortie.
Bien que ce soit là un moyen radical de modifier le résultat, cette
pratique est dans quelques cas fort utile.
+
@subsubheading Modification d'un seul contexte
@translationof Changing a single context
@cindex ambitus, graveur
Vous pouvez aussi ajouter individuellement un graveur à un contexte. La
-commande se formule ainsi@tie{}:
+commande se formule ainsi :
@code{\consists @var{Nom_du_graveur}}
d'indiquer ses notes extrêmes. L'ambitus est généré par
l'@code{Ambitus_engraver}, que l'on peut adjoindre à n'importe quel
contexte. Si nous l'ajoutons au contexte @code{Voice}, seule la
-tessiture de cette voix sera calculée@tie{}:
+tessiture de cette voix sera calculée :
@lilypond[quote,verbatim,ragged-right]
\new Staff <<
@noindent
alors que si nous l'ajoutons au contexte @code{Staff},
l'@code{Ambitus_engraver} calculera l'écart maximal à partir de toutes
-les notes de toutes les voix de la portée@tie{}:
+les notes de toutes les voix de la portée :
@lilypond[quote,verbatim,ragged-right]
\new Staff \with {
>>
@end lilypond
+
@subsubheading Modification de tous les contextes d'un même type
@translationof Changing all contexts of the same type
supprimer des graveurs à tous les contextes d'un même type en insérant
les commandes pour le contexte approprié au sein d'un bloc
@code{\layout}. Si nous voulions afficher un ambitus pour chacune des
-portées d'un système à quatre portées, il nous suffirait d'écrire@tie{}:
+portées d'un système à quatre portées, il nous suffirait d'écrire :
@lilypond[quote,verbatim,ragged-right]
\score {
@translationof Extending the templates
Bon, vous avez lu le tutoriel, vous savez écrire de la musique. Mais
-comment obtenir les portées que vous voulez@tie{}? Les @ref{Modèles},
-c'est bien beau, mais que faire quand ils ne traitent pas ce que l'on
-veut précisément@tie{}?
+comment obtenir les portées que vous voulez ? Les @ref{Modèles}, c'est
+bien beau, mais que faire quand ils ne traitent pas ce que l'on veut
+précisément ?
Les exemples qui suivent vous donneront des méthodes générales pour
adapter des modèles.
* Conducteurs et parties::
@end menu
+
@node Soprano et violoncelle
@subsection Soprano et violoncelle
@translationof Soprano and cello
Commencez par le modèle qui vous semblera le plus proche de ce à quoi
vous voulez aboutir. Disons par exemple que vous voulez écrire une pièce
-pour soprano et violoncelle@tie{}: dans ce cas, on pourrait commencer
-par les @qq{notes et paroles}, pour la partie de soprano.
+pour soprano et violoncelle : dans ce cas, on pourrait commencer par les
+@qq{notes et paroles}, pour la partie de soprano.
@example
\version @w{"@version{}"}
@end example
Maintenant, on veut ajouter une partie de violoncelle.
-Jetons un coup d'œil sur l'exemple avec les notes seules@tie{}:
+Jetons un coup d'œil sur l'exemple avec les notes seules :
@example
\version @w{"@version{}"}
On n'a pas besoin de deux commandes @code{\version}. Ce dont on a
besoin, c'est de la section @code{melodie}. De même, on n'a pas besoin
de deux sections @code{\score} -- si nous les gardions toutes les deux,
-on obtiendrait deux parties séparées@tie{}; mais nous voulons un vrai
-duo, avec les deux parties ensemble. Dans la section @code{\score}, on
-n'a pas besoin non plus de deux @code{\layout} ni de deux @code{\midi}.
+on obtiendrait deux parties séparées ; mais nous voulons un vrai duo,
+avec les deux parties ensemble. Dans la section @code{\score}, on n'a
+pas besoin non plus de deux @code{\layout} ni de deux @code{\midi}.
Si on se contente de couper et coller les sections @code{melodie}, on se
-retrouvera avec deux sections de ce nom@tie{}; il nous faut donc les
+retrouvera avec deux sections de ce nom ; il nous faut donc les
renommer. Appelons la section pour la soprano @code{sopranoMusique} et
celle pour le violoncelle @code{violoncelleMusique}. Tant qu'on y est,
renommons @code{texte} en @code{sopranoParoles}. Attention à bien
-renommer les deux occurrences de chacune de ces dénominations@tie{}:
-c'est-à-dire la définition de départ, où l'on trouve @w{@code{melodie =
-\relative c' @{ }}, et l'endroit où cette dénomination est utilisée,
-dans la section @code{\score}.
+renommer les deux occurrences de chacune de ces dénominations :
+c'est-à-dire la définition de départ, où l'on trouve
+@code{melodie = \relative c' @{ }, et l'endroit où cette dénomination
+est utilisée, dans la section @code{\score}.
Et puis, toujours tant qu'on y est, mettons le violoncelle en clé de fa,
comme le veut l'usage, et donnons-lui d'autres notes.
Voilà qui est mieux, mais la partie de violoncelle n'apparaît pas sur
la partition -- en effet, nous n'y avons pas fait appel dans la section
@code{\score}. Si l'on veut que la partie de violoncelle s'imprime sous
-la partie de soprano, on va devoir ajouter@tie{}:
+la partie de soprano, on va devoir ajouter :
@example
\new Staff \musiqueVioloncelle
@end example
@noindent
-C'est un peu le bazar dans tout ça@tie{}; mais il vous sera facile de
+C'est un peu le bazar dans tout ça ; mais il vous sera facile de
mettre un peu d'ordre dans l'indentation. Voici le modèle pour
-soprano et violoncelle au complet@tie{}:
+soprano et violoncelle au complet :
@lilypond[quote,verbatim,ragged-right,addversion]
sopranoMusic = \relative c' {
}
@end lilypond
-
@seealso
Les patrons originaux sont disponibles à l'annexe @qq{Modèles}, voir
@ref{Portée unique}.
la musique et les paroles du chœur sur quatre portées -- soprano, alto,
ténor et basse -- surmontant une réduction pour piano de
l'accompagnement orchestral. En voici un exemple, tiré du Messie de
-Haendel@tie{}:
+Haendel :
@c The following should appear as music without code
@lilypond[quote,ragged-right]
Aucun des modèles ne permet d'arriver exactement à cette mise en forme.
Celui qui s'en rapprocherait le plus est @qq{SATB vocal score and
automatic piano reduction} -- voir @ref{Ensemble vocal} -- mais encore
-faudrait-il en modifier la mise en forme et refaire la partie de
-piano qui n'est plus une simple reprise des parties vocales. Les
-variables qui gèrent la musique et les paroles du chœur ne nécessitent
-pas de modification, mais il nous faut d'autres variables pour la
-réduction de piano.
+faudrait-il en modifier la mise en forme et refaire la partie de piano
+qui n'est plus une simple reprise des parties vocales. Les variables
+qui gèrent la musique et les paroles du chœur ne nécessitent pas de
+modification, mais il nous faut d'autres variables pour la réduction de
+piano.
L'ordre dans lequel apparaissent les contextes dans le @code{ChoirStaff}
du modèle ne correspond pas à ce que nous voyons ci-dessus. Il nous
faudra y revenir pour obtenir quatre portées avec des paroles en dessous
de chacune d'elles. Toutes les voix devraient être @code{\voiceOne},
-ce qui est la position par défaut@tie{}; il nous faudra donc éliminer
-toutes les commandes @code{\voiceXXX}. Les ténors auront besoin d'une
-clé spécifique. Enfin, nous n'avons pas encore abordé la façon dont les
-paroles sont présentées dans le modèle@tie{}; nous procéderons donc
-comme nous en avons l'habitude. Il faudra aussi ajouter un nom à chaque
+ce qui est la position par défaut ; il nous faudra donc éliminer toutes
+les commandes @code{\voiceXXX}. Les ténors auront besoin d'une clé
+spécifique. Enfin, nous n'avons pas encore abordé la façon dont les
+paroles sont présentées dans le modèle ; nous procéderons donc comme
+nous en avons l'habitude. Il faudra aussi ajouter un nom à chaque
portée.
-Une fois tout ceci accompli, voici notre @code{ChoirStaff}@tie{}:
+Une fois tout ceci accompli, voici notre @code{ChoirStaff} :
@example
\new ChoirStaff <<
@end example
Il nous faut maintenant nous occuper de la partie de piano. Nous allons
-nous contenter de récupérer la partie de piano du modèle
-@qq{Solo piano}@tie{}:
+nous contenter de récupérer la partie de piano du modèle @qq{Solo
+piano} :
@example
\new PianoStaff <<
@code{inferieur}.
Les systèmes pour chœur et pour piano doivent être combinés à l'aide de
-doubles chevrons gauche/droite puisqu'ils doivent s'empiler@tie{}:
+doubles chevrons gauche/droite puisqu'ils doivent s'empiler :
@example
<< % combine ChoirStaff et PianoStaff l'un au-dessus de l'autre
@end example
Une fois tout cela mis en place, et après avoir ajouté les notes et les
-paroles de ces trois mesures du Messie, nous obtenons@tie{}:
+paroles de ces trois mesures du Messie, nous obtenons :
@lilypond[quote,verbatim,ragged-right,addversion]
global = { \key d \major \time 4/4 }
particulièrement. Pour voir comment procéder, nous allons monter la
partition d'un prélude pour orgue.
-Nous débutons par une section d'en-tête@tie{}; nous y mettrons entre
+Nous débutons par une section d'en-tête ; nous y mettrons entre
autres le titre et le nom du compositeur. Puis viennent toutes les
définitions de toutes les variables. Nous terminons par le bloc
@code{\score}. Attelons-nous pour cette aventure, en gardant bien à
-l'esprit ce que nous venons de dire@tie{}; nous nous occuperons des
+l'esprit ce que nous venons de dire ; nous nous occuperons des
détails en temps voulu.
Nous nous appuyons sur les deux premières mesures du prélude sur
voir ces deux mesures au bas de cette page. La main droite comporte
deux voix, la main gauche et le pédalier une seule. Il nous faut donc
quatre définitions de musique, plus une qui contiendra la métrique et
-l'armure@tie{}:
+l'armure :
@example
\version @w{"@version{}"}
sous le système de piano, mais puisqu'elle doit rester synchrone avec
lui, nous utilisons des doubles chevrons pour les regrouper.
Négliger ceci nous renverrait une erreur, et personne n'est à l'abri de
-cette faute@tie{}! Pour preuve, il vous suffit de copier l'exemple
+cette faute ! Pour preuve, il vous suffit de copier l'exemple
complet en fin de chapitre, de supprimer ces @code{<<} et @code{>>}, et
de le compiler, pour voir de quoi il retourne.
La construction en simultané -- @code{<<...>>} -- n'est pas strictement
obligatoire pour les portées manuel deux et pédalier, qui ne contiennent
-chacune qu'une seule expression musicale@tie{}; mais cela ne mange pas
-de pain, et c'est une bonne habitude que de toujours encadrer par des
-doubles chevrons gauche/droite ce qui suit une commande @code{\new
-Staff} au cas où il y aurait plusieurs voix. Il en va autrement pour
-les contextes @code{Voice}@tie{}: ils doivent être toujours suivis
-d'accolades -- @code{@{...@}} -- au cas où vous auriez employé
+chacune qu'une seule expression musicale ; mais cela ne mange pas de
+pain, et c'est une bonne habitude que de toujours encadrer par des
+doubles chevrons gauche/droite ce qui suit une commande
+@code{\new Staff} au cas où il y aurait plusieurs voix. Il en va
+autrement pour les contextes @code{Voice} : ils doivent être toujours
+suivis d'accolades -- @code{@{...@}} -- au cas où vous auriez employé
plusieurs variables qui doivent intervenir consécutivement.
Ajoutons donc cette structure au bloc @code{\score}, tout en fignolant
-l'indentation. Nous en profitons pour ajouter les clés appropriées,
+l'indentation. Nous en profitons pour ajouter les clefs appropriées,
effectuer les réglages concernant les hampes et liaisons de la portée
supérieure grâce à @code{\voiceOne} et @code{\voiceTwo}, et mettre en
place la métrique et l'armure de chaque portée grâce à notre variable
@cindex portées, espacement
Cette partition pour orgue est presque parfaite. Reste juste ce petit
-défaut qui ne se remarque pas lorsque l'on considère un seul
-système@tie{}: la distance qui sépare la portée de pédalier de celle de
-la main gauche devrait être plus ou moins égale à celle qui sépare les
-deux mains. En fait, la distance entre les deux portées d'un
-@code{PianoStaff} ne saurait trop se dilater@tie{}; le pédalier devrait
-adopter le même comportement.
+défaut qui ne se remarque pas lorsque l'on considère un seul système :
+la distance qui sépare la portée de pédalier de celle de la main gauche
+devrait être plus ou moins égale à celle qui sépare les deux mains. En
+fait, la distance entre les deux portées d'un @code{PianoStaff} ne
+saurait trop se dilater ; le pédalier devrait adopter le même
+comportement.
@cindex sous-propriétés
@cindex propriétés et sous-propriétés
propriété @code{staff-staff-spacing}, attachée à @qq{l'objet graphique}
@code{VerticalAxisGroup} -- la documentation de LilyPond utilise souvent
l'abréviation @emph{grob} pour @emph{graphical object}. Pas de
-panique@tie{}! Tout ceci sera expliqué plus tard -- pour les curieux,
+panique ! Tout ceci sera expliqué plus tard -- pour les curieux,
jetez un œil au chapitre
@ruser{Vue d'ensemble de la modification des propriétés}.
-Revenons à notre propos@tie{}: nous voulons modifier uniquement la
+Revenons à notre propos : nous voulons modifier uniquement la
sous-propriété @code{stretchability}. Les impatients trouveront les
valeurs par défaut de la propriété @code{staff-staff-spacing} dans le
fichier @file{scm/define-grobs.scm}, en examinant la définition du
@cindex variables
@cindex identificateurs
-Jusqu'à maintenant, vous avez vu ce type de code@tie{}:
+Jusqu'à maintenant, vous avez vu ce type de code :
@lilypond[quote,verbatim,ragged-right]
hornNotes = \relative c'' { c4 b dis c }
@end lilypond
Vous comprendrez combien cela peut être utile pour écrire de la
-musique minimaliste@tie{}:
+musique minimaliste :
@lilypond[quote,verbatim,ragged-right]
fragmentA = \relative c'' { a4 a8. b16 }
}
@end lilypond
-Néanmoins vous pouvez aussi utiliser ces identificateurs
--- aussi connus sous le nom de variables, macros, ou commandes
-(définies par l'utilisateur) -- pour des retouches@tie{}:
+Néanmoins vous pouvez aussi utiliser ces identificateurs -- aussi connus
+sous le nom de variables, macros, ou commandes (définies par
+l'utilisateur) -- pour des retouches :
@c TODO Avoid padtext - not needed with skylining
@lilypond[quote,verbatim,ragged-right]
Ces identificateurs sont évidemment utiles pour économiser de la
frappe. Mais ils peuvent l'être même si vous ne les utilisez qu'une
-seule fois@tie{}: ils réduisent la complexité. Regardons l'exemple
+seule fois : ils réduisent la complexité. Regardons l'exemple
précédent sans aucun identificateur. C'est beaucoup plus laborieux à
lire, et particulièrement la dernière ligne.
@c TODO Replace the following with a better example -td
@c Skylining handles this correctly without padText
-Jusqu'ici nous avons vu des substitutions statiques@tie{}: quand
-LilyPond rencontre @code{\padText}, il le remplace par le contenu que
-nous lui avons défini -- c'est-à-dire le contenu à droite de
-@code{padText=}.
+Jusqu'ici nous avons vu des substitutions statiques : quand LilyPond
+rencontre @code{\padText}, il le remplace par le contenu que nous lui
+avons défini -- c'est-à-dire le contenu à droite de @code{padText=}.
LilyPond gère également des substitutions non-statiques -- vous
pouvez les voir comme des fonctions.
@end example
@noindent
-On établira alors une partie séparée en constituant un nouveau
-fichier@tie{}:
+On établira alors une partie séparée en constituant un nouveau fichier :
@example
\include "musique-Cor.ly"
@noindent
sera substitué le contenu du fichier @file{musique-Cor.ly}, et de ce
fait la variable @code{notesCor} se trouvera définie. La commande
-@code{\transpose@tie{}f@tie{}c'} indique que son argument
-@code{\notesCor} sera transposé à la quinte supérieure@tie{}: le son
-réel @code{f} s'écrit @code{c'}, ce qui est la caractéristique d'un Cor
-en fa. La transposition est visible comme suit@tie{}:
+@code{\transpose f c'} indique que son argument @code{\notesCor} sera
+transposé à la quinte supérieure : le son réel @code{f} s'écrit
+@code{c'}, ce qui est la caractéristique d'un Cor en fa. La
+transposition est visible comme suit :
@lilypond[quote,ragged-right]
\transpose f c' \relative c {
Dans les pièces d'ensemble, il arrive souvent qu'une voix ne joue pas
pendant plusieurs mesures. Un silence spécial, appelé silence
multimesures, l'indique alors. On l'obtient par un @code{R} majuscule,
-suivi d'une durée@tie{}: @code{1}@tie{}pour une pause,
-@code{2}@tie{}pour une demi-pause, etc. Cette durée peut être
-multipliée pour établir de plus longs silences. Par exemple, le silence
-suivant dure 3@tie{}mesures à 2/4.
+suivi d'une durée : @code{1} pour une pause, @code{2} pour une
+demi-pause, etc. Cette durée peut être multipliée pour établir de plus
+longs silences. Par exemple, le silence suivant dure 3 mesures à 2/4.
@example
R2*3
@end example
Dans une partie séparée, les silences multimesure sont compressés.
-Il faut pour cela définir la propriété @code{skipBars} à
-@qq{vrai}@tie{}:
+Il faut pour cela définir la propriété @code{skipBars} à @qq{vrai} :
@example
\set Score.skipBars = ##t
@noindent
Cette commande assigne la valeur @qq{vrai} -- @emph{true} en anglais, et
-@code{#t} dans le langage Scheme -- à cette propriété dans le
-contexte @code{Score}. Si l'on ajoute dans la musique ci-dessus le
-silence multimesure et cette option, on obtient le résultat suivant@tie{}:
+@code{#t} dans le langage Scheme -- à cette propriété dans le contexte
+@code{Score}. Si l'on ajoute dans la musique ci-dessus le silence
+multimesure et cette option, on obtient le résultat suivant :
@lilypond[quote,ragged-right]
\transpose f c' \relative c {
@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: 5f722f1688eff7436789f8ca011205bdb16c04b7
+ Translation of GIT committish: 8df40d45e4366f4e9baa2cec3b7eb38b6482150f
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Notre principale motivation vient sans doute de l'utilité réelle de
notre logiciel. En flânant sur Internet, nous trouvons beaucoup de
gens qui utilisent LilyPond pour réaliser d'impressionnantes
-partitions@tie{}: c'est incroyable, mais en même temps très flatteur.
+partitions : c'est incroyable, mais en même temps très flatteur.
Les utilisateurs ne se contentent pas de nous encourager en utilisant
-notre logiciel@tie{}; nombre d'entre eux nous aident aussi en faisant des
+notre logiciel ; nombre d'entre eux nous aident aussi en faisant des
suggestions et en signalant des bogues. Aussi, nous voudrions
remercier ici tous les utilisateurs qui nous ont signalé des bugs, ont
fait des suggestions ou ont contribué d'une façon ou d'une autre au
ensemble, et qu'on éprouve une satisfaction profonde à aider les gens,
au bout du compte, notre travail sur LilyPond est avant tout une
manière d'exprimer notre amour sincère de la musique. Puisse-t-il
-vous aider à créer de nombreuses et belles œuvres@tie{}!
+vous aider à créer de nombreuses et belles œuvres !
Han-Wen et Jan
@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@ignore
- Translation of GIT committish: 0f93dd92ffa0319328e58148458d22c5448b3d58
+ Translation of GIT committish: 8df40d45e4366f4e9baa2cec3b7eb38b6482150f
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Lilypond, prets à l'emploi. Il vous suffira d'y ajouter quelques notes,
de lancer LilyPond, et d'aprécier le résultat.
-
@menu
* Portée unique::
* Modèles pour piano::
* Autres modèles::
@end menu
+
@node Portée unique
@appendixsec Portée unique
@translationof Single staff
@lilypondfile[verbatim,quote,ragged-right,texidoc,addversion]
{single-staff-template-with-only-notes.ly}
+
@appendixsubsec Notes et paroles
@lilypondfile[verbatim,quote,ragged-right,texidoc,addversion]
{single-staff-template-with-notes-and-lyrics.ly}
+
@appendixsubsec Notes et accords
@lilypondfile[verbatim,quote,ragged-right,texidoc]
{single-staff-template-with-notes-and-chords.ly}
+
@appendixsubsec Notes, paroles et accords
@lilypondfile[verbatim,quote,ragged-right,texidoc]
@lilypondfile[verbatim,quote,ragged-right,texidoc]
{piano-template-simple.ly}
+
@appendixsubsec Chant et accompagnement
@lilypondfile[verbatim,quote,ragged-right,texidoc]
{piano-template-with-melody-and-lyrics.ly}
+
@appendixsubsec Piano et paroles entre les portées
@lilypondfile[verbatim,quote,ragged-right,texidoc]
@lilypondfile[verbatim,quote,ragged-right,texidoc]
{string-quartet-template-simple.ly}
+
@appendixsubsec Parties pour quatuor à cordes
@lilypondfile[verbatim,quote,ragged-right,texidoc]
@lilypondfile[verbatim,quote,ragged-right,texidoc]
{vocal-ensemble-template.ly}
+
@appendixsubsec Partition pour chœur SATB avec réduction pour piano
@lilypondfile[verbatim,quote,ragged-right,texidoc]
{vocal-ensemble-template-with-automatic-piano-reduction.ly}
+
@appendixsubsec Partition pour chœur SATB avec alignement des contextes
@lilypondfile[verbatim,quote,ragged-right,texidoc]
{vocal-ensemble-template-with-lyrics-aligned-below-and-above-the-staves.ly}
+
@appendixsubsec Chœur à quatre voix mixtes sur quatre portées
@lilypondfile[verbatim,quote,ragged-right,texidoc]
{satb-choir-template---four-staves.ly}
+
@appendixsubsec Couplet pour solo et refrain à deux voix
@lilypondfile[verbatim,quote,ragged-right,texidoc]
{vocal-ensemble-template-with-verse-and-refrain.ly}
+
@appendixsubsec Hymnes et cantiques
@lilypondfile[verbatim,quote,ragged-right,texidoc]
{hymn-template.ly}
+
@appendixsubsec Psalmodie
@lilypondfile[verbatim,quote,ragged-right,texidoc]
@lilypondfile[verbatim,quote,ragged-right,texidoc,line-width=140]
{ancient-notation-template----modern-transcription-of-mensural-music.ly}
+
@appendixsubsec Transcription du grégorien
@lilypondfile[verbatim,quote,ragged-right,texidoc]
@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@ignore
- Translation of GIT committish: 5f722f1688eff7436789f8ca011205bdb16c04b7
+ Translation of GIT committish: 8df40d45e4366f4e9baa2cec3b7eb38b6482150f
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
* Ligne de commande::
@end menu
+
@node Saisie de la musique
@subsection Saisie de la musique
@translationof Entering input
@end lilypond
@c DIV specific
-Il est aussi possible d'utiliser les noms de notes français @qq{@w{do
-re mi fa sol la si}}, en insérant au début du fichier la ligne
-@w{@code{\include@tie{}"italiano.ly"}}.
+Il est aussi possible d'utiliser les noms de notes français @qq{do
+re mi fa sol la si}, en insérant au début du fichier la ligne
+@code{\include "italiano.ly"}.
@c END DIV
@warning{Tout extrait de code LilyPond doit être entouré d'une
@w{@strong{@{ paire d'accolades @}}}. De plus, pour éviter toute
ambiguïté, il est préférable d'entourer les accolades par des espaces
ou retours à la ligne. Bien que certains exemples de ce manuel ne
-comportent pas d'accolades, ne les oubliez pas dans vos partitions@tie{}!
+comportent pas d'accolades, ne les oubliez pas dans vos partitions !
Pour plus d'informations sur l'affichage des exemples de cette
documentation, consultez @ref{Bien lire le manuel}.}
-
@cindex casse, prise en compte de la
@cindex prise en compte de la casse
@cindex sensibilité à la casse
-De plus, LilyPond est @strong{sensible à la casse}@tie{}: le code
+De plus, LilyPond est @strong{sensible à la casse} : le code
@w{@samp{@{ c d e @}}} est valide, alors que @w{@samp{@{ C D E @}}}
produira un message d'erreur.
@end itemize
Notez qu'il existe plusieurs éditeurs de texte disponibles avec un bon
-support de LilyPond@tie{}; consultez @rweb{Facilités d'édition}.
+support de LilyPond ; consultez @rweb{Facilités d'édition}.
@warning{Le premier démarrage de LilyPond peut prendre une minute ou
deux, afin de générer la liste des polices du système. LilyPond démarre
@noindent
Ces valeurs automatiques simplifient la saisie du code source dans
-bien des cas ; nous verrons plus loin comment les indiquer
+bien des cas ; nous verrons plus loin comment les indiquer
explicitement.
clef de sol et la clef de fa, puis est suivi par le @notation{ré} le
plus proche, et ainsi de suite. On peut bien sûr créer des mélodies
avec de plus grands intervalles, toujours avec le mode
-@code{\relative}@tie{}:
+@code{\relative} :
@lilypond[verbatim,quote]
\relative c' {
@noindent
Remarquez que cet exemple ne commence plus sur le @notation{do
-central}@tie{}: la première note -- le @code{d} -- est le ré qui en est
+central} : la première note -- le @code{d} -- est le ré qui en est
le plus proche.
Dans l'exemple suivant, on remplace @code{c'} dans la commande
@w{@code{@bs{}relative c'}} par @code{c''}, afin de calculer l'octave de
la première note par rapport au do situé une octave au-dessus du do
-central@tie{}:
+central :
@lilypond[verbatim,quote]
% one octave above middle C
@end lilypond
@noindent
-Pour déplacer une note deux octaves (ou davantage@tie{}!) plus haut ou plus
+Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus
bas, il suffit de mettre deux (ou davantage) @code{'} ou @code{,} --
attention cependant à bien mettre deux apostrophes @code{''}, et non
-un guillemet @code{"}@tie{}! C'est de cette même manière que l'on
+un guillemet @code{"} ! C'est de cette même manière que l'on
peut modifier la valeur de départ de @w{@code{\relative c'}}.
@c " - keeps quotes in order for context-sensitive editor -td
@rglosnamed{dotted note,note pointée}.
La @notation{durée} d'une note est indiquée par un nombre qui suit sa
-hauteur@tie{}: @code{1} pour une @notation{ronde}, @code{2} pour une
+hauteur : @code{1} pour une @notation{ronde}, @code{2} pour une
@notation{blanche}, @code{4} pour une @notation{noire} et ainsi de
suite. Les @notation{crochets} et @notation{liens} sont ajoutés
automatiquement.
Glossaire musicologique : @rglosnamed{time signature,métrique}.
La @notation{métrique}, aussi appelée @notation{chiffre de mesure},
-peut être définie à l'aide de la commande @code{\time}@tie{}:
+peut être définie à l'aide de la commande @code{\time} :
@lilypond[verbatim,quote]
\relative c'' {
@rglosnamed{metronome,métronome}.
La commande @code{\tempo} permet de stipuler aussi bien le @emph{tempo}
-que le métronome@tie{}:
+que le métronome :
@lilypond[verbatim,quote]
\relative c'' {
Glossaire musicologique : @rglos{clef}.
La @notation{clef} peut être définie à l'aide de la commande
-@code{\clef}@tie{}:
+@code{\clef} :
@lilypond[verbatim,quote]
\relative c' {
@subheading Tout ensemble
Voici un bref exemple qui rassemble tous les éléments que nous déjà
-vus@tie{}:
+vus :
@lilypond[verbatim,quote]
\relative c, {
}
@end lilypond
-
@seealso
-Manuel de notation : @ruser{Écriture des hauteurs de note},
-@ruser{Écriture du rythme}, @ruser{Écriture des silences},
-@ruser{Gravure du rythme}, @ruser{Gravure des hauteurs}.
+Manuel de notation :
+@ruser{Écriture des hauteurs de note},
+@ruser{Écriture du rythme},
+@ruser{Écriture des silences},
+@ruser{Gravure du rythme},
+@ruser{Gravure des hauteurs}.
@node Travail sur les fichiers d'entrée
code de nombreux langages de programmation. La casse est prise
en compte, et les caractères considérés comme espaces ont généralement
peu d'importance. Les expressions sont délimitées par des accolades
-@w{@code{@{ @}}}, et les commentaires par @code{%} ou
-@w{@code{%@{ @dots{} @}}}@tie{}.
-
-Si cette phrase vous paraît incompréhensible, ne vous en faites pas@tie{}!
-Expliquons tous ces termes@tie{}:
+@code{@{ @}}, et les commentaires par @code{%} ou
+@w{@code{%@{ @dots{} @}}} .
+Si cette phrase vous paraît incompréhensible, ne vous en faites pas !
+Expliquons tous ces termes :
@itemize
@strong{La version} :
Tout fichier LilyPond devrait porter mention de la version. Cette
mention prend la forme d'une ligne décrivant le numéro de la version
-utilisée lors de la confection du fichier en question, comme ici@tie{}:
+utilisée lors de la confection du fichier en question, comme ici :
@example
\version "@w{@version{}}"
LilyPond.
Mentionner la version est important pour, au moins, les deux raisons
-suivantes@tie{}: cela permet dans un premier temps de faciliter les
+suivantes : cela permet dans un premier temps de faciliter les
opérations de mise à jour automatisée au fil de l'évolution de la
syntaxe de LilyPond. Ensuite, cela met en évidence le minimum requis
pour pouvoir compiler votre fichier.
@strong{La casse} :
LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale
n'a pas la même valeur qu'une lettre minuscule. Les notes, par
-exemple, doivent être entrées en minuscule : @w{@code{@{ c d e @}}} est
+exemple, doivent être entrées en minuscule : @w{@code{@{ c d e @}}} est
un code valide, alors que @w{@code{@{ C D E @}}} produira un message
d'erreur.
@strong{Les espaces multiples} :
LilyPond ne tient pas compte du nombre d'espaces, de tabulations ou de
retours à la ligne. @w{@code{@{ c d e @}}} a le même sens que
-@w{@code{@{ c @tie{} @tie{} d @tie{} e @}}} ou que
+@w{@code{@{ c d e @}}} ou que
@example
@{ c4 d
@noindent
Bien sûr, ce dernier exemple est illisible. Une bonne habitude
-à prendre est d'indenter les blocs de code avec des doubles espaces@tie{}:
+à prendre est d'indenter les blocs de code avec des doubles espaces :
@example
@{
d'éléments syntaxiques les uns des autres. En d'autres termes, s'il est
toujours possible d'@emph{ajouter} des espaces, il faut prendre garde à
ne pas trop en @emph{supprimer}. En effet, l'absence d'une espace peut
-avoir des conséquences et entraîner une erreur@tie{}; aussi nous vous
+avoir des conséquences et entraîner une erreur ; aussi nous vous
invitons à toujours insérer une espace avant et après chaque élément
syntaxique, comme avant et après une accolade.
@item
@strong{Expressions musicales} :
Tout morceau saisi dans LilyPond doit être placé entre
-@strong{@{@tie{}accolades@tie{}@}}. Ces caractères indiquent à LilyPond
+@strong{@{ accolades @}}. Ces caractères indiquent à LilyPond
que ce bloc de texte représente une et une seule expression musicale,
tout comme les parenthèses @code{()} en mathématiques. Pour éviter
toute ambiguïté, il est préférable d'entourer ces accolades d'espaces ou
@item
@strong{Les commentaires} :
Un commentaire est une indication pour tout lecteur humain d'un
-fichier source de musique@tie{}; il est ignoré lors de la compilation et
+fichier source de musique ; il est ignoré lors de la compilation et
n'a donc aucun effet sur la partition imprimée. On distingue deux types
de commentaires. Le commentaire de fin de ligne, introduit par le
-symbole @code{%}@tie{}: tout ce qui suit ce symbole sur la même ligne sera
+symbole @code{%} : tout ce qui suit ce symbole sur la même ligne sera
ignoré. Par convention, un commentaire qui occupe une ligne entière
se place juste @emph{au-dessus} de la ligne à laquelle il fait
référence.
@end example
Le bloc de commentaire, qui peut occuper plusieurs lignes, voire toute
-une section@tie{}: tout ce qui se trouve entre @code{%@{} et @code{%@}} est
+une section : tout ce qui se trouve entre @code{%@{} et @code{%@}} est
ignoré. Les blocs de commentaires ne peuvent s'imbriquer, ce qui
signifie que vous ne pouvez pas placer un commentaire-bloc à
l'intérieur d'un autre commentaire-bloc. Si jamais vous essayez, vous
verrez que la première occurence de @code{%@}} terminera @qq{les
@emph{deux} commentaires-blocs}. Le fragment suivant met en évidence
-quelques usages possibles des commentaires@tie{}:
+quelques usages possibles des commentaires :
@example
% voici les notes de "ah vous dirai-je maman"
Parfois, LilyPond ne produit pas le résultat escompté. Voici quelques
pistes à suivre pour vous aider à éviter de telles déconvenues.
-
@menu
* Quand ça ne fonctionne pas::
* Erreurs courantes::
@end menu
+
@node Quand ça ne fonctionne pas
@subsection Quand ça ne fonctionne pas
@translationof General troubleshooting tips
@subsection Matériel incomplet
@translationof Omitted material
-
@cindex bien lire le manuel
@cindex manuel, lecture
@cindex compulser le manuel
@cindex fichiers, conseils de construction
Comme nous l'avons vu dans @ref{Travail sur les fichiers d'entrée}, un
-code LilyPond doit être encadré par des accolades @{@tie{}@} ou bien par
+code LilyPond doit être encadré par des accolades @{ @} ou bien par
@w{@code{\relative c'' @{ @dots{} @}}}. Cependant, dans la suite de ce
manuel, la plupart des exemples ne feront pas apparaître ces signes.
Pour reproduire les exemples, vous pouvez copier et coller le code
affiché, mais @strong{à condition} d'ajouter
-@code{@w{\relative c'' @{ @}}} de la façon suivante@tie{}:
+@code{@w{\relative c'' @{ @}}} de la façon suivante :
@example
\relative c'' @{
@}
@end example
-Pourquoi avoir omis les accolades@tie{}? La plupart des exemples de ce
+Pourquoi avoir omis les accolades ? La plupart des exemples de ce
manuel peuvent être insérés au milieu d'un morceau de musique plus
long. Il n'y a donc aucune raison d'ajouter @code{@w{\relative c'' @{
@}}} à ces exemples -- en effet, il n'est pas possible d'insérer une
et en bidouillant avec. C'est également possible avec LilyPond. Si
vous cliquez sur une image dans la version HTML de ce manuel, vous
verrez exactement le code LilyPond utilisé pour générer cette image.
-Essayez sur cette image@tie{}:
+Essayez sur cette image :
@c no verbatim here
@c KEEP LY
qui répertorie les commandes usuelles pour une consultation rapide.
@end ignore
+
@node Vue d'ensemble des manuels
@subsection Vue d'ensemble des manuels
@translationof Overview of manuals
@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+
@ignore
- Translation of GIT committish: 2a87f1e1f98b76751482cae4474d41aa5e38e37b
+ Translation of GIT committish: 8df40d45e4366f4e9baa2cec3b7eb38b6482150f
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Dans ce chapitre, nous traitons des concepts de base nécessaires
pour comprendre l'art de la retouche. Puis nous présentons de
nombreuses commandes déjà prêtes, qu'il suffit de recopier pour
-obtenir un résultat identique dans vos partitions ; nous en
-profitons pour expliquer comment ces commandes ont été construites, si
-bien que vous pouvez apprendre par la même occasion à développer
-vos propres retouches.
+obtenir un résultat identique dans vos partitions ; nous en profitons
+pour expliquer comment ces commandes ont été construites, si bien que
+vous pouvez apprendre par la même occasion à développer vos propres
+retouches.
Avant de vous lancer dans ce chapitre, il peut être utile de revoir la
section @ref{Contextes et graveurs}, dans la mesure où les contextes,
Le terme @qq{Objet} est un terme générique qui fait référence à
une multitude de structures internes mises en place par LilyPond
durant la compilation d'un fichier d'entrée. Ainsi, quand une
-commande du type @code{\new Staff} apparaît, un nouvel objet
-du type @code{Staff} est créé. Cet objet @code{Staff} contient
-alors toutes les propriétés associées à cette portée, par exemple son
-nom et son armure, ainsi que le détail des graveurs qui ont été
-désignés pour fonctionner dans ce contexte de portée.
-Certains objets peuvent contenir les propriétés de tous les autres
-contextes, comme les objets @code{Voice}, les objets @code{Score},
-les objets @code{Lyrics} ; d'autres se rapportent à tous les
-éléments de notation, comme les barres de mesure, les liaisons, les
-nuances, etc. Chaque objet dispose de son propre échantillon de valeurs
-pour le réglage des propriétés.
+commande du type @code{\new Staff} apparaît, un nouvel objet du type
+@code{Staff} est créé. Cet objet @code{Staff} contient alors toutes les
+propriétés associées à cette portée, par exemple son nom et son armure,
+ainsi que le détail des graveurs qui ont été désignés pour fonctionner
+dans ce contexte de portée. Certains objets peuvent contenir les
+propriétés de tous les autres contextes, comme les objets @code{Voice},
+les objets @code{Score}, les objets @code{Lyrics} ; d'autres se
+rapportent à tous les éléments de notation, comme les barres de mesure,
+les liaisons, les nuances, etc. Chaque objet dispose de son propre
+échantillon de valeurs pour le réglage des propriétés.
Certains types d'objet portent des noms spécifiques. Les objets qui se
rapportent à des éléments de notation sur le fichier de sortie, comme
les notes, les hampes, les liaisons de phrasé ou de prolongation, les
-doigtés, les clefs, etc. sont appelés @qq{Objets de rendu} ; ils
-sont aussi connus sous le nom d'@qq{Objets graphiques} (en
-anglais : @emph{Graphical objects} ou @emph{Grobs} pour faire
-court). Ce sont bien des objets au sens générique ci-dessus et, en
-tant que tels, ils reçoivent des propriétés qui leur sont associées,
-comme leur position, leur taille, leur couleur etc.
+doigtés, les clefs, etc. sont appelés @qq{Objets de rendu} ; ils sont
+aussi connus sous le nom d'@qq{Objets graphiques} (en anglais :
+@emph{Graphical objects} ou @emph{Grobs} pour faire court). Ce sont
+bien des objets au sens générique ci-dessus et, en tant que tels, ils
+reçoivent des propriétés qui leur sont associées, comme leur position,
+leur taille, leur couleur etc.
Certains objets de rendu, comme les liaisons de phrasé, les soufflets
de crescendo, les marques d'octaviation et beaucoup d'autres
Il reste à expliquer ce que sont les @qq{interfaces}. De nombreux
objets, qui peuvent être très différents les uns des autres, ont pour
point commun de devoir être compilés simultanément. Par exemple, tous
-les @emph{grobs} ont une couleur, une taille, une position etc., et
+les @emph{grobs} ont une couleur, une taille, une position, etc. et
toutes ces propriétés sont compilées simultanément durant
l'interprétation du fichier d'entrée par LilyPond. Pour alléger ces
opérations internes, ces actions et propriétés communes sont regroupées
@cindex retouches, méthodologie
@cindex méthodes de retouche
+
@strong{La commande \override}
@cindex override, commande
Le contexte @var{Contexte} peut être omis (c'est généralement
le cas) quand il n'y a pas d'ambiguïté et qu'il s'agit d'un contexte
-de très bas niveau, comme @code{Voice}, @code{ChordNames}
-ou @code{Lyrics}. Dans les exemples qui suivent, le contexte sera
-très souvent omis. Nous verrons plus tard dans quelles
-circonstances il doit impérativement être indiqué.
+de très bas niveau, comme @code{Voice}, @code{ChordNames} ou
+@code{Lyrics}. Dans les exemples qui suivent, le contexte sera très
+souvent omis. Nous verrons plus tard dans quelles circonstances il doit
+impérativement être indiqué.
Les sections ci-dessous traitent largement des propriétés et de leurs
valeurs -- voir @ref{Types de propriétés} -- mais, pour illustrer la
g4 a b c |
@end lilypond
+
@strong{La commande \revert}
@cindex revert, commande
b4 c |
@end lilypond
+
@strong{Le préfixe \once}
@funindex \once
@c Maybe explain in a later iteration -td
+
@strong{La commande \tweak}
@cindex tweak, commande
musical, c'est encore la commande @code{\tweak} qui est utilisée pour
changer l'apparence de l'un d'entre eux. Dans l'exemple suivant, le
long crochet de nolet et le premier des trois crochets courts commencent
-au même instant musical ; une commande @code{\override}
-s'appliquerait donc à la fois aux deux. En revanche, @code{\tweak}
-permet de les dissocier. La première commande @code{\tweak} indique que
-le long crochet doit être placé au-dessus des notes, et la seconde
-indique que le coefficient de nolet doit être imprimé en rouge sur le
-premier crochet de triolet court.
+au même instant musical ; une commande @code{\override} s'appliquerait
+donc à la fois aux deux. En revanche, @code{\tweak} permet de les
+dissocier. La première commande @code{\tweak} indique que le long
+crochet doit être placé au-dessus des notes, et la seconde indique que
+le coefficient de nolet doit être imprimé en rouge sur le premier
+crochet de triolet court.
@cindex @code{\tweak}, exemple
@cindex direction, exemple d'utilisation de la propriété
Admettons que nous voulions rendre les traits de liaison plus épais.
Est-ce possible ? Une liaison est assurément un objet de rendu, si
bien que la question est @qq{Existe-t-il une propriété attachée aux
-liaisons et qui en contrôle l'épaisseur ?} Pour y répondre, nous
+liaisons et qui en contrôle l'épaisseur ?} Pour y répondre, nous
consultons la Référence des propriétés internes (ou RPI pour faire
court).
@end example
Voilà qui semble approprié pour changer l'épaisseur (@emph{thickness} en
-anglais). On apprend que la valeur de @code{thickness}
-est un simple nombre (@emph{number}), qu'elle est par défaut définie
-à 1,2 et que l'unité de mesure est fixée par une autre propriété
-appelée @code{line-thickness}.
+anglais). On apprend que la valeur de @code{thickness} est un simple
+nombre (@emph{number}), qu'elle est par défaut définie à 1,2 et que
+l'unité de mesure est fixée par une autre propriété appelée
+@code{line-thickness}.
Comme il a été indiqué, on ne trouve que peu, voire pas du tout
d'explication dans la RPI, mais nous en savons assez pour essayer
@noindent
et nous constatons que le trait de liaison est beaucoup plus épais.
-Telle est la façon normale de construire les commandes
+Telle est la façon normale de construire des commandes
@code{\override}. Comme nous aurons l'occasion de le voir
par la suite, le problème est parfois plus complexe. Dans
l'immédiat, nous en savons assez pour construire nos propres
@cindex contexte, détermination du
@cindex contexte, identification correcte du
-Tout d'abord, de quoi avions-nous besoin pour préciser le
-contexte ? À quoi devait-il ressembler ? Gageons que les
-liaisons appartiennent au contexte Voix, dans la mesure où
-elles sont étroitement liées à une ligne mélodique, mais
-comment en être sûr ? Pour répondre à cette question,
-revenons en haut de la page de la RPI consacrée aux liaisons ;
+Tout d'abord, de quoi avions-nous besoin pour préciser le contexte ? À
+quoi devait-il ressembler ? Gageons que les liaisons appartiennent au
+contexte Voix, dans la mesure où elles sont étroitement liées à une
+ligne mélodique, mais comment en être sûr ? Pour répondre à cette
+question, revenons en haut de la page de la RPI consacrée aux liaisons ;
il est écrit : @qq{Les objets Liaison sont créés par le graveur
-Slur_engraver}. Ainsi les liaisons seront créées dans n'importe
-quel contexte où se trouve le @code{Slur_engraver}. Suivons
-le lien vers la page @code{Slur_engraver}. Tout en bas, on
-lit que le @code{Slur_engraver} est un élément appartenant
-à cinq contextes Voix, dont le contexte de voix
-standard, @code{Voice}. Notre hypothèse était donc juste.
-Et parce que @code{Voice} est un contexte de très bas
+Slur_engraver}. Ainsi les liaisons seront créées dans n'importe quel
+contexte où se trouve le @code{Slur_engraver}. Suivons le lien vers la
+page @code{Slur_engraver}. Tout en bas, on lit que le
+@code{Slur_engraver} est un élément appartenant à cinq contextes Voix,
+dont le contexte de voix standard, @code{Voice}. Notre hypothèse était
+donc juste. Et parce que @code{Voice} est un contexte de très bas
niveau, qu'il est activé sans ambiguïté par le fait que l'on est
en train de saisir des notes, on peut ici ne pas le mentionner.
@funindex once
Dans le dernier exemple ci-dessus, @emph{toutes} les liaisons étaient
-plus épaisses. Et si on veut épaissir uniquement la première
-liaison ? On recourt alors à la commande @code{\once}. Placée
-juste avant la commande @code{\override}, elle lui indique de ne changer
-que la liaison commençant avec la note @strong{juste après}. Si la note
-juste après n'ouvre pas une liaison, la commande sera sans aucun effet
--- elle ne reste pas en mémoire jusqu'à la prochaine liaison, elle est
-purement et simplement ignorée. Il faut donc que la commande introduite
-par @code{\once} soit insérée comme suit :
+plus épaisses. Et si on veut épaissir uniquement la première liaison ?
+On recourt alors à la commande @code{\once}. Placée juste avant la
+commande @code{\override}, elle lui indique de ne changer que la liaison
+commençant avec la note @strong{juste après}. Si la note juste après
+n'ouvre pas une liaison, la commande sera sans aucun effet -- elle ne
+reste pas en mémoire jusqu'à la prochaine liaison, elle est purement et
+simplement ignorée. Il faut donc que la commande introduite par
+@code{\once} soit insérée comme suit :
@cindex Slur, exemple de dérogation
@cindex thickness, exemple d'utilisation de la propriété
Et si l'on voulait que les deux premières liaisons soient plus
épaisses ? On pourrait bien sûr utiliser deux commandes, chacune
-précédée de @code{\once}, et placées juste avant la note par laquelle
+précédée de @code{\once} et placée juste avant la note par laquelle
débute la liaison :
-
@cindex liaison, exemple de dérogation
@cindex thickness, exemple d'utilisation de la propriété
@cindex épaisseur, exemple d'utilisation
Lorsqu'il s'agit de paroles et qu'on cherche à préciser le contexte
sur le modèle de ce qui a été fait précédemment, la commande échoue.
-Car une syllabe saisie en mode Paroles (lyricmode) se termine
+Car une syllabe saisie en mode Paroles (@code{lyricmode}) se termine
obligatoirement par une espace, un saut de ligne ou un nombre. Tout
autre caractère compte comme un élément de la syllabe. C'est pourquoi
il faut une espace ou un saut de ligne avant le @code{@}} final, pour
@tab @code{2.5}, @code{0.34}
@item Direction
@tab Une direction valide ou son équivalent numérique (valeur décimale
- comprise entre -1 et 1 seulement)
+ comprise entre -1 et 1 seulement)
@tab @code{LEFT}, @code{CENTER}, @code{UP}, @code{1}, @code{-1}
@item Entier (@emph{Integer} en anglais)
@tab Un nombre entier positif
@tab @code{3}, @code{1}
@item Liste
@tab Plusieurs valeurs séparées par une espace, encadrées par des
-parenthèses et précédées par une apostrophe
+ parenthèses et précédées par une apostrophe
@tab @code{'(left-edge staff-bar)}, @code{'(1)},
@code{'(1.0 0.25 0.5)}
@item Markup (ou étiquette)
@tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)}
@item Symbole
@tab L'un des symboles autorisés pour cette propriété, précédé par une
-apostrophe
+ apostrophe
@tab @code{'italic}, @code{'inside}
@item Inconnu (@emph{Unknown} en anglais)
@tab Un processus, ou @code{#f} pour empêcher toute action
@tab @code{bend::print}, @code{ly:text-interface::print}, @code{#f}
@item Vecteur
@tab Une liste de trois éléments encadrés par des parenthèses et
-précédés par apostrophe-hash, @code{'#}
+ précédés par apostrophe-hash, @code{'#}
@tab @code{'#(#t #t #f)}
@end multitable
@subheading stencil
+@c VO stencil
@cindex stencil, propriété
-@c VO stencil
Cette propriété contrôle l'apparence des barres de mesure en précisant
le type de symbole (glyphe) à imprimer. Comme pour de nombreuses
prévu, c'est parce que @code{Barline} n'appartient pas au contexte par
défaut, @code{Voice}. Si le contexte spécifié est erroné, la commande
ne fonctionne pas. Cela n'entraîne pas de message d'erreur, et rien
-n'apparaît dans le fichier log. Essayons de corriger en mentionnant le
-bon contexte :
+n'apparaît dans le fichier @emph{log}. Essayons de corriger en
+mentionnant le bon contexte :
@cindex BarLine, exemple de dérogation
@cindex stencil, exemple d'utilisation de la propriété
le cas, par exemple, si vous effacez le @code{stencil} d'un objet
@code{NoteHead}. Il vaut mieux, en pareil cas, utiliser la fonction
@code{point-stencil} qui, quant à elle, attribue à l'objet une taille à
-zero :
+zéro :
@lilypond[quote,verbatim,relative=2]
{
doivent être imprimées ou non à la fin de la ligne, à l'intérieur de la
ligne et au début de la ligne. Dans notre cas, nous voulons que toutes
les barres soient supprimées, si bien que la valeur dont nous avons
-besoin est @code{'#(#f #f #f)}. Essayons, sans oublier
-d'ajouter le contexte @code{Staff}. Vous remarquerez que, en plus de
-cette valeur, nous ajoutons @code{#'#} devant la parenthèse ouvrante.
-Le @code{'#} est nécessaire car il fait partie intégrante de la valeur
-contenant un vecteur, et le premier @code{#} est là, comme toujours avec
-la commande @code{\override}, pour introduire la valeur elle-même.
+besoin est @code{'#(#f #f #f)}. Essayons, sans oublier d'ajouter le
+contexte @code{Staff}. Vous remarquerez que, en plus de cette valeur,
+nous ajoutons @code{#'#} devant la parenthèse ouvrante. Le @code{'#}
+est nécessaire car il fait partie intégrante de la valeur contenant un
+vecteur, et le premier @code{#} est là, comme toujours avec la commande
+@code{\override}, pour introduire la valeur elle-même.
@cindex BarLine, exemple de dérogation
@cindex break-visibility exemple d'utilisation de la propriété
Il existe une troisième fonction, écrite pour convertir les valeurs RVB
en couleurs internes -- la fonction @code{rgb-color}. Elle comporte
trois arguments, donnant respectivement l'intensité du rouge, du vert et
-du bleu. Ces arguments prennent des valeurs comprises entre 0 et 1.
+du bleu. Ces arguments prennent des valeurs comprises entre 0 et 1.
Ainsi, pour choisir la couleur rouge, la valeur serait
-@code{(rgb-color 1 0 0)} ; pour le blanc, ce serait
-@code{(rgb-color 1 1 1)} :
+@code{(rgb-color 1 0 0)} ; pour le blanc, ce serait
+@code{(rgb-color 1 1 1)} :
@cindex BarLine, exemple de dérogation
@cindex color, exemple d'utilisation de la propriété
Les propriétés d'épaisseur (@code{thickness}), quant à elles, sont
généralement mesurées en unités d'une propriété interne appelée
@qq{épaisseur de ligne} (@code{line-thickness}). Par exemple, les
-lignes de crescendo/decrescendo présentent par défaut une épaisseur de
-1 unité de @code{line-thickness}, alors que l'épaisseur d'une hampe
+lignes de (de)crescendo présentent par défaut une épaisseur d'une
+unité de @code{line-thickness}, alors que l'épaisseur d'une hampe
est de 1,3. Toutefois, certaines propriétés d'épaisseur sont
différentes : par exemple, l'épaisseur des ligature --
@code{beam-thickness} -- se mesure en espaces de portée.
polices de caractères ? La solution consiste à utiliser une
fonction spéciale appelée @code{magstep} -- pseudo facteur de zoom --,
créée précisément dans ce but. Elle comporte un argument, le changement
-de taille de police (#-2 dans l'exemple précédent), à partir duquel elle
-applique un facteur de mise à l'échelle qui réduit, ou augmente, les
-objets en question. Voici comment elle s'utilise :
+de taille de police (@code{#-2} dans l'exemple précédent), à partir
+duquel elle applique un facteur de mise à l'échelle qui réduit, ou
+augmente, les objets en question. Voici comment elle s'utilise :
@cindex alignAboveContext, exemple d'utilisation de la propriété
@cindex @code{\with}, exemple
Pour de petits changements d'échelle, comme dans l'exemple ci-dessus, il
n'est généralement pas utile d'ajuster l'épaisseur des différentes
lignes telles que les barres de mesure, les ligatures, les soufflets de
-crescendo ou decrescendo, les liaisons, etc. Si l'épaisseur d'un objet
+crescendo ou decrescendo, les liaisons, etc. Si l'épaisseur d'un objet
en particulier doit être ajustée, le mieux est de modifier sa propriété
@code{thickness}. Nous avons vu plus haut, dans
@ref{Propriétés des objets de rendu}, un exemple de modification de
(@emph{outside-staff objects} en anglais).
Les objets de la portée sont ceux qui sont placés sur la portée
--- les têtes de notes et les hampes, les altérations, etc. Leur
+-- les têtes de notes et les hampes, les altérations, etc. Leur
position est généralement déterminée par la musique elle-même -- ils
sont placés verticalement sur des lignes spécifiques ou sont liés à
d'autres objets placés de cette manière. Normalement, les collisions
plus courantes, d'avoir à encoder les retouches.
Certains objets comme les traits des liaisons se recourbent tantôt
-vers le haut, tantôt vers le bas ; d'autres encore, comme les
-hampes et les crochets, peuvent se décaler vers la gauche ou vers la
-droite selon qu'ils pointent vers le haut ou vers le bas. Ce
-comportement est géré automatiquement dès lors que @code{direction} est
-activé.
+vers le haut, tantôt vers le bas ; d'autres encore, comme les hampes et
+les crochets, peuvent se décaler vers la gauche ou vers la droite selon
+qu'ils pointent vers le haut ou vers le bas. Ce comportement est géré
+automatiquement dès lors que @code{direction} est activé.
@cindex down
@cindex up
@item @code{\textSpannerDown}
@tab @code{\textSpannerUp}
@tab @code{\textSpannerNeutral}
- @tab Le texte saisi en tant qu'extension est au-dessous/au-dessus de la portée
+ @tab Le texte saisi en tant qu'extension est au-dessous/au-dessus de
+ la portée
@item @code{\tieDown}
@tab @code{\tieUp}
@tab @code{\tieNeutral}
On peut aller encore plus loin dans le positionnement des doigtés pour
chacune des notes d'un accord grâce à la commande
-@code{\set fingeringOrientations}. La syntaxe de cette commande
-est :
+@code{\set fingeringOrientations}. La syntaxe de cette commande est :
@example
@code{\set fingeringOrientations = #'([up] [left/right] [down])}
@emph{markup} (ou d'étiquette) n'est pas pris en compte, dans la mesure
où ce qui est concerné n'entre pas dans la musique. La commande
@code{\textLengthOn} inverse ce comportement, faisant en sorte que les
-notes soient espacées autant qu'il le faut pour s'adapter au
-texte :
+notes soient espacées autant qu'il le faut pour s'adapter au texte :
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
\textLengthOn % Cause notes to space out to accommodate text
De toute façon, si les notes et les nuances qui leur sont liées sont
trop proches, le positionnement automatique évitera les collisions en
déplaçant davantage les nuances suivantes, mais le résultat peut ne
-pas être très satisfaisant, comme le montre cet exemple
-artificiel :
+pas être très satisfaisant, comme le montre cet exemple artificiel :
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
\dynamicUp
horizontalement. Pour remédier à cela, on a ajouté l'infini à
l'extension gauche et moins l'infini à l'extension droite, en
attribuant à @code{extra-spacing-width} la valeur
-@code{'(+inf.0 . -inf.0)}. Pour être sûr que les objets ne se
+@code{'(+inf.0 . -inf.0)}. Pour être sûr que les objets ne se
chevaucheront pas horizontalement, nous devons donc corriger cette
-valeur de @code{extra-spacing-width} en @w{@code{'(0 . 0)}}, afin que
+valeur de @code{extra-spacing-width} en @code{'(0 . 0)}, afin que
leur vraie largeur se manifeste. La commande pour y parvenir avec des
indications de nuances est :
@item
Les @strong{propriétés d'objet}, auxquelles LilyPond a recours pour
positionner les objets, sont modifiables avec @code{\override}. Il y a
-deux avantages à changer ces propriétés : (a) d'autres objets
+deux avantages à changer ces propriétés : (a) d'autres objets
pourront être déplacés automatiquement si nécessaire pour faire de la
-place, et (b) la même retouche peut s'appliquer à toutes les occurrences
+place, et (b) la même retouche peut s'appliquer à toutes les occurrences
du même type d'objet. Ces propriétés sont :
@itemize
Cette propriété est très utile pour ajuster manuellement l'inclinaison
et la hauteur des barres de ligature, des liaisons et des nolets. Elle
est suivie de deux nombres qui donnent la position des extrémités gauche
-et droite des barres, liaisons, etc. par rapport à la ligne médiane de
+et droite des barres, liaisons, etc. par rapport à la ligne médiane de
la portée. L'unité de référence est l'intervalle de lignes de portée.
Attention toutefois au fait que les liaisons et phrasés ne peuvent pas
être repositionnés n'importe où. LilyPond commence par dresser la liste
@multitable @columnfractions .5 .5
-@headitem Type d'objet @tab Nom d'objet
-@item Articulations @tab @code{Script}
-@item Barres de ligature @tab @code{Beam}
-@item Doigté @tab @code{Fingering}
-@item Liaisons de phrasé @tab @code{Slur}
-@item Liaisons de prolongation @tab @code{Tie}
-@item Nolets @tab @code{TupletBracket}
-@item Nuances (verticalement) @tab @code{DynamicLineSpanner}
-@item Nuances (horizontalement) @tab @code{DynamicText}
-@item Reprises / marques de texte @tab @code{RehearsalMark}
-@item Texte, p.ex. @code{^"texte"} @tab @code{TextScript}
+@headitem Type d'objet @tab Nom d'objet
+@item Articulations @tab @code{Script}
+@item Barres de ligature @tab @code{Beam}
+@item Doigté @tab @code{Fingering}
+@item Liaisons de phrasé @tab @code{Slur}
+@item Liaisons de prolongation @tab @code{Tie}
+@item Nolets @tab @code{TupletBracket}
+@item Nuances (verticalement) @tab @code{DynamicLineSpanner}
+@item Nuances (horizontalement) @tab @code{DynamicText}
+@item Reprises / marques de texte @tab @code{RehearsalMark}
+@item Texte, par ex. @code{^"texte"} @tab @code{TextScript}
@end multitable
construction @code{<<@{@dots{}@} \\ @{@dots{}@}>>}), la propriété
@code{staff-position} est réglée sur @code{-4} pour les
@code{MultiMeasureRest} ; nous avons donc besoin de la déplacer, disons,
-de quatre demi-intervalles vers le bas, ce qui donne @code{-8}.
+de quatre demi-intervalles vers le bas, ce qui donne @code{-8}.
@cindex MultiMeasureRest, exemple de dérogation
@cindex staff-position, exemple d'utilisation de la propriété
verticalement.
Dans l'exemple suivant, la seconde indication de doigté est déplacée
-légèrement vers la gauche et de 1,8 intervalle de lignes vers le
-bas :
+légèrement vers la gauche et de 1,8 intervalle de lignes vers le bas :
@cindex Fingering, exemple de dérogation
@cindex extra-offset, exemple d'utilisation de la propriété
@noindent
On peut y remédier en déplaçant manuellement vers le haut les deux
extrémités des ligatures de croches, non plus à 1,81 intervalle
-au-dessous de la ligne médiane mais, disons, à 1 :
+au-dessous de la ligne médiane mais, disons, à 1 :
@cindex Beam, exemple de dérogation
@cindex positions, exemple d'utilisation de la propriété
exemple a été choisi en raison des problèmes inhabituels de notation
qu'il soulevait et pour vous apprendre à les résoudre grâce au Manuel de
notation. Il n'est pas représentatif d'une opération normale de
-gravure ; que ces difficultés ne vous découragent donc pas !
-Des difficultés comme celles-ci ne sont, heureusement, pas
-courantes !
+gravure ; que ces difficultés ne vous découragent donc pas ! Des
+difficultés comme celles-ci ne sont, heureusement, pas courantes !
Cet exemple est tiré de la Première Ballade de Chopin, Op. 23, mesures
6 à 9 ; cela correspond à la transition entre le Lento d'ouverture
qu'il faut nous reporter au Manuel de notation. Quand on cherche
@qq{arpège} et @qq{barre de mesure} dans l'index, on voit aisément qu'il
faut ajouter @code{\arpeggio} à un accord pour produire un arpège et
-qu'une double barre est le résultat de la commande
-@code{\bar "||"}. Rien de plus facile ! Nous devons ensuite
-corriger la collision entre la liaison et l'indication de mesure. Le
-mieux est de déplacer la liaison vers le haut. La méthode pour déplacer
-les objets a déjà été présentée dans @ref{Déplacement d'objets}, et l'on
-sait que, pour des objets positionnés par rapport à la portée, il nous
-faut modifier leur propriété @code{staff-position}, exprimée en
-demi-intervalles de lignes par rapport à la ligne médiane de la portée.
-Voici donc la retouche à insérer juste devant la première note
-liée ; elle est censée déplacer la liaison vers le haut de 3,5
-demi-intervalles de lignes au-dessus de la ligne médiane :
+qu'une double barre est le résultat de la commande @code{\bar "||"}.
+Rien de plus facile ! Nous devons ensuite corriger la collision entre
+la liaison et l'indication de mesure. Le mieux est de déplacer la
+liaison vers le haut. La méthode pour déplacer les objets a déjà été
+présentée dans @ref{Déplacement d'objets}, et l'on sait que, pour des
+objets positionnés par rapport à la portée, il nous faut modifier leur
+propriété @code{staff-position}, exprimée en demi-intervalles de lignes
+par rapport à la ligne médiane de la portée. Voici donc la retouche à
+insérer juste devant la première note liée ; elle est censée déplacer la
+liaison vers le haut de 3,5 demi-intervalles de lignes au-dessus de la
+ligne médiane :
@code{\once \override Tie #'staff-position = #3.5}
sur LilyPond. Cependant vous pouvez en découvrir encore plus en
consultant les fichiers internes de LilyPond. Pour cela, il vous faut
d'abord connaître le répertoire @emph{ad hoc} sur votre système.
-L'emplacement du répertoire dépend (a) du fait que, pour vous procurer
-LilyPond, vous avez téléchargé un paquet précompilé sur lilypond.org, ou
+L'emplacement du répertoire dépend (a) du fait que, pour vous procurer
+LilyPond, vous avez téléchargé un paquet précompilé sur lilypond.org ou
vous l'avez installé grâce à votre gestionnaire de paquetages
-(c'est-à-dire distribué avec Linux ou installé avec fink ou cygwin), ou
+(c'est-à-dire distribué avec GNU/Linux ou installé avec fink ou cygwin), ou
encore vous l'avez compilé directement à partir des sources ; et
-(b) du système d'exploitation sur lequel il tourne.
+(b) du système d'exploitation sur lequel il tourne.
+
@strong{Téléchargé depuis lilypond.org}
@itemize @bullet
-@item Linux
+@item GNU/Linux
@example
@file{@var{INSTALLDIR}/lilypond/usr/@/share/lilypond/current/}
@end itemize
+
@strong{Installé par un gestionnaire de paquetages ou compilé d'après
les sources}
@code{@var{PREFIX}/share/lilypond/@var{X.Y.Z}/}, où
@var{PREFIX} est déterminé par votre gestionnaire de paquetages ou par
-le script @code{configure}, et @var{X.Y.Z} est le numéro de version de
-LilyPond.
+le script @code{configure}, et @var{X.Y.Z} représente le numéro de
+version de LilyPond.
@smallspace
@headitem Nom de fichier
@tab Contenu
@item @file{ly/engraver-init.ly}
- @tab Définitions des Contextes de graveurs
+ @tab Définition des contextes de graveurs
@item @file{ly/paper-defaults-init.ly}
@tab Réglages papier par défaut
@item @file{ly/performer-init.ly}
- @tab Définitions des Contextes d'interprétation
+ @tab Définition des contextes d'interprétation
@item @file{ly/property-init.ly}
- @tab Définitions de toutes les commandes prédéfinies courantes
+ @tab Définition de toutes les commandes prédéfinies courantes
@item @file{ly/spanner-init.ly}
- @tab Définitions des commandes prédéfinies pour les bandeaux
+ @tab Définition des commandes prédéfinies pour les bandeaux
@end multitable
Les autres réglages (comme les définitions de commandes @emph{markup})
@tab Réglages par défaut pour les sorties MIDI
@item @file{scm/output-lib.scm}
@tab Réglages affectant l'apparence des frets, couleurs, altérations,
- barres de mesure etc.
+ barres de mesure, etc.
@item @file{scm/parser-clef.scm}
@tab Définition des clefs prises en charge
@item @file{scm/script.scm}
procédure. Dans cet exemple, nous colorons les têtes de notes en
fonction de leur position sur la portée.
-
@cindex x11-color, exemple d'utilisation de la fonction
@cindex NoteHead, exemple de dérogation
@cindex color, détermination de la propriété par une procédure Scheme
Vous trouverez dans @rextend{Fonctions de rappel} d'autres exemples
d'utilisation de ces interfaces programmables.
-
projects / lilypond.git / commitdiff