@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: 65dd8bb120476562eb0104c6969d72d8b105ac8f
+ Translation of GIT committish: 27af34a245b02a6b89c9af3becefcfe676b2e19d
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.38"
+
+@c Translators: Ludovic Sardain, John Mandereau
+@c Translation checkers: Jean-Charles Malahieude, Jean-Yves Baudais
+
+
@node Introduction
@chapter Introduction
@menu
-* Engraving::
-* Automated engraving::
+* Engraving::
+* Automated engraving::
* What symbols to engrave?::
-* Music representation::
-* Example applications::
-* About this manual::
+* Music representation::
+* Example applications::
+* About the documentation::
@end menu
@end multitable
-@cindex musical symbols
-@cindex font
-@cindex blackness
-@cindex balance
+@cindex symboles musicaux
+@cindex fonte
+@cindex police
+@cindex épaisseur des caractères
+@cindex équilibre
@c introduce illustrating aspects of engraving, spacing...
En matière d'espacement, la répartition de l'espace devrait refléter
exact, et une autre fois avec des corrections. Pouvez-vous les
repérer ?
-@cindex optical spacing
+@cindex espacement optique
@c file spacing-optical.
@c need to include it here, because we want two images.
@lilypond
}
@end lilypond
-@cindex regular rhythms
-@cindex regular spacing
+@cindex régulier, rythme
+@cindex régulier, espacement
+@cindex espacement régulier
L'extrait n'utilise que des notes de même durée ; l'espacement devrait
le refléter. Malheureusement, notre oeil nous trompe quelque peu ; il
dans les deux dernières mesures forment des blocs de notes @qq{hampe
vers le bas}/@/@qq{hampe vers le haut}.
-@cindex typography
+@cindex typographie
Les musiciens sont généralement plus absorbés par l'exécution que par
l'étude de l'aspect graphique d'une partition, donc discutailler sur
@node What symbols to engrave?
@section What symbols to engrave?
-@cindex engraving
-@cindex typography
+@cindex gravure
+@cindex typographie
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 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 à de monstrueux contrepoints pour grand orchestre.
-
-Comment pouvons nous appréhender un tel monstre à plusieurs têtes, et
-le confiner dans l'espace réduit d'un programme informatique ? Notre
+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
+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 à
+de monstrueux contrepoints pour grand orchestre.
+
+Comment pouvons nous appréhender un tel monstre à plusieurs têtes, et le
+confiner dans l'espace réduit d'un programme informatique ? Notre
solution consiste à diviser le problème de la notation --- par
opposition à la gravure, ou typographie --- en morceaux digestes et
programmables : chaque type de symbole est géré par un module séparé,
couramment appelé greffon@footnote{traduction de l'anglais
@emph{plug-in}.}. Chaque greffon est entièrement modulaire et
indépendant, et donc peut être développé et amélioré séparément. De
-tels greffons sont nommés @code{graveur}s@footnote{@code{engraver}s
-en anglais.}, par analogie avec les artisans qui traduisent les idées
+tels greffons sont nommés @code{graveur}s@footnote{@code{engraver}s en
+anglais.}, par analogie avec les artisans qui traduisent les idées
musicales en symboles graphiques.
Dans l'exemple suivant, voyons comment nous commençons avec un greffon
@seealso
-Program reference: @internalsref{Contexts}.
+Program reference: @rinternals{Contexts}.
@lilypond[quote,ragged-right]
\include "engraver-example.ily"
@noindent
c'est-à-dire un do central noire et, juste au-dessus un ré croche
-@lilypond[quote,fragment]
-c'4 d'8
+@lilypond[quote]
+{
+ c'4 d'8
+}
@end lilypond
Sur une échelle microscopique, une telle syntaxe est facile à
accomplir des travaux utiles. L'application la plus simple est
d'imprimer des notes :
-@lilypond[quote,relative=1,fragment]
-\time 2/4 c4 c g'4 g a4 a g2
+@lilypond[quote,relative=1]
+{
+ \time 2/4
+ c4 c g'4 g a4 a g2
+}
@end lilypond
@noindent
-@node About this manual
-@section About this manual
+@node About the documentation
+@section About the documentation
+
+Deux manuels traitent de LilyPond : le @emph{manuel de l'utilisateur}
+--- que vous lisez actuellement --- et le @emph{manuel d'utilisation du
+programme.}
-Le manuel est divisé en quatres livres.
+@subheading Manuel de l'utilisateur
+
+Ce manuel se divise en trois livres.
+@c pourquoi pas "tomes" au lieu de "livres" ? -John M.
@subsubheading Manuel d'apprentissage
Ce livre explique comment débuter avec LilyPond, et expose de manière
-simple quelques concepts clés.
+simple quelques concepts clés. Il est conseillé de lire ces chapitres
+de manière linéaire.
@itemize @bullet
Les utilisateurs débutants sont invités à commencer ici.
@item
-@emph{@ref{Putting it all together}}
+@emph{@ref{Fundamental concepts}}
explique des concepts généraux du format de fichier ly. Si vous n'êtes
pas certain de l'endroit où placer une commande, lisez ce chapitre !
@itemize @bullet
@item
-@emph{@ref{Basic notation}}
+@emph{@ruser{Musical notation}}
traite de sujets groupés par type de notation. Cette section
détaille la notation de base, qui sera utile dans la plupart des
projets de partition.
@item
-@emph{@ref{Instrument-specific notation}}
+@emph{@ruser{Specialist notation}}
traite de sujets groupés par type de notation. Cette section détaille
des notations spéciales qui ne seront utiles que pour des types
particuliers d'instruments ou la voix.
@item
-@emph{@ref{Advanced notation}}
-traite de sujets groupés par type de notation. Cette section
-donne des précisions à propos de notations compliquées et
-inhabituelles
-
-@item
-@emph{@ref{Changing defaults}}
+@emph{@ruser{Changing defaults}}
explique comment ajuster finement la mise en page.
@item
-@emph{@ref{Non-musical notation}}
+@emph{@ruser{Non-musical notation}}
traite de sorties non musicales comme les titres, les mouvements
multiples, et la sélection des instruments MIDI.
@item
-@emph{@ref{Spacing issues}}
+@emph{@ruser{Spacing issues}}
traite de sujets affectant la sortie globale, comme sélectionner
la taille de papier ou spécifier les sauts de page.
@item
-@emph{@ref{Interfaces for programmers}}
+@emph{@ruser{Interfaces for programmers}}
explique comment créer des fonctions de musique.
@end itemize
-@subsubheading Utilisation du programme
-
-Ce livre explique comment exécuter le programme et comment intégrer les
-partitions LilyPond dans d'autres programmes.
-
-@itemize @bullet
-
-@item
-@emph{@ref{Running LilyPond}}
-montre comment lancer LilyPond et ses programmes auxiliaires. De
-plus, cette section explique comment mettre à jour des fichiers
-source écrits pour d'anciennes versions de LilyPond.
-
-@item
-@emph{@ref{LilyPond-book}}
-explique comment créer des documents intégrant des exemples musicaux,
-comme ce manuel.
-
-@item
-@emph{@ref{Converting from other formats}}
-explique comment exécuter les programmes de conversion. Ces programmes
-sont livrés avec le paquetage LilyPond, et convertissent une variété
-de formats musicaux vers le format @code{.ly}.
-
-@end itemize
-
-
@subsubheading Annexes
Ce livre contient des tables de référence pratiques.
+@c Nous avons besoin d'ecrivez tous ca, aprez GDP est fini. -gp
+@ignore
@itemize @bullet
@item
@ifhtml
La
@end ifhtml
-@emph{@ref{Literature list}}
+@emph{@ruser{Literature list}}
contient un choix de livres de référence utiles pour ceux qui veulent
en savoir plus sur la notation et la gravure.
@ifhtml
Les
@end ifhtml
-@emph{@ref{Notation manual tables}}
+@emph{@ruser{Notation manual tables}}
sont un ensemble de tableaux montrant les noms d'accord, les
instruments MIDI, les noms de couleur, et la police Feta.
dans un fichier, ajoutez les notes, et c'est prêt !
@item
-La
-@emph{@ref{Cheat sheet}}
+L'
+@emph{@ruser{Cheat sheet}}
est une référence pratique des commandes LilyPond les plus courantes.
@item
L'
-@emph{@ref{LilyPond command index}}
+@emph{@ruser{LilyPond command index}}
est un index de toutes les @code{\commandes} LilyPond.
@item
L'
-@emph{@ref{LilyPond index}}
+@emph{@ruser{LilyPond index}}
est un index complet.
@end itemize
+@subheading Utilisation du programme
+
+Ce livre explique l'exécution du programme et l'intégration de
+partitions LilyPond dans d'autres programmes.
+
+@itemize @bullet
+
+@item
+@emph{@rprogram{Install}}
+explique l'installation (et pour les personnes intéressées la
+compilation) de LilyPond.
+
+@item
+@emph{@rprogram{Running LilyPond}}
+documente le lancement de LilyPond et de ses programmes auxiliaires. De
+plus, cette section explique la mise à jour de fichiers source écrits
+pour d'anciennes versions de LilyPond.
+
+@item
+@emph{@rprogram{LilyPond-book}}
+détaille la création de documents intégrant des exemples musicaux,
+comme ce manuel.
+
+@item
+@emph{@rprogram{Converting from other formats}}
+explique l'exécution des programmes de conversion. Ces programmes sont
+livrés avec le paquetage LilyPond, et convertissent divers formats
+musicaux vers le format @code{.ly}.
+
+@end itemize
+@end ignore
+
+
@subsubheading Autre documentation
D'autres documents constituent de précieuses sources d'information.
disponible aux formats HTML et PDF.
@end iftex
@ifnottex
-Le @ref{Top,glossaire musical,,music-glossary} explique les termes
+Le @ruser{Top,glossaire musical,,music-glossary} explique les termes
musicaux et inclut les traductions dans diverses langues. Il est
également disponible au format PDF.
@end ifnottex
référence du programme
@end iftex
@ifnottex
-@ref{Top,référence du programme,,lilypond-internals}.
+@ruser{Top,référence du programme,,lilypond-internals}.
@end ifnottex
est un ensemble de pages HTML étroitement liées entre elles, qui
documente les moindres petits détails de chaque classe, objet et