]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/user/working.itely
Merge master into nested-bookparts
[lilypond.git] / Documentation / fr / user / working.itely
index 8e11a6bba451efafa7f3ed120ec947f93aabf83f..9fd28c2e2457243fb9feba6ff863a48e484967a7 100644 (file)
@@ -1,12 +1,17 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond.tely
 @ignore
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond.tely
 @ignore
-   Translation of GIT committish: 6ffead15d2e3dffd294c8e030938facef896d861
+   Translation of GIT committish: bfbaf6488d99ab4cdfcb4efdc67eaca63a636106
 
    When revising a translation, copy the HEAD committish of the
    version that you are working on.  See TRANSLATION for details.
 @end ignore
 
 
    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.11.61"
+
+@c Translators: Ludovic Sardain
+@c Translation checkers: Jean-Yves Baudais, Valentin Villenave, John Mandereau, Jean-Charles Malahieude
+
 @node Working on LilyPond projects
 @chapter Working on LilyPond projects
 
 @node Working on LilyPond projects
 @chapter Working on LilyPond projects
 
@@ -16,16 +21,13 @@ ces astuces peuvent vous paraître évidentes, mais vous ne perdrez tout
 de même pas votre temps à lire ce chapitre.
 
 @menu
 de même pas votre temps à lire ce chapitre.
 
 @menu
-* Suggestions for writing LilyPond files::
-* Saving typing with identifiers and functions::
-* Style sheets::
-* Updating old files::
-* Troubleshooting (taking it all apart)::
-* Minimal examples::
+* Suggestions for writing LilyPond input files::
+* When things don't work::      
+* Scores and parts::            
 @end menu
 
 @end menu
 
-@node Suggestions for writing LilyPond files
-@section Suggestions for writing LilyPond files
+@node Suggestions for writing LilyPond input files
+@section Suggestions for writing LilyPond input files
 
 Maintenant vous êtes prêt à travailler sur de plus gros fichiers
 LilyPond --- des pièces entières, et plus seulement les petits
 
 Maintenant vous êtes prêt à travailler sur de plus gros fichiers
 LilyPond --- des pièces entières, et plus seulement les petits
@@ -56,9 +58,11 @@ faciliter leur mise à jour.
 @end itemize
 
 @menu
 @end itemize
 
 @menu
-* General suggestions::
-* Typesetting existing music::
-* Large projects::
+* General suggestions::         
+* Typesetting existing music::  
+* Large projects::              
+* Saving typing with variables and functions::  
+* Style sheets::                
 @end menu
 
 @node General suggestions
 @end menu
 
 @node General suggestions
@@ -67,20 +71,20 @@ faciliter leur mise à jour.
 Voici quelques conseils qui peuvent vous éviter certains problèmes ou
 en résoudre d'autres.
 
 Voici quelques conseils qui peuvent vous éviter certains problèmes ou
 en résoudre d'autres.
 
-@itemize @bullet
+@itemize
 @item @strong{Ajoutez le numéro de version dans chaque fichier}.
 Notez que chaque fichier modèle contient une ligne @code{\version
 @item @strong{Ajoutez le numéro de version dans chaque fichier}.
 Notez que chaque fichier modèle contient une ligne @code{\version
-"2.11.15"}.  Nous vous conseillons fortement d'inclure cette ligne,
+"2.11.32"}.  Nous vous conseillons fortement d'inclure cette ligne,
 même pour de petits fichiers.  Par expérience, il est très difficile
 de se rappeler quelle version de LilyPond on utilisait quelques
 même pour de petits fichiers.  Par expérience, il est très difficile
 de se rappeler quelle version de LilyPond on utilisait quelques
-années auparavant.  L'utilitaire @code{convert-ly} demande que vous
-spécifiiez quelle version de LilyPond vous utilisiez.
-
-@item @strong{Ajoutez des contrôles}: @ref{Bar check}, @ref{Octave
-check} et @ref{Barnumber check}.  Si vous avez ajouté des contrôles de
-loin en loin, et que vous faites une erreur, vous pourrez la retrouver
-plus rapidement.  @qq{De loin en loin}, qu'est-ce à dire ?  Cela
-dépend de la complexité de la musique.  Pour de la musique très
+années auparavant.  L'utilitaire @command{convert-ly} demande que vous
+spécifiiez la version de LilyPond vous utilisiez alors.
+
+@item @strong{Ajoutez des contrôles}: @ruser{Octave checks}, et
+@ruser{Bar and bar number checks}.  Si vous avez ajouté des contrôles
+de loin en loin, et que vous faites une erreur, vous pourrez la
+retrouver plus rapidement.  @qq{De loin en loin}, qu'est-ce à dire ?
+Cela dépend de la complexité de la musique.  Pour de la musique très
 simple, peut-être une ou deux fois.  Pour de la musique très complexe,
 peut-être à chaque mesure.
 
 simple, peut-être une ou deux fois.  Pour de la musique très complexe,
 peut-être à chaque mesure.
 
@@ -104,7 +108,7 @@ structuré si vous n'y avez pas adjoint de commentaires.
 viennent d'un défaut de parité entre @code{@{} et @code{@}}.
 
 @item @strong{Séparez les affinages de mise en forme} de la musique
 viennent d'un défaut de parité entre @code{@{} et @code{@}}.
 
 @item @strong{Séparez les affinages de mise en forme} de la musique
-elle-même. Voyez @ref{Saving typing with identifiers and functions} et
+elle-même. Voyez @ref{Saving typing with variables and functions} et
 @ref{Style sheets}.
 
 @end itemize
 @ref{Style sheets}.
 
 @end itemize
@@ -122,15 +126,15 @@ c'est-à-dire de la musique déjà écrite,
 à la fois --- mais toujours une seule mesure par ligne de texte ---,
 et vérifiez chaque système lorsqu'il est terminé.  Vous pouvez
 utiliser la commande @code{showLastLength} pour accélérer la
 à la fois --- mais toujours une seule mesure par ligne de texte ---,
 et vérifiez chaque système lorsqu'il est terminé.  Vous pouvez
 utiliser la commande @code{showLastLength} pour accélérer la
-compilation --- voir @ref{Skipping corrected music} ;
+compilation --- voir @ruser{Skipping corrected music} ;
 
 @item définissez @code{mBreak = @{\break @}} et insérez
 
 @item définissez @code{mBreak = @{\break @}} et insérez
-@code{\mBreak} dans le fichier d'entrée des sauts de ligne identiques à la
-partition originale.  Cela facilite la comparaison entre la partition
-originale et la partition de LilyPond.  Lorsque vous avez fini de
-relire votre musique, vous pouvez définir @code{mBreak = @{ @}} pour
-enlever tous ces sauts de ligne, et laisser LilyPond placer les sauts
-de ligne selon son propre algorithme.
+@code{\mBreak} dans le fichier d'entrée pour obtenir des sauts de
+ligne identiques à la partition originale.  Cela facilite la
+comparaison entre la partition originale et la partition de 
+LilyPond.  Lorsque vous avez fini de relire votre musique, vous pouvez
+définir @code{mBreak = @{ @}} pour enlever tous ces sauts de ligne, et
+laisser LilyPond placer les sauts de ligne selon son propre algorithme.
 
 @end itemize
 
 
 @end itemize
 
@@ -165,7 +169,7 @@ g4 c'8. e16
 
 @item @strong{Séparez les retouches} des définitions de
 musique.  Ce conseil a été vu dans @ref{General suggestions},
 
 @item @strong{Séparez les retouches} des définitions de
 musique.  Ce conseil a été vu dans @ref{General suggestions},
-mais pour les gros projets c'est absolument vital.  Nous
+mais pour les projets d'importance c'est absolument vital.  Nous
 pouvons avoir besoin de changer la définition de
 @code{fthenp}, mais dans ce cas nous n'aurons besoin de le faire
 qu'une seule fois, et nous pourrons encore éviter de
 pouvons avoir besoin de changer la définition de
 @code{fthenp}, mais dans ce cas nous n'aurons besoin de le faire
 qu'une seule fois, et nous pourrons encore éviter de
@@ -183,8 +187,8 @@ g4\fthenp c'8. e16
 @end itemize
 
 
 @end itemize
 
 
-@node Saving typing with identifiers and functions
-@section Saving typing with identifiers and functions
+@node Saving typing with variables and functions
+@subsection Saving typing with variables and functions
 
 @cindex variables
 @cindex identificateurs
 
 @cindex variables
 @cindex identificateurs
@@ -204,9 +208,9 @@ Vous comprendrez combien cela peut être utile pour écrire de la
 musique minimaliste :
 
 @lilypond[quote,verbatim,ragged-right]
 musique minimaliste :
 
 @lilypond[quote,verbatim,ragged-right]
-fragA = \relative c'' { a4 a8. b16 }
-fragB = \relative c'' { a8. gis16 ees4 }
-violin = \new Staff { \fragA \fragA \fragB \fragA }
+fragmentA = \relative c'' { a4 a8. b16 }
+fragmentB = \relative c'' { a8. gis16 ees4 }
+violin = \new Staff { \fragmentA \fragmentA \fragmentB \fragmentA }
 \score {
   {
     \violin
 \score {
   {
     \violin
@@ -258,7 +262,7 @@ violin = \relative c'' @{
 
 Jusqu'ici nous avons vu des substitutions statiques : quand LilyPond
 rencontre @code{\padText}, il le remplace par le contenu que nous lui
 
 Jusqu'ici nous avons vu des substitutions statiques : quand LilyPond
 rencontre @code{\padText}, il le remplace par le contenu que nous lui
-avons défini --- c'est-à-dire le contenu à droite de @code{padText=}).
+avons défini --- c'est-à-dire le contenu à droite de @code{padText=}.
 
 LilyPond gère également des substitutions non-statiques --- vous
 pouvez les voir comme des fonctions.
 
 LilyPond gère également des substitutions non-statiques --- vous
 pouvez les voir comme des fonctions.
@@ -289,7 +293,7 @@ chaque fichier @code{.ly}.
 
 
 @node Style sheets
 
 
 @node Style sheets
-@section Style sheets
+@subsection Style sheets
 
 La sortie que produit LilyPond peut être largement modifiée --- voir
 @ref{Tweaking output} pour plus de détails.  Mais que faire si vous
 
 La sortie que produit LilyPond peut être largement modifiée --- voir
 @ref{Tweaking output} pour plus de détails.  Mais que faire si vous
@@ -533,13 +537,13 @@ alors à
 @end example
 
 Cette approche peut être utile même si vous ne produisez qu'un seul
 @end example
 
 Cette approche peut être utile même si vous ne produisez qu'un seul
-jeu de partitions.  J'utilise une demi-douzaine de fichiers de
-@qq{feuille de style} pour mes projets.  Je commence chaque fichier de
-musique par @code{\include "../global.ly"} qui contient :
+jeu de partitions.  J'utilise personnellement une demi-douzaine de
+fichiers de @qq{feuille de style} pour mes projets.  Je commence
+chaque fichier de musique par @code{\include "../global.ly"} qui contient :
 
 @example
 %%%   global.ly
 
 @example
 %%%   global.ly
-\version "2.11.15"
+\version @w{"@version{}"}
 #(ly:set-option 'point-and-click #f)
 \include "../init/init-defs.ly"
 \include "../init/init-mise-en-page.ly"
 #(ly:set-option 'point-and-click #f)
 \include "../init/init-defs.ly"
 \include "../init/init-mise-en-page.ly"
@@ -547,8 +551,17 @@ musique par @code{\include "../global.ly"} qui contient :
 \include "../init/init-papier.ly"
 @end example
 
 \include "../init/init-papier.ly"
 @end example
 
+@node When things don't work
+@section When things don't work
+
+@menu
+* Updating old files::          
+* Troubleshooting (taking it all apart)::  
+* Minimal examples::            
+@end menu
+
 @node Updating old files
 @node Updating old files
-@section Updating old files
+@subsection Updating old files
 
 La syntaxe de LilyPond change de temps en temps.  Ces changements de
 syntaxe du langage d'entrée accompagnent les améliorations du
 
 La syntaxe de LilyPond change de temps en temps.  Ces changements de
 syntaxe du langage d'entrée accompagnent les améliorations du
@@ -557,14 +570,14 @@ plus faciles à lire et à écrire, ou permettent d'intégrer de nouvelles
 fonctionnalités.
 
 LilyPond est fourni avec un utilitaire qui facilite cette mise à
 fonctionnalités.
 
 LilyPond est fourni avec un utilitaire qui facilite cette mise à
-jour : @code{convert-ly}.  Pour savoir comment utiliser ce programme,
+jour : @command{convert-ly}.  Pour savoir comment utiliser ce programme,
 voir @rprogram{Updating files with convert-ly}.
 
 voir @rprogram{Updating files with convert-ly}.
 
-Malheureusement, @code{convert-ly} ne peut pas réaliser toutes les
+Malheureusement, @command{convert-ly} ne peut pas réaliser toutes les
 modifications.  Il s'occupe des changements qui ne requièrent qu'une
 simple substitution de texte --- comme @code{raggedright} devenant
 @code{ragged-right} ---, les autres étant trop compliqués à effectuer.
 modifications.  Il s'occupe des changements qui ne requièrent qu'une
 simple substitution de texte --- comme @code{raggedright} devenant
 @code{ragged-right} ---, les autres étant trop compliqués à effectuer.
-Les changements de syntaxe qui ne sont pas gérés par @code{convert-ly}
+Les changements de syntaxe qui ne sont pas gérés par @command{convert-ly}
 sont énumérés dans @rprogram{Updating files with convert-ly}.
 
 Par exemple, dans les versions 2.4 et antérieures de LilyPond,
 sont énumérés dans @rprogram{Updating files with convert-ly}.
 
 Par exemple, dans les versions 2.4 et antérieures de LilyPond,
@@ -579,7 +592,7 @@ fichiers LilyPond manuellement.
 
 
 @node Troubleshooting (taking it all apart)
 
 
 @node Troubleshooting (taking it all apart)
-@section Troubleshooting (taking it all apart)
+@subsection Troubleshooting (taking it all apart)
 
 Tôt ou tard, vous écrirez un fichier que LilyPond ne peut pas
 compiler.  Les messages que LilyPond affiche peuvent vous aider à
 
 Tôt ou tard, vous écrirez un fichier que LilyPond ne peut pas
 compiler.  Les messages que LilyPond affiche peuvent vous aider à
@@ -640,7 +653,7 @@ d'@ref{Minimal examples}.
 
 
 @node Minimal examples
 
 
 @node Minimal examples
-@section Minimal examples
+@subsection Minimal examples
 
 Un exemple minimal est un exemple de code aussi court que possible.
 De tels exemples sont bien plus compréhensibles que des exemples
 
 Un exemple minimal est un exemple de code aussi court que possible.
 De tels exemples sont bien plus compréhensibles que des exemples
@@ -670,8 +683,135 @@ début de votre exemple.
 Tout l'intérêt d'un exemple minimal réside dans sa facilité de lecture :
 @itemize
 @item évitez d'utiliser des notes, armures ou métriques compliquées, à
 Tout l'intérêt d'un exemple minimal réside dans sa facilité de lecture :
 @itemize
 @item évitez d'utiliser des notes, armures ou métriques compliquées, à
-moins que vous vouliez montrer quelque chose en rapport avec
+moins que vous ne vouliez montrer quelque chose en rapport avec
 celles-ci,
 @item n'utilisez pas de commandes @code{\override} sauf si elles font
 l'intérêt de l'exemple.
 @end itemize
 celles-ci,
 @item n'utilisez pas de commandes @code{\override} sauf si elles font
 l'intérêt de l'exemple.
 @end itemize
+
+@node Scores and parts
+@section Scores and parts
+
+Dans la musique d'orchestre, toutes les notes sont imprimées deux fois.
+D'abord dans les parties séparées destinées aux musiciens, et ensuite
+dans le conducteur destiné au chef.  Les variables sont là pour vous éviter
+un double travail.  La musique n'est entrée qu'une seule fois, et stockée dans
+une variable, dont le contenu servira à imprimer à la fois la partie
+séparée et la partition d'orchestre.
+
+Il est judicieux de définir les notes dans un fichier séparé. Par
+exemple, supposons que le fichier @file{musique-Cor.ly} contienne la
+partie suivante pour un duo cor/@/basson.
+
+@example
+notesCor = \relative c @{
+  \time 2/4
+  r4 f8 a cis4 f e d
+@}
+@end example
+
+@noindent
+On établira alors une partie séparée en constituant un nouveau fichier :
+
+@example
+\include "musique-Cor.ly"
+\header @{
+  instrument = "Cor en Fa"
+@}
+
+@{
+ \transpose f c' \notesCor
+@}
+@end example
+
+À la ligne
+
+@example
+\include "musique-Cor.ly"
+@end example
+
+@noindent
+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}
+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 :
+
+@lilypond[quote,ragged-right]
+\transpose f c' \relative c {
+  \time 2/4
+  r4 f8 a cis4 f e d
+}
+@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é silence multi-mesures,
+l'indique alors. On l'obtient par un @samp{R} majuscule, suivi d'une
+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.
+
+@example
+R2*3
+@end example
+
+Dans une partie séparée, les silences multi-mesures sont compressés.
+Il faut pour cela définir la propriété @code{skipBars} à @q{vrai} :
+
+@example
+\set Score.skipBars = ##t
+@end example
+
+@noindent
+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 {
+  \time 2/4
+  \set Score.skipBars = ##t
+  R2*3
+  r4 f8 a cis4 f e d
+}
+@end lilypond
+
+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
+
+@example
+\include "musique-Basson.ly"
+\include "musique-Cor.ly"
+
+<<
+  \new Staff \notesCor
+  \new Staff \notesBasson
+>>
+@end example
+
+@noindent
+ce qui équivaut à
+
+@lilypond[quote,ragged-right]
+\relative c <<
+  \new Staff {
+    \time 2/4 R2*3
+    r4 f8 a cis4 f e d
+  }
+  \new Staff {
+    \clef bass
+    r4 d,8 f | gis4 c | b bes |
+    a8 e f4 | g d | gis f
+  }
+>>
+@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
+@ruser{Writing parts}.
+
+Les variables (@q{propriétés}) réglables sont abordées en détail dans
+@ruser{The set command}.