@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
-@c This file is part of lilypond.tely
+@c This file is part of lilypond-kearning.tely
@ignore
- Translation of GIT committish: a765cf7a841733570469b8f8b5c5ba538c4187d6
+ 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.61"
+
+@c Translators: Ludovic Sardain, John Mandereau
+@c Translation checkers: Jean-Charles Malahieude, Jean-Yves Baudais
+@c Translation status: post-GDP
+
+
@node Introduction
@chapter Introduction
+Ce chapitre constitue une première présentation de LilyPond et de sa
+documentation.
+
+@menu
+* Background::
+* About the documentation::
+@end menu
+
+
+@node Background
+@section Background
+
+Cette partie présente les objectifs de LilyPond ainsi que son
+architecture.
@menu
-* Engraving::
-* Automated engraving::
+* Engraving::
+* Automated engraving::
* What symbols to engrave?::
-* Music representation::
-* Example applications::
-* About this manual::
+* Music representation::
+* Example applications::
@end menu
@node Engraving
-@section Engraving
+@unnumberedsubsec Engraving
L'art de la typographie musicale se nomme la @emph{gravure}. Ce terme
est issu du processus traditionnel d'impression musicale. Il y a
@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
@end ifnottex
@end ifnotinfo
@ifinfo
-@c workaround for makeinfo-4.6: line breaks and multi-column cookies
-@image{henle-flat-bw,,,png} @image{baer-flat-bw,,,png}
-@image{lily-flat-bw,,,png}
+@image{lilypond/henle-flat-bw,,,png} @image{lilypond/baer-flat-bw,,,png}
+@image{lilypond/lily-flat-bw,,,png}
@end ifinfo
@item @tab
@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
ne se contente pas de remarquer la distance entre les têtes de notes,
il prend en compte également la distance entre les hampes
consécutives. Ainsi, par compensation, les notes avec une combinaison
-« hampe vers le haut »/@/« hampe vers le bas » doivent être éloignées
-l'une de l'autre, et les notes avec une combinaison « hampe vers le
-bas »/@/« hampe vers le haut » rapprochées, le tout dépendant de la
+@qq{hampe vers le haut}/@/@qq{hampe vers le bas} doivent être éloignées
+l'une de l'autre, et les notes avec une combinaison @qq{hampe vers le
+bas}/@/@qq{hampe vers le haut} rapprochées, le tout dépendant de la
position verticale des notes. Les deux premières mesures sont
imprimées avec cette correction, les deux suivantes sans. Les notes
-dans les deux dernières mesures forment des blocs de notes « hampe
-vers le bas »/@/« hampe vers le haut ».
+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 Automated engraving
-@section Automated engraving
+@unnumberedsubsec Automated engraving
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
-faire leur travail?
+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
programme étaient figées par les développeurs. Ceci s'est avéré
insatisfaisant pour plusieurs raisons :
-@itemize @bullet
+@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
\new Score \with {
\override SpacingSpanner #'spacing-increment = #3
\override TimeSignature #'transparent = ##t
-} \relative {
+} \relative c' {
\stemDown <e g b>4_>-\arpeggio
\override Arpeggio #'direction = #RIGHT
\stemUp <e g b>4^>-\arpeggio
@node What symbols to engrave?
-@section What symbols to engrave?
+@unnumberedsubsec 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
\include "engraver-example.ily"
\score {
- \topVoice
- \layout {
- \context {
+ \topVoice
+ \layout {
+ \context {
\Voice
\remove "Stem_engraver"
\remove "Phrasing_slur_engraver"
\remove "Script_engraver"
\remove "Beam_engraver"
\remove "Auto_beam_engraver"
- }
- \context {
+ }
+ \context {
\Staff
\remove "Accidental_engraver"
\remove "Key_engraver"
\remove "Time_signature_engraver"
\remove "Staff_symbol_engraver"
\consists "Pitch_squash_engraver"
- }
-}
+ }
+ }
}
@end lilypond
}
@end lilypond
+@noindent
Le graveur de hampe est notifié 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
@seealso
-Program reference: @internalsref{Contexts}.
+Référence du programme: @rinternals{Contexts}.
@lilypond[quote,ragged-right]
\include "engraver-example.ily"
@end lilypond
@node Music representation
-@section Music representation
+@unnumberedsubsec Music representation
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,
conséquent il est facile de saisir
@example
+@{
c'4 d'8
+@}
@end example
@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 à
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
@lilypond[quote,verbatim,fragment,relative=1]
-c4
+f4
@end lilypond
@noindent
@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
@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
+@unnumberedsubsec 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
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
être générées. L'exemple suivant associe quelques constructions
plus exotiques :
-@lilypondfile[quote,ragged-right]{screech-boink.ly}
+@lilypond[quote]
+\header {
+ title = "Screech and boink"
+ subtitle = "Random complex notation"
+ composer = "Han-Wen Nienhuys"
+}
+
+\score {
+ \context PianoStaff <<
+ \new Staff = "up" {
+ \time 4/8
+ \key c \minor
+ << {
+ \revert Stem #'direction
+ \change Staff = down
+ \set subdivideBeams = ##t
+ g16.[
+ \change Staff = up
+ c'''32
+ \change Staff = down
+ g32
+ \change Staff = up
+ c'''32
+ \change Staff = down
+ g16]
+ \change Staff = up
+ \stemUp
+ \set followVoice = ##t
+ c'''32([ b''16 a''16 gis''16 g''32)]
+ } \\ {
+ s4 \times 2/3 { d'16[ f' g'] } as'32[ b''32 e'' d'']
+ } \\ {
+ s4 \autoBeamOff d''8.. f''32
+ } \\ {
+ s4 es''4
+ } >>
+ }
+
+ \new Staff = "down" {
+ \clef bass
+ \key c \minor
+ \set subdivideBeams = ##f
+ \override Stem #'french-beaming = ##t
+ \override Beam #'thickness = #0.3
+ \override Stem #'thickness = #4.0
+ g'16[ b16 fis16 g16]
+ << \makeClusters {
+ as16 <as b>
+ <g b>
+ <g cis>
+ } \\ {
+ \override Staff.Arpeggio #'arpeggio-direction =#down
+ <cis, e, gis, b, cis>4\arpeggio
+ }
+ >> }
+ >>
+ \midi {
+ \context {
+ \Score
+ tempoWholesPerMinute = #(ly:make-moment 60 8)
+ }
+ }
+ \layout {
+ \context {
+ \Staff
+ \consists Horizontal_bracket_engraver
+ }
+ }
+}
+@end lilypond
Les extraits exposés ici ont tous été écrits à la main, mais ce n'est
pas une obligation. Puisque le moteur de formatage est en grande
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
+@node About the documentation
+@section About the documentation
+
+Cette partie présente les différents volumes de la documentation.
+
+@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:: 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
+@unnumberedsubsec About the Learning Manual
+
+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.
-Le manuel est divisé en chapitres comme suit :
-@itemize @bullet
+@itemize
@item
-@ifhtml
-Le
-@end ifhtml
-@emph{@ref{Tutorial}}
-propose une introduction en douceur à la typographie musicale.
-Les utilisateurs débutants sont invités à commencer ici.
+@ref{Introduction} : le pourquoi du comment de LilyPond.
@item
-@emph{@ref{Putting it all together}}
-explique des concepts généraux du format de ficheir ly. Si vous n'êtes
-pas certain de l'endroit où placer une commande, lisez ce chapitre !
+@ref{Tutorial} : introduction en douceur à la typographie musicale.
+Les utilisateurs débutants sont invités à commencer par ce chapitre.
@item
-@emph{@ref{Working on LilyPond projects}}
-montre des utilisations pratiques de LilyPond et donne des conseils
-afin d'éviter les problèmes les plus courants.
+@ref{Fundamental concepts} : concepts généraux du format de fichier
+@code{ly} spécifique à LilyPond. Si vous n'êtes pas certain de
+l'endroit où placer une commande, lisez ce chapitre !
@item
-@emph{@ref{Tweaking output}}
-est une introduction aux retouches de gravure avec LilyPond.
+@ref{Tweaking output} : introduction aux retouches de gravure avec
+LilyPond.
@item
-@emph{@ref{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.
+@ref{Working on LilyPond projects} : utilisation pratique de LilyPond,
+conseils généraux, prévention et résolution des problèmes les plus
+courants. À lire avant de se lancer dans des travaux d'envergure !
+
+@end itemize
+
+Ce volume contient aussi des annexes que vous pouvez consulter au gré de
+vos besoins :
+
+@itemize
@item
-@emph{@ref{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.
+@ref{Templates} de pièces LilyPond. Copiez et collez un modèle dans
+un fichier, ajoutez les notes, et c'est prêt !
@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
+@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.
+@end itemize
+
+
+@node About the Music Glossary
+@unnumberedsubsec About the Music Glossary
+
+@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
+musicales, il est conseillé de consulter le glossaire, notamment pour
+les parties non encore traduites de la documentation.
+
+
+@node About the Notation Reference
+@unnumberedsubsec About the Notation Reference
+
+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.
+
+@itemize
+
+@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 n'internationalise pas encore des documents Info, donc nous n'en
+@c avons rien à faire pour l'instant. -jm
@item
-@emph{@ref{Changing defaults}}
-explique comment ajuster finement la mise en page.
+@ruser{Musical notation} : cette partie décrit la notation de base,
+qui sera utile dans la plupart des projets de partition. Les sujets
+sont groupés par type de notation.
@item
-@emph{@ref{Non-musical notation}}
-traite de sorties non musicales comme les titres, les mouvements
-multiples, et la sélection des instruments MIDI.
+@ruser{Specialist notation} : cette partie détaille des éléments de
+notation spécifiques à certains instruments ou styles. Les sujets
+sont groupés par type de notation.
@item
-@emph{@ref{Spacing issues}}
-traite de sujets affectant la sortie globale, comme sélectionner
-la taille de papier ou spécifier les sauts de page.
+@ruser{General input and output} : informations générales sur les
+fichiers source LilyPond et le contrôle des sorties.
@item
-@emph{@ref{Interfaces for programmers}}
-explique comment créer des fonctions de musique.
+@ruser{Spacing issues} : différents aspects de l'espacement selon les
+axes et échelles, par exemple la sélection de la taille de papier, ou
+la gestion des sauts de page.
@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.
+@ruser{Changing defaults} : ce chapitre est une référence des
+différentes formes de retouches, qui permettent d'obtenir de Lilypond
+(presque) tout ce que vous désirez.
@item
-@emph{@ref{LilyPond-book}}
-explique comment créer des documents intégrant des exemples musicaux,
-comme ce manuel.
+@ruser{Interfaces for programmers} :.création de fonctions de musique
+à l'aide de Scheme.
+
+@end itemize
+
+Les annexes de ce manuel contiennent entre autres des tableaux de
+référence pratiques.
+
+@itemize
@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}.
+@ruser{Literature list} : choix de livres de référence, pour en savoir
+plus sur la notation et la gravure.
@item
-@ifhtml
-La
-@end ifhtml
-@emph{@ref{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.
+@ruser{Notation manual tables} : tableaux montrant les noms d'accord,
+les instruments MIDI, les noms de couleur, et la police Feta.
@item
-Le
-@emph{@ref{Scheme tutorial}}
-propose une courte introduction à Scheme, le langage de programmation
-utilisé par les fonctions de musique.
+@ruser{Cheat sheet} : référence pratique des commandes LilyPond les
+plus courantes.
@item
-@ifhtml
-Les
-@end ifhtml
-@emph{@ref{Notation manual tables}}
-sont un ensemble de tableaux montrant les noms d'accord, les
-instruments MIDI, les noms de couleur, et la police Feta.
+@ruser{LilyPond command index} : index de toutes les @code{\commandes}
+LilyPond.
+
+@item
+@ruser{LilyPond index} : un index complet.
+
+@end itemize
+
+
+@node About the Application Usage
+@unnumberedsubsec About the Application Usage
+
+Ce manuel explique l'exécution des programmes et l'intégration de
+partitions LilyPond dans d'autres programmes.
+
+@itemize
+
+@item
+@rprogram{Install} : installation --- et éventuellement compilation ---
+de LilyPond.
@item
-Les
-@emph{@ref{Templates}}
-de pièces LilyPond. Copiez et collez un modèle
-dans un fichier, ajouter les notes, et c'est prêt !
+@rprogram{Setup} : configuration de votre système pour une utilisation
+optimale de LilyPond, comprenant l'utilisation d'environnements
+adaptés pour certains éditeurs de tecte.
@item
-La
-@emph{@ref{Cheat sheet}}
-est une référence pratique des commandes LlyPond les plus courantes.
+@rprogram{Running LilyPond} : exécution de LilyPond et de ses
+programmes auxiliaires. De plus, cette partie explique comment
+effectuer la mise à jour de fichiers source écrits avec d'anciennes
+versions de LilyPond.
@item
-L'
-@emph{@ref{LilyPond command index}}
-est un index de toutes les @code{\commandes} LilyPond.
+@rprogram{LilyPond-book} : création de documents intégrant des
+extraits musicaux, comme ce manuel.
@item
-L'
-@emph{@ref{LilyPond index}}
-est un index complet.
+@rprogram{Converting from other formats} : utilisation des programmes
+de conversion. Ces programmes sont livrés avec le paquetage LilyPond,
+et convertissent divers formats de musique vers le format @code{.ly}.
@end itemize
-Une fois que vous êtes un utilisateur expérimenté, vous pouvez
-utiliser le manuel comme référence : il y a un index
-exhaustif@footnote{Si vous cherchez quelque chose, et que vous ne le
-trouvez pas dans le manuel, ceci est considéré comme un bogue ; dans
-ce cas, envoyez un rapport de bogue s'il-vous-plaît.}, mais ce
-document est aussi disponible en
-@iftex
-une seule grande page HTML,
-@end iftex
-@ifhtml
-@uref{source/Documentation/user/lilypond.html, une seule grande page},
-@end ifhtml
-dans laquelle la fonction recherche d'un navigateur Web est très utile
-pour trouver quelque chose.
-@cindex search in manual
-@cindex using the manual
-
-@c FIXME:
-@c add/integrate glossary, put in list above
-Si vous n'êtes pas familier avec la notation musicale ou la
-terminologie, il est conseillé de consulter le glossaire, notamment
-pour les parties non encore traduites de la documentation.
-@iftex
-Le glossaire de musique explique les termes musicaux, et inclut
-les traductions vers divers languages. C'est un document séparé,
-disponible dans les 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
-également disponible au format PDF.
-@end ifnottex
-@cindex idiom
-@cindex jargon
-@cindex terminology
-@cindex foreign languages
-@cindex language
+@node About the Snippet List
+@unnumberedsubsec About the Snippet List
-Ce manuel ne serait pas complet sans un certain nombre d'autres
-documents. Ils ne sont pas tous disponibles au format papier, mais
-devraient être inclus dans le paquetage de documentation pour votre
-plateforme.
+@cindex snippets
+@cindex LSR
-@itemize @bullet
-@item
-@iftex
-Référence du programme
-@end iftex
-@ifnottex
-@ref{Top,Référence du programme,,lilypond-internals}.
-@end ifnottex
+@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}
+(LSR). Tous ces exemples sont dans le domaine public.
+
+Notez bien que cette annexe n'est en aucune manière un miroir ou même
+une partie du LSR. Dans la mesure où le LSR repose sur une version
+stable de LilyPond, les exemples illustrant des fonctionnalités
+introduites dans la dernière version de développement ne peuvent y
+figurer ; c'est pourquoi vous les trouverez dans le répertoire
+@file{input/new/} des sources de LilyPond.
+
+La liste des exemples correspondant à chacun des sous-chapitres du
+manuel de notation est accessible par des liens dans le paragraphe
+@strong{Voir aussi}.
-La référence du programme est un groupe de pages HTML étroitement
-liées entre elles, qui documente tous les petits détails de chaque
-classe, objet et fonction de LilyPond. Elle est produite directement
-à partir des définitions de formatage utilisées.
+
+@node About the Internals Reference
+@unnumberedsubsec About the Internals Reference
+
+@cindex retoucher
+@cindex variables
+@cindex propriétés
+@cindex lilypond-internals
+@cindex documentation du fonctionnement interne
+@cindex Scheme
+@cindex étendre lilypond
+@cindex index
+
+@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
variables qui contrôlent les épaisseurs, les distances etc., peuvent
ê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
-documentation au format HTML, ces sous-sections ont des liens
+document. Chaque section du manuel de notation a un paragraphe @b{Voir
+aussi}, qui renvoie à la documentation générée automatiquement. Dans la
+documentation au format HTML, ces paragraphes disposent de liens
cliquables.
-@cindex snippets
-@item
-@ifnothtml
-Exemples de source divers.
-@end ifnothtml
-@ifhtml
-@c Works, but link name is not so nice; so write-out macro
-@c @inputfileref{input/test,Various input examples}.
-@uref{source/input/test/collated-files.html,Exemples de source divers}.
-@end ifhtml
-Cette ensemble de fichiers montre des trucs et astuces variés, sous
-la forme d'un large fichier HTML, avec des images et des textes
-explicatifs.
+@node Other documentation
+@unnumberedsubsec Other documentation
+
+Pour finir, présentons d'autres précieuses sources de documentation.
+
+@itemize
@item
-@ifnothtml
-Les tests de régression.
-@end ifnothtml
@ifhtml
-@c Works, but link name is not so nice; so write-out macro
-@c @inputfileref{input/regression,The regression tests}.
-@uref{source/input/regression/collated-files.html,Les tests de régression}.
+@ifset bigpage
+@uref{../topdocs/NEWS.html,Nouveautés} :
+@end ifset
+@ifclear bigpage
+@uref{../../topdocs/NEWS.html,Nouveautés} :
+@end ifclear
@end ifhtml
-
-Cet ensemble de fichiers teste chaque fonctionnalité de notation et de
-gravure de Lilypond en un seul fichier. L'ensemble est surtout
-présent pour nous aider à deboguer les problèmes, mais peut également
-être instructif pour voir comment nous testons le logiciel. Le format
-est identique au document de trucs et astuces.
-@end itemize
-
-
-Dans tous les documents HTML qui incluent des fragments musicaux,
-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
+@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
+courriels qui ont été envoyés à la liste anglophone des utilisateurs.
+Beaucoup de questions sont apparues plusieurs fois sur la liste, il y
+a donc des chances que si vous avez une question, la réponse puisse
+être dans ces archives.
+@c DIV specific
+@uref{http://lists.gnu.org/archive/html/lilypond-user-fr/,Les archives
+de la liste francophone} ne sont pas aussi bien fournies, mais vous
+pouvez toujours y chercher des conversations passées sur les
+traductions, et si vous avez de la chance une réponse à une question.
+@c END DIV
+
+@item @uref{http://lists.gnu.org/archive/html/lilypond-devel/, Les
+archives de la liste lilypond-devel} : les courriels envoyés à la
+liste des développeurs y sont archivés. Les sujets de discussion sont
+plus techniques ; si vous voulez vous renseigner sur l'histoire du
+développement ou si vous avez une question très technique, tentez
+votre chance en cherchant dans ces archives.
+
+@item Fragments de musique au cours du texte : dans tous les documents
+HTML qui incluent des fragments musicaux, le code LilyPond utilisé
+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
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/}.
-
-@cindex adjusting output
-@cindex variables
-@cindex properties
-@cindex lilypond-internals
-@cindex internal documentation
-@cindex Scheme
-@cindex extending lilypond
-@cindex index
-
-Pour finir, ce manuel et les autres sont disponibles en ligne, à la
-fois aux formats PDF et HTML, à partir du site de LilyPond, accessible
-à l'adresse @uref{http://@/www@/.lilypond@/.org/}.
+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
projects / lilypond.git / blobdiff