@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: 8bf657e5c944bd8da26af01d6a021b48e74ff10a
+ 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 Translators: Ludovic Sardain, John Mandereau
+@c Translation checkers: Jean-Charles Malahieude, Jean-Yves Baudais
+
+
@node Introduction
@chapter Introduction
@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
avoir du mal à se retrouver sur la page.
De même, l'aspect robuste des symboles sur d'épaisses lignes de
-portées ressort mieux quand la partition est éloignée du lecteur,
+portée ressort mieux quand la partition est éloignée du lecteur,
comme sur un pupitre par exemple. Une organisation minutieuse des
espaces vides permet de minimiser l'espace qu'occupe la musique, tout
-en évitant que les symboles s'amassent les uns contre les autres. le
+en évitant que les symboles s'amassent les uns contre les autres. Le
résultat permet de réduire le nombre de pages à tourner, ce qui est un
grand avantage.
@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é
-@emph{quels} symbols doivent être imprimés, c'est-à-dire quelle
+@emph{quels} symboles doivent être imprimés, c'est-à-dire quelle
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 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ées @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
Sur une échelle microscopique, une telle syntaxe est facile à
utiliser. A 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
+pièces complexes comme des symphonies ou des opéras ? La structure
est formée par le concept d'expression musicale : en combinant
de petits fragments de musique pour en former de plus grands, on peut
exprimer de la musique plus complexe. Par exemple
@end lilypond
@noindent
-Cette expression est mise dans une séquence en l'encadrant avec des
-accolades @code{@{@tie{}@dots{}@tie{}@}}
+Cette expression est mise dans une séquence grace à l'encadrement par
+des accolades @code{@{@tie{}@dots{}@tie{}@}}
@example
@{ f4 <<c4 d4 e4>> @}
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
-clairement et sans ambiguités.
+clairement et sans ambiguité.
L'interface utilisateur et la syntaxe sont ce que les gens voient et
-manipulent le plus. Elles sont e npartie une affaire de goût, et
+manipulent le plus. Elles sont en partie une affaire de goût, et
aussi sujettes à beaucoup de discussions. Même si ces discussions sur
les goûts ont leur mérite, elles ne sont pas très productives. D'un
point de vue plus large sur LilyPond, l'importance de la syntaxe est
minime : il est facile d'inventer une syntaxe concise, alors qu'écrire
un code de formatage décent est beaucoup plus difficile. Ceci est
également illustré par le nombre de lignes de codes pour les
-composants respectifs : l'analyse et la représentation représentent
+composants respectifs : l'analyse et la représentation constituent
moins de 10% du code source.
@node Example applications
@section Example applications
-Nous avons conçu Lilypond comme une expérimentation visant à
+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
accomplir des travaux utiles. L'application la plus simple est
sites Internet et des présentations multimédias.
Ce manuel montre également une application : le format d'entrée est du
-texte, et peut donc facilement être intégrés dans d'autres formats
+texte, et peut donc facilement être intégré dans d'autres formats
basés sur le texte comme @LaTeX{}, HTML, ou dans le cas de ce manuel,
Texinfo. À l'aide d'un programme spécial, les extraits de code
peuvent être remplacés par des images de musiques dans les fichiers de
@node About this manual
@section About this manual
-Le manuel est divisé en quatres livres.
+Deux manuels traitent de LilyPond : le @emph{manuel de l'utilisateur}
+--- que vous lisez actuellement --- et le @emph{manuel d'utilisation du
+programme.}
+
+@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
@ifhtml
Le
@end ifhtml
-@emph{@ref{Tutorial}}
+@emph{@ruser{Tutorial}}
propose une introduction en douceur à la typographie musicale.
Les utilisateurs débutants sont invités à commencer ici.
@item
-@emph{@ref{Putting it all together}}
-explique des concepts généraux du format de ficheir ly. Si vous n'êtes
+@emph{@ruser{Putting it all together}}
+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 !
@item
-@emph{@ref{Working on LilyPond projects}}
+@emph{@ruser{Working on LilyPond projects}}
montre des utilisations pratiques de LilyPond et donne des conseils
afin d'éviter les problèmes les plus courants.
@item
-@emph{@ref{Tweaking output}}
+@emph{@ruser{Tweaking output}}
est une introduction aux retouches de gravure avec LilyPond.
@end itemize
@subsubheading Manuel de référence
Ce livre détaille toutes les commandes LilyPond produisant une notation
-musicale. La lecture de ce livre requiert une bonne compréhension des
+musicale. La lecture de cet ouvrage requiert une bonne compréhension des
concepts exposés dans le manuel d'apprentissage.
@itemize @bullet
@item
-@emph{@ref{Basic notation}}
+@emph{@ruser{Basic 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{Instrument-specific 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}}
+@emph{@ruser{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.
@item
Le
-@emph{@ref{Scheme tutorial}}
+@emph{@ruser{Scheme tutorial}}
propose une courte introduction à Scheme, le langage de programmation
utilisé dans les fonctions de musique.
@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.
@item
Les
-@emph{@ref{Templates}}
+@emph{@ruser{Templates}}
de pièces LilyPond. Copiez et collez un modèle
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.
@cindex langage
@iftex
Le glossaire de musique explique les termes musicaux, et inclut
-les traductions vers divers languages. C'est un document séparé,
+leur traduction dans diverses langues. C'est un document séparé,
disponible aux formats HTML et PDF.
@end iftex
@ifnottex
-Le @ref{Top,glossaire musical,,music-glossary} explique les termes
-musicaux et inclut les traductions vers divers languages. Il est
+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
Si vous n'êtes pas familier avec la notation musicale ou la
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
être modifiées dans les fichiers d'entrée. Il y a un grand nombre
d'options de formatage, et elles sont toutes décrites dans ce
document. Chaque section du manuel de notation a une section @b{Voir
-aussi} qui réfère à la documentation générée automatiquement. Dans la
+aussi} qui renvoie à la documentation générée automatiquement. Dans la
documentation au format HTML, ces sous-sections ont des liens
cliquables.
le code Lilypond utilisé pour produire l'image peut être vu en
cliquant l'image.
-L'emplacement des fichiers de documentation mentionné ici peut varier
+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
projects / lilypond.git / blobdiff