@c -*- coding: utf-8; mode: texinfo; -*-
@ignore
    Translation of GIT committish: 33ba8d40c3493011a4b39ab8b1369701f8013bd6

    When revising a translation, copy the HEAD committish of the
    version that you are working on.  See TRANSLATION for details.
@end ignore

@c \version "2.12.0"

@c Translators: Jean-Charles Malahieude

@node Notation éditoriale
@section Notation éditoriale
@translationof Editorial annotations

@lilypondfile[quote]{editorial-headword.ly}

@menu
* Dans la portée::            
* Hors de la portée::           
@end menu


@node Dans la portée
@subsection Dans la portée
@translationof Inside the staff


@menu
* Indication de la taille de fonte musicale::  
* Doigtés::      
* Dictée à trous::                
* Coloration d'objets::            
* Parenthèses::                 
* Hampes::                       
@end menu

@node Indication de la taille de fonte musicale
@unnumberedsubsubsec Indication de la taille de fonte musicale
@translationof Selecting notation font size

Le plus sûr moyen de régler la taille de la police, quelque soit le
contexte, consiste à définir la propriété @code{fontSize}.

@lilypond[quote,fragment,relative=1,verbatim]
c8
\set fontSize = #-4
c f
\set fontSize = #3
g
@end lilypond

@noindent
Ceci ne modifiera en rien la taille des différents symboles tels que
ligatures ou liaisons.

En interne, la propriété @code{fontSize} d'un contexte aura pour effet
de définir la propriété @code{font-size} pour tous les objets de
rendu.  La valeur de @code{font-size} est un entier représentant la
taille proportionnellement à la hauteur standard de la portée en
cours.  Chaque incrément correspond à une augmentation d'environ
12@tie{}% de la taille de la police. Un pas de six aboutit exactement
au doublement de la taille.  La fonction Scheme @code{magstep}
convertit le nombre affecté à @code{font-size} en facteur d'échelle.
Vous pouvez aussi définir directement la propriété @code{font-size} de
manière à n'affecter seulement que certains objets de rendu.

@lilypond[quote,fragment,relative=1,verbatim]
c8
\override NoteHead #'font-size = #-4
c f
\override NoteHead #'font-size = #3
g
@end lilypond

Pour changer la taille des symboles musicaux (police Feta), LilyPond met
à l'échelle la fonte dont la taille est la plus proche de la taille voulue ---
cf. @ref{Définition de la taille de portée}.  La taille standard, pour laquelle
@code{font-size} vaut 0, dépend de la hauteur de la portée.  À une
portée de 20 points correspond une police de 10 points.

La propriété @code{font-size} ne peut intervenir que pour les objets
qui utilisent des polices, autrement dit ceux qui disposent de
l'interface de rendu @rinternals{font-interface}.


@predefined
Les commandes suivantes définissent @code{fontSize} pour la voix en
cours :
@funindex \tiny
@code{\tiny},
@funindex \small
@code{\small},
@funindex \normalsize
@code{\normalsize}.
@endpredefined


@node Doigtés
@unnumberedsubsubsec Doigtés
@translationof Fingering instructions

@cindex doigté
@cindex substitution de doigt


Les doigtés peuvent être indiqués comme suit :
@example
@var{note}-@var{chiffre_du_doigt}
@end example
Pour les substitutions de doigts, on a recours à une indication
textuelle (commande @code{\markup}) de doigté
(commande @code{\finger}).

@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
c4-1 c-2 c-3 c-4
c^\markup { \finger "2 - 3" }
@end lilypond


La commande @code{\thumb} peut être utilisée pour indiquer, par exemple
dans une partition de violoncelle, si une note doit être jouée avec le
pouce (@q{thumb} en anglais).

@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
<a_\thumb a'-3>8 <b_\thumb b'-3>
@end lilypond


Les doigtés des accords peuvent être saisis note par note,
en les indiquant après chaque hauteur de note.

@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
< c-1 e-2 g-3 b-5 >4
@end lilypond


@commonprop

On peut contrôler précisément les doigtés des accords en réglant
la propriété @code{fingeringOrientations}.

@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
\set fingeringOrientations = #'(left down)
<c-1 es-2 g-4 bes-5 > 4
\set fingeringOrientations = #'(up right down)
<c-1 es-2 g-4 bes-5 > 4
@end lilypond


Cette propriété permet également, dans de la musique monophonique,
d'indiquer des doigtés très proches des têtes de notes.

@lilypond[verbatim,ragged-right,quote,fragment]
\set fingeringOrientations = #'(right)
<es'-2>4
@end lilypond

@snippets

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{avoiding-collisions-with-chord-fingerings.ly}


@seealso
Référence du programme : @rinternals{Fingering}.

Exemples : @rlsr{Editorial annotations}.


@node Dictée à trous
@unnumberedsubsubsec Dictée à trous
@translationof Hidden notes

@cindex Masquées, notes
@cindex Invisibles, notes
@cindex Transparentes, notes

@funindex \hideNotes
@funindex \unHideNotes
Les notes masquées --- ou invisibles ou encore transparentes --- sont
utiles dans le cadre d'exercices de théorie ou de composition.

@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
c4 d4
\hideNotes
e4 f4
\unHideNotes
g4 a
@end lilypond


@node Coloration d'objets
@unnumberedsubsubsec Coloration d'objets
@translationof Coloring objects

Des objets peuvent être colorisés individuellement.  Une listes des
noms des couleurs disponibles se trouvent à l'annexe @ref{Liste des couleurs}.

@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
\override NoteHead #'color = #red
c4 c
\override NoteHead #'color = #(x11-color 'LimeGreen)
d
\override Stem #'color = #blue
e
@end lilypond

L'intégralité de la palette des couleurs définies pour X11 est
accessible par la fonction Scheme x11-color.  Cette fonction prend
en argument une expression symbolique

@example
\override Beam #'color = #(x11-color 'MediumTurquoise)
@end example

ou une chaîne de caractères

@example
\override Beam #'color = #(x11-color "MediumTurquoise")
@end example

La première formulation est à la fois plus rapide à écrire et aussi
plus efficace.  Néanmoins, la deuxième forme permet d'accéder aux noms
composés des couleurs de X11.

@example
\override Beam #'color = #(x11-color "medium turquoise")
@end example

Lorsque la fonction x11-color ne trouve pas le paramètre fourni, elle
revient à la couleur par défaut, le noir.  Le problème ressort de
façon évidente au vu de la partition finale.

L'exemple suivant illustre l'utilisation de la fonction
@code{x11-color}.  Notez que, après avoir été définie à (x11-color
'Boggle), la couleur des hampes repasse au noir.

@lilypond[quote,ragged-right,verbatim]
{
  \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
  \set Staff.instrumentName = \markup {
    \with-color #(x11-color 'navy) "Clarinet"
  }
  \time 2/4
  gis''8 a''
  \override Beam #'color = #(x11-color "medium turquoise")
  gis'' a''
  \override NoteHead #'color = #(x11-color "LimeGreen")
  gis'' a''
  \override Stem #'color = #(x11-color 'Boggle)
  gis'' a''
}
@end lilypond


@seealso
Annexes : @ref{Liste des couleurs}.


@knownissues
Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
internet.  Aussi nous vous recommandons, dans le cadre d'une
présentation multimedia, d'utiliser des couleurs de base.

Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
normale ayant un nom similaire.

Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
@code{\override}. si besoin est, utilisez @code{\tweak}.  
Pour plus de détails, consultez @ref{La commande d'affinage (@emph{tweak})}.


@node Parenthèses
@unnumberedsubsubsec Parenthèses
@translationof Parentheses

@cindex fantômes, notes
@cindex notes fantômes
@cindex parenthèses, notes entre

Des objets peuvent être mis entre parenthèses en saisissant
@code{\parenthesize} juste avant l'événement musical.

@lilypond[relative=2,fragment,verbatim,ragged-right]
<
  c
  \parenthesize d
  g
>4-\parenthesize -.
@end lilypond

Ceci n'est opérationnel que dans le cadre d'un accord, qui peut ne
comprendre qu'une seule note.

@example
< \parenthesize NOTE>
@end example


@node Hampes
@unnumberedsubsubsec Hampes
@translationof Stems

Dès qu'une note est rencontrée, un objet @rinternals{Stem} se crée
automatiquement.  Pour les rondes et les silences, ils sont aussi
créés, mais en mode invisible.


@predefined
@funindex \stemUp
@code{\stemUp},
@funindex \stemDown
@code{\stemDown},
@funindex \stemNeutral
@code{\stemNeutral}.
@endpredefined


@commonprop

Pour changer la direction des hampes au milieu de la portée, utilisez

@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
a4 b c b
\override Stem #'neutral-direction = #up
a4 b c b
\override Stem #'neutral-direction = #down
a4 b c b
@end lilypond


@node Hors de la portée
@subsection Hors de la portée
@translationof Outside the staff


@menu
* Info-bulle::                
* Quadrillage temporel::                  
* Crochets d'analyse::           
* Papier à musique::           
@end menu

@node Info-bulle
@unnumberedsubsubsec Info-bulle
@translationof Balloon help

Vous pouvez marquer et nommer des éléments de notation à l'aide de
bulles.  L'objectif premier de cette fonctionnalité est d'expliquer la
notation. 

En voici un exemple :
@c KEEP LY
@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
\new Voice \with { \consists "Balloon_engraver" }
{
  \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
  <c-\balloonText #'(-2 . -2) \markup { Hello }  >8
}
@end lilypond

@noindent
Vous disposez de deux fonctions musicales, @code{balloonText} et
@code{balloonGrobText}.  @code{balloonGrobText} prend en argument
l'objet graphique à agrémenter, alors que @code{balloonText} s'utilise
comme une simple articulation.  Les autres arguments sont le décalage
et le texte de la bulle.

@cindex bulles
@cindex notation, expliquer


@seealso
Référence du programme : @rinternals{balloon-interface}.


@node Quadrillage temporel
@unnumberedsubsubsec Quadrillage temporel
@translationof Grid lines

Vous pouvez tracer des lignes entre les portées, synchronisées avec
les notes.
@c KEEP LY
@lilypond[ragged-right,quote,verbatim]
\layout {
  \context {
    \Staff
    \consists "Grid_point_engraver" %% active les guides
    gridInterval = #(ly:make-moment 1 4)
  }
}

\new Score \with {
  \consists "Grid_line_span_engraver"
  %% centre les lignes guides horizontalement sous les notes
  \override NoteColumn #'X-offset = #-0.5
}

\new ChoirStaff <<
  \new Staff {
    \stemUp
    \relative {
      c'4. d8 e8 f g4
    }
  }
  \new Staff {
    %% centre les lignes guides verticalement
    \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 )
    \stemDown
    \clef bass
    \relative c {
      c4  g'  f  e
    }
  }
>>
@end lilypond

Exemples : @rlsr{Editorial annotations}.


@node Crochets d'analyse
@unnumberedsubsubsec Crochets d'analyse
@translationof Analysis brackets
@cindex crochets
@cindex crochets de phrasé
@cindex analyse musicologique
@cindex crochet de regroupement de notes

On utilise des crochets en analyse musicale, pour indiquer la
structure d'une pièce.  LilyPond permet d'utiliser une forme
simplifiée de crochets horizontaux imbriqués, dans la mesure où le
contexte @rinternals{Staff} comporte le graveur
@rinternals{Horizontal_bracket_engraver}.  Un crochet s'ouvre avec
@code{\startGroup}, et se ferme avec @code{\stopGroup}.

@lilypond[quote,ragged-right,verbatim]
\score {
  \relative c'' {
    c4\startGroup\startGroup
    c4\stopGroup
    c4\startGroup
    c4\stopGroup\stopGroup
  }
  \layout {
    \context {
      \Staff \consists "Horizontal_bracket_engraver"
}}}
@end lilypond


@seealso
Référence du programme : @rinternals{HorizontalBracket}.


@node Papier à musique
@unnumberedsubsubsec Papier à musique
@translationof Blank music sheet

@cindex Papier musique
@cindex Portées, feuille blanche

Une feuille de papier musique s'obtient en utilisant des notes
invisibles, et en invalidant le @code{Bar_number_engraver}.

@c KEEP LY
@lilypond[quote,verbatim]
\layout{ indent = #0 }
emptymusic = {
  \repeat unfold 2 % À modifier pour plus de lignes.
  { s1\break }
  \bar "|."
}
\new Score \with {
  \override TimeSignature #'transparent = ##t
% décommenter la  ligne suivante selon besoin
%  \override Clef #'transparent = ##t
  defaultBarType = #""
  \remove Bar_number_engraver
} <<

% à adapter selon les portées désirées
  \new Staff \emptymusic
  \new TabStaff \emptymusic
>>
@end lilypond


