@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@ignore
- Translation of GIT committish: d46572826e777ed3e9fa4656535a6e9000f2ed9e
+ Translation of GIT committish: ec074a41f03cf4cd3b914daa1359dd6e0fb2012d
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Guide, node Updating translation committishes..
@end ignore
-@c \version "2.19.2"
+@c \version "2.19.21"
@c Translators: Jean-Charles Malahieude, Valentin Villenave
tagline = "... music notation for Everyone"
}
\score {
- \relative c' {
- c4 d e f
+ \relative {
+ c'4 d e f
}
}
}
Le contexte auquel appartient l'objet à annoter. Cet argument
peut être omis dès lors qu'il s'agit d'un contexte de bas niveau
tel que @code{Voice}.
-
+
@item nom-grob
Le type d'objet à annoter -- @samp{Flag} par exemple. Lorsque cet
élément est spécifié, c'est l'objet en question qui servira de point de
@lilypond[quote,verbatim,papersize=a8landscape]
\book {
\header { tagline = ##f }
- \relative c'' {
- a4_\footnote #'(0 . -1) "Une liaison arbitrairement en dessous" (
+ \relative {
+ a'4_\footnote #'(0 . -1) "Une liaison arbitrairement en dessous" (
b8^\footnote #'(1 . 0.5) "Une ligature manuelle forcée en haut" [
b8 ]
c4 )
\auto-footnote "recent" \italic " Aug 2012"
"composition."
}
- \relative c' {
+ \relative {
a'4 b8 e c4 d
}
}
}
"composition."
}
- \relative c' {
+ \relative {
a'4 b8 e c4 d
}
}
}
"composition."
}
- \relative c' {
+ \relative {
a'4 b8 e c4 d
}
}
N'hésitez pas à définir vous-même d'autres commandes et @emph{markups}
afin de construire une table plus élaborée :
@itemize
-@item
+@item
commencez par définir une nouvelle variable de type @code{markup} au
sein du bloc @code{\paper},
@ref{Regroupement automatique de parties}. Prenons l'exemple suivant :
@lilypond[verbatim,quote]
-sopranoMusic = \relative c'' { a4 b c b8( a) }
-altoMusic = \relative g' { e4 e e f }
-tenorMusic = \relative c' { c4 b e d8( c) }
-bassMusic = \relative c' { a4 gis a d, }
+sopranoMusic = \relative { a'4 b c b8( a) }
+altoMusic = \relative { e'4 e e f }
+tenorMusic = \relative { c'4 b e d8( c) }
+bassMusic = \relative { a4 gis a d, }
allLyrics = \lyricmode {King of glo -- ry }
<<
\new Staff = "Soprano" \sopranoMusic
@funindex \tag
@funindex \keepWithTag
@funindex \removeWithTag
-@funindex \pushToTag
-@funindex \appendToTag
@cindex tag
@cindex balise
+@cindex regroupement de balises
La commande @code{\tag #'@var{partieA}} affecte à une expression
musicale le nom @var{partieA}. Les expressions ainsi balisées pourront
@code{\removeWithTag #'(@var{nom1} @var{nom2}@dots{})}
@tab Musique non balisée et fragments appelés autrement que par
l'un des noms fournis seront inclus ; la musique balisée
- par autre chose que les noms mentionnés est exclue.
+ par autre chose que les noms mentionnés est exclue.
@item
Musique balisée non précédée de @code{\keepWithTag} ou
@end multitable
-Les arguments des commandes @code{\tag}, @code{\keepWithTag} et
-@code{\removeWithTag} doivent être un symbole (tel que
-@code{#'conducteur} ou @code{#'partie}), suivi d'une expression
-musicale.
+L'argument des commandes @code{\tag}, @code{\keepWithTag} et
+@code{\removeWithTag} doit être un symbole ou une liste de symboles
+(tel que @code{#'conducteur} ou @code{#'(violonI violonII)}), suivi
+d'une expression musicale. Si, @emph{et seulement si} les symboles sont
+des indentifiants LilyPond valides (caractères alphabétiques uniquement,
+sans chiffre, souligné ou tiret) qui ne peuvent se confondre avec des
+notes, le @code{#'} peut s'omettre et, pour raccourcir, une liste de
+symbole peut utiliser le point en séparateur -- autrement dit,
+@code{\tag #'(violinI violinII)} peut s'écrire @code{\tag
+violinI.violinII}. Ceci s'applique aussi bien pour @code{\keepWithTag}
+que pour @code{\removeWithTag}.
Dans l'exemple qui suit, nous obtenons deux versions du même extrait,
l'une pour le conducteur, l'autre pour l'instrumentiste qui, elle,
comportera les ornements développés.
@lilypond[verbatim,quote]
-music = \relative g' {
- g8. c32 d
+music = \relative {
+ g'8. c32 d
\tag #'trills { d8.\trill }
\tag #'expand { \repeat unfold 3 { e32 d } }
c32 d
Il est parfois plus aisé d'exclure des fragments :
@lilypond[verbatim,quote]
-music = \relative g' {
- g8. c32 d
+music = \relative {
+ g'8. c32 d
\tag #'trills { d8.\trill }
\tag #'expand {\repeat unfold 3 { e32 d } }
c32 d
exclus tous les fragments non concernés par l'une quelconque des
balises mentionnées.
+@cindex regroupements de balises
+@cindex balises, regroupement
+@funindex \tagGroup
+
+Bien que @code{\keepWithTag} soit efficace pour gérer @emph{un} jeu
+d'alternatives, le rejet de musique filtrée par des balises
+@emph{étrangères} se révèle problématique lorsque les @code{\tag} sont
+utilisés à plusieurs fins. Des « groupements de balises » peuvent
+alors être déclarés :
+
+@example
+\tagGroup #'(violinI violinII viola cello)
+@end example
+
+stipule que ces filtres respectifs appartiennent à un même groupe.
+
+@example
+\keepWithTag #'violinI @dots{}
+@end example
+
+ne sera donc concerné que par les balises @code{violinI} contenues dans
+le groupe de filtres : tout élément de la musique incluse qui serait
+balisé par un ou plusieurs des filtres de ce jeu mais @emph{pas} par
+@code{violinI} sera rejeté.
+
+Pour toute commande @code{\keepWithTag}, seules les balises du
+regroupement mentionnées dans la commande seront visibles.
+
+Une balise ne peut faire partie que d'un seul regroupement.
+
+@funindex \pushToTag
+@funindex \appendToTag
+@cindex raccordement dans une balise
+
Il peut arriver que vous ayez besoin de raccorder quelque chose en un
point particulier d'une expression musicale. Les commandes
@code{\pushToTag} et @code{\appendToTag} permettent d'insérer du
Ces deux instructions sont affectées d'une balise, le matériau à
raccorder à chaque instance de la balise, et l'expression balisée.
-Ces instructions prennent soin de recopier tout ce qui doit être
-modifié, de telle sorte que l'expression @code{\test} originale conserve
-tout son sens.
-
+
@seealso
Manuel d'initiation :
@rlearning{Organisation du code source avec des variables}.
LilyPond n'effectue aucune conversion d'encodage que ce soit. Ceci
implique donc que tout texte -- un titre, des paroles ou même une
-instruction musicale -- comportant des caractères non ASCII soit
+instruction musicale -- comportant des caractères non ASCII soit
codé en UTF-8. Le plus sûr moyen de saisir du texte de la sorte
consiste à utiliser un éditeur supportant l'unicode et à enregistrer vos
fichier en UTF-8. C'est le cas pour la plupart des éditeurs actuels,
à vo -- cê uma can -- ção legal
}
-\relative c' {
- c2 d e f g f e
+\relative {
+ c'2 d e f g f e
}
\addlyrics { \bulgarian }
\addlyrics { \hebrew }
@lilypond[quote,verbatim]
\score {
- \relative c'' {
- c1 \mark \markup { \char ##x03EE }
+ \relative {
+ c''1 \mark \markup { \char ##x03EE }
c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
}
\addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
}
-\markup { "Copyright 2008--2014" \char ##x00A9 }
+\markup { "Copyright 2008--2015" \char ##x00A9 }
@end lilypond
@cindex copyright
@subsection Extraction de fragments musicaux
@translationof Extracting fragments of music
-LilyPond permet d'extraire des fragments d'une partition à l'instar du
-choriste amateur qui alimente son album avec des coupures de journaux.
+@cindex fragments, extraction
-Vous devrez pour cela définir les mesures à découper. La définition
-suivante, incluse dans votre fichier source,
+@funindex clip-regions
-@verbatim
-\layout {
+LilyPond permet d'extraire des fragments d'une partition, une fois
+definis explicitement le ou les emplacements de la musique concernés au
+sein du bloc @code{\layout} du fichier source, grâce à la fonction
+@code{clip-regions}, puis en lançant @command{lilypond} avec l'option
+@w{@code{-dclip-systems}}.
+
+@example
+\layout @{
clip-regions
= #(list
(cons
(make-rhythmic-location 5 1 2)
(make-rhythmic-location 7 3 4)))
-}
-@end verbatim
+@}
+@end example
@noindent
-vous permettra d'extraire un fragment compris entre le milieu de la
-cinquième mesure et quelque part dans la septième. Le triplet
-@code{5 1 2} signifie : après la durée d'une blanche dans la mesure 5 ;
-le @code{7 3 4} signifie quant à lui que l'on s'arrête à la mesure 7,
-après la durée de trois noires.
+L'exemple ci-dessus permet d'extraire un seul fragment @emph{débutant}
+après une blanche dans la cinquième mesure (@code{5 1 2}) et
+@emph{finissant} après trois noires dans la septième
+mesure (@code{7 3 4}).
+
+D'autres fragments seront extraits dès lors que d'autres paires de
+@w{@code{make-rhythmic-location}} auront été ajoutées à la liste de
+@w{@code{clip-regions}} présente dans le bloc @code{\layout}.
+
+Chaque fragment sera généré individuellement sous la forme d'un fichier
+@code{EPS}, converti en @code{PDF} ou @code{PNG} selon le format que
+vous aurez stipulé. La musique extraite est rendue comme si elle avait
+été littéralement « découpée » dans la partition. Par voie de
+conséquence, un fragment dépassant une ligne fera l'objet d'autant de
+fichiers séparés que de lignes de la partition complète.
-Rien ne vous empêche d'extraire plusieurs fragments, dès lors que vous
-définissez dans la liste d'autres paires d'emplacements rythmiques.
-
-Cette fonctionnalité n'est toutefois effective que lorsque vous lancez
-LilyPond avec l'option @w{@code{-dclip-systems}}. Les @qq{coupures}
-seront générées sous la forme de fichiers EPS, convertis en PDF ou PNG
-selon le format que vous aurez stipulé.
+@seealso
+Manuel de notation :
+@ref{Le bloc layout}.
-Pour de plus amples informations quant au format des résultats,
-consultez le chapitre @rprogram{Lancement de lilypond}.
+Manuel d'utilisation :
+@rprogram{Utilisation en ligne de commande}.
@node Ignorer des passages de la partition
MIDI (Musical Instrument Digital Interface) constitue un standard en
matière de connexion et de contrôle des instruments électroniques. Un
fichier MIDI contient une série de notes réparties dans différentes
-pistes. Il ne s'agit en rien d'un fichier sonore ; il vous faudra
-un logiciel capable de traduire ces séries de notes en sons réels.
+pistes. Il ne s'agit en rien d'un fichier sonore ; il vous faudra un
+logiciel capable de traduire ces séries de notes en sons réels.
Vous pouvez convertir vos partition en fichier MIDI de manière à
entendre ce que vous avez saisi. Ceci vous permet de contrôler aisément
cependant obtenir un meilleur rendu avec @ref{Le script Articulate}.
Dans une sortie MIDI, LilyPond alloue un canal à chaque portée, tout en
-réservant le canal 10 aux percussions. Dans la mesure ou un
+réservant le canal 10 aux percussions. Dans la mesure ou un
périphérique MIDI ne comprend que 16 canaux, un fichier MIDI qui
comportera plus de quinze portées verra le même canal réutilisé.
chargés de traduire la musique en son s'appellent des « interprètes » --
@emph{performers} en anglais.
-
@snippets
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{changing-midi-output-to-one-channel-per-voice.ly}
+@seealso
+Manuel d'initiation :
+@rlearning{Autres sources de documentation}.
+
+Manuel de notation :
+@ref{Signes d'interprétation},
+@ref{Mise en forme de la partition}.
+
+Fichiers d'initialisation :
+@file{ly/performer-init.ly}.
+
+Morceaux choisis :
+@rlsr{MIDI}.
+
+Référence des propriétés internes :
+@rinternals{Dynamic_performer}.
+
@knownissues
Certains systèmes d'exploitation requièrent que les fichiers MIDI
portent l'extension @code{.mid}. Si besoin est, placez la ligne
Certains lecteurs MIDI ne rendent pas correctement les changements de
tempo.
-
-@seealso
-Fichiers d'initialisation :
-@file{../ly/performer-init.ly}.
-
-Manuel d'initiation :
-@rlearning{Autres sources de documentation}.
+Les modifications de @code{midiInstrument} ou autres options MIDI en
+début de portée peuent se retrouver dédoublées dans la sortie MIDI.
@node Instrument MIDI
dénominations consacrées, LilyPond le replacera par un piano de concert
(@code{"acoustic grand"}).
+@seealso
+Manuel de notation :
+@ref{Instruments MIDI}.
+
+Référence des propriétés internes :
+@rinternals{Dynamic_performer}.
+
@node Contenu de la sortie MIDI
@subsection Contenu de la sortie MIDI
les accords nommés ;
@item
-le rythme en tant que durée de note, y compris les nolets ;
+le rythme en tant que durée de note, y compris les n-olets ;
@item
les trémolos, exceptés ceux utilisant la syntaxe
les changements de tempo indiqués par un @code{\tempo} ;
@item
-les paroles.
+les paroles,
+
+@item
+les articulations simples : staccato, staccatissimo, accent, marcato,
+portato,
+
+@item
+les respirations.
@end itemize
Si vous utilisez @ref{Le script Articulate}, d'autres éléments seront
alors inclus :
@itemize
-@item articulations (lié, staccato, etc.),
-@item trilles et groupettos,
-@item rallentando et accelerando.
+@item liaisons d'articulation ou de phrasé,
+@item ornements (mordants, trilles et groupettos, etc.),
+@item rallentando, accelerando, ritard. et a tempo.
@end itemize
+@seealso
+Manuel de notation :
+@ref{Altérations},
+@ref{Signes de respiration},
+@ref{Signes d'interprétation}.
+
+Fichiers d'initialisation :
+@file{ly/articulate.ly}.
+
@node Éléments non pris en compte dans le MIDI
@unnumberedsubsubsec Éléments non pris en compte dans le MIDI
@c TODO index as above
-LilyPond ne peut générer d'événement MIDI pour les éléments
-suivant, sauf à utiliser @ref{Le script Articulate} :
+LilyPond ne peut générer d'événement MIDI pour les éléments suivant,
+même avec @ref{Le script Articulate} :
@itemize
@item
@code{\tempo}) ;
@item
-les staccatos et autres articulations ou ornementations ;
+les points d'orgue ;
+
+@item
+les autres articulations ;
@item
les liaisons d'articulation et de phrasé ;
@item
les accords en microtonalité.
+
+@item
+les glissandos, chutes et sauts.
@end itemize
+@seealso
+Fichiers d'initialisation :
+@file{ly/articulate.ly}.
+
@node Répétitions et MIDI
@subsection Répétitions et MIDI
soient mentionnée correctement dans @strong{toutes} les voix.
Lorsque l'on veut utiliser @code{\unfoldRepeats} seulement pour le rendu
-MIDI, il faut établir deux blocs @code{\score} : un pour le MIDI,
-avec des reprises explicites, et l'autre pour la partition, avec des
-reprises notées sous forme de barres de reprise, de trémolo ou de
-symboles de pourcentage. Par exemple
+MIDI, il faut établir deux blocs @code{\score} : un pour le MIDI, avec
+des reprises explicites, et l'autre pour la partition, avec des reprises
+notées sous forme de barres de reprise, de trémolo ou de symboles de
+pourcentage. Par exemple
@example
\score @{
@}
@end example
+@seealso
+Manuel de notation :
+@ref{Mise en forme de la partition}.
+
+Fichiers d'initialisation :
+@file{ly/articulate.ly}.
+
@node Gestion des nuances en MIDI
@subsection Gestion des nuances en MIDI
\set Staff.midiInstrument = #"cello"
\set Score.dynamicAbsoluteVolumeFunction = #myDynamics
\new Voice {
- \relative c'' {
- a4\pp b c-\rfz
+ \relative {
+ a'4\pp b c-\rfz
}
}
}
@file{../scm/midi.scm} ainsi que la table d'association comme base.
Le dernier exemple de cette partie illustre la manière de procéder.
+@seealso
+Manuel de notation :
+@ref{Signes d'interprétation},
+@ref{Mise en forme de la partition}.
+
+Fichiers d'initialisation :
+@file{scm/midi.scm}.
+
+Référence des propriétés internes :
+@rinternals{Dynamic_performer}.
+
@node Amplitude du volume en MIDI
@unnumberedsubsubsec Amplitude du volume en MIDI
\key g \major
\time 2/2
\set Staff.midiInstrument = #"flute"
- \new Voice \relative c''' {
- r2 g\mp g fis~
+ \new Voice \relative {
+ r2 g''\mp g fis~
4 g8 fis e2~
4 d8 cis d2
}
\new Staff {
\key g \major
\set Staff.midiInstrument = #"clarinet"
- \new Voice \relative c'' {
- b1\p a2. b8 a
+ \new Voice \relative {
+ b'1\p a2. b8 a
g2. fis8 e
fis2 r
}
}
@end lilypond
+@seealso
+Manuel de notation :
+@ref{Mise en forme de la partition}.
+
+Référence des propriétés internes :
+@rinternals{Dynamic_performer}.
+
@node Égalisation de plusieurs instruments (i)
@unnumberedsubsubsec Égalisation de plusieurs instruments (i)
\set Staff.midiInstrument = #"flute"
\set Staff.midiMinimumVolume = #0.7
\set Staff.midiMaximumVolume = #0.9
- \new Voice \relative c''' {
- r2 g\mp g fis~
+ \new Voice \relative {
+ r2 g''\mp g fis~
4 g8 fis e2~
4 d8 cis d2
}
\set Staff.midiInstrument = #"clarinet"
\set Staff.midiMinimumVolume = #0.3
\set Staff.midiMaximumVolume = #0.6
- \new Voice \relative c'' {
- b1\p a2. b8 a
+ \new Voice \relative {
+ b'1\p a2. b8 a
g2. fis8 e
fis2 r
}
}
@end lilypond
+@seealso
+Manuel de notation :
+@ref{Mise en forme de la partition}.
+
@node Égalisation de plusieurs instruments (ii)
@unnumberedsubsubsec Égalisation de plusieurs instruments (ii)
\time 2/2
\set Score.instrumentEqualizer = #my-instrument-equalizer
\set Staff.midiInstrument = #"flute"
- \new Voice \relative c''' {
- r2 g\mp g fis~
+ \new Voice \relative {
+ r2 g''\mp g fis~
4 g8 fis e2~
4 d8 cis d2
}
\new Staff {
\key g \major
\set Staff.midiInstrument = #"clarinet"
- \new Voice \relative c'' {
- b1\p a2. b8 a
+ \new Voice \relative {
+ b'1\p a2. b8 a
g2. fis8 e
fis2 r
}
}
@end lilypond
+@seealso
+Fichiers d'initialisation :
+@file{scm/midi.scm}.
+
+Référence des propriétés internes :
+@rinternals{Dynamic_performer}.
+
@ignore
@c Delete when satisfied this is adequately covered elsewhere -td
@lilypond[verbatim,quote]
\score {
- \relative c' {
- c4 cih cis cisih
+ \relative {
+ c'4 cih cis cisih
d4 dih ees eeh
e4 eih f fih
fis4 fisih g gih
les instruments concernés au canal 10 qui leur est réservé.
Certains instruments, tels le xylophone, le marimba, le vibraphone ou
-les timbales, se traitent cependant comme des instruments
-@qq{classiques} puisqu'ils sont capables d'émettre des hauteurs
-différentes ; leurs notation relève donc d'un contexte @code{Staff}
-standard, et non d'un @code{DrumStaff} pour pouvoir être rendus
-correctement en MIDI.
+les timbales, se traitent cependant comme des instruments « classiques »
+puisqu'ils sont capables d'émettre des hauteurs différentes ; leurs
+notation relève donc d'un contexte @code{Staff} standard, et non d'un
+@code{DrumStaff} pour pouvoir être rendus correctement en MIDI.
D'autres percussions, bien que n'émettant qu'un seul son et inclus dans
le standard @emph{general MIDI}, comme le tom mélodique ou le tambour
-taiko, ne sont pas attachés au canal 10. Ces instruments doivent
-donc être saisi dans un contexte @code{Staff}, en utilisant la hauteur
+taiko, ne sont pas attachés au canal 10. Ces instruments doivent donc
+être saisi dans un contexte @code{Staff}, en utilisant la hauteur
appropriée.
De nombreux instruments de la famille des percussions, les castagnettes
@c TODO Expand with examples, and any other issues
+@seealso
+Manuel de notation :
+@ref{Percussions},
+@ref{Mise en forme de la partition}.
+
+Référence des propriétés internes :
+@rinternals{Dynamic_performer}.
+
@knownissues
Le standard @emph{general MIDI} ne dispose pas du @emph{rim shot} ;
LilyPond lui substitue un @emph{sidestick}.
@example
\unfoldRepeats \articulate <<
- tout le reste du bloc contenant la partition@dots{}
+ tout le reste du bloc contenant la partition@dots{}
>>
@end example
illustré ci-dessus permettra le rendu d'un certain nombre
d'articulations tels les trilles.
+@seealso
+Manuel de notation :
+@ref{Mise en forme de la partition}.
+
+Fichiers d'initialisation :
+@file{ly/articulate.ly}.
+
+Référence des propriétés internes :
+@rinternals{UnfoldedRepeatedMusic}.
+
@knownissues
Dans la mesure où le script @code{articulate} tend à raccourcir les
accords, certaines musiques, notamment pour l'orgue, paraîtront de moins
affichera
@example
-@{ a,4 cis e fis g @}
+@{ a,4 cis4 e4 fis4 g4 @}
@end example
LilyPond affichera le résultat sous forme de message en console, au