@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@c This file is part of lilypond-kearning.tely
@ignore
- Translation of GIT committish: f8b1d1c16ff9c8d89e48175b5881ec039a0fae3b
+ Translation of GIT committish: db53c05f11bea8831733b1fdf7ebe32cb1f491f4
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@end ignore
-@c \version "2.11.51"
+@c \version "2.12.0"
@c Translators: Ludovic Sardain, John Mandereau
-@c Translation checkers: Jean-Charles Malahieude, Jean-Yves Baudais
+@c Translation checkers: Jean-Charles Malahieude, Jean-Yves Baudais, Damien Heurtebise
+@c Translation status: post-GDP
@node Introduction
@node Engraving
@unnumberedsubsec Engraving
+
+@cindex gravure
+@cindex typographie musicale
+@cindex musique et typographie
+
L'art de la typographie musicale se nomme la @emph{gravure}. Ce terme
est issu du processus traditionnel d'impression musicale. Il y a
seulement quelques dizaines d'années, on faisait les partitions en
creux et les bosses retenant l'encre. Une image était formée en
pressant du papier sur la plaque. La découpe et l'embossage étaient
entièrement faits à la main. Il était pénible d'appliquer une
-correction, quand celle-ci n'était pas impossible, la gravure devait
+correction, quand celle-ci n'était pas impossible ; la gravure devait
donc être parfaite du premier coup. La gravure demandait une
qualification hautement spécialisée : un artisan devait accomplir
environ cinq ans de formation avant de mériter le titre de maître
De nos jours, toutes les partitions récentes sont produites avec des
ordinateurs. Ceci a des avantages évidents : le coût des impressions
-a diminué, et le travail d'éditeur peut être envoyé par courriel.
+a diminué, et le travail d'édition peut être envoyé par courriel.
Malheureusement, l'utilisation dominante des ordinateurs a également
diminué la qualité graphique des partitions. L'impression
informatisée leur donne un aspect fade et mécanique qui les rend
@c introduce illustrating aspects of engraving, font...
Les images ci-dessous illustrent la différence entre la gravure
-traditionelle et l'impression typique par ordinateur, et la troisème
+traditionelle et l'impression typique par ordinateur, et la troisième
image montre comment LilyPond mime l'aspect traditionnel. L'image de
gauche est une numérisation d'un symbole bémol d'une édition publiée
en 2000. Celle du centre montre un bémol d'une gravure à la main de
Ces exemples démontrent que la typographie musicale est un art subtil
et complexe, et que la produire demande une expertise considérable,
-que les musiciens n'ont généralement pas. LilyPond représente notre
-effort pour apporter l'excellence graphique de la gravure à la main à
-l'ère de l'ordinateur, et la rendre accessible à tous les musiciens.
-Nous avons conçu nos algorithmes, fontes et paramètres de programme
-pour retrouver la qualité d'édition des anciennes partitions que nous
-aimons tant lire et jouer.
-
+que les musiciens ne possèdent généralement pas. LilyPond est le
+fruit de nos efforts pour restaurer l'excellence graphique de la
+gravure à la main à l'ère de l'ordinateur, et la rendre accessible à
+tous les musiciens. Nous avons conçu nos algorithmes, fontes et
+paramètres de programme pour retrouver la qualité d'édition des
+anciennes partitions que nous aimons tant lire et jouer.
@node Automated engraving
@unnumberedsubsec Automated engraving
+@cindex gravure automatisée
+@cindex automatisée, gravure
+
Comment pouvons-nous implémenter la typographie ? Si les artisans ont
besoin de plus de dix ans pour devenir de vrais maîtres, comment nous,
simples programmeurs, pourrions-nous jamais écrire un programme pour
La réponse est : nous ne le pouvons pas. La typographie se base sur
le jugement visuel humain, donc les humains ne peuvent pas être
-complètement remplacés. Si LilyPond arrive à résoudre la plupart des
+complètement remplacés. Si LilyPond arrive à traiter la plupart des
situations correctement, ce sera déjà une grande avancée sur les
-logiciels existants. Les autres situations peuvent être résolues à la
+logiciels existants. Les problèmes restants peuvent être résolus à la
main. Au fil des ans, le logiciel peut être affiné pour faire de plus
en plus de choses automatiquement, pour que les ajustements manuels
soient de moins en moins nécessaires.
insatisfaisant pour plusieurs raisons :
@itemize
+
@item Quand Lilypond fait des erreurs,
les utilisateurs ont besoin de contredire les décisions de formatage.
Les utilisateurs doivent donc avoir accès au moteur de formatage. Par
à l'utilisateur.
@item Enfin, nous affinons continuellement les algorithmes de formatage,
-donc nous avons besoin d'une approche souple des règles. Le language
+donc nous avons besoin d'une approche souple des règles. Le langage
C++ oblige à une certaine méthode de groupage des règles qui ne
convient pas bien au fonctionnement de la notation musicale.
+
@end itemize
+@cindex langage de programmation Scheme
+
Ces problèmes ont été résolus en intégrant un interpréteur pour le
-language de programmation Scheme, et en réécrivant des parties de
+langage de programmation Scheme, et en réécrivant des parties de
LilyPond en Scheme. L'architecture actuelle de formatage est
construite autour de la notion d'objets graphiques, décrits par des
fonctions et des variables Scheme. Cette architecture comprend les
}
@end lilypond
+@cindex partition, formatage
+@cindex formatage d'une partition
+@cindex formatage, règles de
+
@noindent
Le processus de formatage d'une partition consiste à lire et écrire
les variables d'objets graphiques. Certaines variables ont une valeur
(pos (ly:grob-property grob 'staff-position)))
(if (memq 'note-head-interface interfaces)
(begin
- (ly:grob-set-property! grob 'stencil ly:text-interface::print)
- (ly:grob-set-property! grob 'font-family 'roman)
- (ly:grob-set-property! grob 'text
- (make-raise-markup -0.5
- (case pos
- ((-5) (make-simple-markup "m"))
- ((-3) (make-simple-markup "c "))
- ((-2) (make-smaller-markup (make-bold-markup "2")))
- (else (make-simple-markup "bla")))))))))
+ (ly:grob-set-property! grob 'stencil
+ (grob-interpret-markup grob
+ (make-lower-markup 0.5
+ (case pos
+ ((-5) "m")
+ ((-3) "c ")
+ ((-2) (make-smaller-markup (make-bold-markup "2")))
+ (else "bla")))))))))
\new Voice \relative c' {
- \stemUp
- \set autoBeaming = ##f
- \time 2/4
- <d f g>4
- \once \override NoteHead #'stencil = #ly:note-head::brew-ez-stencil
- \once \override NoteHead #'font-size = #-7
- \once \override NoteHead #'font-family = #'sans
- \once \override NoteHead #'font-series = #'bold
- <d f g>
- \once \override NoteHead #'style = #'cross
- <d f g>
- \applyOutput #'Voice #mc-squared
- <d f g>
- <<
- { d8[ es-( fis^^ g] fis2-) }
- \repeat unfold 5 { \applyOutput #'Voice #mc-squared s8 }
- >>
+ \stemUp
+ \set autoBeaming = ##f
+ \time 2/4
+ <d f g>4
+ \once \override NoteHead #'stencil = #ly:note-head::brew-ez-stencil
+ \once \override NoteHead #'font-size = #-7
+ \once \override NoteHead #'font-family = #'sans
+ \once \override NoteHead #'font-series = #'bold
+ <d f g>4
+ \once \override NoteHead #'style = #'cross
+ <d f g>4
+ \applyOutput #'Voice #mc-squared
+ <d f g>4
+ <<
+ { d8[ es-( fis^^ g] fis2-) }
+ \repeat unfold 5 { \applyOutput #'Voice #mc-squared s8 }
+ >>
}
@end lilypond
@cindex gravure
@cindex typographie
+@cindex graveur
+@cindex greffon
Le processus de formatage décide où placer les symboles. Cependant,
cela ne peut être fait qu'à partir du moment où il a été décidé
La notation musicale usuelle est un système d'écriture qui a évolué à
travers les dix derniers siècles. La forme qui est aujourd'hui
communément utilisée date du début de la Renaissance. Bien que la forme
-basique --- les têtes de notes sur une portée de cinq lignes --- n'a pas
+basique --- les têtes de notes sur une portée de cinq lignes --- n'ait pas
changé, les détails continuent d'évoluer pour exprimer les innovations
de la notation contemporaine. Par conséquent, elle comprend quelque 500
ans de musique, avec des applications allant des mélodies monodiques à
@end lilypond
@noindent
-Le graveur de hampe est notifié de chaque tête de note qui survient.
+Le graveur de hampe est informé de chaque tête de note qui survient.
Chaque fois qu'une tête de note --- plusieurs pour un accord --- est
rencontrée, un objet hampe est créé et connecté à la tête de note. En
ajoutant des graveurs pour les barres de ligature, les liaisons, les
\score { \topVoice }
@end lilypond
+@cindex polyphonie
+@cindex graver plusieurs voix
+@cindex contextes
+
Ce système fonctionne bien pour de la musique monodique, mais qu'en
est-il de la polyphonie ? En notation polyphonique, plusieurs voix
peuvent partager une portée.
contexte de Partition. Le contexte de Partition est le contexte de
notation de plus haut niveau.
-@seealso
+@seealso
Référence du programme: @rinternals{Contexts}.
+
@lilypond[quote,ragged-right]
\include "engraver-example.ily"
\score {
@node Music representation
@unnumberedsubsec Music representation
+@cindex syntaxe
+@cindex structures recursives
+
Idéalement, le format d'entrée pour n'importe quel système de
formatage est une description abstraite du contenu. Dans ce cas-ci,
ce serait la musique elle-même. Cela pose un formidable problème :
-comment pouvons-nous définir ce que la musique est réellement ? Plutôt
+comment pouvons-nous définir ce qu'est réellement la musique ? Plutôt
que d'essayer de trouver une réponse, nous avons renversé la question.
Nous écrivons un logiciel capable de produire de la musique écrite, et
adaptons le format pour atteindre la plus grande concision possible.
définition le contenu lui-même. Notre logiciel sert de définition
formelle d'un document de musique.
-La syntaxe est également l'interface utilisateur pour LilyPond, par
+Pour LilyPond, la syntaxe est également l'interface utilisateur ; par
conséquent il est facile de saisir
@example
@end example
@noindent
-c'est-à-dire un do central noire et, juste au-dessus un ré croche
+c'est-à-dire un do central noire et, juste au-dessus, un ré croche
@lilypond[quote]
{
@end lilypond
Sur une échelle microscopique, une telle syntaxe est facile à
-utiliser. A plus grande échelle, la syntaxe a besoin aussi de
+utiliser. À plus grande échelle, la syntaxe a besoin aussi de
structure. Comment serait-il possible autrement de rentrer des
pièces complexes comme des symphonies ou des opéras ? La structure
est formée par le concept d'expression musicale : en combinant
Des accord peuvent être construits avec @code{<<} et @code{>>} autour
des notes.
-@c < > is not a music expression,
-@c so we use <<>> iso. <> to drive home the point of
-@c expressions. Don't change this back --hwn.
-
-@c FIXME: change this. I can explain it better. -gp
@example
<<c4 d4 e4>>
@end example
@end lilypond
@noindent
-Cette expression est mise dans une séquence grace à l'encadrement par
+On met cette expression dans une séquence en l'encadrant par
des accolades @code{@{@tie{}@dots{}@tie{}@}}
@example
@noindent
Ceci est également une expression, et peut donc encore une fois
-être combinée avec d'autres expressions simultanées (une blanche)
+être combiné avec d'autres expressions simultanées (une blanche)
en utilisant <<, @code{\\}, et >>
@example
\new Voice { << g2 \\ { f4 <<c d e>> } >> }
@end lilypond
-De telles strucutres récursives peuvent être spécifiées formellement
+De telles structures récursives peuvent être spécifiées formellement
et de manière ordonnée dans une grammaire indépendante de tout
-contexte. Le code d'analyse est aussi générée à partir de cette
+contexte. Le code d'analyse est aussi généré à partir de cette
grammaire. Autrement dit, la syntaxe de LilyPond est définie
clairement et sans ambiguité.
@node Example applications
@unnumberedsubsec Example applications
+@cindex exemples simples
+
Nous avons conçu LilyPond comme une expérimentation visant à
concentrer l'art de la gravure musicale dans un logiciel. Grâce à
tout ce dur labeur, le programme peut maintenant être utilisé pour
@lilypond[quote,ragged-right]
<<
\chords { c2 c f2 c }
- \new Staff \relative c' { \time 2/4 c4 c g'4 g a4 a g2 }
- \new Lyrics \lyricmode { twin4 kle twin kle lit tle star2 }
+ \new Staff
+ \relative c' {
+ \time 2/4
+ c4 c g' g a a g2
+ }
+ \addlyrics { twin -- kle twin -- kle lit -- tle star }
>>
@end lilypond
Cette partie présente les différents volumes de la documentation.
+@cindex Manuel d'initiation
+@cindex Glossaire musical
+@cindex Manuel de notation
+@cindex Utilisation des programmes
+@cindex Exemples de code
+@cindex Référence des propriétés internes
+
@c leave these lines wrapping around. It's some texinfo 4.12 thing. -gp
@c This is actually a limitation of texi2html. -jm
@menu
-* About the Learning Manual (LM):: introduction à LilyPond, ce manuel explique aux débutants la création de partitions.
-
-* About the Music Glossary (MG):: ce document explique de nombreux termes musicaux et en donne la traduction dans d'autres langues.
-
-* About the Notation Reference (NR):: ce manuel représente la partie la plus volumineuse de la documentation. Il fournit tous les détails sur la création de notation musicale. La lecture de cet ouvrage requiert une bonne compréhension des concepts exposés dans le manuel d'initiation.
-
-* About the Application Usage (AU):: ce manuel aborde l'exécution des programmes LilyPond et les particularités dépendant du système d'exploitation.
-
-* About the Snippet List (SL):: ce document rassemble une collection d'extraits de code LilyPond.
-
-* About the Internals Reference (IR):: ce manuel constitue une source d'information sur le fonctionnement interne de LilyPond. C'est une référence complète pour l'élaboration de retouches.
-
-* Other documentation:: d'autres sources de documentation sont disponibles, telles que les notes de nouveautés et les archives des listes de diffusion.
-
+* About the Learning Manual:: introduction à LilyPond, ce manuel explique aux débutants la création de partitions.
+* About the Music Glossary:: ce document explique de nombreux termes musicaux et en donne la traduction dans d'autres langues.
+* About the Notation Reference:: ce manuel représente la partie la plus volumineuse de la documentation. Il fournit tous les détails sur la création de notation musicale. La lecture de cet ouvrage requiert une bonne compréhension des concepts exposés dans le manuel d'initiation.
+* About the Application Usage:: ce manuel aborde l'exécution des programmes LilyPond et les particularités dépendant du système d'exploitation.
+* About the Snippet List:: ce document rassemble une collection d'extraits de code LilyPond.
+* About the Internals Reference:: ce manuel constitue une source d'information sur le fonctionnement interne de LilyPond. C'est une référence complète pour l'élaboration de retouches.
+* Other documentation:: d'autres sources de documentation sont disponibles, telles que les notes de nouveautés et les archives des listes de diffusion.
@end menu
-@node About the Learning Manual (LM)
-@unnumberedsubsec About the Learning Manual (LM)
+@node About the Learning Manual
+@unnumberedsubsec About the Learning Manual
-Ce volume explique comment débuter avec LilyPond, et expose de manière
+Ce manuel explique comment débuter avec LilyPond, et expose de manière
simple quelques concepts clés. Il est conseillé de lire ces chapitres
de manière linéaire.
+Dans ce manuel se trouve à chaque section un paragraphe @strong{Voir
+aussi} contenant des références vers d'autres sections : il est
+conseillé de ne pas les suivre en première lecture ; lorsque vous
+aurez lu l'ensemble du manuel d'initiation, vous pourrez en relisant
+certaines sections suivre ces références pour approfondir certains
+aspects.
+
@itemize
@item
@ref{Scheme tutorial} : courte introduction à Scheme, le langage de
programmation utilisé dans les fonctions de musique. Ces quelques
lignes vous aideront à construire des retouches avancées ; nombre
-d'utilisateurs n'ont jamais touché à Scheme.
+d'utilisateurs ne touchent jamais à Scheme.
@end itemize
-@node About the Music Glossary (MG)
-@unnumberedsubsec About the Music Glossary (MG)
+@node About the Music Glossary
+@unnumberedsubsec About the Music Glossary
+@cindex Glossaire musical
@cindex jargon
@cindex terminologie
@cindex langues étrangères
@cindex langue
@cindex langage
-
-@ref{Top,Music Glossary,,music-glossary,Glossaire musical} :
-explication des termes musicaux et traduction dans diverses langues.
+
+@rglosnamed{Top,Glossaire musical} : ce document explique en anglais
+des termes musicaux, et donne leur traduction dans diverses langues.
Si vous n'êtes pas familier avec la notation et la terminologie
musicales, il est conseillé de consulter le glossaire, notamment pour
les parties non encore traduites de la documentation.
-@node About the Notation Reference (NR)
-@unnumberedsubsec About the Notation Reference (NR)
+@node About the Notation Reference
+@unnumberedsubsec About the Notation Reference
+
+@cindex Manuel de notation
+@cindex annexes
+@cindex références, tables de
+@cindex tables de références
-Ce volume détaille toutes les commandes LilyPond produisant une notation
+Ce manuel détaille toutes les commandes LilyPond produisant une notation
musicale. La lecture de cet ouvrage requiert une bonne compréhension des
concepts exposés dans le manuel d'initiation.
@c Normalement, il est impossible d'utiliser deux points en français,
@c car une référence externe doit se terminer par un signe de
-@c ponctuation dans la format Info. Cependant, Info
+@c ponctuation dans le format Info. Cependant, Info
@c n'internationalise pas encore des documents Info, donc nous n'en
@c avons rien à faire pour l'instant. -jm
@item
(presque) tout ce que vous désirez.
@item
-@ruser{Interfaces for programmers} :.création de fonctions de musique
+@ruser{Interfaces for programmers} : création de fonctions de musique
à l'aide de Scheme.
@end itemize
@end itemize
-@node About the Application Usage (AU)
-@unnumberedsubsec About the Application Usage (AU)
+@node About the Application Usage
+@unnumberedsubsec About the Application Usage
+
+@cindex Utilisation des programmes
+@cindex intégration de LilyPond avec d'autres programmes
Ce manuel explique l'exécution des programmes et l'intégration de
partitions LilyPond dans d'autres programmes.
@end itemize
-@node About the Snippet List (SL)
-@unnumberedsubsec About the Snippet List (SL)
+@node About the Snippet List
+@unnumberedsubsec About the Snippet List
@cindex snippets
+@cindex extraits de code
@cindex LSR
+@cindex LilyPond Snippet Repository
-@ref{Top,LilyPond Snippet List,,lilypond-snippets,Exemples de code} :
+@rlsrnamed{Top,Exemples de code} :
il s'agit d'une sélection de petits exemples montrant des trucs,
astuces et fonctionnalités particulières de LilyPond, issus de
@uref{http://lsr@/.dsi@/.unimi@/.it,LilyPond Snippet Repository}
@strong{Voir aussi}.
-@node About the Internals Reference (IR)
-@unnumberedsubsec About the Internals Reference (IR)
+@node About the Internals Reference
+@unnumberedsubsec About the Internals Reference
@cindex retoucher
@cindex variables
@cindex étendre lilypond
@cindex index
-@ref{Top,Internals Reference,,lilypond-internals,Référence des
-propriétés internes} : c'est un ensemble de pages HTML étroitement
-liées entre elles, qui documente les moindres petits détails de chaque
-classe, objet et fonction de LilyPond. Cette documentation est
-produite directement à partir des définitions de formatage utilisées.
+@rinternalsnamed{Top,Référence des propriétés internes} : c'est un
+ensemble de pages HTML étroitement liées entre elles, qui documente
+les moindres petits détails de chaque classe, objet et fonction de
+LilyPond. Cette documentation est produite directement à partir des
+définitions de formatage utilisées.
Presque toutes les fonctions de formatage utilisées en interne sont
directement disponibles pour l'utilisateur. Par exemple, toutes les
@itemize
-@item Nouveautés : ce document résume les changements importants et
-les nouvelles fonctionalités de LilyPond depuis la dernière version
-stable.
+@item
+@ifhtml
+@ifset bigpage
+@uref{../topdocs/NEWS.html,Nouveautés} :
+@end ifset
+@ifclear bigpage
+@uref{../../topdocs/NEWS.html,Nouveautés} :
+@end ifclear
+@end ifhtml
+@ifnothtml
+Nouveautés :
+@end ifnothtml
+ce document résume les changements importants et les nouvelles
+fonctionalités de LilyPond depuis la dernière version stable.
@item @uref{http://lists.gnu.org/archive/html/lilypond-user/, Les
archives de la liste lilypond-user} : c'est un dépôt archivant les
pour produire l'image est accessible par un clic sur l'image.
@item L'emplacement des fichiers de documentation mentionnés ici peut varier
-d'un système à l'autre. De temps en temps, ce manuel fait référence aux
-fichiers d'exemple et d'initialisation. Tout au long de ce manuel, nous
-donnons les emplacements des fichiers d'entrée relativement au
-répértoire racine de l'archive source. Par exemple,
+d'un système à l'autre. De temps en temps, ce manuel fait référence
+aux fichiers d'exemple et d'initialisation. Tout au long de ce
+manuel, nous donnons les emplacements des fichiers d'entrée
+relativement au répértoire racine de l'archive source. Par exemple,
@file{input/@/test/@/bla@/.ly} peut référer au fichier
@file{lilypond@/2.x.y/@/input/@/test/@/bla@/.ly}. Dans les paquets
-binaires pour les plateformes Unix, la documentation et les exemples se
-trouvent généralement sous @file{/usr/@/share/@/doc/@/lilypond/}. Les
-fichiers d'initialisation, par exemple @file{scm/@/lily@/.scm}, ou
+binaires pour les plateformes Unix, la documentation et les exemples
+se trouvent généralement sous @file{/usr/@/share/@/doc/@/lilypond/}.
+Les fichiers d'initialisation, par exemple @file{scm/@/lily@/.scm}, ou
@file{ly/@/engraver@/-init@/.ly}, se trouvent généralement dans le
-répértoire @file{/usr/@/share/@/lilypond/}.
+répertoire @file{/usr/@/share/@/lilypond/}. @c pas encore en français -jm.
+@c Pour plus de détails, consultez @ref{Other sources of information}.
@end itemize