]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/user/introduction.itely
lilypond-book robustness: ensure EOL at the end of @verbatim
[lilypond.git] / Documentation / fr / user / introduction.itely
index 53f77e6d0d892eed27d643df0ef6e5b5f2f7254e..e6be0be6fc3b4767e07b513903d097b2c38469a2 100644 (file)
@@ -1,16 +1,16 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond-kearning.tely
 @ignore
-    Translation of GIT committish: 1e3ef555477a299a695c35ccc0aaabe855bdd541
+    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.61"
+@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
 
 
@@ -44,6 +44,11 @@ architecture.
 @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
@@ -52,7 +57,7 @@ Cette plaque était ensuite encrée, les dépressions créées par les
 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
@@ -61,7 +66,7 @@ pour devenir vraiment habile.
 
 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
@@ -69,7 +74,7 @@ désagréables à jouer.
 
 @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
@@ -245,18 +250,20 @@ meilleure interprétation.
 
 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
@@ -264,9 +271,9 @@ faire leur travail ?
 
 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.
@@ -277,6 +284,7 @@ programme étaient figées par les développeurs.  Ceci s'est avéré
 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
@@ -291,13 +299,16 @@ définitions du modèle typographique doivent également être accessibles
 à 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
@@ -324,6 +335,10 @@ haut (droite).
 }
 @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
@@ -367,34 +382,33 @@ musique.
          (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
 
@@ -405,6 +419,8 @@ musique.
 
 @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é
@@ -414,7 +430,7 @@ notation utiliser.
 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 à
@@ -556,7 +572,7 @@ et le graveur de hampes (@code{Stem_engraver}) ajoute les hampes :
 @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
@@ -568,6 +584,10 @@ métrique, et les armures, nous obtenons un jeu de notation complet.
 \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.
@@ -591,10 +611,11 @@ plusieurs contextes de Portée peuvent être inclus dans un seul
 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 {
@@ -608,10 +629,13 @@ Référence du programme: @rinternals{Contexts}.
 @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.
@@ -619,7 +643,7 @@ Quand le format ne peut plus être simplifé, il nous reste par
 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
@@ -629,7 +653,7 @@ c'4 d'8
 @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]
 {
@@ -638,7 +662,7 @@ c'est-à-dire un do central noire et, juste au-dessus un ré croche
 @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
@@ -653,11 +677,6 @@ f4
 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
@@ -667,7 +686,7 @@ des notes.
 @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
@@ -680,7 +699,7 @@ des accolades @code{@{@tie{}@dots{}@tie{}@}}
 
 @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
@@ -691,9 +710,9 @@ en utilisant <<, @code{\\}, et >>
 \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é.
 
@@ -711,6 +730,8 @@ moins de 10% du code source.
 @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
@@ -731,8 +752,12 @@ une partition de chanson :
 @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
 
@@ -755,7 +780,7 @@ plus exotiques :
       << {
         \revert Stem #'direction
         \change Staff = down
-        \set subdivideBeams = ##t           
+        \set subdivideBeams = ##t
         g16.[
           \change Staff = up
           c'''32
@@ -786,7 +811,7 @@ plus exotiques :
       \override Beam  #'thickness = #0.3
       \override Stem  #'thickness = #4.0
       g'16[ b16 fis16 g16]
-      << \makeClusters { 
+      << \makeClusters {
         as16 <as b>
         <g b>
         <g cis>
@@ -833,6 +858,13 @@ musique et du texte dans les documents.
 
 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
@@ -898,7 +930,7 @@ un fichier, ajoutez les notes, et c'est prêt !
 @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
 
@@ -906,12 +938,13 @@ d'utilisateurs n'ont jamais touché à Scheme.
 @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
+
 @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
@@ -922,6 +955,11 @@ les parties non encore traduites de la documentation.
 @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 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.
@@ -930,7 +968,7 @@ 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
@@ -958,7 +996,7 @@ différentes formes de retouches, qui permettent d'obtenir de Lilypond
 (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
@@ -993,6 +1031,9 @@ LilyPond.
 @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.
 
@@ -1029,7 +1070,9 @@ et convertissent divers formats de musique vers le format @code{.ly}.
 @unnumberedsubsec About the Snippet List
 
 @cindex snippets
+@cindex extraits de code
 @cindex LSR
+@cindex LilyPond Snippet Repository
 
 @rlsrnamed{Top,Exemples de code} :
 il s'agit d'une sélection de petits exemples montrant des trucs,