@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@ignore
- Translation of GIT committish: 95b372c451ea1586db8db66d3d00334382e8e103
+ Translation of GIT committish: 3c907f2dd5ba3dd91e30454922d8361225ca28d5
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.17.6"
+@c \version "2.19.2"
@c Translators: Jean-Charles Malahieude, Valentin Villenave
@example
\score @{
-...
+@dots{}
@}
@end example
Les commentaires constituent l'une des rares exceptions à cette règle
immuable -- voir @ref{Structure de fichier} pour les autres. Qu'il
-s'agisse d'une seule ligne ou de tout un bloc -- délimité par @code{%@{
-.. %@}} -- un commentaire peut se placer n'importe où dans le fichier
-source, aussi bien à l'intérieur qu'à l'extérieur du bloc @code{\score},
-ou encore à l'intérieur ou à l'extérieur de l'expression musicale
-contenue dans un bloc @code{\score}.
+s'agisse d'une seule ligne ou de tout un bloc -- délimité par
+@code{%@{ @dots{} %@}} -- un commentaire peut se placer n'importe où
+dans le fichier source, aussi bien à l'intérieur qu'à l'extérieur du
+bloc @code{\score}, ou encore à l'intérieur ou à l'extérieur de
+l'expression musicale contenue dans un bloc @code{\score}.
Lorsqu'un fichier ne comprend qu'un bloc @code{\score}, celui-ci est
implicitement inclus dans un bloc @code{\book}. Le bloc @code{\book}
@example
\score @{
- @var{..musique..}
+ @var{@dots{}musique@dots{}}
@}
@end example
@example
\markup @{
- @var{..texte..}
+ @var{@dots{}texte@dots{}}
@}
@end example
@example
\score @{
- @var{..}
+ @var{@dots{}}
@}
\markup @{
- @var{..}
+ @var{@dots{}}
@}
\score @{
- @var{..}
+ @var{@dots{}}
@}
@end example
\header @{ piece = "Romance" @}
@}
\markup @{
- ..texte du second couplet..
+ @dots{}texte du second couplet@dots{}
@}
\markup @{
- ..texte du troisième couplet..
+ @dots{}texte du troisième couplet@dots{}
@}
\score @{
@dots{}
@example
\book @{
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
@end example
\book @{
\bookOutputSuffix "Romance"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\bookOutputSuffix "Menuet"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\bookOutputSuffix "Nocturne"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
@end example
\book @{
\bookOutputName "Romance"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\bookOutputName "Menuet"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\bookOutputName "Nocturne"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
@end example
différents contenus seront combinés, à ceci près qu'en cas de
déclarations conflictuelles, la dernière aura préséance. Des
informations complémentaires sont disponibles à la rubrique
-@ref{Le bloc \layout}.
+@ref{Le bloc layout}.
@item
Une expression Scheme pure, telle que
Une ligne de commentaire, introduite par le signe @code{%}.
@item
-Un bloc de commentaire, délimité par @code{%@{ .. %@}}.
+Un bloc de commentaire, délimité par @code{%@{ @dots{} %@}}.
@end itemize
@itemize
@item
-Autour d'une accolade, qu'elle soit ouvrant ou fermante ;
+Autour d'une accolade, qu'elle soit ouvrante ou fermante ;
@item
Après chaque commande ou variable, autrement dit tout élément qui
Pour séparer les éléments d'une expression Scheme ;
@item
-En mode parole -- @code{lyricmode} -- pour séparer les termes des
-commandes @code{\override} et @code{\set}. Précisons à ce sujet qu'en
-plus d'ajouter une espace avant et après l'intégralité de la commande,
-vous devrez encadrer d'espaces le point et le signe égal qu'elle peut
-contenir, comme dans
-@w{@code{\override Score . LyricText #'font-size = #5}}.
+En mode parole -- @code{lyricmode} -- avant et après les commandes
+@code{\override} et @code{\set}.
@end itemize
Manuel de notation :
@ref{Généralités en matière de titrages},
-@ref{Le bloc \layout}.
+@ref{Le bloc layout}.
@node Titres et entêtes
Chaque bloc @code{\book} apparaissant dans un même fichier source
résultera en un fichier indépendant, comme indiqué à la rubrique
-@ref{Structure de fichier}. Chacun de ces fichiers résultants
-comporte deux endroits où placer des titrages : les @strong{titrages
-de partie} au début de chaque partie (@emph{bookpart}) et les
-@strong{titrages de morceau} avant chaque pièce (@emph{score}). Tous
-deux peuvent comporter les mêmes champs bien que, par défaut, le titrage
+@ref{Structure de fichier}. Chacun de ces fichiers résultants comporte
+trois endroits où placer des titrages : le @strong{titrage de l'ouvrage}
+au début de chaque recueil (@emph{book}), les @strong{titrages de
+partie} au début de chaque partie (@emph{bookpart}) et les
+@strong{titrages de morceau} avant chaque pièce (@emph{score}).
+
+La valeur des champs de titrage @code{title} (le titre) et
+@code{composer} (le compositeur) se définissent dans des blocs
+@code{\header} -- la syntaxe appropriée et la liste des différents
+champs disponibles par défaut sont à la section
+@ref{Mise en forme par défaut des titrages subalternes}.
+Les titrages d'un ouvrage, de ses parties ou des morceaux qu'il contient
+peuvent tous comporter les même champs bien que, par défaut, le titrage
d'un morceau se limite à @code{piece} et @code{opus}.
Les blocs @code{\header} peuvent se placer à quatre endroits différents
autre valeur à un niveau inférieur. Ainsi :
@itemize
+@item
+Le titre d'un ouvrage découle des champs définis en tête de fichier
+source, modifiés par les champs définis au sein du bloc @code{\book}.
+Les champs résultants serviront à affecter un titre de recueil à
+l'ouvrage, si tant est que quoi que ce soit génère une page au début de
+cet ouvrage, avant la première partie -- un simple saut de page forcé
+(@code{\pageBreak}) suffit.
+
@item
Le titre d'une partie découle des champs définis en tête du fichier
source, modifiés par les champs définis au sein du bloc @code{\book}
Voici les différentes variables attachées au bloc @code{\header} :
@c KEEP LY
-@lilypond[papersize=a7,quote,verbatim,noragged-right]
+@lilypond[papersize=a6landscape,quote,verbatim,noragged-right]
\book {
\header {
% Les champs suivants sont centrés
@cindex breakbefore
+Un bloc @code{\book} qui commencerait directement par un bloc
+@code{\bookpart} ne verra pas ses titrages apparaître puisqu'il n'y a
+aucune page où imprimer le titre. Si toutefois le titre de l'ouvrage
+est requis, le bloc @code{\book} devra commencer par un @emph{markup} ou
+une commande @code{\pageBreak}.
+
La variable @code{breakbefore} activée dans un bloc @code{\header} situé
dans un bloc @code{\score} force le saut de page avant le morceau
contenu dans ce @code{\score}. Vous pourrez ainsi séparer le titre
principal de la musique.
-@lilypond[papersize=a8landscape,verbatim,noragged-right]
+@lilypond[papersize=c7landscape,verbatim,noragged-right]
\book {
\header {
title = "This is my Title"
@end itemize
-@lilypond[papersize=a8landscape]
-\book {
- \score {
- \relative c' {
- c4 d e f
- }
- }
-}
-@end lilypond
-
La mention spéciale se modifie en alimentant le champ @code{tagline} au
niveau du bloc @code{\header} principal.
{ s1 }
\header {
piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
- opus = \markup { \italic "(Excerpt)" }
+ opus = \markup { \italic "BWV 846" }
}
}
@end lilypond
@example
scoreTitleMarkup = \markup @{ \column @{
- \on-the-fly #print-all-headers @{ \bookTitleMarkup \hspace #1 @}
+ \on-the-fly \print-all-headers @{ \bookTitleMarkup \hspace #1 @}
\fill-line @{
\fromproperty #'header:piece
\fromproperty #'header:opus
@example
@code{variable} = @code{\markup} @{
- ...
- @code{\on-the-fly} #@var{procédure} @var{markup}
- ...
+ @dots{}
+ @code{\on-the-fly} \@var{procédure} @var{markup}
+ @dots{}
@}
@end example
@headitem Nom de la procédure @tab Condition testée
@item print-page-number-check-first @tab il faut imprimer ce numéro de page.
-@item create-page-number-stencil @tab 'print-page-numbers est vrai.
-@item print-all-headers @tab 'print-all-headers est vrai.
+@item create-page-number-stencil @tab print-page-numbers est vrai.
+@item print-all-headers @tab print-all-headers est vrai.
@item first-page @tab c'est la première page du @emph{book}.
@item (on-page nombre) @tab numéro de page = nombre
@item last-page @tab c'est la dernière page du @emph{book}.
evenHeaderMarkup = \markup \null
oddFooterMarkup = \markup {
\fill-line {
- \on-the-fly #print-page-number-check-first
+ \on-the-fly \print-page-number-check-first
\fromproperty #'page:page-number-string
}
}
l'autre se cumulent. Ainsi, par exemple,
@example
- @code{\on-the-fly #first-page}
- @code{\on-the-fly #last-page}
- @code{@{ \markup ... \fromproperty #'header: ... @}}
+ @code{\on-the-fly \first-page}
+ @code{\on-the-fly \last-page}
+ @code{@{ \markup @dots{} \fromproperty #'header: @dots{} @}}
@end example
teste si la sortie tient sur une page unique.
@table @emph
@item Les annotations événementielles
-se rattachent à des événements particuliers, comme une note individuelle
-ou au sein d'un accord, un élément d'interprétation (ligature, liaison,
-doigté, accent ou nuance) et des paroles.
+se rattachent à des événements particuliers, comme une note individuelle,
+un élément d'interprétation (doigté, accent ou nuance) ou des événements
+postérieurs (liaison, ligature manuelle). Une note de bas de page
+événementielle se libelle généralement sous la forme :
+
+@example
+[@var{position}] \footnote [@var{marque}] @var{décalage} @var{annotation} @var{musique}
+@end example
@item Les annotations temporelles
se rapportent à un point particulier du déroulement d'un contexte
reposent pas sur un événement pour la création de l'objet métrique ou
clef. Il en va de même pour un accord : sa hampe ou ses crochets ne
sont créés qu'à la fin d'un moment (plus exactement au travers de l'un
-des événements note qui le composent). Une annotation temporelle permet
-d'annoter ces objets de rendus sans se référer à un événement.
+des événements note qui le composent). Il n'est pas possible de
+connaître assurément lequel des événements note d'un accord est
+plus particulièrement à l'origine de la hampe ou du crochet. Il
+est donc plus aisé, pour de tels éléments, d'utiliser des
+annotations temporelles.
-@end table
-
-Examinons la forme développée d'une commande de note de bas de page,
-qu'elle soit événementielle ou temporelle :
+Une annotation temporelle permet d'annoter des objets de rendus
+sans se référer à un événement. Elle se libelle généralement sous
+la forme :
@example
-[@var{position}] \footnote [@var{marque}] @var{décalage} [@var{nom-grob}] @var{annotation} @var{musique}
+\footnote [@var{marque}] @var{décalage} @var{annotation} [@var{Contexte}.]@var{nom-grob}
@end example
-Ses arguments peuvent se définir ainsi :
+@end table
+
+Les arguments, quelle que soit la catégorie d'annotation, peuvent se
+définir ainsi :
@table @var
@item position
Lorsque la commande @code{\footnote} s'applique à un élément
d'interprétation ou un événement rattaché, et uniquement dans ces cas,
-elle doit être précédée d'un indicateur de positionnement (@code{-, _
-ou ^}) de façon à rattacher @var{musique} (avec sa marque) à la note ou
-au silence qui précède.
+elle doit être précédée d'un indicateur de positionnement (@code{-, _}
+ou @code{^}) de façon à rattacher @var{musique} (avec sa marque) à
+la note ou au silence qui précède.
@item marque
Un @emph{markup} ou une chaîne de caractères identifiant l'annotation
zéro centrent la marque sur le point de référence. Le décalage
s'exprime en espace de portée.
+@item Contexte
+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
+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
référence, même s'il trouve son origine non pas directement dans
-l'élément @var{musique} mais dans un objet en résultant. Son absence ou
-une valeur de @code{\default} ne permet d'annoter que des objets
-directement créés.
+une expression musicale mais dans tout objet du type spécifié
+intervenant à cet instant précis de la partition.
@item annotation
un @emph{markup} ou une chaîne de caractères qui sera reporté au bas de
@item musique
l'élément qui fait l'objet du commentaire, qu'il s'agisse d'un
événement musical, de l'un des constituants d'un accord ou d'un
-événement rattaché. Bien qu'il ne puisse être omis, il peut être
-remplacé par @code{\default}, auquel cas l'annotation ne sera pas
-rattachée à une expression musicale particulière, mais plutôt à un
-instant précis. L'argument @var{nom-grob} est alors obligatoire pour
-sélectionner le type d'objet affecté -- @samp{#'TimeSignature} par
-exemple.
+événement rattaché.
@end table
+
@subsubsubheading Notes de bas de page événementielles
@c VO Event-based footnotes
@cindex événementielle, note de bas de page
-Le moyen le plus simple d'annoter un événement est :
+Ce type de note de bas de page s'attache à un objet de rendu
+généré directement par l'événement correspondant à @var{musique}.
+Il répond à la syntaxe :
@example
-\footnote @var{décalage} @var{annotation} @var{musique}
+\footnote [@var{décalage}] @var{décalage} @var{annotation} @var{musique}
@end example
-Ce type de note de bas de page s'attache à un objet de rendu généré par
-l'événement correspondant à @var{musique}.
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
+\book {
+ \header { tagline = ##f }
+ \relative c'' {
+ \footnote #'(-1 . 3) "Une note" a4
+ a4
+ \footnote #'(2 . 2) "Un silence" r4
+ a4
+ }
+}
+@end lilypond
+
+Un accord @emph{dans son intégralité} ne peut pas faire l'objet
+d'une note de bas de page événementielle : un accord, même s'il ne
+contient qu'une seule et unique note, ne génère aucun événement en
+propre. Une des notes @emph{au sein} de l'accord peut toutefois
+se voir attribuer une annotation :
+
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
+\book {
+ \header { tagline = ##f }
+ \relative c'' {
+ \footnote #'(2 . 3) "Résultat non probant" <a-3>2
+ <\footnote #'(-2 . -3) "Résultat probant" a-3>4
+ <a-3 \footnote #'(3 . 1/2) "Tout aussi probant" c-5>4
+ }
+}
+@end lilypond
+
+Lorsque l'annotation concerne un événement postérieur ou une
+articulation, la commande @code{\footnote} @strong{doit} être
+précédée d'un indicateur de position (@code{-, _} ou @code{^}) et
+suivie de l'événement postérieur ou l'articulation comme argument
+@var{musique}. Dans ce cas, la commande @code{\footnote} peut se
+considérer comme une copie de son dernier argument auquel on
+attache une annotation. La syntaxe consacrée est :
+
+@example
+@var{position} \footnote [@var{marque}] @var{décalage} @var{annotation} @var{musique}
+@end example
@c KEEP LY
@lilypond[quote,verbatim,papersize=a8landscape]
Les appels de note peuvent être personnalisés, et le trait reliant
l'objet à l'appel supprimé :
+
+@subsubsubheading Notes de bas de page temporelles
+@c VO Time-based footnotes
+
+@cindex temporelle, note de bas de page
+
+Lorsque la note de bas de page se réfère à un objet de rendu résultant
+d'un événement -- @code{Accidental} ou @code{Stem} découlent d'un
+@code{NoteHead} --, l'argument @var{nom-grob} de l'objet en question est
+requis après le texte de l'annotation, en lieu et place de
+@var{musique} :
+
@c KEEP LY
@lilypond[quote,verbatim,papersize=a8landscape]
\book {
\header { tagline = ##f }
- \relative c' {
- \footnote "*" #'(0.5 . -2) \markup { \italic "* La première note" }
- a'4 b8
- \footnote \markup { \super "$" } #'(0.5 . 1)
- \markup { \super "$" \italic " La deuxième note" }
- e c4
- \once \override Score.FootnoteItem #'annotation-line = ##f
- b-\footnote \markup \tiny "+" #'(0.1 . 0.1)
- \markup { \super "+" \italic " Éditorial" } \p
+ \relative c'' {
+ \footnote #'(-1 . -3) "Un bémol" Accidental
+ aes4 c
+ \footnote #'(-1 . 0.5) "Un autre bémol" Accidental
+ ees
+ \footnote #'(1 . -2) "Une hampe" Stem
+ aes
}
}
@end lilypond
-D'autres exemples de personnalisation des appels de note sont donnés à
-la rubrique @ref{Notes de bas de page dans du texte indépendant}.
+Notez bien que, lorsque @var{nom-grob} est spécifié, tous les objets de
+ce type qui se trouvent à ce même instant se verront attacher une
+annotation :
-L'annotation d'un accord dans sa globalité n'est pas réalisable de cette
-manière dans la mesure où un accord ne génère pas d'événement en dehors
-de ses constituants. Les notes qui le composent peuvent cependant faire
-l'objet d'une annotation.
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ \footnote #'(-1 . 3) "Un bémol" Accidental
+ <ees ges bes>4
+ \footnote #'(2 . 0.5) "Une articulation" Script
+ c'->-.
+ }
+}
+@end lilypond
-Lorsque la note de bas de page se réfère à un objet de rendu résultant
-d'un événement -- @code{Accidental} ou @code{Stem} découlent d'un
-@code{NoteHead} --, l'argument additionnel @var{nom-grob} est requis
-avant le texte de l'annotation :
+Une note incluse dans un accord peut individuellement se voir attribuer
+une annotation événementielle. Une tête de note (@code{NoteHead}) est
+le @emph{seul} objet directement généré par un constituant d'accord ;
+elle peut donc être affectée d'une annotation événementielle. Tous les
+autres objets constituant un accord sont générés indirectement. La
+commande @code{\footnote} ne dispose pas d'une syntaxe permettant de
+spécifier @emph{à la fois} un type d'objet @emph{et} un événement
+particulier auquel s'attacher. De tels objets pourront toutefois faire
+l'objet d'une annotation temporelle, préfixée d'un @code{\single} afin
+d'annoter l'événement directement consécutif :
@c KEEP LY
@lilypond[quote,verbatim,papersize=a8landscape]
\book {
\header { tagline = ##f }
\relative c'' {
- % footnotes may be added to chord constituents
- < \single\footnote #'(-1 . -3) "Un autre bémol" Accidental aes
- c
- \single\footnote #'(-1 . 0.5) "Un bémol" Accidental ees
+ < \footnote #'(1 . -2) "Un la" a
+ \single \footnote #'(-1 . -1) "Un dièse" Accidental
+ cis
+ \single \footnote #'(0.5 . 0.5) "Un bémol" Accidental
+ ees fis
>2
- \single\footnote #'(-1 . 2) "Une hampe" Stem ees2
}
}
@end lilypond
@warning{Lorsque plusieurs notes de bas de page se rapportent à un même
-empilement vertical, elles sont numérotées et apparaîtront selon
-l'ordre vertical des éléments présentés, autrement dit celui positionné
-le plus haut en premier, non dans leur ordre d'apparition dans le
-fichier source.}
-
-@subsubsubheading Notes de bas de page temporelles
-@c VO Time-based footnotes
-
-@cindex temporelle, note de bas de page
+empilement vertical comme ci-dessus, elles sont numérotées et
+apparaîtront selon l'ordre vertical des éléments présentés, autrement dit
+celui positionné le plus haut en premier, non dans leur ordre
+d'apparition dans le fichier source.}
Les objets de rendu tels que changement de clef ou d'armure tirent leur
origine dans la modification d'une propriété plutôt que d'un véritable
directement de la temporisation. C'est la raison pour laquelle de tels
objets doivent s'annoter en fonction de leur survenance au fil de la
musique. Les notes de bas de page temporelles sont la solution à
-privilégier lorsqu'il s'agit d'annoter les hampes ou ligature affectant
+privilégier lorsqu'il s'agit d'annoter les hampes ou ligatures affectant
des accords : bien qu'une telle fonctionnalité puisse s'appliquer à l'un
des événements constituant l'accord, rien ne laisse présager lequel
-serait le plus adéquat.
+serait le plus approprié.
-Une note de bas de page temporelle s'introduit de la même manière qu'une
-note événementielle, à ceci près que la mention @code{\default}
-remplacera l'argument @var{musique} qui indique l'événement à annoter.
En matière de note de bas de page temporelle, l'objet de rendu considéré
-devrait toujours être mentionné explicitement, de telle sorte qu'il n'y
-ait pas d'erreur quant au positionnement de l'appel de note.
+doit toujours être mentionné explicitement, ainsi que le contexte si
+l'objet est créé dans un autre contexte que celui du plus bas niveau.
@c KEEP LY
@lilypond[quote,verbatim,papersize=a8landscape]
\header { tagline = ##f }
\relative c'' {
r1 |
- \footnote #'(-0.5 . -1) #'TimeSignature "Changement de métrique" \default
+ \footnote #'(-0.5 . -1) "Changement de métrique" Staff.TimeSignature
\time 3/4
- \footnote #'(1 . -1) #'Stem "Hampe de l'accord" \default
+ \footnote #'(1 . -1) "Hampe de l'accord" Stem
<c e g>4 q q
- \footnote #'(-0.5 . 1) #'BarLine "Barre de mesure" \default
+ \footnote #'(-0.5 . 1) "Barre de mesure" Staff.BarLine
q q
- \footnote #'(0.5 . -1) #'KeySignature "Changement d'armure" \default
- \key c\minor
+ \footnote #'(0.5 . -1) "Changement d'armure" Staff.KeySignature
+ \key c \minor
q
}
}
@end lilypond
+Les appels de note peuvent être personnalisés, et le trait reliant
+l'objet à l'appel supprimé :
+
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
+\book {
+ \header { tagline = ##f }
+ \relative c' {
+ \footnote "*" #'(0.5 . -2) \markup { \italic "* La première note" }
+ a'4 b8
+ \footnote \markup { \super "$" } #'(0.5 . 1)
+ \markup { \super "$" \italic " La deuxième note" }
+ e c4
+ \once \override Score.FootnoteItem #'annotation-line = ##f
+ b-\footnote \markup \tiny "+" #'(0.1 . 0.1)
+ \markup { \super "+" \italic " Éditorial" } \p
+ }
+}
+@end lilypond
+
+D'autres exemples de personnalisation des appels de note sont donnés à
+la rubrique @ref{Notes de bas de page dans du texte indépendant}.
+
@node Notes de bas de page dans du texte indépendant
@unnumberedsubsubsec Notes de bas de page dans du texte indépendant
de note est :
@example
-\markup @{ ... \auto-footnote @var{texte} @var{annotation} ... @}
+\markup @{ @dots{} \auto-footnote @var{texte} @var{annotation} @dots{} @}
@end example
-Dont les éléments sont :
+Ses les éléments sont :
@table @var
de note est :
@example
-\markup @{ ... \footnote @var{appel} @var{annotation} ... @}
+\markup @{ @dots{} \footnote @var{appel} @var{annotation} @dots{} @}
@end example
-Dont les éléments sont :
+Ses les éléments sont :
@table @var
Les notes de bas de page ne peuvent que s'empiler l'une au-dessus de
l'autre ; elles ne seront jamais présentées à la queue leu leu.
-Silence multimesures et ligatures automatiques ne peuvent se voir
-affecter de note de bas de page.
+Silences multimesures, ligatures automatiques et paroles ne peuvent se
+voir affecter de note de bas de page.
Les notes de bas de page peuvent générer des chevauchements quand elles
sont trop nombreuses sur une même page.
\tocItem \markup "Premier mouvement"
\score {
{
- c'4 % ...
+ c'4 % @dots{}
\tocItem \markup "Passage spécifique du premier mouvement"
- d'4 % ...
+ d'4 % @dots{}
}
}
\tocItem \markup "Second mouvement"
\score {
{
- e'4 % ...
+ e'4 % @dots{}
}
}
@end verbatim
@verbatim
\paper {
- %% Translate the toc title into French:
+ %% Traduit le titre de la table des matières en français :
tocTitleMarkup = \markup \huge \column {
\fill-line { \null "Table des matières" \null }
\hspace #1
}
- %% use larger font size
+ %% des fontes un peu plus grandes
tocItemMarkup = \markup \large \fill-line {
\fromproperty #'toc:text \fromproperty #'toc:page
}
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},
@example
\include "parties/VI.ly"
\include "parties/VII.ly"
-... etc.
+etc.
@end example
Les fichiers à inclure peuvent eux-mêmes contenir des instructions
@code{#f}, la commande @code{\include} permettra d'incorporer des
fichiers contenus dans l'arborescence du répertoire principal et des
fichiers situés ailleurs. Si, par exemple, une biblothèque générale
-libA a été créée pour utiliser des sous-fichiers à l'aide de
+libA a été créée pour utiliser des sous-fichiers à l'aide
d'inclusions dans un fichier catalogue, les clauses @code{\include}
-devront être précédées d'un@code{#(ly:set-option #relative-includes #t)}
-de telle sorte qu'elles soient interprétées correctement lorsque
-rapatriées dans le fichier @file{.ly} principal. Examinons cela dans
-les faits :
+devront être précédées d'un
+@code{#(ly:set-option #relative-includes #t)} de telle sorte
+qu'elles soient interprétées correctement lorsque rapatriées dans
+le fichier @file{.ly} principal. Examinons cela dans les faits :
@example
libA/
libA.ly
A1.ly
A2.ly
- ...
+ @dots{}
@end example
@noindent
#(ly:set-option 'relative-includes #t)
\include "A1.ly"
\include "A2.ly"
-...
+@dots{}
% retour au réglage par défaut
#(ly:set-option 'relative-includes #f)
@end example
@example
\include "VI.ly"
\include "VII.ly"
-... etc
+ etc.
@end example
Lorsqu'un fichier est voué à être inclus dans nombre de partitions, vous
Au moment où vous lancez LilyPond, un certain nombre de fichiers se
retrouvent inclus par défaut ; il suffit d'activer le mode verbeux
-en faisant @w{@code{lilypond --verbose}} pour s'en rendre compte. Vous
+en faisant @w{@code{lilypond --verbose}} pour s'en rendre compte. Vous
verrez ainsi défiler, en plus de nombreuses informations, le nom d'un
certain nombre de fichiers et de chemins d'accès. Les fichiers les plus
important sont mentionnés au chapitre
@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
@tab Résultat
@item
-Musique balisée précédée de @code{\keepWithTag #'@var{nom}}
- @tab Musique non balisée et musique balisée par @var{nom} seront
- incluses ; la musique balisée autrement est exclue.
+Musique balisée précédée de @code{\keepWithTag #'@var{nom}} ou
+ @code{\keepWithTag #'(@var{nom1} @var{nom2}@dots{})}
+@tab Musique non balisée et musique balisée par l'un des noms de
+ balise fournis seront incluses ; la musique balisée
+ autrement est exclue.
@item
-Musique balisée précédée de @code{\removeWithTag #'@var{nom}}
- @tab Musique non balisée et fragments appelés autrement que @var{nom}
- seront inclus ; la musique balisée par @var{nom} est exclue.
+Musique balisée précédée de @code{\removeWithTag #'@var{nom}} ou
+ @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.
@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,
}
@end lilypond
-Ce principe de filtrage peut s'appliquer aux articulations, textes etc.
+Ce principe de filtrage peut s'appliquer aux articulations, textes, etc.
Il suffit de positionner
@example
un texte.
Vous pouvez baliser différemment la même expression musicale en
-saisissant plusieurs @code{\tag} :
+saisissant plusieurs @code{\tag} ou bien en combinant plusieurs
+balises dans une liste :
@lilypond[quote,verbatim]
music = \relative c'' {
\tag #'a \tag #'both { a4 a a a }
- \tag #'b \tag #'both { b4 b b b }
+ \tag #'(b both) { b4 b b b }
}
<<
\keepWithTag #'a \music
@end lilypond
L'application concomitante de plusieurs filtres @code{\removeWithTag} à
-la même expression musicale permet d'exclure plusieurs balisages :
+la même expression musicale permet d'exclure plusieurs balisages.
+Une liste fournie en argument à un unique @code{\removeWithTag}
+produira le même effet :
@lilypond[verbatim,quote]
music = \relative c'' {
-\tag #'A { a4 a a a }
-\tag #'B { b4 b b b }
-\tag #'C { c4 c c c }
-\tag #'D { d4 d d d }
+ \tag #'A { a4 a a a }
+ \tag #'B { b4 b b b }
+ \tag #'C { c4 c c c }
+ \tag #'D { d4 d d d }
}
-{
-\removeWithTag #'B
-\removeWithTag #'C
-\music
+\new Voice {
+ \removeWithTag #'B
+ \removeWithTag #'C
+ \music
+ \removeWithTag #'(B C)
+ \music
}
@end lilypond
expression musicale aboutit à l'exclusion de @b{tous} les balisages.
En effet, si le premier filtre exclut tous les autres balisages,
l'application du second exclura les effets du premier.
+L'utilisation d'une unique commande @code{\keepWithTag} avec une
+liste de balises est en pareil cas des plus pertinente : seront
+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
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}.
@ref{Regroupement automatique de parties},
@ref{Insertion de fichiers LilyPond}.
-
-@ignore
-@c This warning is more general than this placement implies.
-@c Rests are not merged whether or not they come from tagged sections.
-@c Should be deleted? -td
-
@knownissues
-Lorsqu'elles comportent des silences, ceux-ci ne seront pas fusionnés
-si vous imprimez une partition avec les deux sections balisées.
-
-@end ignore
+L'application d'un @code{\relative} à une expression musicale
+obtenue par filtrage à l'aide de @code{\keepWithTag} ou
+@code{\removeWithTag} peut générer des changements d'octave,
+puisque seules les hauteurs récupérées dans ce filtre seront
+prises en considération. Une instruction @code{\relative} qui
+précède les commandes @code{\keepWithTag} ou
+@code{\removeWithTag} permet d'éviter ce risque, dans la mesure où
+elle viendra « recaler » ces hauteurs récupérées.
@node Globalisation des réglages
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,
}
\addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
}
-\markup { "Copyright 2008--2012" \char ##x00A9 }
+\markup { "Copyright 2008--2015" \char ##x00A9 }
@end lilypond
@cindex copyright
selon le format que vous aurez stipulé.
Pour de plus amples informations quant au format des résultats,
-consultez le chapitre @rprogram{Lancement de lilypond}.
+consultez le chapitre @rprogram{Lancement de LilyPond}.
@node Ignorer des passages de la partition
processus de correction, vous pouvez @qq{escamoter} le reste et ne
générer que les dernières mesures en insérant
-@verbatim
+@example
showLastLength = R1*5
-\score { ... }
-@end verbatim
+\score @{ @dots{} @}
+@end example
@noindent
dans votre fichier source. Ceci aura pour effet de ne générer que les
@c NOTE: these images are a bit big, but that's important
@c for the font comparison. -gp
-@sourceimage{Gonville_after,,,}
+@sourceimage{Gonville_after,15cm,,}
Et ces même mesures avec la police de LilyPond, Feta :
-@sourceimage{Gonville_before,,,}
+@sourceimage{Gonville_before,15cm,,}
@subsubheading Instructions d'installation pour MacOS
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é.
@menu
* Création de fichiers MIDI::
-* Le bloc MIDI::
+* Instrument MIDI::
* Contenu de la sortie MIDI::
* Répétitions et MIDI::
* Gestion des nuances en MIDI::
@translationof Creating MIDI files
LilyPond générera un fichier MIDI dès que vous ajouterez un bloc
-@code{\midi} à la structure de votre partition, comme ici :
+@code{\midi} au sein du bloc @code{\score} :
@example
\score @{
- @var{...musique...}
+ @var{@dots{}musique@dots{}}
+ \layout @{ @}
\midi @{ @}
@}
@end example
-Lorsque le bloc @code{\score} contient un bloc @code{\midi} mais pas de
-bloc @code{\layout}, LilyPond ne produira qu'une sortie MIDI. Si donc
-vous avez besoin aussi d'un support visuel, vous devrez aussi mentionner
-un bloc @code{\layout}.
+Lorsque le bloc @code{\score} contient uniquement un bloc @code{\midi}
+(autrement dit pas de bloc @code{\layout}), LilyPond produira uniquement
+la sortie MIDI -- aucun support visuel ne sera généré.
@example
\score @{
- @var{...musique...}
+ @var{@dots{}musique@dots{}}
\midi @{ @}
- \layout @{ @}
@}
@end example
indications de nuances, crescendos et decrescendos sont traduits en
niveau de volume ; les indications sous la forme d'une fraction
déterminée du volume disponible, et crescendos et decrescendos sous la
-forme d'une progression linéaire entre les deux extrêmes. Le rendu des
-indications de nuance peut être désactivé pour le MIDI -- voir
-@ref{Le bloc MIDI}.
+forme d'une progression linéaire entre les deux extrêmes.
Le tempo initial ainsi que ses changements sont normalement indiqués au
fil de la notation à l'aide de la commande @code{\tempo} ; ils seront
-retranscrits dans le fichier MIDI. La commande @code{\tempo} donne lieu
-à l'impression d'une indication métronomique que vous pouvez toutefois
-rendre invisible, comme indiqué à la rubrique
-@ref{Indication métronomique}. Une autre manière de spécifier le tempo
-initial pour un fichier MIDI est indiquée plus avant -- voir
-@ref{Le bloc MIDI}.
-
-En raison de certaines limitations de Windows, les fichiers MIDI doivent
-y porter l'extension @code{.mid}. D'autres systèmes utilisent
-l'extension @code{.midi}. Si besoin est, placez la ligne suivante au
-début de votre fichier source, avant l'ouverture de tout bloc
-@code{\book}, @code{\bookpart} ou @code{\score} :
+retranscrits dans le fichier MIDI.
-@example
-#(ly:set-option 'midi-extension "midi")
-@end example
-
-Cette ligne déterminera @code{.midi} comme extension par défaut pour les
-fichiers MIDI.
-
-Vous pouvez aussi le faire en ligne de commande :
+Si le bloc @code{\midi} est la plupart du temps laissé vide, il peut
+contenir des aménagements pour certains contextes, la définition de
+contextes particuliers ou du code permettant de déterminer la valeur de
+certaines propriétés. L'exemple suivant détermine le tempo initial du
+fichier MIDI tout en se passant de son indication sur la partition
+imprimée :
@example
-lilypond … -dmidi-extension=midi fichierLily.ly
+\score @{
+ @var{@dots{}music@dots{}}
+ \midi @{
+ \tempo 4 = 72
+ @}
+@}
@end example
+Notez bien que @code{\tempo} est une commande chargée de définir des
+propriétés en cours d'interprétation de la musique. Intervenant dans le
+cadre de définitions d'une sortie, comme ici un bloc @code{\midi}, elle
+est réinterprétée comme une modification de contexte.
-@unnumberedsubsubsec Noms d'instrument
-@translationof Instrument names
+@cindex MIDI, définition de contexte
-@cindex instrument, nom d'
-@funindex Staff.midiInstrument
-
-L'instrument MIDI affecté à un canal particulier est déterminé par la
-propriété @code{Staff.midiInstrument}. Vous pouvez choisir l'un des
-instruments répertoriés à l'annexe @ref{Instruments MIDI}.
-
-@example
-\new Staff @{
- \set Staff.midiInstrument = #"glockenspiel"
- @var{...notes...}
-@}
-@end example
+La syntaxe permettant de définir un contexte pour le @code{\midi} est en
+tout point identique à celle que vous utilisez dans le bloc
+@code{\layout}, à ceci près que le « graveur » est remplacé par un
+« interprète » (@emph{performer} en anglais).
@example
-\new Staff \with @{midiInstrument = #"cello"@} @{
- @var{...notes...}
+\score @{
+ @var{@dots{}music@dots{}}
+ \midi @{
+ \context @{
+ \Voice
+ \remove "Dynamic_performer"
+ @}
+ @}
@}
@end example
-Lorsque l'instrument choisi ne correspond pas exactement à l'une des
-dénominations consacrées, LilyPond le replacera par un piano de concert
-(@code{"acoustic grand"}).
+@noindent
+supprimera les effets de nuance dans la sortie MIDI. Les modules
+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
-@c In 2.11 the following no longer seems to be a problem -td
-@ignore
-Un (de)crescendo non terminé ne sera pas correctement rendu en MIDI --
-il y a nécessairement du silence. Il vous faut donc lui donner une fin
-explicite. Par exemple,
+Certains systèmes d'exploitation requièrent que les fichiers MIDI
+portent l'extension @code{.mid}. Si besoin est, placez la ligne
+suivante au début de votre fichier source, avant l'ouverture de tout
+bloc @code{\book}, @code{\bookpart} ou @code{\score} :
@example
-@{ a4\< b c d\f @}
+#(ly:set-option 'midi-extension "mid")
@end example
-@noindent
-ne fonctionnera pas correctement, contrairement à
+Cette ligne déterminera @code{.midi} comme extension par défaut pour les
+fichiers MIDI.
+
+Vous pouvez aussi le faire en ligne de commande :
@example
-@{ a4\< b c d\!\f @}
+lilypond … -dmidi-extension=mid MonFichier.ly
@end example
-@end ignore
Un changement de volume ne peut intervenir que sur le démarrage d'une
note. C'est la raison pour laquelle la succession d'un crescendo et
d'un diminuendo ne peut se produire sur une même note.
Certains lecteurs MIDI ne rendent pas correctement les changements de
-tempo. MS Windows Media Player et
-@uref{http://@/timidity@/.sourceforge@/.net/,timidity} le font sans
-problème.
+tempo.
+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 Le bloc MIDI
-@subsection Le bloc MIDI
-@translationof MIDI block
-Dès lors que vous désirez obtenir une sortie MIDI, vous devrez inscrire
-un bloc @code{\midi} au sein du bloc @code{\score}. Son fonctionnement
-est comparable à ce lui du bloc @code{\layout}, voire plus simple. Si
-le bloc @code{\midi} est la plupart du temps laissé vide, il peut
-contenir des aménagements pour certains contextes, la définition de
-contextes particuliers ou du code permettant de déterminer la valeur de
-certaines propriétés. L'exemple suivant détermine le tempo initial du
-fichier MIDI tout en se passant de son indication sur la partition
-imprimée.
+@node Instrument MIDI
+@subsection Instrument MIDI
+@translationof MIDI Instruments
-@example
-\score @{
- @var{...musique...}
- \midi @{
- \tempo 4 = 72
- @}
-@}
-@end example
+@cindex instrument, nom d'
+@cindex MIDI, instruments
+@funindex Staff.midiInstrument
-Ici, le tempo est fixé à 72 noires à la minute. Spécifier un tempo de
-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 :
+L'instrument MIDI affecté à un canal particulier est déterminé par la
+propriété @code{Staff.midiInstrument}. Vous pouvez choisir l'un des
+instruments répertoriés à l'annexe @ref{Instruments MIDI}.
@example
-tempoWholesPerMinute = #(ly:make-moment 270 8)
+\new Staff @{
+ \set Staff.midiInstrument = #"glockenspiel"
+ @var{@dots{}notes@dots{}}
+@}
@end example
-@cindex MIDI et définition de contexte
-@cindex contexte, définition en MIDI
-
-La syntaxe permettant de définir un contexte pour le @code{\midi} est en
-tout point identique à celle que vous utilisez dans le bloc
-@code{\layout}, à ceci près que le @qq{graveur} est remplacé par un
-@qq{interprète}. Les différents contextes disponibles en matière de
-MIDI sont répertoriés dans le fichier d'initialisation
-@file{../ly/performer-init.ly} -- pour plus de détail, voir
-@rlearning{Autres sources de documentation}.
-Si vous voulez vous passer des nuances dans votre fichier MIDI, il vous
-suffit d'insérer les lignes suivantes dans votre bloc
-@code{\midi@{ @}}.
-
@example
-\midi @{
- ...
- \context @{
- \Voice
- \remove "Dynamic_performer"
- @}
+\new Staff \with @{midiInstrument = #"cello"@} @{
+ @var{@dots{}notes@dots{}}
@}
@end example
-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}.
+Lorsque l'instrument choisi ne correspond pas exactement à l'une des
+dénominations consacrées, LilyPond le replacera par un piano de concert
+(@code{"acoustic grand"}).
-@example
-\score @{
- @{ @dots{}notes@dots{} @}
- \midi @{ @}
-@}
-@end example
+@seealso
+Manuel de notation :
+@ref{Instruments MIDI}.
+
+Référence des propriétés internes :
+@rinternals{Dynamic_performer}.
@node Contenu de la sortie MIDI
@c TODO Check grace notes - timing is suspect?
+@menu
+* Éléments pris en compte dans le MIDI::
+* Éléments non pris en compte dans le MIDI::
+@end menu
+
+@node Éléments pris en compte dans le MIDI
@unnumberedsubsubsec Éléments pris en compte dans le MIDI
@translationof Supported in 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
@translationof Unsupported in 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 @{
- @var{..musique..}
- \layout @{ .. @}
+ @var{@dots{}musique@dots{}}
+ \layout @{ @dots{} @}
@}
\score @{
- \unfoldRepeats @var{..musique..}
- \midi @{ .. @}
+ \unfoldRepeats @var{@dots{}musique@dots{}}
+ \midi @{ @dots{} @}
@}
@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
volume général, celui des indications de nuance ainsi que celui des
différents instruments.
+@menu
+* Indications de nuance::
+* Amplitude du volume en MIDI::
+* Égalisation de plusieurs instruments (i)::
+* Égalisation de plusieurs instruments (ii)::
+@end menu
+
+@node Indications de nuance
@unnumberedsubsubsec Indications de nuance
@translationof Dynamic marks
@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
@translationof Overall MIDI volume
Les valeurs extrêmes du volume MIDI des nuances se contrôlent à l'aide
des propriétés @code{midiMinimumVolume} et @code{midiMaximumVolume} qui
agissent au niveau @code{Score}. Ces propriétés sont effectives dès
-lors qu'une nuance est indiquée ; une nuance de départ est donc
+lors qu'une nuance est indiquée ; une nuance de départ explicite est donc
requise pour que le volume soit ajusté dès le début de la partition.
Vous pouvez alors modifier la fraction correspondant à chaque nuance à
l'aide de la formule
@end example
Voici comment ajuster les nuances tout en limitant l'amplitude du volume
-entre 0,2 et 0,5 :
+entre 0,2 et 0,5 :
@lilypond[verbatim,quote]
\score {
\set Staff.midiInstrument = #"flute"
\new Voice \relative c''' {
r2 g\mp g fis~
- fis4 g8 fis e2~
- e4 d8 cis d2
+ 4 g8 fis e2~
+ 4 d8 cis d2
}
}
\new Staff {
>>
\layout {}
\midi {
+ \tempo 2 = 72
\context {
\Score
- tempoWholesPerMinute = #(ly:make-moment 72 2)
midiMinimumVolume = #0.2
midiMaximumVolume = #0.5
}
}
@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)
@translationof Equalizing different instruments (i)
\set Staff.midiMaximumVolume = #0.9
\new Voice \relative c''' {
r2 g\mp g fis~
- fis4 g8 fis e2~
- e4 d8 cis d2
+ 4 g8 fis e2~
+ 4 d8 cis d2
}
}
\new Staff {
}
@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)
@translationof Equalizing different instruments (ii)
\set Staff.midiInstrument = #"flute"
\new Voice \relative c''' {
r2 g\mp g fis~
- fis4 g8 fis e2~
- e4 d8 cis d2
+ 4 g8 fis e2~
+ 4 d8 cis d2
}
}
\new Staff {
}
@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
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...
+ 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
LilyPond affichera le résultat sous forme de message en console, au
milieu de toutes les informations de compilation. Afin d'isoler ces
messages et enregistrer le résultat de la fonction
-@code{\display@{MATÉRIAU@}}, pensez à rediriger la sortie vers un
-fichier.
+@code{\displayLilyMusic}, pensez à rediriger la sortie vers un fichier.
@example
lilypond fichier.ly > affichage.txt
nombre de paramètres optionnels.
@example
-@var{temps} @var{type} @var{...paramètres...}
+@var{temps} @var{type} @var{@dots{}paramètres@dots{}}
@end example
Ces informations peuvent faire l'objet d'un retraitement par d'autres
projects / lilypond.git / blobdiff