@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 Translators: Ludovic Sardain, John Mandereau
+@c Translation checkers: Jean-Charles Malahieude, Jean-Yves Baudais
+
+
@node Introduction
@chapter Introduction
@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}}
+@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
@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.
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