@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@c This file is part of lilypond-kearning.tely
@ignore
- Translation of GIT committish: 4706bf2d0cccc915834cd9c063999cb38d2e78e8
+ Translation of GIT committish: 1e3ef555477a299a695c35ccc0aaabe855bdd541
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.11.61"
@c Translators: Ludovic Sardain, John Mandereau
@c Translation checkers: Jean-Charles Malahieude, Jean-Yves Baudais
@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
@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
@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
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
donc nous avons besoin d'une approche souple des règles. Le language
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
LilyPond en Scheme. L'architecture actuelle de formatage est
}
@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
@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é
\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.
@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 :
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
\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
grammaire. Autrement dit, la syntaxe de LilyPond est définie
@node Example applications
@unnumberedsubsec Example applications
+@cindex examples 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
<< {
\revert Stem #'direction
\change Staff = down
- \set subdivideBeams = ##t
+ \set subdivideBeams = ##t
g16.[
\change Staff = up
c'''32
\override Beam #'thickness = #0.3
\override Stem #'thickness = #4.0
g'16[ b16 fis16 g16]
- << \makeClusters {
+ << \makeClusters {
as16 <as b>
<g b>
<g cis>
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
@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
@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