X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ffr%2Fuser%2Ftutorial.itely;h=3dc0e6695852fc93944945e2983a02c92e2b4235;hb=0676de388a138fa0260d614d5afeeb94e25fb5b9;hp=7b9d9c443a23ea8508db00589fb05db555170bd4;hpb=ce5cfa4a4b6e94655d12e3f1a1719bde789d2127;p=lilypond.git diff --git a/Documentation/fr/user/tutorial.itely b/Documentation/fr/user/tutorial.itely index 7b9d9c443a..3dc0e66958 100644 --- a/Documentation/fr/user/tutorial.itely +++ b/Documentation/fr/user/tutorial.itely @@ -1,12 +1,14 @@ -@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: a9d6b9a317e20cff479f9e0e54320dfae40bde31 + 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.38" + @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 @@ -50,18 +56,18 @@ verrez exactement le code LilyPond utilisé pour générer cette image. Essayez sur cette image : @c no verbatim here +@c KEEP LY @lilypond[quote,ragged-right] \relative c'' { - c-\markup { \bold \huge { Click here. } } + c-\markup { \bold \huge { Cliquez ici. } } } @end lilypond -En copiant et en collant tout le code @qq{ly snippet} 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 la -@ref{Cheat sheet}, tableau qui répertorie les commandes usuelles -pour une consultation rapide. +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'@ruser{Cheat sheet}, tableau qui répertorie les +commandes usuelles pour une consultation rapide. @end ifhtml @menu @@ -121,7 +127,7 @@ est préférable d'entourer les accolades par des espaces ou retours à la ligne. Bien que certains exemples de ce manuel ne comportent pas d'accolades, ne les oubliez pas dans vos partitions ! -@cindex Case sensitive +@cindex casse, prise en compte de De plus, LilyPond est sensible à la casse. @code{ @{ c d e @} } est un code valide ; @code{ @{ C D E @} } produira un message d'erreur. @@ -134,7 +140,7 @@ comment voir ou imprimer le résultat de LilyPond. @subsubheading MacOS X -Si vous double-cliquez sur LilyPond.app, un fichier d'exemple +Si vous double-cliquez sur @code{LilyPond.app}, un fichier d'exemple s'ouvrira. Sauvegardez-le, par exemple, sous @file{test.ly} sur votre bureau, et traitez-le ensuite avec la commande du menu @samp{Compile > Typeset File}. Le fichier PDF résultant sera alors affiché sur votre @@ -143,45 +149,36 @@ Typeset File}. Le fichier PDF résultant sera alors affiché sur votre Notez que le premier démarrage peut prendre une minute ou deux, car toutes les polices système doivent être d'abord analysées. -À l'avenir, vous aurez certainement recours aux commandes @qq{ Nouveau -} ou @qq{ Ouvrir }. Vous devez enregistrer votre fichier avant de -lancer la création de la partition. Si une erreur advient pendant le -traitement, vous la trouverez dans la fenêtre @qq{ log }. +À l'avenir, vous aurez certainement recours aux commandes @qq{Nouveau} +ou @qq{Ouvrir}. Vous devez enregistrer votre fichier avant de lancer +la création de la partition. Si une erreur advient pendant le +traitement, vous la trouverez dans la fenêtre @qq{log}. @subsubheading Windows -Sous Windows, démarrez un éditeur de texte @footnote{N'importe quel -éditeur simple ou orienté programmation, qui prend en charge le codage -de caractères UTF-8, fera l'affaire, par exemple le Bloc-notes. N'utilisez -pas de traitement de texte car ceux-ci insèrent des codes de formatage -qui posent problème à LilyPond.} et saisissez - -@verbatim -{ - c' e' g' e' -} -@end verbatim - -Enregistrez-le sur le bureau sous @file{test.ly} et vérifiez bien -qu'il ne s'appelle pas @file{test.ly.TXT}. Double-cliquez sur le -fichier @file{test.ly} pour le traiter et afficher le fichier -PDF résultant. Pour modifier un fichier @file{.ly} existant, faites -un clic droit dessus et sélectionnez @qq{Éditer la source}. - -Si vous double-cliquez sur l'icône LilyPond sur le Bureau, un fichier -d'exemple s'ouvrira dans un simple éditeur de texte. Enregistrez-le, -par exemple en tant que @file{test.ly} sur votre Bureau, puis -double-cliquez dessus pour le traiter. Après quelques secondes, vous -obtiendrez un fichier @file{test.pdf} sur votre Bureau, fichier que -vous pourrez ouvrir pour voir la partition imprimée. Une autre -méthode pour lancer le traitement du fichier @file{test.ly} est de le -glisser avec votre souris sur l'icône de LilyPond. +Sous Windows, lorsque vous double-cliquez sur l'icône LilyPond qui se +trouve sur le Bureau, un fichier d'exemple s'ouvre dans un simple +éditeur de texte. Enregistrez-le, par exemple en tant que +@file{test.ly} sur votre Bureau, puis double-cliquez sur son icône +(qui montre une note de musique) pour le traiter. Après quelques +secondes, vous obtiendrez un fichier @file{test.pdf} sur votre Bureau, +fichier que vous pourrez ouvrir pour voir la partition imprimée. Une +autre méthode pour lancer le traitement du fichier @file{test.ly} est +de le glisser avec votre souris sur l'icône de LilyPond. + +Pour modifier un fichier @file{.ly} existant, faites un clic droit +dessus et sélectionnez @qq{Éditer la source}. Pour partir d'un +fichier vide, lancez l'éditeur en ouvrant un fichier existant et +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 à @rprogram{Text editor support}. + @subsubheading Unix @@ -193,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} @@ -229,8 +226,8 @@ Converting to `test.pdf'... Suivant votre installation, ces messages peuvent être traduits. @c END DIV -@cindex PDF file -@cindex Viewing music +@cindex fichier PDF +@cindex visionnage de la musique @noindent De tout cela résulte un fichier @file{test.pdf}, que vous pouvez imprimer @@ -265,7 +262,7 @@ Le moyen le plus simple d'entrer des notes est d'utiliser le mode @code{\relative}. Avec ce mode, l'@rglos{interval} entre la note et celle qui la précède est supposé inférieur ou égal à une @rglos{fourth}. Commençons par entrer la partition la plus -élémentaire qui soit, une (@rglos{scale}). +élémentaire qui soit, une @rglos{scale}. @lilypond[quote,ragged-right,verbatim] \relative c' { @@ -275,11 +272,10 @@ celle qui la précède est supposé inférieur ou égal à une @end lilypond 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 dit "du milieu", entre la clé de Sol et -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 -: +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 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] \relative c' { @@ -290,7 +286,7 @@ suite. On peut bien sûr créer des mélodies d'intervalles plus étendus @noindent Comme vous l'aurez remarqué, cet exemple ne commence plus sur le do du -milieu. La première note -- le @samp{d} -- est le ré qui en est le +milieu. La première note --- le @samp{d} --- est le ré qui en est le plus proche. Pour ajouter des intervalles supérieurs à une quarte, il suffit @@ -306,10 +302,10 @@ ajoutant respectivement une apostrophe @code{'} ou une virgule @end lilypond @noindent -Pour envoyer une note deux octaves (ou davantage !) plus haut ou plus -bas, il suffit de mettre plusieurs @code{''} ou plusieurs @code{,,} -- +Pour déplacer une note deux octaves (ou davantage !) plus haut ou plus +bas, il suffit de mettre plusieurs @code{''} ou plusieurs @code{,,} --- attention cependant à bien mettre deux apostrophes @code{''}, et non -deux guillemets @code{"}@tie{}! C'est de cette même manière que l'on +un guillemet @code{"}@tie{}! C'est de cette même manière que l'on peut modifier la valeur de départ de @code{\relative c'}. @@ -334,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] @@ -347,7 +343,7 @@ la valeur rythmique. @subheading Rests -On saisit un (@rglos{rest}) tout comme une note, mais avec le +On saisit un @rglos{rest} tout comme une note, mais avec le caractère @samp{r}. @lilypond[quote,ragged-right,verbatim] @@ -360,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] @@ -406,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 @@ -424,29 +420,29 @@ voir @ref{Clef}. @node Working on text files @subsection Working on text files -Les fichiers d'entrée de LilyPond sont traités comme la plupart des -langages de programmation : la casse est prise en compte mais pas les -espaces vides, les expressions musicales sont délimitées par des -accolades @{ @}, et les commentaires par des @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 : @itemize -@cindex Case sensitive +@cindex casse, prise en compte de @item @strong{La casse} : -LilyPond est sensible à la casse, c'est à dire qu'une lettre en -capitales n'a pas la même valeur qu'une lettre en minuscules. Les -notes, par exemple, doivent être entrées en minuscules : @code{ @{ c -d e @} } est -un code valide, alors que @code{ @{ C D E @} } produira un message d'erreur. +LilyPond est sensible à la casse, c'est à dire qu'une lettre capitale +n'a pas la même valeur qu'une lettre minuscule. Les notes, par +exemple, doivent être entrées en minuscules : @code{@{ c d e @}} est +un code valide, alors que @code{@{ C D E @}} produira un message +d'erreur. @item @strong{Les espaces multiples} : LilyPond ne tient pas compte du nombre d'espaces, ou de retours à la -ligne. @code{ @{ c d e @}} a le même sens que @code{ @{ c @ @ @ @ @ -d e @} } ou que +ligne. @code{@{ c d e @}} a le +même sens que @code{@{ c @tie{} @tie{} d @tie{} e @}} ou que @example @{ c d @@ -463,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 @@ -471,12 +467,12 @@ parenthèses @samp{()} en mathématiques. Il est préférable, pour éviter toute ambiguïté, d'entourer tous ces crochets d'espaces, à moins qu'ils se trouvent au début ou à la fin d'une ligne. -Une fonction telle que @code{\relative @{ @}} ) compte également comme -une seule expression musicale. +Une fonction --- @code{\relative @{ @}} par exemple --- compte +également comme une seule expression musicale. -@cindex comments -@cindex line comment -@cindex block comment +@cindex commentaires +@cindex commentaire de fin de ligne +@cindex commentaire-bloc @item @strong{Les commentaires} : Un commentaire est une indication pour tout lecteur humain d'un fichier de musique ; il est ignoré par l'ordinateur, et n'a donc aucun @@ -487,7 +483,7 @@ commentaires : tout ce qui suit ce symbole sur cette ligne sera ignoré. @item le bloc de commentaire, qui peut être de plusieurs lignes voire de toute une section : tout ce qui se trouve entre @code{%@{} et -@code{%@}} est ignoré. +@code{%@}} est ignoré. Les blocs de commentaires ne peuvent s'imbriquer. @end itemize Le fragment suivant met en évidence quelques usages possibles des commentaires : @@ -563,11 +559,11 @@ 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 --- en d'autres termes,une quarte augmentée n'est @emph{pas} +--- en d'autres termes, une quarte augmentée n'est @emph{pas} équivalente à une quinte diminuée. Ainsi, si l'on part d'un Do, un Fa dièse sera placé au-dessus, tandis qu'un Sol bémol sera placé au-dessous. @@ -577,13 +573,13 @@ c2 fis c2 ges @end lilypond -@moreinfo +@seealso @quotation @table @asis -@item Les Octaves Relatives -voir @ref{Relative octaves}. +@item Les hauteurs de note relatives +voir @ruser{Relative octaves}. @item Les vérifications d'octaves -voir @ref{Octave check}. +voir @ruser{Octave check}. @end table @end quotation @@ -594,31 +590,30 @@ voir @ref{Octave check}. @subheading Accidentals -Dans la notation par défaut,un dièse (@rglos{sharp}) s'obtient en -ajoutant @samp{is} au nom de la -note, et un bémol (@rglos{flat}) en ajoutant @samp{es}. Comme vous pouvez -vous y attendre, un double dièse ou double bémol est alors obtenu en -ajoutant @samp{isis} ou @samp{eses}@footnote{Cette syntaxe est dérivée -de la convention de dénomination des notes dans les langues nordiques -et germaniques, comme l'allemand ou le hollandais.}. +Dans la notation par défaut, un @rglos{sharp} s'obtient en ajoutant +@samp{is} au nom de la note, et un @rglos{flat} en ajoutant @samp{es}. +Comme vous pouvez vous y attendre, un double dièse ou double bémol est +alors obtenu en ajoutant @samp{isis} ou @samp{eses}@footnote{Cette +syntaxe est dérivée de la convention de dénomination des notes dans +les langues nordiques et germaniques, comme l'allemand ou le +hollandais.}. @c DIV specific Cependant, si vous utilisez la commande @samp{\include "italiano.ly"} -pour entrer -les noms de notes français au lieu des noms hollandais, il faudra -ajouter un @samp{d} pour un dièse, et un @samp{b} pour un bémol. Le -double dièse et le double bémol s'obtiennent en ajoutant +pour entrer les noms de notes français au lieu des noms hollandais, il +faudra ajouter un @samp{d} pour un dièse, et un @samp{b} pour un +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 -names in other languages}.} +Pour en savoir plus sur les autres langues disponibles, voir @ruser{Note +names in other languages}. @lilypond[quote,ragged-right,verbatim,fragment,relative=2] cis1 ees fisis, aeses @end lilypond -@cindex key signature, setting +@cindex armure, définition de @subheading Key signatures L'armure est déterminée par la commande @code{\key}, suivie d'une @@ -636,25 +631,24 @@ a @subheading Warning: key signatures and pitches La combinaison de l'armure et des hauteurs de note --- y compris les -altérations --- permet à LilyPond de déterminer dans quel cas afficher les -altérations accidentelles. L'armure n'affecte que les altérations +altérations --- permet à LilyPond de déterminer dans quel cas afficher +les altérations accidentelles. L'armure n'affecte que les altérations @emph{imprimées}, et non les hauteurs réelles ! Cette fonctionnalité -est souvent source de -confusion pour les nouveaux utilisateurs, aussi expliquons-la en -détail. +est souvent source de confusion pour les nouveaux utilisateurs, aussi +expliquons-la en détail. LilyPond fait une nette distinction entre le contenu musical et la -mise en forme. L'altération d'une note -- bémol, bécarre ou dièse -- -fait partie de sa hauteur, et relève donc du contenu musical. La -présence ou non -d'une altération accidentelle -- un @emph{signe} bémol, bécarre ou -dièse -- devant la note correspondante est une question qui relève de la mise en -page. Mettre en page une partition se fait selon des règles ; les -altérations accidentelles seront donc automatiquement imprimées suivant -ces règles. Les hauteurs de note, en revanche, relèvent de ce que -vous voulez entendre ; et, dans la mesure où la musique que vous -entrez est censée être celle que vous voulez entendre, LilyPond (qui -n'est chargé que de la gravure) ne les choisira pas à votre place. +mise en forme. L'altération d'une note --- bémol, bécarre ou dièse +--- fait partie de sa hauteur, et relève donc du contenu musical. La +présence ou non d'une altération accidentelle --- un @emph{signe} +bémol, bécarre ou dièse --- devant la note correspondante est une +question qui relève de la mise en page. Mettre en page une partition +se fait selon des règles ; les altérations accidentelles seront donc +automatiquement imprimées suivant ces règles. Les hauteurs de note, +en revanche, relèvent de ce que vous voulez entendre ; et, dans la +mesure où la musique que vous entrez est censée être celle que vous +voulez entendre, LilyPond (qui n'est chargé que de la gravure) ne les +choisira pas à votre place. Dans cet exemple, @@ -664,7 +658,7 @@ 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 @@ -684,17 +678,17 @@ 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 +@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. -@moreinfo +@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 @@ -702,7 +696,7 @@ voir @ref{Key signature}. @node Ties and slurs @subsection Ties and slurs -@cindex ties +@cindex liaisons de prolongation @subheading Ties Une @rglos{tie}@footnote{parfois aussi appelée liaison de tenue} se crée en ajoutant un tilde @samp{~} à la première note liée. @@ -712,7 +706,7 @@ g4~ g c2~ c4 ~ c8 a8 ~ a2 @end lilypond -@cindex slurs +@cindex liaisons d'articulation @subheading Slurs @c Le terme de "slur" a deux sens en français : articulation et phrasé. @@ -720,18 +714,16 @@ 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] d4( c16) cis( d e c cis d) e( d4) @end lilypond -@cindex slurs, phrasing -@cindex phrasing slurs +@cindex liaisons de phrasé @subheading Phrasing slurs -@cindex phrasing slurs De plus longues liaisons, dites de phrasé, sont délimitées par @code{\(} et @code{\)}. Il est possible d'avoir en même temps des legatos et des phrasés, mais pas plusieurs liaisons de phrasé ou de legato à la fois. @@ -742,8 +734,8 @@ a8(\( ais b c) cis2 b'2 a4 cis,\) @sp 1 -@cindex slurs versus ties -@subheading Warnings: slurs vs. ties +@cindex liaisons de phrasé et de prolongation, différences +@subheading Warnings: slurs vs. ties Une liaison d'articulation ou de phrasé ressemble à une liaison de tenue, mais n'a pas la même signification. Alors qu'une liaison de @@ -755,15 +747,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 Liaisons de prolongation -voir @ref{Ties}. -@item Legato -voir @ref{Slurs}. -@item Liaisons de phrasé -voir @ref{Phrasing slurs}. +@item @ruser{Ties}, +@item @ruser{Slurs}, +@item @ruser{Phrasing slurs}. @end table @end quotation @@ -776,14 +765,14 @@ voir @ref{Phrasing slurs}. @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] c-. c-- c-> c-^ c-+ c-_ @end lilypond -@cindex fingering +@cindex doigtés @subheading Fingerings De même, des indications de doigté peuvent être ajoutées à une note en utilisant un tiret (@samp{-}) et le chiffre à écrire : @@ -794,9 +783,10 @@ c-3 e-5 b-2 a-1 Articulations et doigtés sont habituellement placés automatiquement, mais vous pouvez spécifier une direction en utilisant @samp{^} (en haut) -ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs articulations -sur la même note. Dans la plupart des cas, cependant, il est mieux de -laisser LilyPond déterminer l'emplacement de l'articulation. +ou @samp{_} (en bas). Vous pouvez aussi utiliser plusieurs +articulations sur la même note. Dans la plupart des cas, cependant, il +est mieux de laisser LilyPond déterminer l'emplacement de +l'articulation. @lilypond[quote,ragged-right,verbatim,fragment,relative=2] c_-^1 d^. f^4_2-> e^-_+ @@ -810,7 +800,7 @@ précédées d'un anti-slash @samp{\} : c\ff c\mf c\p c\pp @end lilypond -@cindex dynamics +@cindex nuances @cindex decrescendo @cindex crescendo @@ -818,23 +808,19 @@ c\ff c\mf c\p c\pp @c selon Littré, plutôt à la française (en "-os" qu'en "-i") Crescendos et decrescendos débutent avec les commandes @code{\<} et -@code{\>}. Ils se terminent soit par une nuance d'arrivée, par -exemple @code{\f}, -soit par la commande @code{\!} : +@code{\>}. Ils se terminent soit par une nuance d'arrivée, par exemple +@code{\f}, soit par la commande @code{\!} : @lilypond[quote,ragged-right,verbatim,fragment,relative=2] c2\< c2\ff\> c2 c2\! @end lilypond -@moreinfo +@seealso @quotation @table @asis -@item Ponctuations -voir @ref{Articulations}. -@item Doigtés -voir @ref{Fingering instructions}. -@item Nuances -voir @ref{Dynamics}. +@item @ruser{Articulations}. +@item @ruser{Fingering instructions}. +@item @ruser{Dynamics}. @end table @end quotation @@ -842,8 +828,8 @@ voir @ref{Dynamics}. @node Automatic and manual beams @subsection Automatic and manual beams -@cindex beams, by hand -Toutes les @rglos{beam}s sont dessinées automatiquement : +@cindex ligatures manuelles +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 @@ -851,20 +837,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 @@ -872,28 +858,27 @@ voir @ref{Manual beams}. @node Advanced rhythmic commands @subsection Advanced rhythmic commands -@cindex pickup -@cindex anacruse -@cindex partial measure +@cindex levée +@cindex anacrouse +@cindex mesure incomplète @subheading Partial measure Une levée (ou @rglos{anacrusis}) est entrée avec la commande @code{\partial}, suivie d'une durée : @code{\partial 4} est une levée -d'une noire et -@code{\partial 8} d'une croche. +d'une noire et @code{\partial 8} d'une croche. @lilypond[quote,ragged-right,verbatim,fragment,relative=2] \partial 8 f8 c2 d @end lilypond -@cindex tuplets -@cindex triplets +@cindex nolets +@cindex triolets @subheading Tuplets -Les nolets sont créés avec la commande @code{\times}, qui prend -deux arguments : une fraction et une expression musicale. La durée des -notes de l'expression musicale est multipliée par la fraction. Par exemple les -notes d'un triolet durent les deux tiers du temps de leur notation +Les nolets sont créés avec la commande @code{\times}, qui prend deux +arguments : une fraction et une expression musicale. La durée des notes +de l'expression musicale est multipliée par la fraction. Par exemple +les notes d'un triolet durent les deux tiers du temps de leur notation réelle, cette fraction est donc de 2/3 pour les triolets : @lilypond[quote,ragged-right,verbatim,fragment,relative=2] @@ -903,13 +888,13 @@ réelle, cette fraction est donc de 2/3 pour les triolets : \times 2/3 { d4 a8 } @end lilypond -@cindex grace notes -@cindex acciaccatura -@cindex appoggiatura +@cindex notes d'ornement +@cindex ornementation +@cindex appoggiature @subheading Grace notes -Des notes d'ornement sont produites par la commande @code{\grace}, -mais aussi en préfixant une expression musicale avec le mot-clé +Des notes d'ornement sont produites par la commande @code{\grace}, mais +aussi en préfixant une expression musicale avec le mot-clé @code{\appoggiatura} ou @code{\acciaccatura} : @lilypond[quote,ragged-right,verbatim,fragment,relative=2] @@ -918,15 +903,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 @@ -934,9 +919,9 @@ voir @ref{Partial measures}. @node Multiple notes at once @section Multiple notes at once -Cette section traite des situations où l'on a plus d'une note à la -fois : plusieurs instruments, plusieurs portées pour un même -instrument (le piano, par exemple), et les accords. +Cette section traite des situations où l'on a plus d'une note à la fois +: plusieurs instruments, plusieurs portées pour un même instrument (le +piano, par exemple), et les accords. La polyphonie, en théorie musicale, est la notion d'une musique constituée de plusieurs voix ; dans lilypond, ce terme désigne les @@ -946,18 +931,18 @@ 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 @node Music expressions explained @subsection Music expressions explained -Dans les fichiers source LilyPond, la musique est représentée par ce qu'on -appelle des @emph{expressions musicales}. En soi, une seule note peut -constituer une -expression musicale, si tant est qu'elle soit correctement encadrée : +Dans les fichiers source LilyPond, la musique est représentée par ce +qu'on appelle des @emph{expressions musicales}. En soi, une seule note +peut constituer une expression musicale, si tant est qu'elle soit +correctement encadrée : @lilypond[quote,ragged-right,verbatim,fragment,relative=2] a4 @@ -970,8 +955,8 @@ musicale : { a4 g4 } @end lilypond -Placer une séquence d'expressions musicales -- des notes par exemple --- entre accolades signifie qu'elles doivent être jouées +Placer une séquence d'expressions musicales --- des notes par exemple +--- entre accolades signifie qu'elles doivent être jouées successivement, les unes après les autres. Le résultat est une expression, qui peut elle-même être regroupée séquentiellement avec d'autres expressions. Ici, l'expression de l'exemple précédent est @@ -983,14 +968,14 @@ combinée à deux notes : @subheading Simultaneous music expressions: multiple staves -Cette technique est utile pour de la musique polyphonique. Pour -entrer une musique avec plusieurs voix ou plusieurs portées, nous -pouvons aussi combiner en parallèle les expressions. Deux voix qui doivent être +Cette technique est utile pour de la musique polyphonique. Pour entrer +une musique avec plusieurs voix ou plusieurs portées, nous pouvons aussi +combiner en parallèle les expressions. Deux voix qui doivent être jouées en même temps, sont entrées comme une combinaison simultanée de deux expressions. Une expression musicale @q{simultanée} est formée en entourant les expressions entre @code{<<} et @code{>>}. Dans l'exemple -suivant, trois expressions (contenant chacune deux notes distinctes) sont -combinées simultanément. +suivant, trois expressions (contenant chacune deux notes distinctes) +sont combinées simultanément. @lilypond[quote,ragged-right,verbatim] \relative c'' { @@ -1002,10 +987,10 @@ combinées simultanément. } @end lilypond -Notez que nous avons ici indenté chaque niveau du fichier d'entrée -avec un nombre d'espaces différent. LilyPond se moque de l'espace -qu'il peut y avoir (ou pas) au début d'une ligne, mais en indentant -votre code vous le rendrez bien plus facile à lire pour les humains. +Notez que nous avons ici indenté chaque niveau du fichier d'entrée avec +un nombre d'espaces différent. LilyPond se moque de l'espace qu'il peut +y avoir (ou pas) au début d'une ligne, mais en indentant votre code vous +le rendrez bien plus facile à lire pour les humains. @strong{Attention} : chaque note saisie est relative à la précédente, mais pas au @code{c''} de la commande @code{\relative} de départ. @@ -1026,7 +1011,7 @@ portée. @end lilypond @cindex expression -@cindex music expression +@cindex expression musicale @subheading Analogy: mathematical expressions Ce mécanisme est similaire au formules mathématiques : une grosse @@ -1046,28 +1031,28 @@ longues et complexes. Par exemple, @end example Ceci est une suite d'expressions, où chacune est contenue dans la -suivante. Les expressions les plus simples sont les nombres, et de -plus grandes expressions sont produites en combinant des expressions -avec des opérateurs -- comme @samp{+}, @samp{*} et @samp{/} -- et des +suivante. Les expressions les plus simples sont les nombres, et de plus +grandes expressions sont produites en combinant des expressions avec des +opérateurs --- comme @samp{+}, @samp{*} et @samp{/} --- et des parenthèses. Tout comme les expressions mathématiques, les expressions -musicales peuvent être imbriquées avec une profondeur arbitraire, ce -qui est nécessaire pour de la musique complexe comme des partitions +musicales peuvent être imbriquées avec une profondeur arbitraire, ce qui +est nécessaire pour de la musique complexe comme des partitions polyphoniques. @node Multiple staves @subsection Multiple staves -Comme nous l'avons vu dans @ref{Music expressions explained}, un -fichier d'entrée LilyPond est fait d'expressions musicales. Si la -partition commence par plusieurs expressions simultanées, LilyPond -créera plusieurs portées. Cependant, il est plus facile de voir ce -qu'il advient si l'on crée explicitement chacune des portées. +Comme nous l'avons vu dans @ref{Music expressions explained}, un fichier +d'entrée LilyPond est fait d'expressions musicales. Si la partition +commence par plusieurs expressions simultanées, LilyPond créera +plusieurs portées. Cependant, il est plus facile de voir ce qu'il +advient si l'on crée explicitement chacune des portées. Pour créer plus d'une portée, chaque partie de la musique constituant -une portée est entrée en la faisant précéder de @code{\new Staff}. -Ces éléments @code{Staff} sont ensuite combinés en parallèle avec - @code{<<} et @code{>>}, comme ceci : +une portée est entrée en la faisant précéder de @code{\new Staff}. Ces +éléments @code{Staff} sont ensuite combinés en parallèle avec @code{<<} +et @code{>>}, comme ceci : @lilypond[quote,ragged-right,verbatim] \relative c'' { @@ -1079,13 +1064,13 @@ Ces éléments @code{Staff} sont ensuite combinés en parallèle avec @end lilypond -La commande @code{\new} introduit un « contexte de notation ». Un +La commande @code{\new} introduit un @qq{contexte de notation}. Un contexte de notation est un environnement dans lequel les événements -musicaux -- comme les notes ou les commandes @code{\clef} -- sont -interprétés. Pour des pièces simples, ces contextes sont créés +musicaux --- comme les notes ou les commandes @code{\clef} --- sont +interprétés. Pour des pièces simples, ces contextes sont créés automatiquement. Pour des pièces plus complexes, il est préférable de -spécifier explicitement les contextes. Cela assure que chaque -fragment aura sa propre portée. +spécifier explicitement les contextes. Cela assure que chaque fragment +aura sa propre portée. Il existe différents types de contextes. Les contextes @code{Staff} (portée), @code{Voice} (voix) et @code{Score} (partition) gèrent la @@ -1094,14 +1079,14 @@ notation de la mélodie, alors que @code{Lyrics} gère les paroles et En termes de syntaxe, faire précéder une expression musicale de @code{\new} crée une plus grosse expression musicale. En reprenant la -comparaison, cela ressemble au signe « moins » en mathématiques. La -formule @math{(4+5)} est une expression, donc @math{-(4+5)} est une -plus grosse expression. +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'' { @@ -1118,13 +1103,12 @@ modifié si nécessaire : voir pour cela @ref{Changing defaults}.}. @node Piano staves @subsection Piano staves -@cindex staff switch, manual -@cindex cross staff voice, manual -La musique pour piano s'écrit sur deux portées reliées par une -accolade. Imprimer ce type de portée revient au même que dans -l'exemple de musique polyphonique de (@ref{Multiple staves}), mais -maintenant cette expression entière doit être interprétée dans un -contexte @code{PianoStaff} : +@cindex changement de portée manuel +@cindex voix changeant manuellement de portée +La musique pour piano s'écrit sur deux portées reliées par une accolade. +Imprimer ce type de portée revient au même que dans l'exemple de musique +polyphonique de @ref{Multiple staves}, mais maintenant cette expression +entière doit être interprétée dans un contexte @code{PianoStaff} : @example \new PianoStaff << @@ -1144,27 +1128,50 @@ 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 -@cindex polyphony -@cindex multiple voices -@cindex voices, more -- on a staff -Quand différentes lignes mélodiques sont combinées sur une seule et -même portée, elles sont imprimées comme des voix polyphoniques ; -chaque voix a ses propre hampes@footnote{familièrement appelées queues -de note.}, liaisons et ligatures, la voix supérieure ayant les hampes -vers le haut, la voix inférieure vers le bas. +@cindex polyphonie +@cindex voix multiples sur une portée +Quand différentes lignes mélodiques sont combinées sur une seule et même +portée, elles sont imprimées comme des voix polyphoniques ; chaque voix +a ses propre hampes@footnote{familièrement appelées queues de note.}, +liaisons et ligatures, la voix supérieure ayant les hampes vers le haut, +la voix inférieure vers le bas. Ce type de partition est réalisé en entrant chaque voix comme une séquence (avec @code{@{...@}}), en combinant simultanément les voix et -en les séparant par @code{\\} : +en les séparant par @code{\\} : @lilypond[quote,ragged-right,verbatim,fragment,relative=2] @@ -1175,10 +1182,10 @@ en les séparant par @code{\\} : @end lilypond Pour l'écriture de musique polyphonique, les silences invisibles -s'avèrent bien pratiques : ce sont des silences qui ne s'impriment -pas. Ils sont utiles pour remplir des voix qui, temporairement, ne -jouent rien. On peut voir ici le même exemple avec un silence -invisible (@code{s}) à la place d'un silence normal (@code{r}) : +s'avèrent bien pratiques : ce sont des silences qui ne s'impriment pas. +Ils sont utiles pour remplir des voix qui, temporairement, ne jouent +rien. On peut voir ici le même exemple avec un silence invisible +(@code{s}) à la place d'un silence normal (@code{r}) : @lilypond[quote,ragged-right,verbatim,fragment,relative=2] << @@ -1204,41 +1211,16 @@ 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 chords -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 -Cette section présente l'écriture vocale, et les partitions de variété. +Cette section présente l'écriture vocale et les partitions de variété. @menu * Printing lyrics:: @@ -1249,8 +1231,8 @@ Cette section présente l'écriture vocale, et les partitions de variété. @node Printing lyrics @subsection Printing lyrics -@cindex Lyrics -@cindex Songs +@cindex paroles +@cindex chansons Prenons une mélodie toute simple : @lilypond[quote,ragged-right,verbatim] @@ -1260,9 +1242,9 @@ Prenons une mélodie toute simple : } @end lilypond -Des paroles peuvent être associées à ces notes, en les combinant avec -la commande @code{\addlyrics}. Les paroles sont entrées en séparant -chaque syllable par un espace : +Des paroles peuvent être associées à ces notes, en les combinant avec la +commande @code{\addlyrics}. Les paroles sont entrées en séparant chaque +syllable par un espace : @lilypond[quote,ragged-right,verbatim] << @@ -1274,10 +1256,10 @@ chaque syllable par un espace : >> @end lilypond -@cindex melisma -@cindex extender line +@cindex mélisme +@cindex ligne d'extension Cette mélodie se termine sur un @rglos{melisma}, c'est-à-dire qu'une -seule syllable (« free ») correspond à plus d'une note. Ceci est +seule syllable (@qq{free}) correspond à plus d'une note. Ceci est indiqué avec une @emph{ligne d'extension}. Elle est entrée avec deux caractères souligné (@code{_}), c'est-à-dire : @@ -1306,34 +1288,32 @@ 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}. +Plus de possibilités, comme celle d'ajouter plusieurs lignes de paroles +en dessous d'une même mélodie sont exposées dans @ruser{Vocal music}. @end quotation @node A lead sheet @subsection A lead sheet -@cindex Lead sheets -@cindex chords -@cindex chord names +@cindex partition de chanson +@cindex chanson, partition complète +@cindex accords, noms +@cindex noms d'accords -En musique de variété, il est courant d'indiquer l'accompagnement par -le nom des accords. De tels accords peuvent être entrés comme les -notes : +En musique de variété, il est courant d'indiquer l'accompagnement par le +nom des accords. De tels accords peuvent être entrés comme les notes : @lilypond[quote,ragged-right,verbatim] \chordmode { c2 f4. g8 } @end lilypond -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 points. L'exemple suivant montre quelques modificateurs -usuels : +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 modificateurs après deux +points. L'exemple suivant montre quelques modificateurs usuels : @lilypond[quote,verbatim,ragged-right] \chordmode { c2 f4:m g4:maj7 gis1:dim7 } @@ -1342,15 +1322,16 @@ usuels : 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 résultat suivant : +syntaxe sera utilisée que dans le cas de@code{\chordmode}, mais le rendu +des notes interviendra dans un contexte @code{ChordNames}, avec le +résultat suivant : @lilypond[quote,verbatim,ragged-right] \chords { c2 f4.:m g4.:maj7 gis8:dim7 } @end lilypond -@cindex lead sheet +@cindex partition de chanson +@cindex chanson, partition complète Une fois assemblés, les accords, paroles et mélodie forment une partition de chanson : @@ -1366,19 +1347,19 @@ 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}. +Une liste complète de modificateurs et d'autres options de mise en forme +se trouve à la section @ruser{Chord notation}. @end quotation @node Final touches @section Final touches -Voici l'ultime section de ce tutoriel, qui montre comment ajouter la -touche finale à des morceaux simples, et sert d'introduction pour le -reste du Manuel. +L'ultime section de ce tutoriel montre comment ajouter une touche finale +à des morceaux simples, et consititue une introduction au reste du +manuel. @menu * Version number:: @@ -1393,36 +1374,34 @@ reste du Manuel. @node Version number @subsection Version number -@cindex versioning +@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.10.0, ajoutez +LilyPond pour laquelle le fichier a été écrit, @example -\version "2.10.1" +\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} -- et il utilise @code{\version} pour déterminer les -règles de conversion à appliquer au fichier. +LilyPond. Les changements dans la syntaxe sont gérés avec un programme +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. @node Adding titles @subsection Adding titles -Les informations bibliographiques (nom du morceau, du compositeur, -etc) sont entrées dans un bloc séparé, le bloc d'en-tête -(@code{\header}), qui existe indépendamment des expressions musicales -principales. Le bloc @code{\header} est habituellement placé en début -de fichier. +Les informations bibliographiques (nom du morceau, du compositeur, etc) +sont entrées dans un bloc séparé, le bloc d'en-tête (@code{\header}), +qui existe indépendamment des expressions musicales principales. Le +bloc @code{\header} est habituellement placé en début de fichier. @example -\version "2.10.1" +\version "2.11.38" \header @{ title = "Symphonie" composer = "Moi" @@ -1433,23 +1412,23 @@ de fichier. @dots{} music @dots{} @} @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}. +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 +à @ruser{Creating titles}. @node Absolute note names @subsection Absolute note names -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. +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 des hauteurs absolues. Si vous omettez la commande @code{\relative}, LilyPond considérera toutes les hauteurs comme des hauteurs absolues. Un @code{c'} sera -toujours un do du milieu, un @code{b} sera toujours une note -au-dessous du précédent, et un @code{g,} sera toujours la note la plus -grave dans la portée de clé de Fa. +toujours un do du milieu, un @code{b} sera toujours une note au-dessous +du précédent, et un @code{g,} sera toujours la note la plus grave dans +la portée de clé de fa. @lilypond[quote,verbatim,ragged-right] { @@ -1476,8 +1455,8 @@ Voici une gamme sur 4 octaves : } @end lilypond -Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire -de la musique dans un registre aigu. Regardez cet extrait de Mozart : +Comme vous pouvez le voir, il faut beaucoup d'apostrophes pour écrire de +la musique dans un registre aigu. Regardez cet extrait de Mozart : @lilypond[quote,verbatim,ragged-right] { @@ -1489,8 +1468,8 @@ de la musique dans un registre aigu. Regardez cet extrait de Mozart : @end lilypond Toutes ces apostrophes rendent le fichier moins lisible, et c'est donc -une source d'erreurs. En mode @code{\relative}, le même exemple -devient bien plus facile à lire : +une source d'erreurs. En mode @code{\relative}, le même exemple devient +bien plus facile à lire : @lilypond[quote,verbatim,ragged-right] \relative c'' { @@ -1502,14 +1481,14 @@ devient bien plus facile à lire : @end lilypond 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 à +@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 auntant visible, et donc aussi facile à dénicher. -Cependant, le mode de hauteurs absolues reste utile pour les musiques -où les intervalles sont étendus, surtout pour les fichiers LilyPond -créés par ordinateur. +Cependant, le mode de hauteurs absolues reste utile pour les musiques où +les intervalles sont étendus, surtout pour les fichiers LilyPond créés +par ordinateur. @node Organizing pieces with identifiers @@ -1517,10 +1496,10 @@ créés par ordinateur. Lorsque l'on combine tous les éléments étudiés plus haut pour produire des fichiers plus volumineux, les blocs @code{\score} deviennent -beaucoup plus gros parce que les expressions musicales sont plus -longues et, dans le cas des pièces polyphoniques, profondément -imbriquées. De telles expressions imposantes finissent par devenir -peu maniables. Cet inconvénient peut être résolu par l'utilisation +beaucoup plus gros parce que les expressions musicales sont plus longues +et, dans le cas des pièces polyphoniques, profondément imbriquées. De +telles expressions imposantes finissent par devenir peu maniables. Cet +inconvénient peut être résolu par l'utilisation d'@emph{identificateurs}. En utilisant ces identificateurs, que l'on pourrait aussi appeler @@ -1533,9 +1512,9 @@ MusiqueToto = @{ @dots{} @} Le contenu de l'expression musicale @code{MusiqueToto} pourra être utilisé plus loin en faisant précéder son nom d'un anti-slash, -c'est-à-dire @code{\MusiqueToto}, juste comme n'importe quelle -commande LilyPond. Tous les identificateurs doivent être définis -@emph{avant} l'expression musicale principale. +c'est-à-dire @code{\MusiqueToto}, juste comme n'importe quelle commande +LilyPond. Tous les identificateurs doivent être définis @emph{avant} +l'expression musicale principale. @lilypond[quote,verbatim,ragged-right] violin = \new Staff { \relative c'' { @@ -1566,8 +1545,7 @@ aFivePaper = \paper @{ paperheight = 21.0 \cm @} @end example En fonction de son contenu, un identificateur peut être utilisé à -différents endroits. L'exemple suivant utilise la variable ci-dessus -: +différents endroits. L'exemple suivant utilise la variable ci-dessus : @example \paper @{ @@ -1581,42 +1559,42 @@ différents endroits. L'exemple suivant utilise la variable ci-dessus @node After the tutorial @subsection After the tutorial -Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire -un morceau ou deux. Commencez par copier l'un des modèles types -(@ref{Templates}) 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 un ensemble instrumental non couvert par les -@ref{Example templates}, lisez la section @ref{Extending the -templates}. - -Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5 -du manuel d'apprentissage. Rien ne s'oppose à ce que vous consultiez -dès à présent les autres chapitres, bien sûr ! Néanmoins, le reste du -manuel de l'utilisateur part du principe que vous avez déjà bien -assimilé la syntaxe de LilyPond. Vous pouvez toujours survoler le -reste du manuel, et y revenir plus tard après avoir acquis de -l'expérience. +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 @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}. + +Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5 du +manuel d'apprentissage. Rien ne s'oppose à ce que vous consultiez dès à +présent les autres chapitres, bien sûr ! Néanmoins, le reste du manuel +de l'utilisateur part du principe que vous avez déjà bien assimilé la +syntaxe de LilyPond. Vous pouvez toujours survoler le reste du manuel, +et y revenir plus tard après avoir acquis de l'expérience. @node How to read the manual @subsection How to read the manual Comme nous l'avons déjà vu dans @ref{How to read the tutorial}, de -nombreux exemples du tutoriel n'ont pas fait apparaître le +nombreux exemples du tutoriel n'ont pas fait apparaître @code{\relative c'' @{ ... @}} dans l'extrait de code affiché. -Dans le reste du manuel, les exemples utilisés sont encore beaucoup -plus souples : parfois il leur manque le @code{\relative c'' @{ ... -@}}, mais d'autres fois ils ont recours à une autre hauteur de -référence, telle que @code{c'} ou @code{c,,}), et dans certains cas -c'est même l'exemple entier qui est en mode de hauteurs absolues ! -Cependant, de telles ambiguïtés ne se trouvent que dans des contextes -où les hauteurs n'ont que peu d'importance. Dans tous les exemples où -elles en ont, le mode @code{\relative} ou absolu @code{@{ @}} est -explicitement spécifié. - -Si vous ne vous y retrouvez toujours pas pour savoir quel code -LilyPond 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. +Dans le reste du manuel, les exemples utilisés sont encore beaucoup plus +souples : parfois il leur manque le @code{\relative c'' @{ ... @}}, +mais d'autres fois ils ont recours à une autre hauteur de référence, +telle que @code{c'} ou @code{c,,}), et dans certains cas c'est même +l'exemple entier qui est en mode de hauteurs absolues ! Cependant, de +telles ambiguïtés ne se trouvent que dans des contextes où les hauteurs +n'ont que peu d'importance. Dans tous les exemples où elles en ont, le +mode @code{\relative} ou absolu @code{@{ @}} est explicitement spécifié. + +Si vous ne vous y retrouvez toujours pas pour savoir quel code LilyPond +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 this manual}.