]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/user/putting.itely
Merge branch 'master' of ssh://kainhofer@git.sv.gnu.org/srv/git/lilypond into kainhofer
[lilypond.git] / Documentation / fr / user / putting.itely
index 4a305cbee6030f8337b63161bda1444206ccb98d..81cd991a91074afd6817f52829bbf71637e7b3c3 100644 (file)
-@c -*- coding: utf-8; mode: texinfo; -*-
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 0bf1e119501727ab8217767d8ce6c29dedf4fed1
+    Translation of GIT committish: 27af34a245b02a6b89c9af3becefcfe676b2e19d
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
+@c FIXME outdated stuff, to be soon deleted
+
 @node Putting it all together
 @chapter Putting it all together
 
 Ce chapitre traite des principes généraux de LilyPond, et de
-la manière de créer des blocs @code{\score} @footnote{Le terme @qq{score} signifie partition en anglais.}.
+la manière de créer des blocs @code{\score} @footnote{Le terme
+@q{score} signifie partition en anglais.}.
 
 
 @menu
-* Extending the templates::     
-* How LilyPond files work::     
-* Score is a single musical expression::  
 * An orchestral part::          
 @end menu
 
-
-@node Extending the templates
-@section Extending the templates
-
-Bon, vous avez lu le tutoriel, vous savez écrire de la musique.  Mais
-comment obtenir les portées que vous voulez ?  Les modèles, c'est bien
-beau, mais que faire quand ils ne traitent pas ce que l'on veut précisément ?
-
-Commencez par le modèle qui vous semblera le plus proche de ce à quoi
-vous voulez aboutir.  Disons par exemple que vous voulez écrire une pièce
-pour soprano et violoncelle : dans ce cas l'on pourrait commencer par
-@qq{Notes and lyrics}, pour la partie de soprano.
-
-@example
-\version "2.10.10"
-melodie = \relative c' @{
-  \clef treble
-  \key c \major
-  \time 4/4
-
-  a4 b c d
-@}
-
-texte = \lyricmode @{
-  Laaa Siii Dooo Rééé
-@}
-
-\score@{
-  <<
-    \new Voice = "voixUn" @{
-      \autoBeamOff
-      \melodie
-    @}
-    \new Lyrics \lyricsto "voixUn" \texte
-  >>
-  \layout @{ @}
-  \midi @{ @}
-@}
-@end example
-
-Maintenant, on veut ajouter une partie de violoncelle.
-Jetons un coup d'oeil sur l'exemple @qq{Notes only} :
-
-@example
-\version "2.10.10"
-melodie = \relative c' @{
-  \clef treble
-  \key c \major
-  \time 4/4
-
-  a4 b c d
-@}
-
-\score @{
-\new Staff \melodie
-\layout @{ @}
-\midi @{ @}
-@}
-@end example
-
-
-On n'a pas besoin de deux commandes @code{\version}.  Ce dont on a besoin,
-c'est la section @code{melodie}. De même, on n'a pas besoin de deux sections
-@code{\score} -- si nous les gardions toutes les deux, on obtiendrait deux
-parties séparées ; mais nous voulons un vrai duo, avec les deux parties ensemble.
-Dans la section @code{\score}, on n'a pas besoin non plus de deux @code{\layout}
-ou de deux @code{\midi}.
-
-Si on se contente de couper et coller les sections @code{melodie}, on se
-retrouvera avec deux sections de ce nom ; il nous faut donc les renommer.
-Appelons la section pour la soprano @code{musiqueSoprano} et celle pour le
-violoncelle @code{musiqueVioloncelle}.  Tant qu'on y est, renommons @code{texte}
-en @code{parolesSoprano}.  Attention à bien renommer les deux occurrences de
-chacune de ces dénominations : c'est-à-dire la définition de départ, où l'on
-trouve @code{mélodie = relative c' @{ }, et l'endroit où cette dénomination est
-utilisée, dans la section @code{\score}.
-
-Et puis, toujours tant qu'on y est, mettons le violoncelle en clé de Fa, comme
-le veut l'usage, et donnons-lui d'autres notes.
-
-@example
-\version "2.10.10"
-musiqueSoprano = \relative c' @{
-  \clef treble
-  \key c \major
-  \time 4/4
-
-  a4 b c d
-@}
-
-parolesSoprano = \lyricmode @{
-  Laaa Siii Dooo Rééé
-@}
-
-musiqueVioloncelle = \relative c @{
-  \clef bass
-  \key c \major
-  \time 4/4
-
-  d4 g fis8 e d4
-@}
-
-\score@{
-  <<
-    \new Voice = "voixUn" @{
-      \autoBeamOff
-      \musiqueSoprano
-    @}
-    \new Lyrics \lyricsto "voixUn" \parolesSoprano
-  >>
-  \layout @{ @}
-  \midi @{ @}
-@}
-@end example
-
-Voilà qui est mieux, mais la partie de violoncelle n'apparaît pas sur
-la partition -- en effet, nous ne l'avons pas utilisée dans la section
-@code{\score}.  Si l'on veut que la partie de violoncelle s'imprime sous
-la partie de soprano, on va devoir ajouter :
-
-@example
-\new Staff \musiqueVioloncelle
-@end example
-
-@noindent
-en dessous de tout ce qui concerne la soprano.  Il nous faut également
-encadrer la musique par des @code{<<} et @code{>>}, qui feront comprendre
-à LilyPond que plusieurs évènements -- ici, des objets @code{Staff} --
-se déroulent en même temps.  Le bloc @code{\score} ressemble maintenant à
-ceci :
-
-@example
-\score@{
-  <<
-    <<
-      \new Voice = "voixUn" @{
-        \autoBeamOff
-        \musiqueSoprano
-      @}
-      \new Lyrics \lyricsto "voixUn" \parolesSoprano
-    >>
-    \new Staff \musiqueVioloncelle
-  >>
-  \layout @{ @}
-  \midi @{ @}
-@}
-@end example
-
-@noindent
-C'est un peu le bazar dans tout ça ; mais il vous sera facile de
-mettre un peu d'ordre dans l'indentation.  Voici le modèle pour
-soprano et violoncelle au complet :
-
-@lilypond[quote,verbatim,ragged-right]
-\version "2.10.10"
-musiqueSoprano = \relative c' {
-  \clef treble
-  \key c \major
-  \time 4/4
-
-  a4 b c d
-}
-
-parolesSoprano = \lyricmode {
-  Laaa Siii Dooo Rééé
-}
-
-musiqueVioloncelle = \relative c {
-  \clef bass
-  \key c \major
-  \time 4/4
-
-  d4 g fis8 e d4
-}
-
-\score{
-  <<
-    <<
-      \new Voice = "voixUn" {
-        \autoBeamOff
-        \musiqueSoprano
-      }
-      \new Lyrics \lyricsto "voixUn" \parolesSoprano
-    >>
-    \new Staff \musiqueVioloncelle
-  >>
-  \layout { }
-  \midi { }
-}
-@end lilypond
-
-
-
-@node How LilyPond files work
-@section How LilyPond files work
-
-La mise en forme des fichiers d'entrée de LilyPond est vraiment
-peu astreignante, afin d'offrir assez de souplesse aux utilisateurs
-expérimentés pour qu'ils puissent organiser leurs fichiers comme
-ils l'entendent.  Cependant, les nouveaux utilisateurs peuvent parfois
-se perdre en raison de cette souplesse.  Cette section présente
-sommairement l'organisation du code LilyPond, en privilégiant
-la simplicité au détriment de certains détails.  Vous trouverez une
-description plus complète dans @ref{File structure}.
-
-La plupart des exemples de ce manuel sont de courts fragments, par exemple :
-
-@example
-c4 a b c
-@end example
-
-Comme vous le savez maintenant (du moins nous l'espèrons), ceci ne
-peut pas être traité en tant que tel. Il s'agit de formes abrégées des
-exemples complets ; pour pouvoir être traitées, elles doivent au moins
-être encadrées par des accolades :
-
-@example
-@{
-  c4 a b c
-@}
-@end example
-
-La plupart des exemples font aussi intervenir la commande
-@code{\relative}, suivie de @code{c'} ou @code{c''}.  Elle
-n'est pas à proprement parler nécessaire pour le traitement
-des exemples, mais dans la plupart des cas le résultat sera 
-vraiment déplorable si vous l'oubliez.
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-\relative c'' {
-  c4 a b c
-}
-@end lilypond
-
-C'est ici que nous entamons les choses sérieuses :
-le code LilyPond, sous cette forme, est en réalité
-un @emph{autre} raccourci. Même s'il est traité sans
-problème, et aboutit au bon résultat, c'est une forme
-abrégée de :
-
-@example
-\score @{
-  \relative c'' @{
-    c4 a b c
-  @}
-@}
-@end example
-
-Un bloc @code{\score} doit commencer par une et une seule
-expression musicale. Rappelez-vous que cette expression
-peut être ce que vous voulez, entre une note toute seule et
-un gigantesque 
-
-@example
-@{
-  \new GrandStaff <<
-    collez ici la partition complète de votre opéra Wagnérien préféré
-  >>
-@}
-@end example
-
-@noindent
-Dès lors que tout cela est entre accolades : @code{@{ ... @}}, c'est
-une et une seule expression musicale.
-
-Le bloc @code{\score} peut contenir d'autres éléments, tels que :
-
-@example
-\score @{
-  @{ c'4 a b c' @}
-  \layout @{ @}
-  \midi @{ @}
-  \header @{ @}
-@}
-@end example
-
-@noindent
-Certains préfèrent mettre ces commandes en dehors du bloc 
-@code{\score} -- par exemple, on met souvent le @code{\header}
-au-dessus. C'est juste là une autre forme abrégée que LilyPond
-accepte.
-
-@cindex variables
-@cindex indentifiers
-
-Une autre abréviation pratique est la possibilité de définir
-des variables -- également appelées "identificateurs". Dans tous
-les modèles, vous trouverez :
-
-@example
-melodie = \relative c' @{
-  c4 a b c
-@}
-
-\score @{
-  @{ \melodie @}
-@}
-@end example
-
-Lorsque LilyPond examinera ce fichier, il va prendre la
-valeur de la variable @{melodie}, c'est-à-dire tout ce qui suit
-le signe @code{=}, et l'insérer partout où il tombera sur
-@code{\melodie}.  Vous êtes libre de choisir comment dénommer
-vos variables@footnote{Les noms de variables sont sensibles aux capitales
-et minuscules, et ne peuvent contenir ni chiffres, ni tirets,
-ni caractères accentués.} ; ce peut être @code{melodie}, @code{global},
-@code{maindroitepiano}, ou @code{laTeteAToto}.  Pour plus de détails,
-voir @ref{Saving typing with identifiers and functions}.
-
-Pour une description complète du format des fichiers d'entrée, voir 
-@ref{File structure}.
-
-
-@node Score is a single musical expression
-@section Score is a single musical expression
-
-Dans la section précédente, @ref{How LilyPond files work}, nous
-avons vu l'organisation générale des fichiers d'entrée de LilyPond.
-Mais c'est comme si nous avions éludé la question essentielle : comment
-diable peut-on savoir quoi mettre après @code{\score} ?
-
-En fait, nous ne l'avons pas éludée du tout : le grand mystère est
-tout simplement qu'il n'y a @emph{pas} de mystère.  Allez,
-expliquons-le en une ligne :
-
-@quotation
-@emph{Un bloc @code{\score} doit commencer par une et une seule
-expression musicale.}
-@end quotation
-
-@noindent
-Peut-être serait-il judicieux de relire la section
-@ref{Music expressions explained}, dans laquelle vous avez
-appris à construire de grandes expressions musicales petit bout
-par petit bout -- nous avons vu les notes, puis les accords, etc.
-Maintenant, nous allons partir d'une grande expression musicale,
-et redescendre la pente.
-
-@example
-\score @{
-  @{   % cette accolade marque le début de l'expression musicale
-    \new GrandStaff <<
-    insérez ici votre opéra Wagnérien préféré
-    >>
-  @}   % cette accolade marque la fin de l'expression musicale
-  \layout @{ @}
-@}
-@end example
-
-Un opéra de Wagner multiplierait aisément la longueur de ce manuel
-par deux ou trois, alors faisons ça en version chant/piano.  On n'a
-plus besoin d'une partition d'orchestre -- @code{GrandStaff} -- donc
-laissons cela de côté.  Par contre, un chanteur et un piano
-@emph{pourraient} nous être utiles.
-
-@example
-\score @{
-  @{
-    <<
-      \new Staff = "chanteur" <<
-      >>
-      \new PianoStaff = piano <<
-      >>
-    >>
-  @}
-  \layout @{ @}
-@}
-@end example
-
-Vous vous souvenez que nous avons recours à @code{<<} et @code{>>}
-pour mettre en place des musiques simultanées.  Et, pour le
-coup, on aimerait @emph{vraiment} que la partie vocale et l'accompagnement
-soient imprimés ensemble...
-
-@example
-\score @{
-  @{
-    <<
-      \new Staff = "chanteur" <<
-        \new Voice = "chant" @{ @}
-      >>
-      \new Lyrics \lyricsto chant \new Lyrics @{ @}
-      \new PianoStaff = "piano" <<
-        \new Staff = "mainDroite" @{ @}
-        \new Staff = "mainGauche" @{ @}
-      >>
-    >>
-  @}
-  \layout @{ @}
-@}
-@end example
-
-On y voit nettement plus clair maintenant.  Nous voici
-donc avec la partie du chanteur, qui contient un ensemble
-@code{Voice}, ce qui dans LilyPond correspond à une voix, au
-sens de vois musicale, pas forcément chantée donc (ce pourrait être
-une partie de violon par exemple). 
-
-Nous avons également une partie de piano, qui contient deux portées :
-une pour la main droite, une autre pour la main gauche.
-
-
-À ce point, on pourrait commencer à ajouter les notes. Dans
-les accolades qui suivent @code{\new Voice = chant}, on pourrait
-commencer à écrire
-
-@example
-\relative c'' @{
-  a4 b c d
-@}
-@end example
-
-Mais si l'on procédait ainsi, la section @code{\score} deviendrait
-vite plutôt touffue, et il serait très tôt difficile de s'y retrouver.
-C'est pourquoi on utilisera plutôt des variables, ou identificateurs :
-
-@example
-melodie = @{ @}
-texte = @{ @}
-mainDroite = @{ @}
-mainGauche = @{ @}
-\score @{
-  @{
-    <<
-      \new Staff = "chanteur" <<
-        \new Voice = "chant" @{ \melodie @}
-      >>
-      \new Lyrics \lyricsto chant \new Lyrics @{ \texte @}
-      \new PianoStaff = "piano" <<
-        \new Staff = "mainDroite" @{ \mainDroite @}
-        \new Staff = "mainGauche" @{ \mainGauche @}
-      >>
-    >>
-  @}
-  \layout @{ @}
-@}
-@end example
-
-@noindent
-Souvenez-vous que vous pouvez désigner vos variables du
-nom que vous voulez, à condition de respecter les caractères
-autorisés. Ces limitations sont décrites dans
-@ref{File structure}.
-
-Quand on écrit, ou que l'on lit, une section @code{\score},
-mieux vaut y aller lentement et soigneusement. Commencez
-par le niveau le plus large, puis travaillez sur chaque
-niveau plus détaillé.  Cela aide vraiment, à ce propos,
-d'avoir une indentation stricte et propre : assurez-vous que
-chaque élément d'un même niveau a le même décalage horizontal
-dans votre éditeur de texte !
-
-
-
 @node An orchestral part
 @section An orchestral part
 
@@ -510,7 +56,7 @@ On établira alors une partie séparée en constituant un nouveau fichier :
 @}
 @end example
 
-À La ligne
+À la ligne
 
 @example
 \include "musique-Cor.ly"
@@ -520,7 +66,7 @@ On établira alors une partie séparée en constituant un nouveau fichier :
 sera substitué le contenu du fichier @file{musique-Cor.ly}, et de ce
 fait la variable @code{notesCor} se trouvera définie.  La commande
 @code{\transpose f@tie{}c'} indique que son argument @code{\notesCor}
-soit transposé à la quinte supérieure : le son réel @samp{f} s'écrit
+sera transposé à la quinte supérieure : le son réel @samp{f} s'écrit
 @code{c'}, ce qui est la caractéristique d'un Cor en Fa. La transposition
 est visible comme suit :
 
@@ -532,9 +78,9 @@ est visible comme suit :
 @end lilypond
 
 Dans les pièces d'ensemble, il arrive souvent qu'une voix ne joue pas
-pendant plusieurs mesures.  Un silence spécial, appelé multi-mesures,
+pendant plusieurs mesures.  Un silence spécial, appelé silence multi-mesures,
 l'indique alors. On l'obtient par un @samp{R} majuscule, suivi d'une
-durée : (@code{1}@tie{} est une pause, @code{2}@tie{} une demi-pause,
+durée : @code{1}@tie{}pour une pause, @code{2}@tie{}pour une demi-pause,
 etc.  Cette durée peut être multipliée pour établir de plus longs silences.
 Par exemple, le silence suivant dure 3@tie{}mesures à 2/4.
 
@@ -543,16 +89,17 @@ R2*3
 @end example
 
 Dans une partie séparée, les silences multi-mesures sont compressés.
-Il faut pour cela définir comme vraie la propriété @code{skipBars} :
+Il faut pour cela définir la propriété @code{skipBars} à @q{vrai} :
 
 @example
 \set Score.skipBars = ##t
 @end example
 
 @noindent
-Cette commande définie comme vraie ("true", lettre "t") la propriété dans
-le contexte @code{Score}.  Si l'on ajoute dans la musique ci-dessus
-le silence multi-mesures et cette option, on obtient le résultat suivant :
+Cette commande assigne la valeur @q{vrai} --- @q{true} en anglais, et
+@samp{#t} dans le langage Scheme --- à cette propriété dans le
+contexte @code{Score}.  Si l'on ajoute dans la musique ci-dessus le
+silence multi-mesures et cette option, on obtient le résultat suivant :
 
 @lilypond[quote,ragged-right]
 \transpose f c' \relative c {
@@ -565,7 +112,7 @@ le silence multi-mesures et cette option, on obtient le résultat suivant :
 
 Le conducteur rassemble toute la musique. Si l'on suppose que l'autre
 voix de notre duo se trouve dans le fichier @file{musique-Basson.ly} en
-tant que variable @code{notesBasson}, on établira un conducteur avec :
+tant que variable @code{notesBasson}, on établira un conducteur avec
 
 @example
 \include "musique-Basson.ly"
@@ -594,8 +141,9 @@ ce qui équivaut à
 >>
 @end lilypond
 
-Des informations plus détaillées sur la mise en place de conducteurs et
-de parties séparées se trouvent dans le manuel : voir @ref{Orchestral music}.
+Des informations plus détaillées sur la mise en place de conducteurs
+et de parties séparées se trouvent dans le manuel : voir
+@ruser{Orchestral music}.
 
-Les propriétés réglables (@q{properties}) sont abordées en détail dans
-@ref{Changing context properties on the fly}.
+Les variables (@q{propriétés}) réglables sont abordées en détail dans
+@ruser{Changing context properties on the fly}.