lilypond-book robustness: ensure EOL at the end of @verbatim

[lilypond.git] / Documentation / fr / user / editorial.itely

@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 Editorial annotations
@section Editorial annotations

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

@menu
* Inside the staff::            
* Outside the staff::           
@end menu


@node Inside the staff
@subsection Inside the staff


@menu
* Selecting notation font size::  
* Fingering instructions::      
* Hidden notes::                
* Coloring objects::            
* Parentheses::                 
* Stems::                       
@end menu

@node Selecting notation font size
@unnumberedsubsubsec 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{Setting the staff size}.  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 Fingering instructions
@unnumberedsubsubsec 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 Hidden notes
@unnumberedsubsubsec 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 Coloring objects
@unnumberedsubsubsec Coloring objects

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

@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{List of colors}.


@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{The tweak command}.


@node Parentheses
@unnumberedsubsubsec 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 Stems
@unnumberedsubsubsec 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 Outside the staff
@subsection Outside the staff


@menu
* Balloon help::                
* Grid lines::                  
* Analysis brackets::           
* Blank music sheet::           
@end menu

@node Balloon help
@unnumberedsubsubsec 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 Grid lines
@unnumberedsubsubsec 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 Analysis brackets
@unnumberedsubsubsec 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 Blank music sheet
@unnumberedsubsubsec 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