X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ffr%2Fnotation%2Finput.itely;h=182c8e54b2c5f9d829bd125f90f91e8c46450138;hb=4a81b4d1f1706e503b0bb8fd7c80be3c825cc96c;hp=55146ac588761dcbf8ebe797c0205558dbc2bf4d;hpb=1d509b27723ea1c359b51c0f2fe623a32867d6f9;p=lilypond.git diff --git a/Documentation/fr/notation/input.itely b/Documentation/fr/notation/input.itely index 55146ac588..182c8e54b2 100644 --- a/Documentation/fr/notation/input.itely +++ b/Documentation/fr/notation/input.itely @@ -1,14 +1,13 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- - @ignore - Translation of GIT committish: 3930746d3e6cab846a02332c39510c48027c6006 + Translation of GIT committish: c610645cc9a77cba1a2798280965db142d649ac5 When revising a translation, copy the HEAD committish of the version that you are working on. For details, see the Contributors' Guide, node Updating translation committishes.. @end ignore -@c \version "2.15.17" +@c \version "2.15.32" @c Translators: Jean-Charles Malahieude, Valentin Villenave @@ -20,16 +19,16 @@ Nous n'allons pas, dans ce chapitre, parler directement de notation, mais plutôt du contenu des fichiers source et du résultat produit par LilyPond. - @menu * Agencement du code:: * Titres et entêtes:: * Travail sur des fichiers texte:: * Contrôle des sorties:: * Sortie MIDI:: -* Extraction d'information musicale:: +* Extraction d'informations musicales:: @end menu + @node Agencement du code @section Agencement du code @translationof Input structure @@ -124,9 +123,9 @@ Pour de plus amples informations à propos du bloc @code{\book}, lisez @seealso Manuel d'initiation : -@rlearning{Travail sur les fichiers d'entrée}, +@rlearning{La partition est une (unique) expression musicale composée}, @rlearning{Les expressions musicales en clair}, -@rlearning{La partition est une (unique) expression musicale composée}. +@rlearning{Travail sur les fichiers d'entrée}. @node Plusieurs partitions dans un même ouvrage @@ -268,7 +267,7 @@ Ainsi, le fichier @file{huitminiatures.ly} qui contiendrait @} @end example -génèrera +générera @itemize @item @@ -284,6 +283,9 @@ génèrera @subsection Nom des fichiers de sortie @translationof Output file names +@funindex \bookOutputSuffix +@funindex \bookOutputName + LilyPond vous permet de prendre le contrôle dans la dénomination des fichiers que vous voulez générer, quel que soit le moteur de rendu utilisé. @@ -371,7 +373,7 @@ supérieur, s'appliqueront à l'intégralité de l'ouvrage. Si l'une de ces expression apparaît à plusieurs reprises, la dernière aura préséance. @item -Une expression scheme pure, telle que +Une expression Scheme pure, telle que @w{@code{#(set-default-paper-size@tie{}"a7"@tie{}'landscape)}} ou @w{@code{#(ly:set-option@tie{}'point-and-click@tie{}#f)}}. @@ -433,9 +435,10 @@ simple expression musicale sera traduit en @{ c'4 d' e'2 @} @} @} + \layout @{ @} @} - \layout @{ @} - \header @{ @} + \paper @{ @} + \header @{ @} @} @end example @@ -467,7 +470,7 @@ toto = @{ c4 d e d @} @end example Vous pourrez la réutiliser plus loin dans votre fichier en saisissant -simplement @code{\toto}. Le nom des indentificateurs ne doit être +simplement @code{\toto}. Le nom des identificateurs ne doit être formés que de caractères alphabétiques -- sans chiffre ni caractère souligné ou tiret. @@ -488,7 +491,7 @@ Voici trois éléments que vous pouvez placer à un niveau supérieur@tie{}: @{ c'4 d' e2 @} @end example -Vous pouvez placer, n'importe où dans votre fichier, les instruction +Vous pouvez placer, n'importe où dans votre fichier, les instructions suivantes@tie{}: @itemize @@ -518,7 +521,7 @@ Autour d'une accolade, qu'elle soit ouvrant ou fermante ; @item Après chaque commande ou variable, autrement dit tout élément qui -commence par un @code{\}@tie{}; +commence par un@tie{}@code{\}@tie{}; @item Après tout élément qui sera interprété comme une expression Scheme, @@ -537,7 +540,6 @@ contenir, comme dans @end itemize - @seealso Manuel d'initiation : @rlearning{Organisation des fichiers LilyPond}. @@ -554,6 +556,7 @@ d'information. @menu * Création de titres et entête ou pied de page:: * Titrages personnalisés:: +* Notes de bas de page:: * Référencement des numéros de page:: * Table des matières:: @end menu @@ -602,7 +605,7 @@ imprimés. @funindex print-all-headers @noindent -Vous pouvez modifer ce comportement et imprimer tous les champs d'un +Vous pouvez modifier ce comportement et imprimer tous les champs d'un bloc @code{\header} défini dans un bloc @code{\score} en ajoutant @example @@ -660,7 +663,7 @@ manuellement@tie{}: \header { title = "DAS WOHLTEMPERIRTE CLAVIER" subtitle = "TEIL I" - % Pas de pied en dernière page pour ce livret + % Pas de mention spéciale pour cet ouvrage tagline = ##f } \markup { \vspace #1 } @@ -711,17 +714,17 @@ bloc @code{\header} principal, et @code{scoreTitleMarkup} pour les blocs @lilypond[papersize=a6,quote,verbatim,noragged-right] \header { % Les champs suivants sont centrés - dedication = "Dédice" + dedication = "Dédicace" title = "Titre" subtitle = "Sous-titre" subsubtitle = "Sous-sous-titre" instrument = "Instrument" - % Les champs suivants sont alignés sur le bord gauche + % Les champs suivants sont alignés par la gauche poet = "Librettiste" meter = "Tempo" - % Les champs suivants sont alignés sur le bord droit + % Les champs suivants sont alignés par la droite composer = "Compositeur" arranger = "Arrangeur" } @@ -785,7 +788,7 @@ Fichiers d'initialisation : @translationof Default layout of headers and footers Les entête et pied -- @emph{headers} et @emph{footers} -- sont des -lignes de textes qui apparaîssent en haut et en bas de chaque page, +lignes de textes qui apparaissent en haut et en bas de chaque page, indépendamment du texte de l'ouvrage. Ils sont contrôlés par les variables suivantes, attachées au bloc @code{\paper}@tie{}: @@ -1096,6 +1099,292 @@ Manuel de notation : @ref{Mise en forme par défaut des titrages}. +@node Notes de bas de page +@subsection Notes de bas de page +@translationof Creating footnotes + +LilyPond dispose de deux méthodes pour créer des notes de bas de page, +l'une automatisée, et l'autre manuelle. + +@menu +* Considérations générales en matière de note de bas de page:: +* Notes de bas de page automatiques:: +* Notes de bas de page manuelles:: +@end menu + + +@node Considérations générales en matière de note de bas de page +@unnumberedsubsubsec Considérations générales en matière de note de bas de page +@translationof Footnotes overview + +Il est parfois judicieux, notamment lorsqu'une annotation ou un +commentaire gênerait la lecture de la partition, de les reporter en bas +de page. + +Les notes de bas de page automatiques font appel à un compteur +numérique incrémenté automatiquement@tie{}; les notes de bas de page +manuelles vous laissent le libre choix de l'appel (l'indicateur). Tout +objet graphique, @code{\markup} de haut niveau ou les notes d'un accord +peuvent faire l'objet d'une annotation. + +L'ordre dans lequel les objets seront dessinés détermine l'ordre des +appels et comment les annotations seront créées lors de la compilation. + + +@node Notes de bas de page automatiques +@unnumberedsubsubsec Notes de bas de page automatiques +@translationof Automatic footnotes + +@cindex note de bas de page automatique +@cindex bas de page, note automatique + +@funindex \footnote + +La commande @code{\footnote} permet de générer automatiquement des notes +de bas de page. Elle requiert trois arguments@tie{}: l'@var{Objet de +Rendu} auquel s'applique le commentaire rapporté en bas de page, la +position @samp{(x@tie{}.@tie{}y)} de l'appel de note, et enfin un +@code{\markup} contenant l'annotation qui apparaîtra en bas de la page. + +La commande @code{\footnote} doit être mentionnée @strong{avant} +l'objet auquel la note est attachée. + +@c KEEP LY +@lilypond[verbatim,quote,ragged-right,papersize=a8] +\book { + \header { tagline = ##f } + \relative c' { + \footnote #'(0.5 . -2) #'NoteHead + \markup { La première note } + a'4 b8 + \footnote #'(0.5 . 1) #'NoteHead + \markup { La troisième note } + e c4 d4 + } +} +@end lilypond + +Lorsqu'il s'agit de notes inscrites dans un accord, la commande +@code{\footnote} doit être mentionnée @strong{après} la note à laquelle +le @code{TextScript} fait référence. + +@c KEEP LY +@lilypond[verbatim,quote,ragged-right,papersize=a8] +\book { + \header { tagline = ##f } + \relative c' { + < + c-\footnote #'(1 . -1.25) "Voici un do" + es-\footnote #'(2 . -0.25) \markup { \italic "Un mi bémol" } + g-\footnote #'(2 . 3) \markup { \bold "Ceci est un sol" } + >1 + } +} +@end lilypond + +@warning{Lorsque plusieurs notes de bas de page se rapportent à un même +empilement vertical, les notes apparaîtront dans l'ordre vertical des +appels, autrement dit celui positionné le plus haut en premier, et ainsi +de suite.} + +Voici quelques exemples d'objets annotés automatiquement. Vous pouvez +constater l'agencement des annotations correspondantes avec le copyright +et le pied de page. + +@lilypond[verbatim,quote,ragged-right,papersize=a8] +\book { + \header { copyright = \markup { "Copyright 1970" } } + \relative c' { + \footnote #'(-3 . 0) #'DynamicText + \markup { \bold Forte } + + \footnote #'(0 . 1.5) #'Slur + \markup { A slur } + a'4\f( + + \footnote #'(0 . -2) #'Beam + \markup { Beam } + b8)[ e] + + \footnote #'(1 . -1) #'Stem + \markup { \teeny { This is a stem } } + c4 + + \footnote #'(0 . 0.5) #'AccidentalCautionary + \markup \italic { A cautionary accidental } + + \footnote #'(0.5 . -0.5) #'TextScript + \markup \italic { Slow Down } + dis?4_"rit." + } +} +@end lilypond + +Une note de bas de page affectant un @code{\markup} de haut niveau +s'introduit par la commande @code{\auto-footnote}@tie{}: + +@lilypond[verbatim,quote,ragged-right,papersize=a8] +\book { + \header { tagline = ##f } + \markup { \auto-footnote "A simple tune" \italic "By me" } + \relative c' { + a'4 b8 e c4 d + } +} +@end lilypond + + +@node Notes de bas de page manuelles +@unnumberedsubsubsec Notes de bas de page manuelles +@translationof Manual footnotes + +@cindex note de bas de page manuelle +@cindex bas de page, note manuelle + +@funindex \footnote +@funindex \footnoteGrob + +LilyPond permet aussi de créer des notes de bas de page manuelles@tie{}: +la commande @code{\footnote} prend alors quatre arguments@tie{}: +l'@var{Objet de Rendu} devant être annoté, la position +@samp{(x@tie{}.@tie{}y)} de l'appel de note, et deux @code{\markup} -- +le premier contient l'appel qui s'attache à la note ou à l'objet +référencé, le second contient l'annotation qui est reportée en bas de +page. + +Tout comme dans le cas d'une note de bas de page automatique, la commande +@code{\footnote} doit être mentionnée comme s'il s'agissait d'une +articulation, donc @strong{avant} l'objet auquel l'annotation fait +référence. + +@lilypond[verbatim,quote,ragged-right,papersize=a8] +\book { + \header { tagline = ##f } + \relative c' { + a'4-\footnote + "1" #'(0.5 . -2) #'NoteHead \markup { \italic "1. The first note" } + b8 + e-\footnote + \markup { \bold "2" } #'(0.5 . 1) #'NoteHead "2. The second note" + c4 + d\p-\footnote "3" #'(0.5 . -1) #'DynamicText "3. Piano" + } +} +@end lilypond + +S'agissant d'annoter l'une des notes d'un accord, la commande +@code{\footnote} doit être mentionnée @strong{après} la note à laquelle +l'annotation fait référence, comme s'il s'agissait d'une articulation. + +@lilypond[verbatim,quote,ragged-right,papersize=a8] +\book { + \header { tagline = ##f } + \relative c' { + < + c-\footnote "1" #'(1 . -1.25) "1. C" + es-\footnote + \markup { \bold "b" } #'(2 . -0.25) "b. E-flat" + g-\footnote "3" #'(2 . 3) \markup { \italic "iii. G" } + >1 + } +} +@end lilypond + +@warning{Lorsque plusieurs notes de bas de page se rapportent à un même +empilement vertical, les notes apparaîtront dans l'ordre vertical des +appels, autrement dit celui positionné le plus haut en premier, et ainsi +de suite.} + +Voici quelques exemples d'objets annotés manuellement. Vous pouvez +constater l'agencement des annotations correspondantes avec le copyright +et le pied de page. + +@lilypond[verbatim,quote,ragged-right,papersize=a8] +\book { + \header { tagline = ##f } + \relative c' { + \footnote + \markup { \teeny 1 } #'(-3 . 0) #'DynamicText + \markup { 1. \bold Forte } + + \footnote + \markup { \teeny b } #'(0 . 1.5) #'Slur + \markup { b. A slur } + a'4\f( + + \footnote + \markup { \teeny 3 } #'(0 . -2) #'Beam + \markup { 3. Beam } + b8)[ e] + + \footnote + \markup { 4 } #'(1 . -1) #'Stem + \markup { \bold 4. { This is a stem } } + c4 + + \footnote + \markup \concat \teeny { "sharp (v)" } + #'(0 . 0.5) #'AccidentalCautionary + \markup \italic { v. A cautionary accidental } + + \footnote + \markup \concat \teeny { "a" } #'(0.5 . -0.5) #'TextScript + \markup \italic { a. Slow Down } + dis?4_"rit." + + \breathe + \footnote + \markup { \teeny \musicglyph #"rests.4" } + #'(1.5 . -0.25) #'BreathingSign + \markup { \null } + } +} +@end lilypond + +L'annotation manuelle d'un @code{\markup} de haut niveau répond à la +syntaxe suivante@tie{}: + +@lilypond[verbatim,quote,ragged-right,papersize=a8] +\book { + \header { tagline = ##f } + \markup { "A simple tune" \footnote "*" \italic "* By me" } + \relative c' { + a'4 b8 e c4 d4 + } +} +@end lilypond + +@seealso +Manuel d'initiation : +@rlearning{Objets et interfaces}. + +Manuel de notation : +@ref{Commentaires textuels}, +@ref{Indications textuelles}, +@ref{Info-bulle}, +@ref{Mise en forme de la page}, +@ref{Titres et entêtes}. + +Référence des propriétés internes : +@rinternals{FootnoteEvent}, +@rinternals{FootnoteItem}, +@rinternals{FootnoteSpanner}, +@rinternals{Footnote_engraver}. + +@knownissues +Un silence multimesures ne peut se voir affecter une note de bas de +page. + +Les notes de bas de page ne peuvent que s'empiler l'une au-dessus de +l'autre@tie{}; elles ne seront jamais présentées à la queue leu leu. +Les notes de bas de page peuvent générer des chevauchements quand elles +sont trop nombreuses sur une même page. + +Dès lors que vous utilisez une commande de note de bas de page manuelle, +le bloc @code{\paper} doit contenir la mention +@w{@code{footnote-auto-number@tie{}=@tie{}##f}}. + + @node Référencement des numéros de page @subsection Référencement des numéros de page @translationof Reference to page numbers @@ -1127,7 +1416,7 @@ numéro de page grâce à la commande de @emph{markup} @code{\page-ref}. L'instruction @code{\page-ref} prend trois arguments@tie{}: @enumerate @item -le point de référence, sous la forme d'un symbole scheme, comme par +le point de référence, sous la forme d'un symbole Scheme, comme par exemple @code{#'firstScore}, @item @@ -1145,7 +1434,6 @@ déterminé, LilyPond doit connaître les dimensions de ce @emph{markup}. Vous pouvez, lorsque l'ouvrage contiendra plus de dix pages, stipuler un emporte-pièce sur deux caractères -- soit @code{"00"}. - @predefined @funindex \label @code{\label}, @@ -1281,12 +1569,6 @@ pointillée@tie{}: } @end lilypond - -@seealso -Fichiers d'initialisation : -@file{../ly/toc-init.ly}. - - @predefined @funindex \table-of-contents @code{\table-of-contents}, @@ -1294,6 +1576,10 @@ Fichiers d'initialisation : @code{\tocItem}. @endpredefined +@seealso +Fichiers d'initialisation : +@file{../ly/toc-init.ly}. + @node Travail sur des fichiers texte @section Travail sur des fichiers texte @@ -1302,9 +1588,10 @@ Fichiers d'initialisation : @menu * Insertion de fichiers LilyPond:: * Différentes éditions à partir d'une même source:: -* Codage du texte:: +* Caractères spéciaux:: @end menu + @node Insertion de fichiers LilyPond @subsection Insertion de fichiers LilyPond @translationof Including LilyPond files @@ -1313,7 +1600,7 @@ Fichiers d'initialisation : @cindex inclusion de fichiers Lorsqu'un projet prend de l'importance en volume, il est judicieux de le -scinder en plusieurs fichiers, auxquels vous fereez référence avec un +scinder en plusieurs fichiers, auxquels vous ferez référence avec un simple @example @@ -1355,7 +1642,7 @@ répertoire courant, vous devrez mentionner ... etc. @end example -Les fichiers à inclure peuvent eux-même contenir des instructions +Les fichiers à inclure peuvent eux-mêmes contenir des instructions @code{\include}. Ces instructions @code{\include} de second niveau ne pourront, par défaut, être interprétées qu'une fois intégrées dans le fichier principal@tie{}; leur argument doit donc comporter le chemin @@ -1371,7 +1658,7 @@ défaut dans une future version de LilyPond. Vous pouvez inclure des fichiers dont vous spécifierez le chemin d'accès sur la ligne de commande au moment de lancer la compilation. L'appel à -ces fichiers ne mentionnerra alors que leur nom. Par exemple, si vous +ces fichiers ne mentionnera alors que leur nom. Par exemple, si vous voulez compiler avec cette méthode le fichier @file{principal.ly} qui inclut des fichiers situés dans le sous-répertoire @file{parties}, placez vous dans le répertoire contenant @file{principal.ly}, puis tapez @@ -1409,15 +1696,12 @@ nouvelle version de LilyPond. Vous trouverez quelques exemples simples d'utilisation de la commande @code{\include} au chapitre @rlearning{Conducteurs et parties}. - @seealso Manuel d'initiation : @rlearning{Autres sources de documentation}, @rlearning{Conducteurs et parties}. - @knownissues - Lorsque vous incluez un fichier qui porte le même nom que l'un des fichiers d'initialisation de LilyPond, le fichier de la distribution de LilyPond aura préséance. @@ -1427,15 +1711,17 @@ LilyPond aura préséance. @subsection Différentes éditions à partir d'une même source @translationof Different editions from one source -Différents mécanismes permettent de générer plusieurs versions d'une +Plusieurs méthodes permettent de générer différentes versions d'une partition à partir d'une même source. Les variables -- ou -idendificateurs -- sont sûrement le moyen le plus simple de combiner de +identificateurs -- sont sûrement le moyen le plus simple de combiner de différente manière des passages relativement longs, alors que les balises permettront de sélectionner de courts fragments selon leur -utilisation. Quelle que soit la méthode utilisée, séparer la notation -de la structure de la partition vous donnera plus de liberté dans -l'agencement de l'ouvrage final, puisque vous ne reviendrez pas sur la -musique qui le compose. +utilisation. + +Quelle que soit la méthode utilisée, séparer la notation de la structure +de la partition vous donnera plus de liberté dans l'agencement de +l'ouvrage final, puisque vous ne reviendrez pas sur la musique qui le +compose. @menu * Utilisation de variables:: @@ -1443,6 +1729,7 @@ musique qui le compose. * Globalisation des réglages:: @end menu + @node Utilisation de variables @unnumberedsubsubsec Utilisation de variables @translationof Using variables @@ -1516,6 +1803,8 @@ rappellerez ensuite, comme indiqué à la rubrique @funindex \tag @funindex \keepWithTag @funindex \removeWithTag +@funindex \pushToTag +@funindex \appendToTag @cindex tag @cindex balise @@ -1649,7 +1938,32 @@ expression musicale aboutit à l'exclusion de @b{tous} les balisages. En effet, si le premier filtre exclut tous les autres balisages, l'application du second exclura les effets du premier. +Il peut arriver que vous ayez besoin de raccorder quelque chose en un +point particulier d'une expression musicale. Les commandes +@code{\pushToTag} et @code{\appendToTag} permettent d'insérer du +matériau, qu'il soit antérieur ou postérieur à des @code{éléments} +d'une construction musicale existante. La musique séquentielle ou +simultanée comporte assurément des @code{éléments}@tie{}: + +@lilypond[verbatim,quote] +test = { \tag #'here { \tag #'here <> } } +{ + \pushToTag #'here c' + \pushToTag #'here e' + \pushToTag #'here g' \test + \appendToTag #'here c' + \appendToTag #'here e' + \appendToTag #'here g' \test +} +@end lilypond + +Ces deux instructions sont affectées d'une balise, le matériau à +raccorder à chaque instance de la balise, et l'expression balisée. +Ces instructions prennent soin de recopier tout ce qui doit être +modifié, de telle sorte que l'expression @code{\test} originale conserve +tout son sens. + @seealso Manuel d'initiation : @rlearning{Organisation du code source avec des variables}. @@ -1665,7 +1979,6 @@ Manuel de notation : @c Should be deleted? -td @knownissues - Lorsqu'elles comportent des silences, ceux-ci ne seront pas fusionnés si vous imprimez une partition avec les deux sections balisées. @@ -1679,7 +1992,7 @@ si vous imprimez une partition avec les deux sections balisées. @cindex include-settings Vous pouvez regrouper dans un fichier indépendant vos réglages -personnels que vous incluerez au besoin@tie{}: +personnels que vous inclurez au besoin@tie{}: @example lilypond -dinclude-settings=MES_REGLAGES.ly MA_PARTITION.ly @@ -1691,7 +2004,7 @@ particulières. Selon le fichier de réglages que vous mentionnerez, vous obtiendrez facilement différentes éditions à partir d'une même source quelle qu'elle soit. -Ceete technique peut s'utiliser en combinaison avec des feuilles de +Cette technique peut s'utiliser en combinaison avec des feuilles de styles, comme indiqué au chapitre @rlearning{Feuilles de style}. @seealso @@ -1703,13 +2016,25 @@ Manuel de notation : @ref{Insertion de fichiers LilyPond}. +@node Caractères spéciaux +@subsection Caractères spéciaux +@translationof Special characters + +@cindex caractères spéciaux +@cindex non-ASCII, caractères + +@menu +* Codage du texte:: +* Unicode:: +* Équivalents ASCII:: +@end menu + + @node Codage du texte -@subsection Codage du texte +@unnumberedsubsubsec Codage du texte @translationof Text encoding -@cindex Unicode @cindex UTF-8 -@cindex non-ASCII characters LilyPond utilise le jeu de caractères défini par le consortium Unicode et la norme ISO/CEI@tie{}10646. Chaque caractère est identifié par un @@ -1734,7 +2059,7 @@ consiste à utiliser un éditeur supportant l'unicode et à enregistrer vos fichier en UTF-8. C'est le cas pour la plupart des éditeurs actuels, que ce soit vim, Emacs, jEdit et GEdit. Tous les systèmes Windows postérieurs à NT utilisent Unicode en natif@tie{}; même Notepad est -capable d'éditer et sauvegarder un fichie en UTF-8 -- sans parler de +capable d'éditer et sauvegarder un fichier en UTF-8 -- sans parler de l'excellente alternative qu'est BabelPad. La compilation d'un fichier LilyPond comportant des caractères non ASCII @@ -1745,7 +2070,7 @@ l'erreur FT_Get_Glyph_Name () erreur : invalid argument @end example -Voici un exemple utilisant du texte en cyrilique, en hébreux et en +Voici un exemple utilisant du texte en cyrillique, en hébreux et en portugais. @lilypond[quote] @@ -1773,9 +2098,16 @@ portuguese = \lyricmode { \addlyrics { \portuguese } @end lilypond + +@node Unicode +@unnumberedsubsubsec Unicode +@translationof Unicode + +@cindex Unicode + Lorsque vous avez besoin d'un caractère dont vous connaissez le point de code mais que votre éditeur ne permet pas de saisir directement, vous -pouvez utitliser les instructions @code{\char@tie{}##xhhhh} ou +pouvez utiliser les instructions @code{\char@tie{}##xhhhh} ou @code{\char@tie{}#dddd} au sein d'un bloc @code{\markup} -- @code{hhhh} et @code{dddd} correspondant respectivement à la valeur hexadécimale ou décimale. Même s'il est inutile de saisir les zéros superflus, il est @@ -1808,7 +2140,7 @@ dans des paroles et dans du texte indépendant. } \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } } } -\markup { "Copyright 2008--2011" \char ##x00A9 } +\markup { "Copyright 2008--2012" \char ##x00A9 } @end lilypond @cindex copyright @@ -1823,6 +2155,60 @@ la manière suivante@tie{}: @end example +@node Équivalents ASCII +@unnumberedsubsubsec Équivalents ASCII +@translationof ASCII aliases + +Dès lors que vous aurez inclus la liste de leur équivalent ASCII, +LilyPond reconnaîtra un certain nombre de caractères spéciaux@tie{}: + +@lilypond[quote,verbatim] +\paper { + #(include-special-characters) +} + +\markup "&flqq; – &OE;uvre incomplète… &frqq;" + +\score { + \new Staff { \repeat unfold 9 a'4 } + \addlyrics { + This is al -- so wor -- kin'~in ly -- rics: –_&OE;… + } +} + +\markup \column { + "The replacement can be disabled:" + "– &OE; …" + \override #'(replacement-alist . ()) "– &OE; …" +} +@end lilypond + +L'extension de cette liste est possible aussi bien de manière globale : + +@lilypond[quote,verbatim] +\paper { + #(add-text-replacements! + '(("100" . "hundred") + ("dpi" . "dots per inch"))) +} +\markup "A 100 dpi." +@end lilypond + +qu'en un point particulier de votre source : + +@lilypond[quote,verbatim] +\markup \replace #'(("100" . "hundred") + ("dpi" . "dots per inch")) "A 100 dpi." +@end lilypond + +@seealso +Manuel de notation : +@ref{Liste des caractères spéciaux}. + +Fichiers d'initialisation : +@file{ly/text-replacements.ly}. + + @node Contrôle des sorties @section Contrôle des sorties @translationof Controlling output @@ -1834,6 +2220,7 @@ la manière suivante@tie{}: * Changement des fontes musicales:: @end menu + @node Extraction de fragments musicaux @subsection Extraction de fragments musicaux @translationof Extracting fragments of music @@ -1863,7 +2250,7 @@ la mesure 5@tie{}; le @code{7@tie{}3@tie{}4} signifie quant à lui que l'on s'arrête à la mesure 7, après la durée de trois noires. Rien ne vous empêche d'extraire plusieurs fragments, dès lors que vous -définissez dans la liste d'autres paires d'emplacements ryhtmiques. +définissez dans la liste d'autres paires d'emplacements rythmiques. Cette fonctionnalité n'est toutefois effective que lorsque vous lancez LilyPond avec l'option @w{@code{-dclip-systems}}. Les @qq{coupures} @@ -1937,8 +2324,8 @@ documents au format PostScript (PS) et Portable Document Format (PDF). Vous pouvez aussi obtenir des documents au format Scalable Vector Graphics (SVG), Encapsulated PostScript (EPS) ou Portable Network Graphics (PNG) dès lors que vous aurez lancé LilyPond en ligne de -commande avec l'option @i{ad hoc} -- voir -@rprogram{Options en ligne de commande pour lilypond} à ce sujet. +commande avec l'option @i{ad hoc} -- voir +@rprogram{Utilisation en ligne de commande} à ce sujet. @node Changement des fontes musicales @@ -1972,13 +2359,11 @@ répertoire @code{fonts} qui s'y trouve en @code{fonts_orig}, puis le répertoire @code{lilyfonts} en @code{fonts}. Il vous suffira, pour retrouver la fonte Feta, de renommer @code{fonts_orig} en @code{fonts}. - @seealso Manuel d'initiation : @rlearning{Autres sources de documentation}. @knownissues - Gonville ne permet pas de générer de la notation ancienne, et certains glyphes ajoutés depuis lors aux jeux de caractères en soient absent. Consultez le site de l'auteur pour de plus amples informations ainsi @@ -2000,18 +2385,16 @@ un logiciel capable de traduire ces séries de notes en sons réels. Vous pouvez convertir vos partition en fichier MIDI de manière à entendre ce que vous avez saisi. Ceci vous permet de contrôler aisément -ce que vous avez saisi@tie{}: octaves et altérations erronées heuteront +ce que vous avez saisi@tie{}: octaves et altérations erronées heurteront votre oreille avertie grâce au MIDI. Le fichier MIDI généré par LilyPond est relativement brut. Vous pouvez cependant obtenir un meilleur rendu avec @ref{Le script Articulate}. -@c TODO Check this -Dans une sortie MIDI, LilyPond alloue un canal à chaque portée, plus un -pour les réglages globaux. Par voie de conséquence, un fichier MIDI ne -peut comporter au maximmum que quinze portées (quatorze en l'absence de -percussions)@tie{}; les portées supplémentaires seront tout simplement -silencieuses. +Dans une sortie MIDI, LilyPond alloue un canal à chaque portée, tout en +réservant le canal@tie{}10 aux percussions. Dans la mesure ou un +périphérique MIDI ne comprend que 16 canaux, un fichier MIDI qui +comportera plus de quinze portées verra le même canal réutilisé. @menu * Création de fichiers MIDI:: @@ -2028,7 +2411,7 @@ silencieuses. @subsection Création de fichiers MIDI @translationof Creating MIDI files -LilyPond génèrera un fichier MIDI dès que vous ajouterez un bloc +LilyPond générera un fichier MIDI dès que vous ajouterez un bloc @code{\midi} à la structure de votre partition, comme ici@tie{}: @example @@ -2096,7 +2479,7 @@ lilypond … -dmidi-extension=midi fichierLily.ly @funindex Staff.midiInstrument L'instrument MIDI affecté à un canal particulier est déterminé par la -propiété @code{Staff.midiInstrument}. Vous pouvez choisr l'un des +propriété @code{Staff.midiInstrument}. Vous pouvez choisir l'un des instruments répertoriés à l'annexe @ref{Instruments MIDI}. @example @@ -2116,14 +2499,11 @@ Lorsque l'instrument choisi ne correspond pas exactement à l'une des dénominations consacrées, LilyPond le replacera par un piano de concert (@code{"acoustic grand"}). - @snippets - @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle] {changing-midi-output-to-one-channel-per-voice.ly} @knownissues - @c In 2.11 the following no longer seems to be a problem -td @ignore Un (de)crescendo non terminé ne sera pas correctement rendu en MIDI -- @@ -2170,16 +2550,13 @@ imprimée. \score @{ @var{...musique...} \midi @{ - \context @{ - \Score - tempoWholesPerMinute = #(ly:make-moment 72 4) - @} + \tempo 4 = 72 @} @} @end example Ici, le tempo est fixé à 72 noires à la minute. Spécifier un tempo de -la sorte ne permet pas de doner une valeur pour une note pointée. Vous +la sorte ne permet pas de donner une valeur pour une note pointée. Vous devrez, en pareil cas, subdiviser la note pointée en durée plus courte. Par exemple, indiquer 90 à la noire pointée est équivalent à spécifier 270 croches à la minute@tie{}: @@ -2212,7 +2589,7 @@ suffit d'insérer les lignes suivantes dans votre bloc @} @end example -LilyPond ne génèrera de sortie MIDI que si vous incluez un bloc +LilyPond ne générera de sortie MIDI que si vous incluez un bloc @code{\midi} dans la structure de la partition, initialisée par la commande @code{\score}. @@ -2268,7 +2645,7 @@ les accords nommés ; le rythme en tant que durée de note, y compris les nolets ; @item -les tremolos, exceptés ceux utilisant la syntaxe +les trémolos, exceptés ceux utilisant la syntaxe @qq{@code{:}[@var{nombre}]}@tie{}; @item @@ -2307,7 +2684,7 @@ suivant, sauf à utiliser @ref{Le script Articulate}@tie{}: @itemize @item -le rythme indiqué sous forme d'annotation (p.ex. @emph{swing})@tie{}; +le rythme indiqué sous forme d'annotation (par ex. @emph{swing})@tie{}; @item les changements de tempo indiqués sous forme d'annotation (sans @@ -2320,10 +2697,10 @@ les staccatos et autres articulations ou ornementations@tie{}; les liaisons d'articulation et de prhasé@tie{}; @item -les crescendos ou decrescendos sur une sele note@tie{}; +les crescendos ou decrescendos sur une seule note@tie{}; @item -les tremolos indiqués par la syntaxe @qq{@code{:}[@var{nombre}]}@tie{}; +les trémolos indiqués par la syntaxe @qq{@code{:}[@var{nombre}]}@tie{}; @item la basse chiffrée @@ -2440,8 +2817,8 @@ et demande d'utiliser la fonction par défaut dans les autre cas. Si vous étiez amené à devoir modifier l'intégralité du jeu des correspondances, nous vous conseillons d'utiliser la procédure @command{default-dynamic-absolute-volume} contenue dans le fichier -@file{../scm/midi.scm} ansi que la table d'association comme base. Le -dernier exemple de cette partie illustre la manière de procéder. +@file{../scm/midi.scm} ainsi que la table d'association comme base. +Le dernier exemple de cette partie illustre la manière de procéder. @unnumberedsubsubsec Amplitude du volume en MIDI @@ -2540,10 +2917,7 @@ indication de nuance. >> \layout {} \midi { - \context { - \Score - tempoWholesPerMinute = #(ly:make-moment 72 2) - } + \tempo 2 = 72 } } @end lilypond @@ -2564,7 +2938,7 @@ procédure Scheme @code{instrumentEqualizer} au sein du contexte instrument MIDI et renverra une paire de fractions correspondant au minimum et maximum de volume alloué à cet instrument. Cette substitution fonctionne selon le même principe que celui que nous avons -vu en dédut de chapitre avec @code{dynamicAbsoluteVolumeFunction}. +vu en début de chapitre avec @code{dynamicAbsoluteVolumeFunction}. L'égaliseur par défaut, @notation{default-instrument-equalizer}, est défini dans le fichier @file{../scm/midi.scm}@tie{}; son analyse vous aidera à construire votre propre procédure. @@ -2612,10 +2986,7 @@ flûte et de la clarinette -- au même niveau que dans le précédent. >> \layout { } \midi { - \context { - \Score - tempoWholesPerMinute = #(ly:make-moment 72 2) - } + \tempo 2 = 72 } } @end lilypond @@ -2670,7 +3041,7 @@ D'autres percussions, bien que n'émettant qu'un seul son et inclus dans le standard @emph{general MIDI}, comme le tom mélodique ou le tambour taiko, ne sont pas attachés au canal@tie{}10. Ces instruments doivent donc être saisi dans un contexte @code{Staff}, en utilisant la hauteur -appropiée. +appropriée. De nombreux instruments de la famille des percussions, les castagnettes par exemple, n'existent pas dans le standard @emph{general MIDI}. @@ -2680,9 +3051,8 @@ son le plus proche dans la banque standard. @c TODO Expand with examples, and any other issues @knownissues - Le standard @emph{general MIDI} ne dispose pas du @emph{rim shot}@tie{}; -LilyPond lui subtitue un @emph{sidestick}. +LilyPond lui substitue un @emph{sidestick}. @node Le script Articulate @@ -2724,7 +3094,6 @@ illustré ci-dessus permettra le rendu d'un certain nombre d'articulations tels les trilles. @knownissues - Dans la mesure où la script @code{articulate} tend à raccourcir les accords, certaines musiques, notamment pour l'orgue, paraîtront de moins bonne qualité. @@ -2739,7 +3108,7 @@ l'information musicale sous forme textuelle. @menu * Affichage de notation au format LilyPond:: -* Affichage de la musique sous forme d'expression scheme:: +* Affichage de la musique sous forme d'expression Scheme:: * Enregistrement d'événements musicaux dans un fichier:: @end menu @@ -2750,9 +3119,9 @@ l'information musicale sous forme textuelle. @funindex \displayLilyMusic -La fonction musicale @code{\displayLilyMusic}, disponible uniquement -pour un traitement en ligne de commande, permet d'afficher en -notation LilyPond une expression musicale. Par exemple, +La fonction musicale @code{\displayLilyMusic} permet d'afficher en +notation LilyPond une expression musicale. Le résultat défilera dans le +terminal après avoir lancé LilyPond en ligne de commande. Par exemple, @example @{ @@ -2773,15 +3142,31 @@ messages et enregistrer le résultat de la fonction fichier. @example -lilypond fichier.ly >display.txt +lilypond fichier.ly >affichage.txt +@end example + +@funindex \void + +Vous noterez que LilyPond ne se contente pas de simplement afficher +l'expression musicale, mais procède aussi à son interprétation -- du +fait que @code{\displayLilyMusic} renvoie l'expression tout en +l'affichant. S'il est bien pratique d'insérer un +@code{\displayLilyMusic} dans une expression musicale pour en obtenir +des informations, l'interprétation de cette expression peut toutefois +être évitée en ajoutant un @code{\void} avant l'instruction@tie{}: + +@example +@{ + \void \displayLilyMusic \transpose c a, @{ c4 e g a bes @} +@} @end example -@node Affichage de la musique sous forme d'expression scheme -@subsection Affichage de la musique sous forme d'expression scheme +@node Affichage de la musique sous forme d'expression Scheme +@subsection Affichage de la musique sous forme d'expression Scheme @translationof Displaying scheme music expressions -Voir @rextend{Displaying music expressions}. +Voir @rextend{Affichage d'expressions musicales}. @node Enregistrement d'événements musicaux dans un fichier @@ -2800,7 +3185,7 @@ spécifique@tie{}: Pour chaque portée que comporte votre partition, vous obtiendrez un fichier @file{NOMFICHIER-PORTÉENOMMÉE.notes} ou @file{NOMFICHIER-unnamed-staff.notes}. Notez bien que si plusieurs -portées ne sont pas explicitement nomées, tous leurs événements seront +portées ne sont pas explicitement nommées, tous leurs événements seront regroupés et mélangés dans le même fichier. Le résultat ressemblera à ceci@tie{}: @@ -2822,16 +3207,14 @@ nombre de paramètres optionnels. @var{temps} @var{type} @var{...paramètres...} @end example -Ces informations peuvent faire l'objet d'un retraîtement par d'autres +Ces informations peuvent faire l'objet d'un retraitement par d'autres programmes, comme des scripts python, aux fins de recherche en analyse musicologique ou des expériences à partir du rendu de LilyPond. - @knownissues - Tous les événements ne sont pas pris en charge par @file{event-listener.ly}. Il s'agit en premier lieu d'une démonstration, un @qq{proof of concept} du potentiel de LilyPond. Si -certains des éléments que vous cherchez à obtenir n'apparaîssent pas, -recopiez le fichier @file{event-listener.ly} dans votre répoertoire et +certains des éléments que vous cherchez à obtenir n'apparaissent pas, +recopiez le fichier @file{event-listener.ly} dans votre répertoire et modifiez-le de telle sorte qu'il travaille selon vos attentes.