X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ffr%2Fuser%2Ftutorial.itely;h=0604b0ba4307119da5100c64c9623abc2c3fc35c;hb=6fef7b7a22004cccab9b133d7458fb100d47293a;hp=10347a002270cfda6018c3365019a2c90b83a94b;hpb=9a64973894a3080c917386d0acc85cf4f5a0e5d0;p=lilypond.git diff --git a/Documentation/fr/user/tutorial.itely b/Documentation/fr/user/tutorial.itely index 10347a0022..0604b0ba43 100644 --- a/Documentation/fr/user/tutorial.itely +++ b/Documentation/fr/user/tutorial.itely @@ -1,12 +1,14 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- @c This file is part of lilypond.tely @ignore - Translation of GIT committish: 8bf657e5c944bd8da26af01d6a021b48e74ff10a + Translation of GIT committish: 71b67137f76fa4e8aede58299630369f616004d9 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.51" + @ignore Tutorial guidelines: - unless you have a really good reason, use either @@ -34,6 +36,10 @@ Tutorial guidelines: @c Your first LilyPond score in 10 minutes? +@c Translators: Nicolas Grandclaude, Ludovic Sardain, Gauvain Pocentek +@c Translation checkers: Jean-Charles Malahieude, Valentin Villenave, John Mandereau + + @node Tutorial @chapter Tutorial @@ -60,7 +66,7 @@ Essayez sur cette image : En copiant et en collant tout le code de l'extrait ly dans un fichier test, vous aurez un modèle de base pour faire vos expériences. Si vous apprenez de cette façon, vous aurez probablement envie d'imprimer ou de -garder un lien vers l'@ref{Cheat sheet}, tableau qui répertorie les +garder un lien vers l'@ruser{Cheat sheet}, tableau qui répertorie les commandes usuelles pour une consultation rapide. @end ifhtml @@ -167,11 +173,11 @@ utilisez la commande @qq{New} du menu @qq{File}. En double-cliquant sur le fichier, vous obtiendrez, en plus du fichier PDF, un fichier @file{.log} qui récapitule les opérations que LilyPond -a effectuées sur votre fichier. Si une erreur advient, c'est ce +a effectuées sur votre fichier. Si une erreur survient, c'est ce fichier qu'il vous faudra étudier. Notez qu'il existe d'autres éditeurs de texte, certains disposant d'un -meilleur support pour LilyPond ; reportez-vous à @ref{Editor support}. +meilleur support pour LilyPond ; reportez-vous à @rprogram{Text editor support}. @subsubheading Unix @@ -184,7 +190,7 @@ de VIM et un encore installés, consultez le fichier @file{INSTALL.txt}. L'outil d'édition le plus facile d'utilisation est de loin @file{LilyPondTool}. Vous trouverez plus d'informations dans -@ref{Editor support}.} Dans votre +@rprogram{Text editor support}.} Dans votre éditeur, entrez le texte suivant et sauvegardez le fichier sous @file{test.ly} @@ -268,7 +274,7 @@ celle qui la précède est supposé inférieur ou égal à une La note de départ est @rglos{middle C}. Chacune des notes qui suivent est à moins d'une quarte de la note précédente --- en d'autres termes, le premier @samp{c} est le do central, entre la clé de sol et -la clé de sa, puis est suivi par le ré le plus proche, et ainsi de +la clé de fa, puis est suivi par le ré le plus proche, et ainsi de suite. On peut bien sûr créer des mélodies d'intervalles plus étendus : @lilypond[quote,ragged-right,verbatim] @@ -324,7 +330,7 @@ Si aucune durée n'est indiquée, la dernière durée entrée sera utilisée pour les notes suivantes. En l'absence d'indication, la première note est une noire. -Les @rglos{dotted notes} s'obtiennent en ajoutant un point @samp{.} à +Une @rglos{dotted note} s'obtient en ajoutant un point @samp{.} à la valeur rythmique. @lilypond[quote,ragged-right,verbatim] @@ -350,7 +356,7 @@ caractère @samp{r}. @subheading Time signature -Le @rglos{time signature} peut être défini à l'aide de la commande +La @rglos{time signature} peut être définie à l'aide de la commande @code{\time} : @lilypond[quote,ragged-right,verbatim] @@ -396,17 +402,17 @@ Voici un bref exemple qui montre tous ces éléments ensemble : } @end lilypond -@moreinfo +@seealso @quotation @table @asis @item Entrer des hauteurs et des durées -voir @ref{Pitches} and @ref{Durations}. +voir @ruser{Pitches} and @ruser{Durations}. @item Les silences -voir @ref{Rests}. +voir @ruser{Rests}. @item Les chiffres de mesure et autres commandes de métrique -voir @ref{Time signature}. +voir @ruser{Time signature}. @item Les clés -voir @ref{Clef}. +voir @ruser{Clef}. @end table @end quotation @@ -414,11 +420,11 @@ voir @ref{Clef}. @node Working on text files @subsection Working on text files -Les fichiers d'entrée de LilyPond sont de la même veine que les -sources dans la plupart des autres langages de programmation : la -casse est prise en compte mais pas les -espaces vides ; les expressions sont délimitées par des -accolades @{ @}, et les commentaires par @code{%} ou @code{%@{ ... %@}}. +Le traitement des fichiers source de LilyPond est semblable à celui du +code de nombreux langages de programmation répandus : la casse est prise +en compte, et les caractères considérés comme espaces ont généralement +peu d'importance. Les expressions sont délimitées par des accolades @{ +@}, et les commentaires par @code{%} ou @code{%@{ ... %@}}. Si cette phrase vous paraît incompréhensible, ne vous en faites pas ! Tous ces termes vont être expliqués : @@ -453,7 +459,7 @@ soit des doubles espaces : @} @end example -@item @strong{Expressions musicales :} +@item @strong{Expressions musicales} : Tout morceau saisi dans LilyPond doit être placé entre @strong{@{ accolades @}}. Ces caractères indiquent à LilyPond que ce bloc de texte est une et une seule expression musicale, tout comme les @@ -553,7 +559,7 @@ hauteur de chaque note en fonction de la précédente@footnote{Il existe un autre mode de saisie des hauteurs, le mode @ref{Absolute note names}, mais en pratique il est bien plus aisé et sûr d'avoir recours au mode de hauteurs relatives.}. Si aucune indication supplémentaire -d'octaviation n'est ajoutée, il en conlcuera que chaque hauteur est +d'octaviation n'est ajoutée, il en concluera que chaque hauteur est située à une quarte au plus de la note précédente. Lilypond tient compte des intervalles induits par les noms des notes @@ -567,13 +573,13 @@ c2 fis c2 ges @end lilypond -@moreinfo +@seealso @quotation @table @asis @item Les hauteurs de note relatives -voir @ref{Relative octaves}. +voir @ruser{Relative octaves}. @item Les vérifications d'octaves -voir @ref{Octave check}. +voir @ruser{Octave check}. @end table @end quotation @@ -600,7 +606,7 @@ bémol. Le double dièse et le double bémol s'obtiennent en ajoutant respectivement @samp{dd} et @samp{bb} @c END DIV -Pour en savoir plus sur les autres langues disponibles, voir @ref{Note +Pour en savoir plus sur les autres langues disponibles, voir @ruser{Note names in other languages}. @lilypond[quote,ragged-right,verbatim,fragment,relative=2] @@ -652,15 +658,13 @@ d cis fis @end lilypond @noindent -Aucune note n'a ici d'altération accidentelle, et pourtant vous devrez +aucune note n'a d'altération accidentelle, et pourtant vous devrez entrer le @samp{is} pour les notes @code{cis} et @code{fis}. -Le code @samp{d} ne veut pas dire @qq{Imprimez-moi un point noir juste -en-dessous de la portée.} Cela signifie plutôt : @qq{Ici se trouve -une note dont la -hauteur est un ré naturel.} Avec l'armure de la bémol majeur, ce ré -sera flanqué -d'un bécarre accidentel : +Le code @samp{e} ne veut pas dire @qq{Imprimez-moi un point noir sur +la première ligne de la portée.} Cela signifie plutôt : @qq{Ici se +trouve une note dont la hauteur est un mi naturel.} Avec l'armure de +la bémol majeur, ce mi sera flanqué d'un bécarre accidentel : @lilypond[quote,ragged-right,verbatim,fragment,relative=2] \key aes \major @@ -669,20 +673,19 @@ e Ajouter explicitement toutes les altérations requiert un peu plus d'effort dans la phase de saisie, mais la transposition en sera -grandement facilitée. -De plus les altérations accidentelles -peuvent être imprimées suivant plusieurs conventions. Regardez -@ref{Automatic accidentals} pour connaître les différentes manières dont les -altérations accidentelles peuvent être imprimées, suivant les règles -que vous choisirez. - -@moreinfo +grandement facilitée. De plus les altérations accidentelles peuvent +être imprimées suivant plusieurs conventions. Regardez +@ruser{Automatic accidentals} pour connaître les différentes manières +dont les altérations accidentelles peuvent être imprimées, suivant les +règles que vous choisirez. + +@seealso @quotation @table @asis @item Les altérations -voir @ref{Accidentals} and @ref{Automatic accidentals}. +voir @ruser{Accidentals} and @ruser{Automatic accidentals}. @item Les armures -voir @ref{Key signature}. +voir @ruser{Key signature}. @end table @end quotation @@ -708,7 +711,7 @@ c4 ~ c8 a8 ~ a2 @c car c'est celui qui me semble le plus couramment employé. Une @rglos{slur} d'articulation (ou @qq{legato}) peut englober -plusieurs notes. La note de départ et d'arrivée reçoivent +plusieurs notes. Les notes de départ et d'arrivée reçoivent respectivement un signe @samp{(} et @samp{)}. @lilypond[quote,ragged-right,verbatim,fragment,relative=2] @@ -741,12 +744,12 @@ liaisons de tenue peuvent être enchâssées dans un legato ou un phrasé. c2~( c8 fis fis4 ~ fis2 g2) @end lilypond -@moreinfo +@seealso @quotation @table @asis -@item @ref{Ties}, -@item @ref{Slurs}, -@item @ref{Phrasing slurs}. +@item @ruser{Ties}, +@item @ruser{Slurs}, +@item @ruser{Phrasing slurs}. @end table @end quotation @@ -759,7 +762,7 @@ c2~( c8 fis fis4 ~ fis2 g2) @cindex staccato @subheading Articulations -Des @rglos{articulations} peuvent être ajoutées à une note, au moyen +Des @rglos{articulation}s peuvent être ajoutées à une note, au moyen d'un tiret @samp{-} suivi d'un caractère : @lilypond[quote,ragged-right,verbatim,fragment,relative=2] @@ -809,12 +812,12 @@ Crescendos et decrescendos débutent avec les commandes @code{\<} et c2\< c2\ff\> c2 c2\! @end lilypond -@moreinfo +@seealso @quotation @table @asis -@item @ref{Articulations}. -@item @ref{Fingering instructions}. -@item @ref{Dynamics}. +@item @ruser{Articulations}. +@item @ruser{Fingering instructions}. +@item @ruser{Dynamics}. @end table @end quotation @@ -823,7 +826,7 @@ c2\< c2\ff\> c2 c2\! @subsection Automatic and manual beams @cindex ligatures manuelles -Toutes les @rglos{beam}s sont dessinées automatiquement : +Toutes les @rglos{beam} sont dessinées automatiquement : @lilypond[quote,ragged-right,verbatim,fragment,relative=2] a8 ais d ees r d c16 b a8 @@ -831,20 +834,20 @@ a8 ais d ees r d c16 b a8 @noindent Lorsqu'on n'aime pas la manière dont les notes sont automatiquement -groupées, il est possible de les entrer à la main, en marquant la +groupées, il est possible de les ligaturer manuellement, en marquant la première note à attacher d'un @samp{[} et la dernière d'un @samp{]}. @lilypond[quote,ragged-right,verbatim,fragment,relative=2] a8[ ais] d[ ees r d] a b @end lilypond -@moreinfo +@seealso @quotation @table @asis @item Groupements de notes et ligatures automatiques -voir @ref{Automatic beams}. +voir @ruser{Automatic beams}. @item Groupements et ligatures manuels -voir @ref{Manual beams}. +voir @ruser{Manual beams}. @end table @end quotation @@ -897,15 +900,15 @@ c2 \appoggiatura b16 c2 c2 \acciaccatura b16 c2 @end lilypond -@moreinfo +@seealso @quotation @table @asis @item Notes d'ornement -voir @ref{Grace notes}, +voir @ruser{Grace notes}, @item nolets -voir @ref{Tuplets}, +voir @ruser{Tuplets}, @item levées -voir @ref{Partial measures}. +voir @ruser{Upbeats}. @end table @end quotation @@ -925,8 +928,8 @@ situations où il y a plus d'une voix sur une même portée. * Music expressions explained:: * Multiple staves:: * Piano staves:: -* Single staff polyphony:: * Combining notes into chords:: +* Single staff polyphony:: @end menu @@ -1077,10 +1080,10 @@ comparaison, cela ressemble au signe @qq{moins} en mathématiques. La formule @math{(4+5)} est une expression, donc @math{-(4+5)} est une plus grosse expression. -Les chiffres de mesure figurant sur une portée affectent toutes les -autres portées ; en revanche l'armure d'une portée n'affectera -@emph{pas} les autres portées.@footnote{Ce comportement peut être -modifié si nécessaire : voir pour cela @ref{Changing defaults}.}. +Les chiffres de métrique indiqués sur une portée affectent toutes les +autres portées@footnote{Ce comportement peut être modifié si nécessaire, +voir @ruser{Polymetric notation}.}. En revanche l'armure d'une portée +n'affecte @emph{pas} les autres portées. @lilypond[quote,ragged-right,verbatim] \relative c'' { @@ -1122,12 +1125,36 @@ Voici un bref exemple : } @end lilypond -@moreinfo +@seealso @quotation -Voir @ref{Piano music}. +Voir @ruser{Keyboard instruments}. @end quotation +@node Combining notes into chords +@subsection Combining notes into chords + +@cindex accords +Des accords peuvent être produits en entourant les hauteurs de notes +par des angles gauche et droit --- @samp{<} et @samp{>} --- + +@lilypond[quote,fragment,verbatim,relative=2,fragment] +r4 4 2 +@end lilypond + +Vous pouvez combiner les indications comme les liaisons et les ligatures +de croches avec les accords. Ils doivent cependant être placés en +dehors des angles : + +@lilypond[quote,fragment,verbatim,relative=2,fragment] +r4 8[ ]~ 2 +@end lilypond + +@lilypond[quote,fragment,verbatim,relative=2,fragment] +r4 8\>( 4 \!) +@end lilypond + + @node Single staff polyphony @subsection Single staff polyphony @@ -1181,36 +1208,12 @@ Là encore, ces expressions peuvent s'imbriquer arbitrairement : >> @end lilypond -@moreinfo +@seealso @quotation -Voir @ref{Basic polyphony}. +Voir @ruser{Basic polyphony}. @end quotation -@node Combining notes into chords -@subsection Combining notes into chords - -@cindex accords -Des accords peuvent être produits en entourant les hauteurs de notes -par des angles gauche et droit --- @samp{<} et @samp{>} --- - -@lilypond[quote,fragment,verbatim,relative=2,fragment] -r4 4 2 -@end lilypond - -Vous pouvez combiner les indications comme les liaisons et les ligatures -de croches avec les accords. Ils doivent cependant être placés en -dehors des angles : - -@lilypond[quote,fragment,verbatim,relative=2,fragment] -r4 8[ ]~ 2 -@end lilypond - -@lilypond[quote,fragment,verbatim,relative=2,fragment] -r4 8\>( 4 \!) -@end lilypond - - @node Songs @section Songs @@ -1282,10 +1285,10 @@ entre les deux syllabes : >> @end lilypond -@moreinfo +@seealso @quotation Plus de possibilités, comme celle d'ajouter plusieurs lignes de paroles -en dessous d'une même mélodie sont exposées dans @ref{Vocal music}. +en dessous d'une même mélodie sont exposées dans @ruser{Vocal music}. @end quotation @@ -1306,7 +1309,7 @@ nom des accords. De tels accords peuvent être entrés comme les notes : Maintenant, chaque hauteur est lue comme la base de l'accord à la place de la note. Ce mode est activé avec @code{\chordmode}. D'autres -accords peuvent être créés en ajoutant des modifiacteurs après deux +accords peuvent être créés en ajoutant des modificateurs après deux points. L'exemple suivant montre quelques modificateurs usuels : @lilypond[quote,verbatim,ragged-right] @@ -1317,7 +1320,7 @@ Pour la musique improvisée, les accords ne sont pas imprimés sur des portées mais comme des lignes à part entière. Ceci s'obtient en utilisant @code{\chords} à la place de @code{\chordmode}. La même syntaxe sera utilisée que dans le cas de@code{\chordmode}, mais le rendu -des notes interviendra dans un contexte de @code{ChordNames}, avec le +des notes interviendra dans un contexte @code{ChordNames}, avec le résultat suivant : @lilypond[quote,verbatim,ragged-right] @@ -1341,17 +1344,17 @@ partition de chanson : @end lilypond -@moreinfo +@seealso @quotation Une liste complète de modificateurs et d'autres options de mise en forme -se trouve à la section @ref{Chords}. +se trouve à la section @ruser{Chord notation}. @end quotation @node Final touches @section Final touches -L'ultime section de ce tutoriel montre comment ajouter la touche finale +L'ultime section de ce tutoriel montre comment ajouter une touche finale à des morceaux simples, et consititue une introduction au reste du manuel. @@ -1370,19 +1373,18 @@ manuel. @cindex versions La déclaration @code{\version} stipule le numéro de la version de -LilyPond pour laquelle le fichier a été écrit. Pour donner à un fichier -la version 2.11.20, ajoutez +LilyPond pour laquelle le fichier a été écrit, @example -\version "2.11.20" +\version @w{"@version{}"} @end example @noindent -tout en haut de votre fichier LilyPond. +que l'on place par convention en début de fichier. Cette annotation permet de faciliter les prochaines mises à jour de LilyPond. Les changements dans la syntaxe sont gérés avec un programme -spécial, @file{convert-ly} --- voir @ref{Updating files with convert-ly} +spécial, @file{convert-ly} --- voir @rprogram{Updating files with convert-ly} --- et il utilise @code{\version} pour déterminer les règles de conversion à appliquer au fichier. @@ -1396,7 +1398,7 @@ qui existe indépendamment des expressions musicales principales. Le bloc @code{\header} est habituellement placé en début de fichier. @example -\version "2.11.20" +\version "2.11.51" \header @{ title = "Symphonie" composer = "Moi" @@ -1409,7 +1411,7 @@ bloc @code{\header} est habituellement placé en début de fichier. @end example Quand le fichier est traité, le titre et le compositeur sont imprimés en haut de la partition. Vous trouverez plus d'informations sur les titres -à @ref{Creating titles}. +à @ruser{Creating titles}. @node Absolute note names @subsection Absolute note names @@ -1417,7 +1419,7 @@ haut de la partition. Vous trouverez plus d'informations sur les titres Jusqu'ici nous n'avons utilisé que le mode @code{\relative} pour définir les hauteurs de notes. Si c'est effectivement le moyen le plus simple d'entrer la majeure partie de votre musique, il existe une autre façon -de procéder : le mode de hauteurs absolues. +de procéder : le mode des hauteurs absolues. Si vous omettez la commande @code{\relative}, LilyPond considérera toutes les hauteurs comme des hauteurs absolues. Un @code{c'} sera @@ -1478,7 +1480,7 @@ bien plus facile à lire : Si d'aventure vous faites une erreur d'octaviation, le mode @code{\relative} la rendra frappante --- toutes les notes suivantes seront placées à la mauvaise octave. En mode de hauteurs absolues, une -erreur isolée ne serait pas aussi visible, et donc aussi facile à +erreur isolée ne serait pas auntant visible, et donc aussi facile à dénicher. Cependant, le mode de hauteurs absolues reste utile pour les musiques où @@ -1558,7 +1560,7 @@ Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire un morceau ou deux. Commencez par copier l'un des @ref{Templates} types et ajoutez-y des notes. Si vous voulez employer une notation que vous n'avez pas trouvé dans le tutoriel, consultez la référence de notation, -en commençant par la @ref{Basic notation}. Si vous désirez écrire pour +en commençant par la @ruser{Musical notation}. Si vous désirez écrire pour un ensemble instrumental non couvert par les @ref{Templates}, lisez la section @ref{Extending the templates}. @@ -1590,3 +1592,6 @@ produit précisément tel ou tel exemple, consultez la version HTML de ce manuel si ce n'est pas déjà le cas, et cliquez sur l'image de la partition. La source exacte utilisée pour générer ce manuel s'affichera alors. + +Pour en savoir plus sur l'organisation de la suite de ce manuel, +reportez-vous à @ref{About the documentation}.