X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ffr%2Fnotation%2Fnotation-appendices.itely;h=ee1e153a6f361b79e93fcf622571abf38020504a;hb=a9a451e2316c2e94815e33d51eb42eaae3649384;hp=7bdeb62e12199ab5ab812fc907262791dfdb3d6e;hpb=141e1105f3624b1d7bae4fa6aa98c0c05f7f5b3c;p=lilypond.git diff --git a/Documentation/fr/notation/notation-appendices.itely b/Documentation/fr/notation/notation-appendices.itely index 7bdeb62e12..ee1e153a6f 100644 --- a/Documentation/fr/notation/notation-appendices.itely +++ b/Documentation/fr/notation/notation-appendices.itely @@ -1,14 +1,13 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- - @ignore - Translation of GIT committish: ad154dd57062e5138a8d15615c45ed3a203edc40 + Translation of GIT committish: 0512fcc5db9b050be664413ba0f79a3dcfc1028a 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.16.0" @c Translators: Frédéric Chiasson, Jean-Charles Malahieude @@ -21,19 +20,20 @@ * Modificateurs d'accord usuels:: * Accordages prédéfinis:: * Diagrammes d'accord prédéfinis:: +* Formats de papier prédéfinis:: * Instruments MIDI:: * Liste des couleurs:: * La fonte Feta:: * Styles de tête de note:: -* Text markup commands:: -* Text markup list commands:: +* Commandes pour markup:: +* Commandes pour liste de markups:: * Liste des caractères spéciaux:: * Liste des signes d'articulation:: * Notes utilisées en percussion:: * Glossaire technique:: * Liste des propriétés de contexte:: * Propriétés de mise en forme:: -* Fonctions musicales:: +* Fonctions musicales prédéfinies:: * Identificateurs de modification de contexte:: * Types de prédicats prédéfinis:: * Fonctions Scheme:: @@ -58,7 +58,7 @@ Le tableau suivant indique les différents modificateurs utilisables en mode accords (@code{\chordmode}) qui permettent d'obtenir les structures habituelles d'un certain nombre d'accords. -@multitable @columnfractions .2 .3 .2 .2 +@multitable {Treizieme de dominante} {Treizieme de dominante} {Modificateur(s)} {ExempleExemple} @item @b{Type d'accord} @@ -77,7 +77,7 @@ Tierce majeure et quinte juste @tab @code{5} ou rien @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:5 } @@ -90,7 +90,7 @@ Tierce mineure et quinte juste @tab @code{m} ou @code{m5} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:m } @@ -103,7 +103,7 @@ Tierce majeure et quinte augmentée @tab @code{aug} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:aug } @@ -116,7 +116,7 @@ Tierce mineure et quinte diminuée @tab @code{dim} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:dim } @@ -129,7 +129,7 @@ Triton majeur et septième mineure @tab @code{7} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:7 } @@ -142,7 +142,7 @@ Triton majeur et septième majeure @tab @code{maj7} ou @code{maj} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:maj7 } @@ -155,7 +155,7 @@ Triton mineur et septième mineure @tab @code{m7} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:m7 } @@ -168,7 +168,7 @@ Triton diminué et septième diminuée @tab @code{dim7} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:dim7 } @@ -181,7 +181,7 @@ Triton augmenté et septième mineure @tab @code{aug7} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:aug7 } @@ -194,7 +194,7 @@ Triton diminué et septième mineure @tab @code{m7.5-} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:m7.5- } @@ -205,11 +205,11 @@ Accord mineur avec septième majeure @tab Triton mineur et septième majeure @tab -@code{maj7.3-} +@code{m7+} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { - c1:maj7.3- + c1:m7+ } @end lilypond @@ -220,7 +220,7 @@ Triton majeur et sixte @tab @code{6} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:6 } @@ -233,7 +233,7 @@ Triton mineur et sixte @tab @code{m6} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:m6 } @@ -246,7 +246,7 @@ Septième de dominante et neuvième majeure @tab @code{9} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:9 } @@ -259,7 +259,7 @@ Septième majeure et neuvième majeure @tab @code{maj9} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:maj9 } @@ -272,7 +272,7 @@ Septième mineure et neuvième majeure @tab @code{m9} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:m9 } @@ -285,7 +285,7 @@ Neuvième de dominante et onzième juste @tab @code{11} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:11 } @@ -298,7 +298,7 @@ Neuvième majeure et onzième juste @tab @code{maj11} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:maj11 } @@ -311,7 +311,7 @@ Neuvième mineure et onzième juste @tab @code{m11} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:m11 } @@ -324,7 +324,7 @@ Neuvième de dominante et treizième majeure @tab @code{13} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:13 } @@ -337,7 +337,7 @@ Onzième de dominante et treizième majeure @tab @code{13.11} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:13.11 } @@ -350,7 +350,7 @@ Onzième majeure et treizième majeure @tab @code{maj13.11} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:maj13.11 } @@ -363,7 +363,7 @@ Onzième mineure et treizième majeure @tab @code{m13.11} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:m13.11 } @@ -376,7 +376,7 @@ Seconde majeure et quinte juste @tab @code{sus2} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:sus2 } @@ -389,7 +389,7 @@ Quarte juste et quinte juste @tab @code{sus4} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { c1:sus4 } @@ -402,7 +402,7 @@ Quinte juste @tab @code{1.5} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { \powerChords c1:1.5 @@ -416,7 +416,7 @@ Quinte juste et octave @tab @code{1.5.8} @tab -@lilypond[line-width=3\cm,noragged-right, notime] +@lilypond[line-width=2.8\cm,noragged-right, notime] \chordmode { \powerChords c1:1.5.8 @@ -442,16 +442,269 @@ dispose. La liste suivante répertorie les tablatures prédéfinies pour la guitare. -@lilypondfile{display-predefined-fretboards.ly} +@lilypondfile[line-width=15.5\cm]{display-predefined-fretboards.ly} La liste suivante répertorie les tablatures prédéfinies pour le ukulele. -@lilypondfile{display-predefined-ukulele-fretboards.ly} +@lilypondfile[line-width=15.5\cm]{display-predefined-ukulele-fretboards.ly} La liste suivante répertorie les tablatures prédéfinies pour la mandoline. -@lilypondfile{display-predefined-mandolin-fretboards.ly} +@lilypondfile[line-width=15.5\cm]{display-predefined-mandolin-fretboards.ly} + + +@node Formats de papier prédéfinis +@appendixsec Formats de papier prédéfinis +@translationof Predefined paper sizes + +Les formats de page sont définis dans le fichier @file{scm/paper.scm}. + +@noindent +@strong{La série A @qq{ISO 216}} +@multitable {@code{"government-letter "}} { (abcd x abcd mm)} +@item "a10" +@tab (26 x 37 mm) +@item "a9" +@tab (37 x 52 mm) +@item "a8" +@tab (52 x 74 mm) +@item "a7" +@tab (74 x 105 mm) +@item "a6" +@tab (105 x 148 mm) +@item "a5" +@tab (148 x 210 mm) +@item "a4" +@tab (210 x 297 mm) +@item "a3" +@tab (297 x 420 mm) +@item "a2" +@tab (420 x 594 mm) +@item "a1" +@tab (594 x 841 mm) +@item "a0" +@tab (841 x 1189 mm) +@end multitable + +@noindent +@strong{La série B @qq{ISO 216}} +@multitable {@code{"government-letter "}} { (abcd x abcd mm)} +@item "b10" +@tab (31 x 44 mm) +@item "b9" +@tab (44 x 62 mm) +@item "b8" +@tab (62 x 88 mm) +@item "b7" +@tab (88 x 125 mm) +@item "b6" +@tab (125 x 176 mm) +@item "b5" +@tab (176 x 250 mm) +@item "b4" +@tab (250 x 353 mm) +@item "b3" +@tab (353 x 500 mm) +@item "b2" +@tab (500 x 707 mm) +@item "b1" +@tab (707 x 1000 mm) +@item "b0" +@tab (1000 x 1414 mm) +@end multitable + +@noindent +@strong{Deux tailles étendues, définies par la @qq{DIN 476}} +@multitable {@code{"government-letter "}} { (abcd x abcd mm)} +@item "4a0" +@tab (1682 x 2378 mm) +@item "2a0" +@tab (1189 x 1682 mm) +@end multitable + +@noindent +@strong{La série C standard @qq{ISO 269}} +@multitable {@code{"government-letter "}} { (abcd x abcd mm)} +@item "c10" +@tab (28 x 40 mm) +@item "c9" +@tab (40 x 57 mm) +@item "c8" +@tab (57 x 81 mm) +@item "c7" +@tab (81 x 114 mm) +@item "c6" +@tab (114 x 162 mm) +@item "c5" +@tab (162 x 229 mm) +@item "c4" +@tab (229 x 324 mm) +@item "c3" +@tab (324 x 458 mm) +@item "c2" +@tab (458 x 648 mm) +@item "c1" +@tab (648 x 917 mm) +@item "c0" +@tab (917 x 1297 mm) +@end multitable + +@noindent +@strong{Formats nord américains} +@multitable {@code{"government-letter "}} { (abcd x abcd mm)} +@item "junior-legal" +@tab (8.0 x 5.0 in) +@item "legal" +@tab (8.5 x 14.0 in) +@item "ledger" +@tab (17.0 x 11.0 in) +@item "letter" +@tab (8.5 x 11.0 in) +@item "tabloid" +@tab (11.0 x 17.0 in) +@item "11x17" +@tab (11.0 x 17.0 in) +@item "17x11" +@tab (17.0 x 11.0 in) +@end multitable + +@noindent +@strong{Government-letter, défini par le @emph{IEEE Printer Working +Group}, à l'usage des enfants} +@multitable {@code{"government-letter "}} { (abcd x abcd mm)} +@item "government-letter" +@tab (8 x 10.5 in) +@item "government-legal" +@tab (8.5 x 13.0 in) +@item "philippine-legal" +@tab (8.5 x 13.0 in) +@end multitable + +@noindent +@strong{Formats ANSI} +@multitable {@code{"government-letter "}} { (abcd x abcd mm)} +@item "ansi a" +@tab (8.5 x 11.0 in) +@item "ansi b" +@tab (17.0 x 11.0 in) +@item "ansi c" +@tab (17.0 x 22.0 in) +@item "ansi d" +@tab (22.0 x 34.0 in) +@item "ansi e" +@tab (34.0 x 44.0 in) +@item "engineering f" +@tab (28.0 x 40.0 in) +@end multitable + +@noindent +@strong{Formats nord américains pour l'architecture} +@multitable {@code{"government-letter "}} { (abcd x abcd mm)} +@item "arch a" +@tab (9.0 x 12.0 in) +@item "arch b" +@tab (12.0 x 18.0 in) +@item "arch c" +@tab (18.0 x 24.0 in) +@item "arch d" +@tab (24.0 x 36.0 in) +@item "arch e" +@tab (36.0 x 48.0 in) +@item "arch e1" +@tab (30.0 x 42.0 in) +@end multitable + +@noindent +@strong{Formats anciens, toujours en vigueur dans le Royaume Uni} +@multitable {@code{"government-letter "}} { (abcd x abcd mm)} +@item "statement" +@tab (5.5 x 8.5 in) +@item "half letter" +@tab (5.5 x 8.5 in) +@item "quarto" +@tab (8.0 x 10.0 in) +@item "octavo" +@tab (6.75 x 10.5 in) +@item "executive" +@tab (7.25 x 10.5 in) +@item "monarch" +@tab (7.25 x 10.5 in) +@item "foolscap" +@tab (8.27 x 13.0 in) +@item "folio" +@tab (8.27 x 13.0 in) +@item "super-b" +@tab (13.0 x 19.0 in) +@item "post" +@tab (15.5 x 19.5 in) +@item "crown" +@tab (15.0 x 20.0 in) +@item "large post" +@tab (16.5 x 21.0 in) +@item "demy" +@tab (17.5 x 22.5 in) +@item "medium" +@tab (18.0 x 23.0 in) +@item "broadsheet" +@tab (18.0 x 24.0 in) +@item "royal" +@tab (20.0 x 25.0 in) +@item "elephant" +@tab (23.0 x 28.0 in) +@item "double demy" +@tab (22.5 x 35.0 in) +@item "quad demy" +@tab (35.0 x 45.0 in) +@item "atlas" +@tab (26.0 x 34.0 in) +@item "imperial" +@tab (22.0 x 30.0 in) +@item "antiquarian" +@tab (31.0 x 53.0 in) +@end multitable + +@noindent +@strong{Formats de base PA4} +@multitable {@code{"government-letter "}} { (abcd x abcd mm)} +@item "pa0" +@tab (840 x 1120 mm) +@item "pa1" +@tab (560 x 840 mm) +@item "pa2" +@tab (420 x 560 mm) +@item "pa3" +@tab (280 x 420 mm) +@item "pa4" +@tab (210 x 280 mm) +@item "pa5" +@tab (140 x 210 mm) +@item "pa6" +@tab (105 x 140 mm) +@item "pa7" +@tab (70 x 105 mm) +@item "pa8" +@tab (52 x 70 mm) +@item "pa9" +@tab (35 x 52 mm) +@item "pa10" +@tab (26 x 35 mm) +@end multitable + +@noindent +@strong{Format utilisé en Asie du Sudest et en Australie} +@multitable {@code{"government-letter "}} { (abcd x abcd mm)} +@item "f4" +@tab (210 x 330 mm) +@end multitable + +@noindent +@strong{Format spécifique aux courts exemples @code{@@lilypond} de la +documentation, basé sur un A8 à l'italienne.} +@multitable {@code{"government-letter "}} { (abcd x abcd mm)} +@item "a8landscape" +@tab (74 x 52 mm) +@end multitable @node Instruments MIDI @@ -514,13 +767,14 @@ cello lead 6 (voice) @appendixsec Liste des couleurs @translationof List of colors + @subsubheading Couleurs de base La syntaxe appropriée à la gestion des couleurs est traitée au chapitre @ref{Coloration d'objets}. -@cindex Liste des couleurs -@cindex Couleurs, liste +@cindex liste des couleurs +@cindex couleurs, liste @verbatim black white red green @@ -535,13 +789,13 @@ darkcyan darkmagenta darkyellow Les noms de couleur X peuvent s'employer de différentes manières. Un nom de couleur peut s'écrire sous la forme d'un mot composé et sans -espace auquel chaque élément prend un initiale capitalisée (p.ex. +espace auquel chaque élément prend un initiale capitalisée (p. ex. @code{LightSlateBlue}). Il peut aussi s'exprimer sous la forme d'une suite de mots, auquel cas les initiales ne sont pas capitalisées -(p.ex. @code{light@tie{}slate@tie{}blue}). +(p. ex. @code{light slate blue}). Le @emph{gris} accepte aussi bien l'orthographe @qq{grey} que -@qq{gray} (p.ex. @code{DarkSlateGray}). +@qq{gray} (p. ex. @code{DarkSlateGray}). Certains noms peuvent prendre un suffixe numérique, comme @code{LightSalmon4}. @@ -584,7 +838,7 @@ LightGreen @subsubheading Noms de couleur avec suffixe numérique Les couleurs suivantes acceptent un suffixe numérique @var{N} compris -entre 1 et 4. +entre 1 et 4. @verbatim snowN seashellN AntiqueWhiteN bisqueN PeachPuffN @@ -622,17 +876,16 @@ où @var{N} est compris entre 0 et 100. @appendixsec La fonte Feta @translationof The Feta font -@cindex Feta font -@cindex Font, Feta +@cindex Feta, fonte +@cindex fonte Feta Voici, regroupés par type, les différents symboles de la fonte Emmentaler qui peuvent s'inclure directement dans un objet @emph{markup}. Pour ce faire, il suffit d'employer le nom du glyphe, -comme dans @w{@code{g^\markup @{\musicglyph #"scripts.segno" @}}} ou -@w{@code{\markup @{\musicglyph #"five"@}}}. Pour de plus amples +comme dans @code{g^\markup @{\musicglyph #"scripts.segno" @}} ou +@code{\markup @{\musicglyph #"five"@}}. Pour de plus amples informations, reportez-vous au chapitre @ref{Mise en forme du texte}. - @menu * Glyphes de clef:: * Glyphes de métrique:: @@ -658,6 +911,7 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. * Glyphes de style néomensural:: * Glyphes de style Petrucci:: * Glyphes de style Solesmes:: +* Glyphes de style kiévien:: @end menu @@ -925,6 +1179,17 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @end lilypond +@node Glyphes de style kiévien +@unnumberedsubsec Glyphes de style kiévien +@translationof Kievan Notation glyphs + +@lilypond[quote] +\include "font-table.ly" +\markuplist \override-lines #'(word-space . 4) + \doc-chars #kievan +@end lilypond + + @node Styles de tête de note @appendixsec Styles de tête de note @translationof Note head styles @@ -934,22 +1199,22 @@ Voici les différents styles de tête de note disponibles. @lilypondfile[noindent]{note-head-style.ly} -@node Text markup commands -@appendixsec Text markup commands +@node Commandes pour markup +@appendixsec Commandes pour markup @translationof Text markup commands Les commandes suivantes peuvent être utilisées dans un bloc -@code{\markup @{ @}}. +@code{\markup @{ @}}. @include markup-commands.tely -@node Text markup list commands -@appendixsec Text markup list commands +@node Commandes pour liste de markups +@appendixsec Commandes pour liste de markups @translationof Text markup list commands Les commandes suivantes peuvent être utilisées dans un -bloc @code{\markuplist @{ @}}. +bloc @code{\markuplist @{ @}}. @include markup-list-commands.tely @@ -958,16 +1223,16 @@ bloc @code{\markuplist @{ @}}. @appendixsec Liste des caractères spéciaux @translationof List of special characters -Voici un table des caractères spéciaux disponibles. Pour plus de +Voici une table des caractères spéciaux disponibles. Pour plus de précisions, voir @ref{Équivalents ASCII}. Cette liste utilise la syntaxe HTML, à l'instar de la plupart des -caractères qui la composent@tie{}; les autres sont inspirés du langage +caractères qui la composent ; les autres sont inspirés du langage @LaTeX{}. -Les caractères sont ici inclus dans une boîte, de telle sorte que leur -taille soint mise en évidence, et un léger décalage a été appliqué pour -les décoller de l'encadrement. +Les caractères sont ici inclus dans une boîte, de façon à mettre leur +taille en évidence, et un léger décalage a été appliqué pour les +décoller de l'encadrement. @lilypond[quote] \include "special-characters.ly" @@ -979,11 +1244,13 @@ les décoller de l'encadrement. @translationof List of articulations @cindex accent +@cindex circulus @cindex marcato @cindex staccatissimo @cindex espressivo @cindex point d'orgue @cindex point d'arrêt +@cindex flageolet @cindex staccato @cindex portato @cindex tenuto @@ -991,7 +1258,7 @@ les décoller de l'encadrement. @cindex pousser l'archet @cindex bouché @cindex sourdine -@cindex orgue, marque de pédale d' +@cindex orgue, marque de pédale @cindex grupetto @cindex ouvert @cindex flageolet @@ -1002,12 +1269,13 @@ les décoller de l'encadrement. @cindex pouce @cindex segno @cindex coda +@cindex snappizzicato @cindex varcoda @cindex pointe @cindex talon Voici la liste exhaustive des symboles prédéfinis et que vous pouvez -attacher à une note (p.ex. @code{c\accent})@tie{}: +attacher à une note (p. ex. @code{c\accent}) : @c Articulations and ornamentations @c Fingering instructions (for "thumb") @@ -1018,7 +1286,6 @@ attacher à une note (p.ex. @code{c\accent})@tie{}: @c Custom percussion staves (for "halfopen" -- not yet funindexed) @c References for wind instruments (for "open"/"stopped" -- not yet funindexed) - @menu * Scripts d'articulation:: * Scripts d'ornement:: @@ -1038,6 +1305,7 @@ attacher à une note (p.ex. @code{c\accent})@tie{}: \new RhythmicStaff { \scriptStaff #articulations } @end lilypond + @node Scripts d'ornement @unnumberedsubsec Scripts d'ornement @translationof Ornament scripts @@ -1047,6 +1315,7 @@ attacher à une note (p.ex. @code{c\accent})@tie{}: \new RhythmicStaff { \scriptStaff #ornaments } @end lilypond + @node Scripts de point d'orgue et point d'arrêt @unnumberedsubsec Scripts de point d'orgue et point d'arrêt @translationof Fermata scripts @@ -1056,6 +1325,7 @@ attacher à une note (p.ex. @code{c\accent})@tie{}: \new RhythmicStaff { \scriptStaff #fermatas } @end lilypond + @node Scripts spécifiques à certains instruments @unnumberedsubsec Scripts spécifiques à certains instruments @translationof Instrument-specific scripts @@ -1065,6 +1335,7 @@ attacher à une note (p.ex. @code{c\accent})@tie{}: \new RhythmicStaff { \scriptStaff #instrument-specific } @end lilypond + @node Scripts de reprise et de répétition @unnumberedsubsec Scripts de reprise et de répétition @translationof Repeat sign scripts @@ -1074,6 +1345,7 @@ attacher à une note (p.ex. @code{c\accent})@tie{}: \new RhythmicStaff { \scriptStaff #repeats } @end lilypond + @node Scripts pour musique ancienne @unnumberedsubsec Scripts pour musique ancienne @translationof Ancient scripts @@ -1089,28 +1361,391 @@ attacher à une note (p.ex. @code{c\accent})@tie{}: @appendixsec Notes utilisées en percussion @translationof Percussion notes +@cindex percussions, nom des notes @lilypondfile[quote]{percussion-chart.ly} - @node Glossaire technique @appendixsec Glossaire technique @translationof Technical glossary -@untranslated +Ce glossaire regroupe les termes techniques et concepts utilisés en +interne par LilyPond. Ils apparaissent aussi bien dans les manuels, que +sur les listes de diffusion et dans le code source. + +@menu +* alist (liste associative):: +* callback (rappel):: +* closure (clôture):: +* glyphe:: +* grob (objet graphique):: +* inaltérable:: +* interface:: +* lexer (analyseur lexical):: +* altérable:: +* output-def (définition de sortie):: +* parser (analyseur syntaxique):: +* variable de l'analyseur grammatical:: +* prob (objet de propriété):: +* clôture simple:: +* smob (objet Scheme):: +* stencil:: +@end menu + -@unnumberedsubsec callback -@unnumberedsubsec glyph -@unnumberedsubsec grob +@node alist (liste associative) +@unnumberedsubsec alist (liste associative) +@translationof alist + +@cindex alist +@cindex liste associative + +Une liste associative -- @strong{alist} pour @emph{association list} -- +est une paire Scheme qui associe une valeur à une clé : +@code{(clé . valeur)}. Le fichier @file{scm/lily.scm} contient par +exemple une @emph{alist} @w{@qq{type-p-name-alist}} qui associe certains +types de prédicat (p. ex. @code{ly:music?}) à des noms (p. ex. +@qq{music}) de telle sorte qu'une erreur lors d'un contrôle de typage +puisse être rapportée en console avec mention du type de prédicat +attendu. + + +@node callback (rappel) +@unnumberedsubsec callback (rappel) +@translationof callback + +@cindex callback +@cindex rappel + +Un @strong{rappel}, @emph{callback} en anglais, est une routine, +fonction ou méthode qui est passée en argument à une autre fonction. +Cette dernière peut alors faire usage de cette fonction de rappel comme +de n'importe quelle autre fonction, alors qu'elle ne la connaît pas par +avance. Cette façon de procéder permet à des couches logicielles de bas +niveau d'appeler des fonctions définies à des niveaux plus élevés. +LilyPond utilise abondamment les @emph{callbacks} afin que le code +Scheme saisi par l'utilisateur puisse définir les actions de bas niveau +à opérer. + + +@node closure (clôture) +@unnumberedsubsec closure (clôture) +@translationof closure + +@cindex clôture +@cindex simple closure + +En Scheme, une @strong{clôture} (en anglais, @emph{closure}) est créée +lorsqu'une fonction, généralement une expression lambda, est passée en +tant que variable. La clôture comporte, en plus du code de la fonction, +des références à des variables libres dans l'environnement lexical -- +variables utilisées dans l'expression mais définies ailleurs. Lorsque +la fonction est par la suite appliquée aux différents arguments, les +références aux variables libres, capturées par la clôture, permettent +d'obtenir la valeur de ces variables libres qui sera utilisée lors des +calculs. L'une des propriétés intéressantes des clôtures est la +rétention de la valeur de variables internes tout au long des +différentes invocations, leur état étant alors persistant. + +Une @strong{clôture simple} -- @emph{simple closure} en anglais -- est +une clôture ne comportant pas de variable libre, et donc pas de +référence à des variables libres. + +Une clôture simple est représentée dans LilyPond par un objet Scheme +(un @emph{smob}) contenant l'expression et la méthode pour appliquer +cette expression à la liste d'arguments qui lui est passée. + + +@node glyphe +@unnumberedsubsec glyphe +@translationof glyph + +@cindex glyphe +@cindex fonte +@cindex type de caractère + +Un @strong{glyphe} est une représentation graphique particulière d'un +caractère typographique ou d'une combinaison de deux caractères formant +une ligature. Un jeu de glyphes aux mêmes style et allure constitue une +fonte ; un jeu de fontes comprenant plusieurs styles et tailles constitue +un type de caractère. + +@seealso +Manuel de notation : +@ref{Fontes}, +@ref{Caractères spéciaux}. + + +@node grob (objet graphique) +@unnumberedsubsec grob (objet graphique) +@translationof grob + +@cindex grob +@cindex graphique, objet +@cindex rendu, objets de +@cindex objets de rendu + +Dans LilyPond, les objets représentants les différents éléments de +notation, comme les têtes de note, hampes, liaisons, doigtés, clefs etc. +sont appelés « objets de rendu » ou objet graphique -- en anglais +@emph{GRaphical OBjects} couramment abrégé en @strong{grob}. Ils sont +représentés par des instances de la classe @code{grob}. + +@seealso +Manuel d'initiation : +@rlearning{Objets et interfaces}, +@rlearning{Conventions de nommage des objets et propriétés}, +@rlearning{Propriétés des objets de rendu}. + +Référence des propriétés internes : +@rinternals{grob-interface}, +@rinternals{All layout objects}. + + +@node inaltérable +@unnumberedsubsec inaltérable +@translationof immutable + +@cindex inaltérables, objets +@cindex inaltérables, propriétés +@cindex propriétés communes + +Un objet est dit @strong{inaltérable} -- @emph{immutable} en anglais -- +dès lors que son état ne peut être modifié après sa création ; les +objets altérables, à l'inverse, peuvent être modifiés après création. + +Pour LilyPond, une propriété est inaltérable ou commune lorsqu'elle +définit les style ou le comportement par défaut d'objets graphiques ; +une telle propriété est partagée par un certain nombre de @emph{grobs}. +En apparente contradiction avec ce que leur nom laisse accroire, de +telles propriétés peuvent être adaptées par @code{\override} et +@code{\revert}. + +@seealso +Manuel de notation : +@ref{altérable}. + + +@node interface @unnumberedsubsec interface -@unnumberedsubsec lexer -@unnumberedsubsec output-def -@unnumberedsubsec parser -@unnumberedsubsec parser variable -@unnumberedsubsec prob -@unnumberedsubsec simple-closure -@unnumberedsubsec smob +@translationof interface + +@cindex interface +@cindex grob-interface +@cindex objet graphique, interface + +Les actions et propriétés communes à plusieurs objets graphiques sont +regroupées dans un objet appelé @code{grob-interface}, ou « interface » +pour faire court. + +@seealso +Manuel d'initiation : +@rlearning{Objets et interfaces}, +@rlearning{Conventions de nommage des objets et propriétés}, +@rlearning{Propriétés listées par interface}. + +Manuel de notation : +@ref{Interfaces de rendu}. + +Référence des propriétés internes : +@rinternals{Graphical Object Interfaces}. + + +@node lexer (analyseur lexical) +@unnumberedsubsec lexer (analyseur lexical) +@translationof lexer + +@cindex lexer +@cindex analyse lexicale +@cindex Flex + +Un @strong{lexer} est un programme chargé de convertir une séquence de +caractères en une séquence de jetons. Cette opération s'appelle +l'analyse lexicale. L'analyseur lexical de LilyPond convertit le flot +d'information contenu dans un fichier @file{.ly} en flot de jetons qui +pourront être traités lors de l'étape suivant, l'analyse +grammaticale abordée à la rubrique @ref{parser (analyseur syntaxique)}. +L'analyseur lexical de LilyPond repose sur @code{Flex} ; les règles +lexicales sont regroupées dans le fichier @file{lily/lexer.ll}. Ce +fichier, partie intégrante des sources, n'est pas distribué avec les +programmes binaires de LilyPond. + + +@node altérable +@unnumberedsubsec altérable +@translationof mutable + +@cindex altérables, objets et propriétés +@cindex propriétés altérables +@cindex objets altérables + +Un objet est dit @strong{altérable} -- @emph{mutable} en anglais -- +lorsque son état est sujet à modification après sa création, à l'inverse +des objets inaltérables dont l'état est figé dès leur création. + +Les propriétés altérables contiennent, pour LilyPond, des valeurs +spécifiques à un objet graphique. En particulier, les listes d'autres +objets ou résultats de calculs sont enregistrés sous dorme de propriétés +altérables. + +@seealso +Manuel de notation : +@ref{inaltérable}. + + +@node output-def (définition de sortie) +@unnumberedsubsec output-def (définition de sortie) +@translationof output-def + +@cindex output-def +@cindex sortie, définition +@cindex définition de sortie + +Une instance de la classe @code{Output-def} contient les méthodes et +structures des données associées à un bloc de sortie. Ces instances +sont créées par les blocs @code{\midi}, @code{\layout} et @code{\paper}. + + +@node parser (analyseur syntaxique) +@unnumberedsubsec parser (analyseur syntaxique) +@translationof parser + +@cindex parser +@cindex analyseur syntaxique +@cindex Bison +@cindex grammaire de LilyPond +@cindex BNF + +Un analyseur syntaxique -- @strong{parser} en anglais -- est un +programme qui analyse la séquence de jetons produite par l'analyseur +lexical pour en déterminer la structure grammaticale. Les jetons sont, +pour ce faire, regroupés progressivement en tronçons plus importants, +selon des règles grammaticales. Lorsque la séquence de jetons est +valide, les produit final est une arborescence de jetons ayant à sa base +le symbole grammatical de début. Dès lors que cette étape n'est pas +concluante, le fichier est déclaré invalide ; un message approprié est +alors émis. Les différents regroupements syntaxiques ainsi que les +règles de construction des regroupements relatifs à la grammaire de +LilyPond sont définis dans le fichier @file{lily/parser.yy} et présentés +selon la forme de Backus-Naur (BNF) à l'annexe +@ref{Grammaire de LilyPond}. Ce fichier est utilisé par le +générateur de @emph{parser} Bison lors de la construction du programme. +Partie intégrante des sources, il n'est pas distribué avec les +programmes binaires de LilyPond. + + +@node variable de l'analyseur grammatical +@unnumberedsubsec variable de l'analyseur grammatical +@translationof parser variable + +@cindex parser, variable +@cindex Scheme, variable +@cindex globale, variable +@cindex afterGraceFraction +@cindex musicQuotes +@cindex mode +@cindex output-count +@cindex output-suffix +@cindex partCombineListener +@cindex pitchnames +@cindex toplevel-bookparts +@cindex toplevel-scores +@cindex showLastLength +@cindex showFirstLength + +Il s'agit de variables définies directement en Scheme. Dans la mesure +où leur champ sémantique peut porter à confusion, il est fortement +déconseillé de les utiliser tels quels. + +La modification des valeurs de l'une de ces variables dans un fichier +@file{.ly} sera effective de manière globale. Les valeurs modifiées, +sauf à être explicitement remises à leur état d'origine, affecteront +tous les blocs @code{\score} rencontrés, y compris s'ils proviennent +d'autres fichiers ajoutés par une commande @code{\include}. Ceci peut +avoir des conséquences inattendues et les erreurs qui pourraient en +découler difficiles à localiser dans le cadre d'un projet d'envergure. + +LilyPond utilise les variables suivantes : + +@itemize +@item afterGraceFraction +@item musicQuotes +@item mode +@item output-count +@item output-suffix +@item partCombineListener +@item pitchnames +@item toplevel-bookparts +@item toplevel-scores +@item showLastLength +@item showFirstLength +@end itemize + + +@node prob (objet de propriété) +@unnumberedsubsec prob (objet de propriété) +@translationof prob + +@cindex prob +@cindex propriété objet +@cindex objet de propriété + +Les objets de propriété -- @strong{probs} pour @emph{PRoperty OBjects} +-- sont des instances de la classe @code{Prob}, une classe de base +simple pour les objets qui disposent de de listes associatives de +propriétés altérables et inaltérables ainsi que les méthodes pour les +manipuler. Les classes @code{Music} et @code{Stream_event} dérivent +d'un @code{prob}. Les instances de la classe @code{prob} se créent +aussi pour garder trace du contenu des systèmes une fois formatés et +des blocs de titrage lors de la phase de mise en forme des pages. + + +@node clôture simple +@unnumberedsubsec clôture simple +@translationof simple closure + +Voir @ref{closure (clôture)}. + + +@node smob (objet Scheme) +@unnumberedsubsec smob (objet Scheme) +@translationof smob + +@cindex smob +@cindex Scheme, objet +@cindex objet Scheme + +Les objets Scheme -- @strong{Smobs} pour @emph{ScheMe OBjects} -- font +partie du mécanisme utilisé par l'interpréteur Guile pour exporter en +code Scheme les objets C ou C++. Dans LilyPond, les @emph{smobs} sont +créés, grâce à des macros, à partir d'objets C++. On peut distinguer +deux types d'objets @emph{smob} : des @emph{smobs} simples destinés aux +objets inaltérables comme les nombres par exemples, et des @emph{smobs} +complexes utilisés pour des objets possédant une identité. De plus +amples informations sont disponibles dans les sources de LilyPond, au +sein du fichier @file{lily/includes/smob.hh}. + + +@node stencil @unnumberedsubsec stencil +@translationof stencil + +@cindex stencil + +Une instance de la classe @strong{stencil} comporte l'information +nécessaire à l'impression d'un objet typographique. Il s'agit d'un +@emph{smob} simple qui contient un espace de confinement qui définit +l'envergure verticale et horizontale de l'objet ainsi qu'une expression +Scheme qui imprimera l'objet après évaluation. Les stencils peuvent se +combiner et adopter une forme plus complexe définie par une arborescence +d'expressions Scheme des stencils qui la composent. + +La propriété @code{stencil}, qui permet de connecter un @emph{grob} à +son stencil, est définie par l'interface @code{grob-interface}. + +@seealso +Référence des propriétés internes : +@rinternals{grob-interface}. @node Liste des propriétés de contexte @@ -1127,8 +1762,8 @@ attacher à une note (p.ex. @code{c\accent})@tie{}: @include layout-properties.tely -@node Fonctions musicales -@appendixsec Fonctions musicales +@node Fonctions musicales prédéfinies +@appendixsec Fonctions musicales prédéfinies @translationof Available music functions @include identifiers.tely