X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ffr%2Fnotation%2Fnotation-appendices.itely;h=baf8dca02692e8d3e031e4d76722f4ce38000167;hb=18d03fa6a724b0102ccc47d194209802cea02f2e;hp=a9c1cfa494f69f84d0df545d128443c7c8c260d2;hpb=fa1931081ef5f8edb7ba02587bb901b7f523ef30;p=lilypond.git diff --git a/Documentation/fr/notation/notation-appendices.itely b/Documentation/fr/notation/notation-appendices.itely index a9c1cfa494..baf8dca026 100644 --- a/Documentation/fr/notation/notation-appendices.itely +++ b/Documentation/fr/notation/notation-appendices.itely @@ -1,14 +1,14 @@ @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*- @ignore - Translation of GIT committish: 217cd2b9de6e783f2a5c8a42be9c70a82195ad20 + Translation of GIT committish: 97f856e8c577fdf301ac2a15b336eae8729e53f7 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.12.0" +@c \version "2.19.28" @c Translators: Frédéric Chiasson, Jean-Charles Malahieude @@ -16,43 +16,30 @@ @appendix Tables du manuel de notation @translationof Notation manual tables -@c Please do not delete the following @ignore block. -@ignore -Note for editors and translators: In the following menu, two entries -are needed to link to a pair of automatically generated sections. -Please keep them and, if using emacs, do not run -texinfo-all-menus-update without manually restoring them back. These -menu entries are: - -* Text markup commands:: -* Text markup list commands:: - -and they should go just after -* Styles de tête de note:: - -and just before -* Liste des signes d'articulation:: -@end ignore - @menu * Table des noms d'accord:: * 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:: +* La fonte Emmentaler:: * Styles de tête de note:: -* Text markup commands:: -* Text markup list commands:: +* Styles de clef:: +* 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:: -@end menu +@end menu @node Table des noms d'accord @@ -69,370 +56,755 @@ les plus répandus, ainsi que ce qu'ils représentent. @appendixsec Modificateurs d'accord usuels @translationof Common chord modifiers -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. +Le tableau suivant indique les différents modificateurs qui permettent +d'obtenir les structures habituelles d'un certain nombre d'accords. -@multitable @columnfractions .2 .3 .2 .2 +@multitable @columnfractions .2 .25 .2 .15 .2 @item -@b{Type d'accord} +@b{Type} @tab -@b{Intervalles} +@b{Intervalle} @tab -@b{Modificateur(s)} +@b{Modificateur} @tab @b{Exemple} +@tab +@b{Résultat} @item Majeur @tab -Tierce mejeure et quinte juste +Tierce majeure @*et quinte juste @tab @code{5} ou rien @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:5 -} +@code{c1:5} +@tab +@lilypond[line-width=2.1\cm,notime] +<< + \chords { c1:5 } + \chordmode { c1:5 } +>> @end lilypond @item Mineur @tab -Tierce minaure et quinte juste +Tierce mineure @*et quinte juste @tab @code{m} ou @code{m5} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:m -} +@code{c1:m} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:m } + \chordmode { c1:m } +>> @end lilypond @item Augmenté @tab -Tierce majeure et quinte augmentée +Tierce majeure et @*quinte augmentée @tab @code{aug} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:aug -} +@code{c1:aug} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:aug } + \chordmode { c1:aug } +>> @end lilypond @item Diminué @tab -Tierce mineure et quinte diminuée +Tierce mineure et @*quinte diminuée @tab @code{dim} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:dim -} +@code{c1:dim} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:dim } + \chordmode { c1:dim } +>> @end lilypond @item Septième de dominante @tab -Triton majeur et septième mineure +Triton majeur et @*septième mineure @tab @code{7} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:7 -} +@code{c1:7} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:7 } + \chordmode { c1:7 } +>> @end lilypond @item Septième majeure @tab -Triton majeur et septième majeure +Triton majeur et @*septième majeure @tab -@code{maj7} or @code{maj} +@code{maj7} ou @code{maj} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:maj7 -} +@code{c1:maj7} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:maj7 } + \chordmode { c1:maj7 } +>> @end lilypond @item Septième mineure @tab -Triton mineur et septième mineure +Triton mineur et @*septième mineure @tab @code{m7} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:m7 -} +@code{c1:m7} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:m7 } + \chordmode { c1:m7 } +>> @end lilypond @item Septième diminuée @tab -Triton diminué et septième diminuée +Triton diminué et @*septième diminuée @tab @code{dim7} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:dim7 -} +@code{c1:dim7} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:dim7} + \chordmode { c1:dim7 } +>> @end lilypond @item Septième augmentée @tab -Triton augmenté et septième mineure +Triton augmenté et @*septième mineure @tab @code{aug7} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:aug7 -} +@code{c1:aug7} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:aug7 } + \chordmode { c1:aug7 } +>> @end lilypond @item Septième semi-diminuée @tab -Triton diminué et septième mineure +Triton diminué et @*septième mineure @tab @code{m7.5-} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:m7.5- -} +@code{c1:m7.5-} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:m7.5- } + \chordmode { c1:m7.5- } +>> @end lilypond @item Accord mineur avec septième majeure @tab -Triton mineur et septième majeure +Triton mineur et @*septième majeure @tab -@code{maj7.3-} +@code{m7+} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:maj7.3- -} +@code{c1:m7+} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:m7+ } + \chordmode { c1:m7+ } +>> @end lilypond @item Sixte majeure @tab -Triton majeur et sixte +Triton majeur @*et sixte @tab @code{6} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:6 -} +@code{c1:6} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:6 } + \chordmode { c1:6 } +>> @end lilypond @item Sixte mineure @tab -Triton mineur et sixte +Triton mineur @*et sixte @tab @code{m6} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:m6 -} +@code{c1:m6} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:m6 } + \chordmode { c1:m6 } +>> @end lilypond @item Neuvième de dominante @tab -Septième de dominante et neuvième majeure +Septième de dominante @*et neuvième majeure @tab @code{9} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:9 -} +@code{c1:9} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:9 } + \chordmode { c1:9 } +>> @end lilypond @item Neuvième majeure @tab -Septième majeure et neuvième majeure +Septième majeure et @*neuvième majeure @tab @code{maj9} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:maj9 -} +@code{c1:maj9} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:maj9 } + \chordmode { c1:maj9 } +>> @end lilypond @item Neuvième mineure @tab -Septième mineure et neuvième majeure +Septième mineure et @*neuvième majeure @tab @code{m9} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:m9 -} +@code{c1:m9} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:m9 } + \chordmode { c1:m9 } +>> @end lilypond @item Onzième de dominante @tab -Neuvième de dominante et onzième juste +Neuvième de dominante @*et onzième juste @tab @code{11} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:11 -} +@code{c1:11} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:11 } + \chordmode { c1:11 } +>> @end lilypond @item Onzième majeure @tab -Neuvième majeure et onzième juste +Neuvième majeure @*et onzième juste @tab @code{maj11} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:maj11 -} +@code{c1:maj11} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:maj11 } + \chordmode { c1:maj11 } +>> @end lilypond @item Onzième mineure @tab -Neuvième mineure et onzième juste +Neuvième mineure @*et onzième juste @tab @code{m11} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:m11 -} +@code{c1:m11} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:m11 } + \chordmode { c1:m11 } +>> @end lilypond @item -Trézième de dominante +Treizième de dominante @tab -Neuvième de dominante et trézième majeure +Neuvième de dominante @*et treizième majeure @tab @code{13} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:13 -} +@code{c1:13} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:13 } + \chordmode { c1:13 } +>> @end lilypond @item -Trézième de dominante +Treizième de dominante @tab -Onzième de dominante et trézième majeure +Onzième de dominante @*et treizième majeure @tab @code{13.11} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:13.11 -} +@code{c1:13.11} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords{ c1:13.11 } + \chordmode { c1:13.11 } +>> @end lilypond @item -Trézième majeure +Treizième majeure @tab -Onzième majeure et trézième majeure +Onzième majeure et @*treizième majeure @tab @code{maj13.11} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:maj13.11 -} +@code{c1:maj13.11} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:maj13.11 } + \chordmode { c1:maj13.11 } +>> @end lilypond @item -Trézième mineure +Treizième mineure @tab -Onzièmem mineure et trézième majeure +Onzième mineure et @*treizième majeure @tab @code{m13.11} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:m13.11 -} +@code{c1:m13.11} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:m13.11 } + \chordmode { c1:m13.11 } +>> @end lilypond @item Seconde suspendue @tab -Seconde majeure et quinte juste +Seconde majeure @*et quinte juste @tab @code{sus2} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:sus2 -} +@code{c1:sus2} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:sus2 } + \chordmode { c1:sus2 } +>> @end lilypond @item Quarte suspendue @tab -Quarte juste et quqinte juste +Quarte juste @*et quinte juste @tab @code{sus4} @tab -@lilypond[line-width=3\cm,noragged-right, notime] -\chordmode { - c1:sus4 -} +@code{c1:sus4} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +<< + \chords { c1:sus4 } + \chordmode { c1:sus4 } +>> +@end lilypond + +@item +Power chord @*(deux voix) +@tab +Quinte juste +@tab +@code{1.5} +@tab +@code{\powerChords c1:5} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] +\chordmode { \powerChords c1:5 } @end lilypond +@item +Power chord @*(trois voix) +@tab +Quinte juste @*et octave +@tab +@code{1.5.8} +@tab +@code{\powerChords c1:5.8} +@tab +@lilypond[line-width=2.1\cm,noragged-right,notime] + \chordmode { \powerChords c1:5.8 } +@end lilypond @end multitable +@node Accordages prédéfinis +@appendixsec Accordages prédéfinis +@translationof Predefined string tunings + +La liste suivante répertorie les différents accordages dont LilyPond +dispose. + +@lilypondfile{display-predefined-string-tunings.ly} + + @node Diagrammes d'accord prédéfinis @appendixsec Diagrammes d'accord prédéfinis @translationof Predefined fretboard diagrams -La liste suivante répertorie les tablatures prédéfinies pour la guitare. +@menu +* Diagrammes pour guitare:: +* Diagrammes pour ukulele:: +* Diagrammes pour mandoline:: +@end menu + + +@node Diagrammes pour guitare +@unnumberedsubsec Diagrammes pour guitare +@translationof Diagrams for Guitar + +@lilypondfile[line-width=15.5\cm]{display-predefined-fretboards.ly} + + +@node Diagrammes pour ukulele +@unnumberedsubsec Diagrammes pour ukulele +@translationof Diagrams for Ukulele + +@lilypondfile[line-width=15.5\cm]{display-predefined-ukulele-fretboards.ly} + + +@node Diagrammes pour mandoline +@unnumberedsubsec Diagrammes pour mandoline +@translationof Diagrams for Mandolin + +@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 -@lilypondfile{display-predefined-fretboards.ly} +@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 -La liste suivante répertorie les tablatures prédéfinies pour le ukulele. +@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 -@lilypondfile{display-predefined-ukulele-fretboards.ly} +@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 @appendixsec Instruments MIDI -@translationof MIDI instruments +@translationof MIDI instruments La liste suivante répertorie les différentes dénominations que vous -pouvez affecter à la propriété @code{midiInstrument}. +pouvez affecter à la propriété @code{midiInstrument}. L'ordre dans +lequel ils sont rangés, par colonne, correspond aux 128 programmes du +standard @emph{General MIDI}. @example acoustic grand contrabass lead 7 (fifths) @@ -485,13 +857,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 @@ -506,13 +879,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}). +(par ex. @code{light slate blue}). -Le @emph{gris} accepte aussi bien l'orthographe @qq{grey} que -@qq{gray} (p.ex. @code{DarkSlateGray}). +Le @emph{gris} accepte aussi bien l'orthographe @qq{grey} que +@qq{gray} (par ex. @code{DarkSlateGray}). Certains noms peuvent prendre un suffixe numérique, comme @code{LightSalmon4}. @@ -555,7 +928,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 @@ -589,21 +962,24 @@ greyN où @var{N} est compris entre 0 et 100. -@node La fonte Feta -@appendixsec La fonte Feta -@translationof The Feta font +@node La fonte Emmentaler +@appendixsec La fonte Emmentaler +@translationof The Emmentaler font -@cindex Feta font -@cindex Font, Feta +@cindex Emmentaler fonte +@cindex Fonte, Emmentaler +@cindex Feta fonte +@cindex Fonte, Feta +@cindex Parmesan font +@cindex Fonte, Parmesan 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 @code{g^\markup @{\musicglyph #"scripts.segno" @}} ou -@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:: @@ -621,6 +997,7 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. * Glyphes d'extrémité d'accolade:: * Glyphes de pédale:: * Glyphes d'accordéon:: +* Glyphes de liaison:: * Glyphes de style vaticana:: * Glyphes de style medicaea:: * Glyphes de style Hufnagel:: @@ -628,6 +1005,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 @@ -637,8 +1015,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #clefs +\markuplist \override-lines #'(word-space . 4) + \doc-chars #clefs @end lilypond @@ -648,8 +1026,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #timesig +\markuplist \override-lines #'(word-space . 4) + \doc-chars #timesig @end lilypond @@ -659,8 +1037,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #numbers +\markuplist \override-lines #'(word-space . 4) + \doc-chars #numbers @end lilypond @@ -670,8 +1048,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #accidentals +\markuplist \override-lines #'(word-space . 4) + \doc-chars #accidentals @end lilypond @@ -681,8 +1059,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #default-noteheads +\markuplist \override-lines #'(word-space . 4) + \doc-chars #default-noteheads @end lilypond @@ -692,8 +1070,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #special-noteheads +\markuplist \override-lines #'(word-space . 4) + \doc-chars #special-noteheads @end lilypond @@ -703,8 +1081,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #shape-note-noteheads +\markuplist \override-lines #'(word-space . 4) + \doc-chars #shape-note-noteheads @end lilypond @@ -714,8 +1092,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #rests +\markuplist \override-lines #'(word-space . 4) + \doc-chars #rests @end lilypond @@ -725,8 +1103,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #flags +\markuplist \override-lines #'(word-space . 4) + \doc-chars #flags @end lilypond @@ -736,8 +1114,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #dots +\markuplist \override-lines #'(word-space . 4) + \doc-chars #dots @end lilypond @@ -747,8 +1125,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #dynamics +\markuplist \override-lines #'(word-space . 4) + \doc-chars #dynamics @end lilypond @@ -758,8 +1136,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #scripts +\markuplist \override-lines #'(word-space . 4) + \doc-chars #scripts @end lilypond @@ -769,8 +1147,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #arrowheads +\markuplist \override-lines #'(word-space . 4) + \doc-chars #arrowheads @end lilypond @@ -780,8 +1158,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #brackettips +\markuplist \override-lines #'(word-space . 4) + \doc-chars #brackettips @end lilypond @@ -791,8 +1169,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #pedal +\markuplist \override-lines #'(word-space . 4) + \doc-chars #pedal @end lilypond @@ -802,8 +1180,19 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #accordion +\markuplist \override-lines #'(word-space . 4) + \doc-chars #accordion +@end lilypond + + +@node Glyphes de liaison +@unnumberedsubsec Glyphes de liaison +@translationof Tie glyphs + +@lilypond[quote] +\include "font-table.ly" +\markuplist \override-lines #'(word-space . 4) + \doc-chars #ties @end lilypond @@ -813,8 +1202,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #vaticana +\markuplist \override-lines #'(word-space . 4) + \doc-chars #vaticana @end lilypond @@ -824,8 +1213,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #medicaea +\markuplist \override-lines #'(word-space . 4) + \doc-chars #medicaea @end lilypond @@ -835,8 +1224,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #hufnagel +\markuplist \override-lines #'(word-space . 4) + \doc-chars #hufnagel @end lilypond @@ -846,8 +1235,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #mensural +\markuplist \override-lines #'(word-space . 4) + \doc-chars #mensural @end lilypond @@ -857,8 +1246,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #neomensural +\markuplist \override-lines #'(word-space . 4) + \doc-chars #neomensural @end lilypond @@ -868,8 +1257,8 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #petrucci +\markuplist \override-lines #'(word-space . 4) + \doc-chars #petrucci @end lilypond @@ -879,167 +1268,1499 @@ informations, reportez-vous au chapitre @ref{Mise en forme du texte}. @lilypond[quote] \include "font-table.ly" -\markuplines \override-lines #'(word-space . 4) - \doc-chars #solesmes +\markuplist \override-lines #'(word-space . 4) + \doc-chars #solesmes +@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 +@translationof Note head styles Voici les différents styles de tête de note disponibles. @lilypondfile[noindent]{note-head-style.ly} -Les commandes suivantes peuvent être utilisées dans un bloc -@code{\markup @{ @}}. - -@include markup-commands.tely +@node Styles de clef +@appendixsec Styles de clef +@translationof Clef styles +Le tableau suivant répertorie tous les styles de clef disponibles +ainsi que la position du @emph{do médium} par rapport à la clef. -Les commandes suivantes peuvent être utilisées dans un -bloc @code{\markuplines @{ @}}. +@multitable @columnfractions .30 .2 .30 .2 -@include markup-list-commands.tely +@headitem +Exemple +@tab +Résultat +@tab +Exemple +@tab +Résultat -@node Liste des signes d'articulation -@appendixsec Liste des signes d'articulation -@translationof List of articulations +@item +@code{\clef G} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef G c1 +@end lilypond -@cindex accent -@cindex marcato -@cindex staccatissimo -@cindex espressivo -@cindex point d'orgue -@cindex point d'arrêt -@cindex staccato -@cindex portato -@cindex tenuto -@cindex tirer l'archet -@cindex pousser l'archet -@cindex bouché -@cindex sourdine -@cindex orgue, marque de pédale d' -@cindex grupetto -@cindex ouvert -@cindex flageolet -@cindex trille -@cindex mordant -@cindex ornementation baroque -@cindex baroque, ornementation -@cindex pouce -@cindex segno -@cindex coda -@cindex varcoda +@tab +@code{\clef "G2"} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef "G2" +c1 +@end lilypond +@item +@code{\clef treble} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef treble +c1 +@end lilypond -Voici la liste exhaustive des symboles prédéfinis : +@tab +@code{\clef violin} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef violin +c1 +@end lilypond -@c Articulations and ornamentations -@c Fingering instructions (for "thumb") -@c Common notation for unfretted strings -@c Bowing indications -@c Harmonics -@c Snap (Bartók) pizzicato -@c Custom percussion staves (for "halfopen" -- not yet funindexed) -@c References for wind instruments (for "open"/"stopped" -- not yet funindexed) +@item +@code{\clef french} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef french +c1 +@end lilypond +@tab +@code{\clef GG} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef GG +c1 +@end lilypond -@menu -* Scripts d'articulation:: -* Scripts d'ornement:: -* Scripts de point d'orgue et point d'arrêt:: -* Scripts spécifiques à certains instruments:: -* Scripts de reprise et de répétition:: -* Scripts pour musique ancienne:: -@end menu +@item +@code{\clef tenorG} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef tenorG +c1 +@end lilypond +@tab +@code{\clef soprano} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef soprano +c1 +@end lilypond -@node Scripts d'articulation -@unnumberedsubsec Scripts d'articulation -@translationof Articulation scripts +@item +@code{\clef mezzosoprano} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef mezzosoprano +c1 +@end lilypond -@lilypond[quote] -\include "script-chart.ly" -\new RhythmicStaff { \scriptStaff #articulations } +@tab +@code{\clef C} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef C +c1 @end lilypond -@node Scripts d'ornement -@unnumberedsubsec Scripts d'ornement -@translationof Ornament scripts +@item +@code{\clef alto} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef alto +c1 +@end lilypond -@lilypond[quote] -\include "script-chart.ly" -\new RhythmicStaff { \scriptStaff #ornaments } +@tab +@code{\clef tenor} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef tenor +c1 @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 +@item +@code{\clef baritone} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef baritone +c1 +@end lilypond -@lilypond[quote] -\include "script-chart.ly" -\new RhythmicStaff { \scriptStaff #fermatas } +@tab +@code{\clef varC} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef varC +c1 @end lilypond -@node Scripts spécifiques à certains instruments -@unnumberedsubsec Scripts spécifiques à certains instruments -@translationof Instrument-specific scripts +@item +@code{\clef altovarC} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef altovarC +c1 +@end lilypond -@lilypond[quote] -\include "script-chart.ly" -\new RhythmicStaff { \scriptStaff #instrument-specific } +@tab +@code{\clef tenorvarC} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef tenorvarC +c1 @end lilypond -@node Scripts de reprise et de répétition -@unnumberedsubsec Scripts de reprise et de répétition -@translationof Repeat sign scripts +@item +@code{\clef baritonevarC} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef baritonevarC +c1 +@end lilypond -@lilypond[quote] -\include "script-chart.ly" -\new RhythmicStaff { \scriptStaff #repeats } +@tab +@code{\clef varbaritone} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef varbaritone +c1 @end lilypond -@node Scripts pour musique ancienne +@item +@code{\clef baritonevarF} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef baritonevarF +c1 +@end lilypond + +@tab +@code{\clef F} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef F +c1 +@end lilypond + +@item +@code{\clef bass} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef bass +c1 +@end lilypond + +@tab +@code{\clef subbass} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef subbass +c1 +@end lilypond + +@item +@code{\clef percussion} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\clef percussion +c1 +@end lilypond + +@tab +@c @example does not work as expected within multitables +@code{ +\new TabStaff @{ @* +@ @ \clef tab @* +@} +} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\new TabStaff { + \clef tab + c1 +} +@end lilypond + +@item +@c @example does not work as expected within multitables +@code{ +\new TabStaff @{ @* +@ @ \clef moderntab @* +@} +} +@tab +@lilypond[line-width=3\cm,notime,ragged-right,relative=1] +\new TabStaff { + \clef moderntab + c1 +} +@end lilypond + + +@end multitable + + +@node Commandes pour markup +@appendixsec Commandes pour @emph{markup} +@translationof Text markup commands + +Les commandes suivantes peuvent être utilisées dans un bloc +@code{\markup @{ @}}. + +@include markup-commands.tely + + +@node Commandes pour liste de markups +@appendixsec Commandes pour liste de @emph{markups} +@translationof Text markup list commands + +Les commandes suivantes peuvent être utilisées dans un +bloc @code{\markuplist @{ @}}. + +@include markup-list-commands.tely + + +@node Liste des caractères spéciaux +@appendixsec Liste des caractères spéciaux +@translationof List of special characters + +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 ; les autres sont inspirés du langage +@LaTeX{}. + +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" +@end lilypond + + +@node Liste des signes d'articulation +@appendixsec Liste des signes d'articulation +@translationof List of articulations + +Les listes qui suivent recensent les symboles prédéfinis dans le +glyphe Feta que vous pouvez attacher à une note (par ex. @code{f\accent} +ou @code{f->}). Chaque exemple illustre les trois positionnements : en +surplomb (@emph{up}), en dessous (@emph{down}) et à l'appréciation de +LilyPond (@emph{neutral}). + +@c Articulations and ornamentations +@c Fingering instructions (for "thumb") +@c Common notation for unfretted strings +@c Bowing indications +@c Harmonics +@c Snap (Bartók) pizzicato +@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:: +* Scripts de point d'orgue et point d'arrêt:: +* Scripts spécifiques à certains instruments:: +* Scripts de reprise et de répétition:: +* Scripts pour musique ancienne:: +@end menu + +@ignore +The @multitable @columnfraction value discrepancy between the first and +the remaining columns is deliberate; it seems (at least visually +anyway) the gap (after building the documentation) between first and +second column examples was always larger than between the remaining +columns - JL +@end ignore + + +@node Scripts d'articulation +@unnumberedsubsec Scripts d'articulation +@translationof Articulation scripts + +@cindex accent +@cindex espressivo +@cindex marcato +@cindex portato +@cindex staccatissimo +@cindex staccato +@cindex tenuto +@cindex pouce @emph{(thumb)} + +@multitable @columnfractions .22 .25 .25 .25 + +@item +@code{\accent} ou @code{->} +@lilypond[notime,relative=2] +f^\accent e,_\accent b'\accent +@end lilypond +@tab +@code{\espressivo} +@lilypond[notime,relative=2] +f^\espressivo e,_\espressivo b'\espressivo +@end lilypond +@tab +@code{\marcato} ou @code{-^} +@lilypond[notime,relative=2] +f^\marcato e,_\marcato b'\marcato +@end lilypond +@tab +@code{\portato} ou @code{-_} +@lilypond[notime,relative=2] +f^\portato e,_\portato b'\portato +@end lilypond + +@item +@code{\staccatissimo} @* ou @code{-!} +@lilypond[notime,relative=2] +f^\staccatissimo e,_\staccatissimo b'\staccatissimo +@end lilypond +@tab +@code{\staccato} ou @code{-.} +@lilypond[notime,relative=2] +f^\staccato e,_\staccato b'\staccato +@end lilypond +@tab +@code{\tenuto} ou @code{--} +@lilypond[notime,relative=2] +f^\tenuto e,_\tenuto b'\tenuto +@end lilypond + +@end multitable + + +@node Scripts d'ornement +@unnumberedsubsec Scripts d'ornement +@translationof Ornament scripts + +@cindex trille +@cindex mordant +@cindex grupetto + +@multitable @columnfractions .22 .25 .25 .25 + +@item +@code{\prall} +@lilypond[notime,relative=2] +f^\prall e,_\prall b'\prall +@end lilypond +@tab +@code{\prallup} +@lilypond[notime,relative=2] +f^\prallup e,_\prallup b'\prallup +@end lilypond +@tab +@code{\pralldown} +@lilypond[notime,relative=2] +f^\pralldown e,_\pralldown b'\pralldown +@end lilypond +@tab +@code{\upprall} +@lilypond[notime,relative=2] +f^\upprall e,_\upprall b'\upprall +@end lilypond + +@item +@code{\downprall} +@lilypond[notime,relative=2] +f^\downprall e,_\downprall b'\downprall +@end lilypond +@tab +@code{\prallprall} +@lilypond[notime,relative=2] +f^\prallprall e,_\prallprall b'\prallprall +@end lilypond +@tab +@code{\lineprall} +@lilypond[notime,relative=2] +f^\lineprall e,_\lineprall b'\lineprall +@end lilypond +@tab +@code{\prallmordent} +@lilypond[notime,relative=2] +f^\prallmordent e,_\prallmordent b'\prallmordent +@end lilypond + +@item +@code{\mordent} +@lilypond[notime,relative=2] +f^\mordent e,_\mordent b'\mordent +@end lilypond +@tab +@code{\upmordent} +@lilypond[notime,relative=2] +f^\upmordent e,_\upmordent b'\upmordent +@end lilypond +@tab +@code{\downmordent} +@lilypond[notime,relative=2] +f^\downmordent e,_\downmordent b'\downmordent +@end lilypond +@tab +@code{\trill} +@lilypond[notime,relative=2] +f^\trill e,_\trill b'\trill +@end lilypond + +@item +@code{\turn} +@lilypond[notime,relative=2] +f^\turn e,_\turn b'\reverseturn +@end lilypond +@tab +@code{\reverseturn} +@lilypond[notime,relative=2] +f^\reverseturn e,_\reverseturn b'\reverseturn +@end lilypond + +@end multitable + + +@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 + +@cindex point d'orgue +@cindex point d'arrêt + +@multitable @columnfractions .22 .25 .25 .25 + +@item +@code{\shortfermata} +@lilypond[notime,relative=2] +f^\shortfermata e,_\shortfermata b'\shortfermata +@end lilypond +@tab +@code{\fermata} +@lilypond[notime,relative=2] +f^\fermata e,_\fermata b'\fermata +@end lilypond +@tab +@code{\longfermata} +@lilypond[notime,relative=2] +f^\longfermata e,_\longfermata b'\longfermata +@end lilypond +@tab +@code{\verylongfermata} +@lilypond[notime,relative=2] +f^\verylongfermata e,_\verylongfermata b'\verylongfermata +@end lilypond + +@end multitable + + +@node Scripts spécifiques à certains instruments +@unnumberedsubsec Scripts spécifiques à certains instruments +@translationof Instrument-specific scripts + +@cindex flageolet +@cindex tirer l'archet +@cindex pousser l'archet +@cindex snappizzicato +@cindex bouché +@cindex sourdine +@cindex ouvert +@cindex orgue, marque de pédale +@cindex pointe +@cindex talon + +@multitable @columnfractions .22 .25 .25 .25 + +@item +@code{\upbow} +@lilypond[notime,relative=2] +f^\upbow e,_\upbow b'\upbow +@end lilypond +@tab +@code{\downbow} +@lilypond[notime,relative=2] +f^\downbow e,_\downbow b'\downbow +@end lilypond +@tab +@code{\flageolet} +@lilypond[notime,relative=2] +f^\flageolet e,_\flageolet b'\flageolet +@end lilypond +@tab +@code{\open} +@lilypond[notime,relative=2] +f^\open e,_\open b'\open +@end lilypond + +@item +@code{\halfopen} +@lilypond[notime,relative=2] +f^\halfopen e,_\halfopen b'\halfopen +@end lilypond +@tab +@code{\lheel} +@lilypond[notime,relative=2] +f^\lheel e,_\lheel b'\lheel +@end lilypond +@tab +@code{\rheel} +@lilypond[notime,relative=2] +f^\rheel e,_\rheel b'\rheel +@end lilypond +@tab +@code{\ltoe} +@lilypond[notime,relative=2] +f^\ltoe e,_\ltoe b'\ltoe +@end lilypond + +@item +@code{\rtoe} +@lilypond[notime,relative=2] +f^\rtoe e,_\rtoe b'\rtoe +@end lilypond +@tab +@code{\snappizzicato} +@lilypond[notime,relative=2] +f^\snappizzicato e,_\snappizzicato b'\snappizzicato +@end lilypond +@tab +@code{\stopped} ou @code{-+} +@lilypond[notime,relative=2] +f^\stopped e,_\stopped b'\stopped +@end lilypond + +@end multitable + + +@node Scripts de reprise et de répétition +@unnumberedsubsec Scripts de reprise et de répétition +@translationof Repeat sign scripts + +@cindex segno +@cindex coda +@cindex varcoda + +@multitable @columnfractions .22 .25 .25 .25 + +@item +@code{\segno} +@lilypond[notime,relative=2] +f^\segno e,_\segno b'\segno +@end lilypond +@tab +@code{\coda} +@lilypond[notime,relative=2] +f^\coda e,_\coda b'\coda +@end lilypond +@tab +@code{\varcoda} +@lilypond[notime,relative=2] +f^\varcoda e,_\varcoda b'\varcoda +@end lilypond + +@end multitable + + +@node Scripts pour musique ancienne @unnumberedsubsec Scripts pour musique ancienne @translationof Ancient scripts -@lilypond[quote] -\include "script-chart.ly" +@cindex accentus +@cindex circulus +@cindex ictus +@cindex semicirculus +@cindex signumcongruentiae + +@multitable @columnfractions .22 .25 .25 .25 + +@item +@code{\accentus} +@lilypond[notime] +\include "gregorian.ly" +\new VaticanaStaff { e'^\accentus s4 f_\accentus s4 b\accentus} +@end lilypond +@tab +@code{\circulus} +@lilypond[notime] +\include "gregorian.ly" +\new VaticanaStaff { e'^\circulus s4 f_\circulus s4 b\circulus } +@end lilypond +@tab +@code{\ictus} +@lilypond[notime] +\include "gregorian.ly" +\new VaticanaStaff { e'^\ictus s4 f_\ictus s4 b\ictus} +@end lilypond + +@item +@code{\semicirculus} +@lilypond[notime] +\include "gregorian.ly" +\new VaticanaStaff { + e'^\semicirculus s4 f_\semicirculus s4 b\semicirculus +} +@end lilypond +@tab +@code{\signumcongruentiae} +@lilypond[notime] \include "gregorian.ly" -\new VaticanaStaff { \scriptStaffAncient #ancient } +\new VaticanaStaff { + e'^\signumcongruentiae s4 + f_\signumcongruentiae s4 + b\signumcongruentiae +} @end lilypond +@end multitable + @node Notes utilisées en percussion @appendixsec Notes utilisées en percussion @translationof Percussion notes -@lilypondfile[quote]{percussion-chart.ly} +@cindex percussions, nom des notes +@cindex drums, various +@cindex acoustic bass +@cindex bass +@cindex snare +@cindex electric snare +@cindex acoustic snare +@cindex tom tom +@cindex bongo +@cindex conga +@cindex timbale +@cindex sidestick +@cindex floor tom tom +@cindex low tom tom +@cindex high tom tom +@cindex mid tom tom +@cindex high hat +@cindex pedal high hat +@cindex open high hat +@cindex half-open high hat +@cindex cymbal, various +@cindex crash cymbal +@cindex ride cymbal +@cindex chinese cymbal +@cindex splash cymbal +@cindex ride bell +@cindex cowbell +@cindex agogo +@cindex high bongo +@cindex low bongo +@cindex mute bongo +@cindex open bongo +@cindex high conga +@cindex low conga +@cindex mute conga +@cindex open conga +@cindex high timbale +@cindex low timbale +@cindex mute timbale +@cindex open timbale +@cindex sidestick +@cindex guiro +@cindex cabasa +@cindex maracas +@cindex whistle +@cindex handclap +@cindex tambourine +@cindex vibraslap +@cindex tam tam +@cindex claves +@cindex woodblock +@cindex cuica +@cindex triangle + +@multitable @columnfractions .22 .25 .25 .25 +@item +@code{bassdrum @* bd @*} +@lilypond[notime,ragged-right] +\drums { bd4 bd1 } +@end lilypond +@tab +@code{acousticbassdrum @* bda @*} +@lilypond[notime,ragged-right] +\drums { bda4 bda1 } +@end lilypond +@tab +@code{snare @* sn @*} +@lilypond[notime,ragged-right] +\drums { sn4 sn1 } +@end lilypond +@tab +@code{acousticsnare @* sna @*} +@lilypond[notime,ragged-right] +\drums { sna4 sna1 } +@end lilypond + +@item +@code{electricsnare @* sne @*} +@lilypond[notime,ragged-right] +\drums { sne4 sne1 } +@end lilypond +@tab +@code{lowfloortom @* tomfl @*} +@lilypond[notime,ragged-right] +\drums { tomfl4 tomfl1 } +@end lilypond +@tab +@code{highfloortom @* tomfh @*} +@lilypond[notime,ragged-right] +\drums { tomfh4 tomfh1 } +@end lilypond +@tab +@code{lowtom @* toml @*} +@lilypond[notime,ragged-right] +\drums { toml4 toml1 } +@end lilypond + +@item +@code{hightom @* tomh @*} +@lilypond[notime,ragged-right] +\drums { tomh4 tomh1 } +@end lilypond +@tab +@code{lowmidtom @* tomml @*} +@lilypond[notime,ragged-right] +\drums { tomml4 tomml1 } +@end lilypond +@tab +@code{highmidtom @* tommh @*} +@lilypond[notime,ragged-right] +\drums { tommh4 tommh1 } +@end lilypond +@tab +@code{highhat @* hh @*} +@lilypond[notime,ragged-right] +\drums { hh4 hh1 } +@end lilypond + +@item +@code{closedhihat @* hhc @*} +@lilypond[notime,ragged-right] +\drums { hhc4 hhc1 } +@end lilypond +@tab +@code{openhighhat @* hho @*} +@lilypond[notime,ragged-right] +\drums { hho4 hho1 } +@end lilypond +@tab +@code{halfopenhihat @* hhho @*} +@lilypond[notime,ragged-right] +\drums { hhho4 hhho1 } +@end lilypond +@tab +@code{pedalhihat @* hhp @*} +@lilypond[notime,ragged-right] +\drums { hhp4 hhp1 } +@end lilypond + + +@item +@code{crashcymbal @* cymc @*} +@lilypond[notime,ragged-right] +\drums { cymc4 cymc1 } +@end lilypond +@tab +@code{crashcymbala @* cymca @*} +@lilypond[notime,ragged-right] +\drums { cymca4 cymca1 } +@end lilypond +@tab +@code{crashcymbalb @* cymcb @*} +@lilypond[notime,ragged-right] +\drums { cymcb4 cymcb1 } +@end lilypond +@tab +@code{ridecymbal @* cymr @*} +@lilypond[notime,ragged-right] +\drums { cymr4 cymr1 } +@end lilypond + +@item +@code{ridecymbala @* cymra @*} +@lilypond[notime,ragged-right] +\drums { cymra4 cymra1 } +@end lilypond +@tab +@code{ridecymbalb @* cymrb @*} +@lilypond[notime,ragged-right] +\drums { cymrb4 cymrb1 } +@end lilypond +@tab +@code{chinesecymbal @* cymch @*} +@lilypond[notime,ragged-right] +\drums { cymch4 cymch1 } +@end lilypond +@tab +@code{splashcymbal @* cyms @*} +@lilypond[notime,ragged-right] +\drums { cyms4 cyms1 } +@end lilypond + +@item +@code{ridebell @* rb @*} +@lilypond[notime,ragged-right] +\drums { rb4 rb1 } +@end lilypond +@tab +@code{cowbell @* cb @*} +@lilypond[notime,ragged-right] +\drums { cb4 cb1 } +@end lilypond +@tab +@code{hibongo @* boh @*} +@lilypond[notime,ragged-right] +\drums { boh4 boh1 } +@end lilypond +@tab +@code{openhibongo @* boho @*} +@lilypond[notime,ragged-right] +\drums { boho4 boho1 } +@end lilypond + +@item +@code{mutehibongo @* bohm @*} +@lilypond[notime,ragged-right] +\drums { bohm4 bohm1 } +@end lilypond +@tab +@code{lobongo @* bol @*} +@lilypond[notime,ragged-right] +\drums { bol4 bol1 } +@end lilypond +@tab +@code{openlobongo @* bolo @*} +@lilypond[notime,ragged-right] +\drums { bolo4 bolo1 } +@end lilypond +@tab +@code{mutelobongo @* bolm @*} +@lilypond[notime,ragged-right] +\drums { bolm4 bolm1 } +@end lilypond + + +@item +@code{hiconga @* cgh @*} +@lilypond[notime,ragged-right] +\drums { cgh4 cgh1 } +@end lilypond +@tab +@code{openhiconga @* cgho @*} +@lilypond[notime,ragged-right] +\drums { cgho4 cgho1 } +@end lilypond +@tab +@code{mutehiconga @* cghm @*} +@lilypond[notime,ragged-right] +\drums { cghm4 cghm1 } +@end lilypond +@tab +@code{loconga @* cgl @*} +@lilypond[notime,ragged-right] +\drums { cgl4 cgl1 } +@end lilypond + +@item +@code{openloconga @* cglo @*} +@lilypond[notime,ragged-right] +\drums { cglo4 cglo1 } +@end lilypond +@tab +@code{muteloconga @* cglm @*} +@lilypond[notime,ragged-right] +\drums { cglm4 cglm1 } +@end lilypond +@tab +@code{hitimbale @* timh @*} +@lilypond[notime,ragged-right] +\drums { timh4 timh1 } +@end lilypond +@tab +@code{lotimbale @* timl @*} +@lilypond[notime,ragged-right] +\drums { timl4 timl1 } +@end lilypond + +@item +@code{hiagogo @* agh @*} +@lilypond[notime,ragged-right] +\drums { agh4 agh1 } +@end lilypond +@tab +@code{loagogo @* agl @*} +@lilypond[notime,ragged-right] +\drums { agl4 agl1 } +@end lilypond +@tab +@code{sidestick @* ss @*} +@lilypond[notime,ragged-right] +\drums { ss4 ss1 } +@end lilypond +@tab +@code{hisidestick @* ssh @*} +@lilypond[notime,ragged-right] +\drums { ssh4 ssh1 } +@end lilypond + +@item +@code{losidestick @* ssl @*} +@lilypond[notime,ragged-right] +\drums { ssl4 ssl1 } +@end lilypond +@tab +@code{guiro @* gui @*} +@lilypond[notime,ragged-right] +\drums { gui4 gui1 } +@end lilypond +@tab +@code{shortguiro @* guis @*} +@lilypond[notime,ragged-right] +\drums { guis4 guis1 } +@end lilypond +@tab +@code{longguiro @* guil @*} +@lilypond[notime,ragged-right] +\drums { guil4 guil1 } +@end lilypond + +@item +@code{cabasa @* cab @*} +@lilypond[notime,ragged-right] +\drums { cab4 cab1 } +@end lilypond +@tab +@code{maracas @* mar @*} +@lilypond[notime,ragged-right] +\drums { mar4 mar1 } +@end lilypond +@tab +@code{shortwhistle @* whs @*} +@lilypond[notime,ragged-right] +\drums { whs4 whs1 } +@end lilypond +@tab +@code{longwhistle @* whl @*} +@lilypond[notime,ragged-right] +\drums { whl4 whl1 } +@end lilypond + +@item +@code{handclap @* hc @*} +@lilypond[notime,ragged-right] +\drums { hc4 hc1 } +@end lilypond +@tab +@code{tambourine @* tamb @*} +@lilypond[notime,ragged-right] +\drums { tamb4 tamb1 } +@end lilypond +@tab +@code{vibraslap @* vibs @*} +@lilypond[notime,ragged-right] +\drums { vibs4 vibs1 } +@end lilypond +@tab +@code{tamtam @* tt @*} +@lilypond[notime,ragged-right] +\drums { tt4 tt1 } +@end lilypond + +@item +@code{claves @* cl @*} +@lilypond[notime,ragged-right] +\drums { cl4 cl1 } +@end lilypond +@tab +@code{hiwoodblock @* wbh @*} +@lilypond[notime,ragged-right] +\drums { wbh4 wbh1 } +@end lilypond +@tab +@code{lowoodblock @* wbl @*} +@lilypond[notime,ragged-right] +\drums { wbl4 wbl1 } +@end lilypond +@tab +@code{opencuica @* cuio @*} +@lilypond[notime,ragged-right] +\drums { cuio4 cuio1 } +@end lilypond + +@item +@code{mutecuica @* cuim @*} +@lilypond[notime,ragged-right] +\drums { cuim4 cuim1 } +@end lilypond +@tab +@code{triangle @* tri @*} +@lilypond[notime,ragged-right] +\drums { tri4 tri1 } +@end lilypond +@tab +@code{opentriangle @* trio @*} +@lilypond[notime,ragged-right] +\drums { trio4 trio1 } +@end lilypond +@tab +@code{mutetriangle @* trim} +@lilypond[notime,ragged-right] +\drums { trim4 trim1 } +@end lilypond + +@item +@code{oneup @* ua @*} +@lilypond[notime,ragged-right] +\drums { ua4 ua1 } +@end lilypond +@tab +@code{twoup @* ub @*} +@lilypond[notime,ragged-right] +\drums { ub4 ub1 } +@end lilypond +@tab +@code{threeup @* uc @*} +@lilypond[notime,ragged-right] +\drums { uc4 uc1 } +@end lilypond +@tab +@code{fourup @* ud @*} +@lilypond[notime,ragged-right] +\drums { ud4 ud1 } +@end lilypond + +@item +@code{fiveup @* ue @*} +@lilypond[notime,ragged-right] +\drums { ue4 ue1 } +@end lilypond +@tab +@code{onedown @* da @*} +@lilypond[notime,ragged-right] +\drums { da4 da1 } +@end lilypond +@tab +@code{twodown @* db @*} +@lilypond[notime,ragged-right] +\drums { db4 db1 } +@end lilypond +@tab +@code{threedown @* dc @*} +@lilypond[notime,ragged-right] +\drums { dc4 dc1 } +@end lilypond + +@item +@code{fourdown @* dd @*} +@lilypond[notime,ragged-right] +\drums { dd4 dd1 } +@end lilypond +@tab +@code{fivedown @* de @*} +@lilypond[notime,ragged-right] +\drums { de4 de1 } +@end lilypond + + +@end multitable @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é):: +* 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 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. + + +@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) à la rubrique +@rcontribnamed{LilyPond grammar, 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 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 @@ -1056,13 +2777,23 @@ Voici la liste exhaustive des symboles prédéfinis : @include layout-properties.tely -@node Fonctions mucicales -@appendixsec Fonctions mucicales +@node Fonctions musicales prédéfinies +@appendixsec Fonctions musicales prédéfinies @translationof Available music functions @include identifiers.tely +@node Identificateurs de modification de contexte +@appendixsec Identificateurs de modification de contexte +@translationof Context modification identifiers + +Les commandes suivantes permettent de modifier des contextes au sein +d'un bloc @code{\layout} ou @code{\with}. + +@include context-mod-identifiers.tely + + @node Types de prédicats prédéfinis @appendixsec Types de prédicats prédéfinis @translationof Predefined type predicates