@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
-
@ignore
- Translation of GIT committish: d0c96d3f0b1dca7df98ef5586059965dd46ab16f
+ Translation of GIT committish: 1ac60f7a65210612bcb5a6e508fee4986d8c2701
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.14.0"
+@c \version "2.15.32"
@c Translators: Jean-Charles Malahieude, Valentin Villenave
* Travail sur des fichiers texte::
* Contrôle des sorties::
* Sortie MIDI::
-* Extraction d'information musicale::
+* Extraction d'informations musicales::
@end menu
@node Agencement du code
@seealso
Manuel d'initiation :
-@rlearning{Travail sur les fichiers d'entrée},
+@rlearning{La partition est une (unique) expression musicale composée},
@rlearning{Les expressions musicales en clair},
-@rlearning{La partition est une (unique) expression musicale composée}.
+@rlearning{Travail sur les fichiers d'entrée}.
@node Plusieurs partitions dans un même ouvrage
@}
@end example
-génèrera
+générera
@itemize
@item
@subsection Nom des fichiers de sortie
@translationof Output file names
+@funindex \bookOutputSuffix
+@funindex \bookOutputName
+
LilyPond vous permet de prendre le contrôle dans la dénomination des
fichiers que vous voulez générer, quel que soit le moteur de rendu
utilisé.
expression apparaît à plusieurs reprises, la dernière aura préséance.
@item
-Une expression scheme pure, telle que
+Une expression Scheme pure, telle que
@w{@code{#(set-default-paper-size@tie{}"a7"@tie{}'landscape)}} ou
@w{@code{#(ly:set-option@tie{}'point-and-click@tie{}#f)}}.
@{ c'4 d' e'2 @}
@}
@}
+ \layout @{ @}
@}
- \layout @{ @}
- \header @{ @}
+ \paper @{ @}
+ \header @{ @}
@}
@end example
@end example
Vous pourrez la réutiliser plus loin dans votre fichier en saisissant
-simplement @code{\toto}. Le nom des indentificateurs ne doit être
+simplement @code{\toto}. Le nom des identificateurs ne doit être
formés que de caractères alphabétiques -- sans chiffre ni caractère
souligné ou tiret.
@{ c'4 d' e2 @}
@end example
-Vous pouvez placer, n'importe où dans votre fichier, les instruction
+Vous pouvez placer, n'importe où dans votre fichier, les instructions
suivantes@tie{}:
@itemize
@item
Après chaque commande ou variable, autrement dit tout élément qui
-commence par un @code{\}@tie{};
+commence par un@tie{}@code{\}@tie{};
@item
Après tout élément qui sera interprété comme une expression Scheme,
@menu
* Création de titres et entête ou pied de page::
* Titrages personnalisés::
+* Notes de bas de page::
* Référencement des numéros de page::
* Table des matières::
@end menu
@funindex print-all-headers
@noindent
-Vous pouvez modifer ce comportement et imprimer tous les champs d'un
+Vous pouvez modifier ce comportement et imprimer tous les champs d'un
bloc @code{\header} défini dans un bloc @code{\score} en ajoutant
@example
\header {
title = "DAS WOHLTEMPERIRTE CLAVIER"
subtitle = "TEIL I"
- % Pas de pied en dernière page pour ce livret
+ % Pas de mention spéciale pour cet ouvrage
tagline = ##f
}
\markup { \vspace #1 }
@lilypond[papersize=a6,quote,verbatim,noragged-right]
\header {
% Les champs suivants sont centrés
- dedication = "Dédice"
+ dedication = "Dédicace"
title = "Titre"
subtitle = "Sous-titre"
subsubtitle = "Sous-sous-titre"
instrument = "Instrument"
- % Les champs suivants sont alignés sur le bord gauche
+ % Les champs suivants sont alignés par la gauche
poet = "Librettiste"
meter = "Tempo"
- % Les champs suivants sont alignés sur le bord droit
+ % Les champs suivants sont alignés par la droite
composer = "Compositeur"
arranger = "Arrangeur"
}
@translationof Default layout of headers and footers
Les entête et pied -- @emph{headers} et @emph{footers} -- sont des
-lignes de textes qui apparaîssent en haut et en bas de chaque page,
+lignes de textes qui apparaissent en haut et en bas de chaque page,
indépendamment du texte de l'ouvrage. Ils sont contrôlés par les
variables suivantes, attachées au bloc @code{\paper}@tie{}:
@ref{Mise en forme par défaut des titrages}.
+@node Notes de bas de page
+@subsection Notes de bas de page
+@translationof Creating footnotes
+
+LilyPond dispose de deux méthodes pour créer des notes de bas de page,
+l'une automatisée, et l'autre manuelle.
+
+@menu
+* Considérations générales en matière de note de bas de page::
+* Notes de bas de page automatiques::
+* Notes de bas de page manuelles::
+@end menu
+
+@node Considérations générales en matière de note de bas de page
+@unnumberedsubsubsec Considérations générales en matière de note de bas de page
+@translationof Footnotes overview
+
+Il est parfois judicieux, notamment lorsqu'une annotation ou un
+commentaire gênerait la lecture de la partition, de les reporter en bas
+de page.
+
+Les notes de bas de page automatiques font appel à un compteur
+numérique incrémenté automatiquement@tie{}; les notes de bas de page
+manuelles vous laissent le libre choix de l'appel (l'indicateur). Tout
+objet graphique, @code{\markup} de haut niveau ou les notes d'un accord
+peuvent faire l'objet d'une annotation.
+
+L'ordre dans lequel les objets seront dessinés détermine l'ordre des
+appels et comment les annotations seront créées lors de la compilation.
+
+
+@node Notes de bas de page automatiques
+@unnumberedsubsubsec Notes de bas de page automatiques
+@translationof Automatic footnotes
+
+@cindex note de bas de page automatique
+@cindex bas de page, note automatique
+
+@funindex \footnote
+
+La commande @code{\footnote} permet de générer automatiquement des notes
+de bas de page. Elle requiert trois arguments@tie{}: l'@var{Objet de
+Rendu} auquel s'applique le commentaire rapporté en bas de page, la
+position @samp{(x@tie{}.@tie{}y)} de l'appel de note, et enfin un
+@code{\markup} contenant l'annotation qui apparaîtra en bas de la page.
+
+La commande @code{\footnote} doit être mentionnée @strong{avant}
+l'objet auquel la note est attachée.
+
+@c KEEP LY
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ \footnote #'(0.5 . -2) #'NoteHead
+ \markup { La première note }
+ a'4 b8
+ \footnote #'(0.5 . 1) #'NoteHead
+ \markup { La troisième note }
+ e c4 d4
+ }
+}
+@end lilypond
+
+Lorsqu'il s'agit de notes inscrites dans un accord, la commande
+@code{\footnote} doit être mentionnée @strong{après} la note à laquelle
+le @code{TextScript} fait référence.
+
+@c KEEP LY
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ <
+ c-\footnote #'(1 . -1.25) "Voici un do"
+ es-\footnote #'(2 . -0.25) \markup { \italic "Un mi bémol" }
+ g-\footnote #'(2 . 3) \markup { \bold "Ceci est un sol" }
+ >1
+ }
+}
+@end lilypond
+
+@warning{Lorsque plusieurs notes de bas de page se rapportent à un même
+empilement vertical, les notes apparaîtront dans l'ordre vertical des
+appels, autrement dit celui positionné le plus haut en premier, et ainsi
+de suite.}
+
+Voici quelques exemples d'objets annotés automatiquement. Vous pouvez
+constater l'agencement des annotations correspondantes avec le copyright
+et le pied de page.
+
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { copyright = \markup { "Copyright 1970" } }
+ \relative c' {
+ \footnote #'(-3 . 0) #'DynamicText
+ \markup { \bold Forte }
+
+ \footnote #'(0 . 1.5) #'Slur
+ \markup { A slur }
+ a'4\f(
+
+ \footnote #'(0 . -2) #'Beam
+ \markup { Beam }
+ b8)[ e]
+
+ \footnote #'(1 . -1) #'Stem
+ \markup { \teeny { This is a stem } }
+ c4
+
+ \footnote #'(0 . 0.5) #'AccidentalCautionary
+ \markup \italic { A cautionary accidental }
+
+ \footnote #'(0.5 . -0.5) #'TextScript
+ \markup \italic { Slow Down }
+ dis?4_"rit."
+ }
+}
+@end lilypond
+
+Une note de bas de page affectant un @code{\markup} de haut niveau
+s'introduit par la commande @code{\auto-footnote}@tie{}:
+
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \markup { \auto-footnote "A simple tune" \italic "By me" }
+ \relative c' {
+ a'4 b8 e c4 d
+ }
+}
+@end lilypond
+
+
+@node Notes de bas de page manuelles
+@unnumberedsubsubsec Notes de bas de page manuelles
+@translationof Manual footnotes
+
+@cindex note de bas de page manuelle
+@cindex bas de page, note manuelle
+
+@funindex \footnote
+@funindex \footnoteGrob
+
+LilyPond permet aussi de créer des notes de bas de page manuelles@tie{}:
+la commande @code{\footnote} prend alors quatre arguments@tie{}:
+l'@var{Objet de Rendu} devant être annoté, la position
+@samp{(x@tie{}.@tie{}y)} de l'appel de note, et deux @code{\markup} --
+le premier contient l'appel qui s'attache à la note ou à l'objet
+référencé, le second contient l'annotation qui est reportée en bas de
+page.
+
+Tout comme dans le cas d'une note de bas de page automatique, la commande
+@code{\footnote} doit être mentionnée comme s'il s'agissait d'une
+articulation, donc @strong{avant} l'objet auquel l'annotation fait
+référence.
+
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ a'4-\footnote
+ "1" #'(0.5 . -2) #'NoteHead \markup { \italic "1. The first note" }
+ b8
+ e-\footnote
+ \markup { \bold "2" } #'(0.5 . 1) #'NoteHead "2. The second note"
+ c4
+ d\p-\footnote "3" #'(0.5 . -1) #'DynamicText "3. Piano"
+ }
+}
+@end lilypond
+
+S'agissant d'annoter l'une des notes d'un accord, la commande
+@code{\footnote} doit être mentionnée @strong{après} la note à laquelle
+l'annotation fait référence, comme s'il s'agissait d'une articulation.
+
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ <
+ c-\footnote "1" #'(1 . -1.25) "1. C"
+ es-\footnote
+ \markup { \bold "b" } #'(2 . -0.25) "b. E-flat"
+ g-\footnote "3" #'(2 . 3) \markup { \italic "iii. G" }
+ >1
+ }
+}
+@end lilypond
+
+@warning{Lorsque plusieurs notes de bas de page se rapportent à un même
+empilement vertical, les notes apparaîtront dans l'ordre vertical des
+appels, autrement dit celui positionné le plus haut en premier, et ainsi
+de suite.}
+
+Voici quelques exemples d'objets annotés manuellement. Vous pouvez
+constater l'agencement des annotations correspondantes avec le copyright
+et le pied de page.
+
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ \footnote
+ \markup { \teeny 1 } #'(-3 . 0) #'DynamicText
+ \markup { 1. \bold Forte }
+
+ \footnote
+ \markup { \teeny b } #'(0 . 1.5) #'Slur
+ \markup { b. A slur }
+ a'4\f(
+
+ \footnote
+ \markup { \teeny 3 } #'(0 . -2) #'Beam
+ \markup { 3. Beam }
+ b8)[ e]
+
+ \footnote
+ \markup { 4 } #'(1 . -1) #'Stem
+ \markup { \bold 4. { This is a stem } }
+ c4
+
+ \footnote
+ \markup \concat \teeny { "sharp (v)" }
+ #'(0 . 0.5) #'AccidentalCautionary
+ \markup \italic { v. A cautionary accidental }
+
+ \footnote
+ \markup \concat \teeny { "a" } #'(0.5 . -0.5) #'TextScript
+ \markup \italic { a. Slow Down }
+ dis?4_"rit."
+
+ \breathe
+ \footnote
+ \markup { \teeny \musicglyph #"rests.4" }
+ #'(1.5 . -0.25) #'BreathingSign
+ \markup { \null }
+ }
+}
+@end lilypond
+
+L'annotation manuelle d'un @code{\markup} de haut niveau répond à la
+syntaxe suivante@tie{}:
+
+@lilypond[verbatim,quote,ragged-right,papersize=a8]
+\book {
+ \header { tagline = ##f }
+ \markup { "A simple tune" \footnote "*" \italic "* By me" }
+ \relative c' {
+ a'4 b8 e c4 d4
+ }
+}
+@end lilypond
+
+@seealso
+Manuel d'initiation :
+@rlearning{Objets et interfaces}.
+
+Manuel de notation :
+@ref{Commentaires textuels},
+@ref{Indications textuelles},
+@ref{Info-bulle},
+@ref{Mise en forme de la page},
+@ref{Titres et entêtes}.
+
+Référence des propriétés internes :
+@rinternals{FootnoteEvent},
+@rinternals{FootnoteItem},
+@rinternals{FootnoteSpanner},
+@rinternals{Footnote_engraver}.
+
+@knownissues
+Un silence multimesures ne peut se voir affecter une note de bas de
+page.
+
+Les notes de bas de page ne peuvent que s'empiler l'une au-dessus de
+l'autre@tie{}; elles ne seront jamais présentées à la queue leu leu.
+Les notes de bas de page peuvent générer des chevauchements quand elles
+sont trop nombreuses sur une même page.
+
+Dès lors que vous utilisez une commande de note de bas de page manuelle,
+le bloc @code{\paper} doit contenir la mention
+@w{@code{footnote-auto-number@tie{}=@tie{}##f}}.
+
+
@node Référencement des numéros de page
@subsection Référencement des numéros de page
@translationof Reference to page numbers
L'instruction @code{\page-ref} prend trois arguments@tie{}:
@enumerate
@item
-le point de référence, sous la forme d'un symbole scheme, comme par
+le point de référence, sous la forme d'un symbole Scheme, comme par
exemple @code{#'firstScore},
@item
@subsection Table des matières
@translationof Table of contents
-La commande @code{\markuplines \table-of-contents} vous permettra de
+La commande @code{\markuplist \table-of-contents} vous permettra de
générer une table des matières. Les éléments qui la composeront sont
créés par la commande @code{\tocItem}, insérée indépendamment ou au sein
d'une expression musicale.
@verbatim
-\markuplines \table-of-contents
+\markuplist \table-of-contents
\pageBreak
\tocItem \markup "Premier mouvement"
(add-toc-item! 'tocActMarkup text))
\book {
- \markuplines \table-of-contents
+ \markuplist \table-of-contents
\tocAct \markup { Atto Primo }
\tocItem \markup { Coro. Viva il nostro Alcide }
\tocItem \markup { Cesare. Presti omai l'Egizzia terra }
}
\book {
- \markuplines \table-of-contents
+ \markuplist \table-of-contents
\tocItem \markup { Allegro }
\tocItem \markup { Largo }
\markup \null
@menu
* Insertion de fichiers LilyPond::
* Différentes éditions à partir d'une même source::
-* Codage du texte::
+* Caractères spéciaux::
@end menu
@node Insertion de fichiers LilyPond
@cindex inclusion de fichiers
Lorsqu'un projet prend de l'importance en volume, il est judicieux de le
-scinder en plusieurs fichiers, auxquels vous fereez référence avec un
+scinder en plusieurs fichiers, auxquels vous ferez référence avec un
simple
@example
... etc.
@end example
-Les fichiers à inclure peuvent eux-même contenir des instructions
+Les fichiers à inclure peuvent eux-mêmes contenir des instructions
@code{\include}. Ces instructions @code{\include} de second niveau ne
pourront, par défaut, être interprétées qu'une fois intégrées dans le
fichier principal@tie{}; leur argument doit donc comporter le chemin
Vous pouvez inclure des fichiers dont vous spécifierez le chemin d'accès
sur la ligne de commande au moment de lancer la compilation. L'appel à
-ces fichiers ne mentionnerra alors que leur nom. Par exemple, si vous
+ces fichiers ne mentionnera alors que leur nom. Par exemple, si vous
voulez compiler avec cette méthode le fichier @file{principal.ly} qui
inclut des fichiers situés dans le sous-répertoire @file{parties},
placez vous dans le répertoire contenant @file{principal.ly}, puis tapez
@knownissues
-
Lorsque vous incluez un fichier qui porte le même nom que l'un des
fichiers d'initialisation de LilyPond, le fichier de la distribution de
LilyPond aura préséance.
@subsection Différentes éditions à partir d'une même source
@translationof Different editions from one source
-Différents mécanismes permettent de générer plusieurs versions d'une
+Plusieurs méthodes permettent de générer différentes versions d'une
partition à partir d'une même source. Les variables -- ou
-idendificateurs -- sont sûrement le moyen le plus simple de combiner de
+identificateurs -- sont sûrement le moyen le plus simple de combiner de
différente manière des passages relativement longs, alors que les
balises permettront de sélectionner de courts fragments selon leur
-utilisation. Quelle que soit la méthode utilisée, séparer la notation
-de la structure de la partition vous donnera plus de liberté dans
-l'agencement de l'ouvrage final, puisque vous ne reviendrez pas sur la
-musique qui le compose.
+utilisation.
+
+Quelle que soit la méthode utilisée, séparer la notation de la structure
+de la partition vous donnera plus de liberté dans l'agencement de
+l'ouvrage final, puisque vous ne reviendrez pas sur la musique qui le
+compose.
@menu
* Utilisation de variables::
@funindex \tag
@funindex \keepWithTag
@funindex \removeWithTag
+@funindex \pushToTag
+@funindex \appendToTag
@cindex tag
@cindex balise
En effet, si le premier filtre exclut tous les autres balisages,
l'application du second exclura les effets du premier.
+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
+matériau, qu'il soit antérieur ou postérieur à des @code{éléments}
+d'une construction musicale existante. La musique séquentielle ou
+simultanée comporte assurément des @code{éléments}@tie{}:
+
+@lilypond[verbatim,quote]
+test = { \tag #'here { \tag #'here <<c''>> } }
+
+{
+ \pushToTag #'here c'
+ \pushToTag #'here e'
+ \pushToTag #'here g' \test
+ \appendToTag #'here c'
+ \appendToTag #'here e'
+ \appendToTag #'here g' \test
+}
+@end lilypond
+
+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 :
@cindex include-settings
Vous pouvez regrouper dans un fichier indépendant vos réglages
-personnels que vous incluerez au besoin@tie{}:
+personnels que vous inclurez au besoin@tie{}:
@example
lilypond -dinclude-settings=MES_REGLAGES.ly MA_PARTITION.ly
obtiendrez facilement différentes éditions à partir d'une même source
quelle qu'elle soit.
-Ceete technique peut s'utiliser en combinaison avec des feuilles de
+Cette technique peut s'utiliser en combinaison avec des feuilles de
styles, comme indiqué au chapitre @rlearning{Feuilles de style}.
@seealso
@ref{Insertion de fichiers LilyPond}.
+@node Caractères spéciaux
+@subsection Caractères spéciaux
+@translationof Special characters
+
+@cindex caractères spéciaux
+@cindex non-ASCII, caractères
+
+@menu
+* Codage du texte::
+* Unicode::
+* Équivalents ASCII::
+@end menu
+
+
@node Codage du texte
-@subsection Codage du texte
+@unnumberedsubsubsec Codage du texte
@translationof Text encoding
-@cindex Unicode
@cindex UTF-8
-@cindex non-ASCII characters
LilyPond utilise le jeu de caractères défini par le consortium Unicode
et la norme ISO/CEI@tie{}10646. Chaque caractère est identifié par un
fichier en UTF-8. C'est le cas pour la plupart des éditeurs actuels,
que ce soit vim, Emacs, jEdit et GEdit. Tous les systèmes Windows
postérieurs à NT utilisent Unicode en natif@tie{}; même Notepad est
-capable d'éditer et sauvegarder un fichie en UTF-8 -- sans parler de
+capable d'éditer et sauvegarder un fichier en UTF-8 -- sans parler de
l'excellente alternative qu'est BabelPad.
La compilation d'un fichier LilyPond comportant des caractères non ASCII
FT_Get_Glyph_Name () erreur : invalid argument
@end example
-Voici un exemple utilisant du texte en cyrilique, en hébreux et en
+Voici un exemple utilisant du texte en cyrillique, en hébreux et en
portugais.
@lilypond[quote]
\addlyrics { \portuguese }
@end lilypond
+
+@node Unicode
+@unnumberedsubsubsec Unicode
+@translationof Unicode
+
+@cindex Unicode
+
Lorsque vous avez besoin d'un caractère dont vous connaissez le point de
code mais que votre éditeur ne permet pas de saisir directement, vous
-pouvez utitliser les instructions @code{\char@tie{}##xhhhh} ou
+pouvez utiliser les instructions @code{\char@tie{}##xhhhh} ou
@code{\char@tie{}#dddd} au sein d'un bloc @code{\markup} -- @code{hhhh}
et @code{dddd} correspondant respectivement à la valeur hexadécimale ou
décimale. Même s'il est inutile de saisir les zéros superflus, il est
}
\addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
}
-\markup { "Copyright 2008--2011" \char ##x00A9 }
+\markup { "Copyright 2008--2012" \char ##x00A9 }
@end lilypond
@cindex copyright
@end example
+@node Équivalents ASCII
+@unnumberedsubsubsec Équivalents ASCII
+@translationof ASCII aliases
+
+Dès lors que vous aurez inclus la liste de leur équivalent ASCII,
+LilyPond reconnaîtra un certain nombre de caractères spéciaux@tie{}:
+
+@lilypond[quote,verbatim]
+\paper {
+ #(include-special-characters)
+}
+
+\markup "&flqq; – &OE;uvre incomplète… &frqq;"
+
+\score {
+ \new Staff { \repeat unfold 9 a'4 }
+ \addlyrics {
+ This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
+ }
+}
+
+\markup \column {
+ "The replacement can be disabled:"
+ "– &OE; …"
+ \override #'(replacement-alist . ()) "– &OE; …"
+}
+@end lilypond
+
+L'extension de cette liste est possible aussi bien de manière globale :
+
+@lilypond[quote,verbatim]
+\paper {
+ #(add-text-replacements!
+ '(("100" . "hundred")
+ ("dpi" . "dots per inch")))
+}
+\markup "A 100 dpi."
+@end lilypond
+
+qu'en un point particulier de votre source :
+
+@lilypond[quote,verbatim]
+\markup \replace #'(("100" . "hundred")
+ ("dpi" . "dots per inch")) "A 100 dpi."
+@end lilypond
+
+@seealso
+Manuel de notation :
+@ref{Liste des caractères spéciaux}.
+
+Fichiers d'initialisation :
+@file{ly/text-replacements.ly}.
+
+
@node Contrôle des sorties
@section Contrôle des sorties
@translationof Controlling output
l'on s'arrête à la mesure 7, après la durée de trois noires.
Rien ne vous empêche d'extraire plusieurs fragments, dès lors que vous
-définissez dans la liste d'autres paires d'emplacements ryhtmiques.
+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}
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
-ce que vous avez saisi@tie{}: octaves et altérations erronées heuteront
+ce que vous avez saisi@tie{}: octaves et altérations erronées heurteront
votre oreille avertie grâce au MIDI.
Le fichier MIDI généré par LilyPond est relativement brut. Vous pouvez
cependant obtenir un meilleur rendu avec @ref{Le script Articulate}.
-@c TODO Check this
-Dans une sortie MIDI, LilyPond alloue un canal à chaque portée, plus un
-pour les réglages globaux. Par voie de conséquence, un fichier MIDI ne
-peut comporter au maximmum que quinze portées (quatorze en l'absence de
-percussions)@tie{}; les portées supplémentaires seront tout simplement
-silencieuses.
+Dans une sortie MIDI, LilyPond alloue un canal à chaque portée, tout en
+réservant le canal@tie{}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é.
@menu
* Création de fichiers MIDI::
@subsection Création de fichiers MIDI
@translationof Creating MIDI files
-LilyPond génèrera un fichier MIDI dès que vous ajouterez un bloc
+LilyPond générera un fichier MIDI dès que vous ajouterez un bloc
@code{\midi} à la structure de votre partition, comme ici@tie{}:
@example
@funindex Staff.midiInstrument
L'instrument MIDI affecté à un canal particulier est déterminé par la
-propiété @code{Staff.midiInstrument}. Vous pouvez choisr l'un des
+propriété @code{Staff.midiInstrument}. Vous pouvez choisir l'un des
instruments répertoriés à l'annexe @ref{Instruments MIDI}.
@example
@snippets
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{changing-midi-output-to-one-channel-per-voice.ly}
@knownissues
\score @{
@var{...musique...}
\midi @{
- \context @{
- \Score
- tempoWholesPerMinute = #(ly:make-moment 72 4)
- @}
+ \tempo 4 = 72
@}
@}
@end example
Ici, le tempo est fixé à 72 noires à la minute. Spécifier un tempo de
-la sorte ne permet pas de doner une valeur pour une note pointée. Vous
+la sorte ne permet pas de donner une valeur pour une note pointée. Vous
devrez, en pareil cas, subdiviser la note pointée en durée plus courte.
Par exemple, indiquer 90 à la noire pointée est équivalent à spécifier
270 croches à la minute@tie{}:
@}
@end example
-LilyPond ne génèrera de sortie MIDI que si vous incluez un bloc
+LilyPond ne générera de sortie MIDI que si vous incluez un bloc
@code{\midi} dans la structure de la partition, initialisée par la
commande @code{\score}.
le rythme en tant que durée de note, y compris les nolets ;
@item
-les tremolos, exceptés ceux utilisant la syntaxe
+les trémolos, exceptés ceux utilisant la syntaxe
@qq{@code{:}[@var{nombre}]}@tie{};
@item
les paroles.
@end itemize
-Si vous utilisez @ref{Le scrip Articulate}, d'autres éléments seront
+Si vous utilisez @ref{Le script Articulate}, d'autres éléments seront
alors inclus@tie{}:
@itemize
@c TODO index as above
LilyPond ne peut générer d'événement MIDI pour les éléments
-suivant, sauf à utiliser @ref{Le scrip Articulate}@tie{}:
+suivant, sauf à utiliser @ref{Le script Articulate}@tie{}:
@itemize
@item
-le rythme indiqué sous forme d'annotation (p.ex. @emph{swing})@tie{};
+le rythme indiqué sous forme d'annotation (par ex. @emph{swing})@tie{};
@item
les changements de tempo indiqués sous forme d'annotation (sans
les liaisons d'articulation et de prhasé@tie{};
@item
-les crescendos ou decrescendos sur une sele note@tie{};
+les crescendos ou decrescendos sur une seule note@tie{};
@item
-les tremolos indiqués par la syntaxe @qq{@code{:}[@var{nombre}]}@tie{};
+les trémolos indiqués par la syntaxe @qq{@code{:}[@var{nombre}]}@tie{};
@item
la basse chiffrée
Si vous étiez amené à devoir modifier l'intégralité du jeu des
correspondances, nous vous conseillons d'utiliser la procédure
@command{default-dynamic-absolute-volume} contenue dans le fichier
-@file{../scm/midi.scm} ansi que la table d'association comme base. Le
-dernier exemple de cette partie illustre la manière de procéder.
+@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.
@unnumberedsubsubsec Amplitude du volume en MIDI
>>
\layout {}
\midi {
- \context {
- \Score
- tempoWholesPerMinute = #(ly:make-moment 72 2)
- }
+ \tempo 2 = 72
}
}
@end lilypond
instrument MIDI et renverra une paire de fractions correspondant au
minimum et maximum de volume alloué à cet instrument. Cette
substitution fonctionne selon le même principe que celui que nous avons
-vu en dédut de chapitre avec @code{dynamicAbsoluteVolumeFunction}.
+vu en début de chapitre avec @code{dynamicAbsoluteVolumeFunction}.
L'égaliseur par défaut, @notation{default-instrument-equalizer}, est
défini dans le fichier @file{../scm/midi.scm}@tie{}; son analyse vous
aidera à construire votre propre procédure.
>>
\layout { }
\midi {
- \context {
- \Score
- tempoWholesPerMinute = #(ly:make-moment 72 2)
- }
+ \tempo 2 = 72
}
}
@end lilypond
le standard @emph{general MIDI}, comme le tom mélodique ou le tambour
taiko, ne sont pas attachés au canal@tie{}10. Ces instruments doivent
donc être saisi dans un contexte @code{Staff}, en utilisant la hauteur
-appropiée.
+appropriée.
De nombreux instruments de la famille des percussions, les castagnettes
par exemple, n'existent pas dans le standard @emph{general MIDI}.
@knownissues
Le standard @emph{general MIDI} ne dispose pas du @emph{rim shot}@tie{};
-LilyPond lui subtitue un @emph{sidestick}.
+LilyPond lui substitue un @emph{sidestick}.
@node Le script Articulate
@menu
* Affichage de notation au format LilyPond::
-* Affichage de la musique sous forme d'expression scheme::
+* Affichage de la musique sous forme d'expression Scheme::
* Enregistrement d'événements musicaux dans un fichier::
@end menu
@funindex \displayLilyMusic
-La fonction musicale @code{\displayLilyMusic}, disponible uniquement
-pour un traitement en ligne de commande, permet d'afficher en
-notation LilyPond une expression musicale. Par exemple,
+La fonction musicale @code{\displayLilyMusic} permet d'afficher en
+notation LilyPond une expression musicale. Le résultat défilera dans le
+terminal après avoir lancé LilyPond en ligne de commande. Par exemple,
@example
@{
fichier.
@example
-lilypond fichier.ly >display.txt
+lilypond fichier.ly >affichage.txt
+@end example
+
+@funindex \void
+
+Vous noterez que LilyPond ne se contente pas de simplement afficher
+l'expression musicale, mais procède aussi à son interprétation -- du
+fait que @code{\displayLilyMusic} renvoie l'expression tout en
+l'affichant. S'il est bien pratique d'insérer un
+@code{\displayLilyMusic} dans une expression musicale pour en obtenir
+des informations, l'interprétation de cette expression peut toutefois
+être évitée en ajoutant un @code{\void} avant l'instruction@tie{}:
+
+@example
+@{
+ \void \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
+@}
@end example
-@node Affichage de la musique sous forme d'expression scheme
-@subsection Affichage de la musique sous forme d'expression scheme
+@node Affichage de la musique sous forme d'expression Scheme
+@subsection Affichage de la musique sous forme d'expression Scheme
@translationof Displaying scheme music expressions
-Voir @rextend{Displaying music expressions}.
+Voir @rextend{Affichage d'expressions musicales}.
@node Enregistrement d'événements musicaux dans un fichier
Pour chaque portée que comporte votre partition, vous obtiendrez un
fichier @file{NOMFICHIER-PORTÉENOMMÉE.notes} ou
@file{NOMFICHIER-unnamed-staff.notes}. Notez bien que si plusieurs
-portées ne sont pas explicitement nomées, tous leurs événements seront
+portées ne sont pas explicitement nommées, tous leurs événements seront
regroupés et mélangés dans le même fichier. Le résultat ressemblera à
ceci@tie{}:
@var{temps} @var{type} @var{...paramètres...}
@end example
-Ces informations peuvent faire l'objet d'un retraîtement par d'autres
+Ces informations peuvent faire l'objet d'un retraitement par d'autres
programmes, comme des scripts python, aux fins de recherche en analyse
musicologique ou des expériences à partir du rendu de LilyPond.
Tous les événements ne sont pas pris en charge par
@file{event-listener.ly}. Il s'agit en premier lieu d'une
démonstration, un @qq{proof of concept} du potentiel de LilyPond. Si
-certains des éléments que vous cherchez à obtenir n'apparaîssent pas,
-recopiez le fichier @file{event-listener.ly} dans votre répoertoire et
+certains des éléments que vous cherchez à obtenir n'apparaissent pas,
+recopiez le fichier @file{event-listener.ly} dans votre répertoire et
modifiez-le de telle sorte qu'il travaille selon vos attentes.