@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: 27af34a245b02a6b89c9af3becefcfe676b2e19d
+ 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.38"
+@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
@node Introduction
@chapter Introduction
+Ce chapitre constitue une première présentation de LilyPond et de sa
+documentation.
@menu
-* Engraving::
-* Automated engraving::
+* 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::
* What symbols to engrave?::
-* Music representation::
-* Example applications::
-* About this manual::
+* Music representation::
+* Example applications::
@end menu
@node Engraving
-@section 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
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
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
@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
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
-@section 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,
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.
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
à 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
\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
}
@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
(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
@node What symbols to engrave?
-@section What symbols to engrave?
+@unnumberedsubsec What symbols to engrave?
@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é
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 à
\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
-Le graveur de hampe est notifié de chaque tête de note qui survient.
+@noindent
+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
\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.
contexte de Partition. Le contexte de Partition est le contexte de
notation de plus haut niveau.
+
@seealso
+Référence du programme: @rinternals{Contexts}.
-Program reference: @internalsref{Contexts}.
@lilypond[quote,ragged-right]
\include "engraver-example.ily"
@end lilypond
@node Music representation
-@section 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.
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
+@{
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,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
+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
exprimer de la musique plus complexe. Par exemple
@lilypond[quote,verbatim,fragment,relative=1]
-c4
+f4
@end lilypond
@noindent
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.
@example
<<c4 d4 e4>>
@end example
@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
@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
\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é.
moins de 10% du code source.
@node Example applications
-@section 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 à
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
@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
ê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
-@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.}
+Cette partie présente les différents volumes de la documentation.
-@subheading Manuel de l'utilisateur
+@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
-Ce manuel se divise en trois livres.
-@c pourquoi pas "tomes" au lieu de "livres" ? -John M.
+@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
-@subsubheading Manuel d'apprentissage
-Ce livre explique comment débuter avec LilyPond, et expose de manière
+@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.
-@itemize @bullet
+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.
+
+@itemize
@item
-@ifhtml
-Le
-@end ifhtml
-@emph{@ruser{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{@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 !
+@ref{Tutorial} : introduction en douceur à la typographie musicale.
+Les utilisateurs débutants sont invités à commencer par ce chapitre.
@item
-@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.
+@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{@ruser{Tweaking output}}
-est une introduction aux retouches de gravure avec LilyPond.
+@ref{Tweaking output} : introduction aux retouches de gravure avec
+LilyPond.
-@end itemize
+@item
+@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
-@subsubheading Manuel de référence
+Ce volume contient aussi des annexes que vous pouvez consulter au gré de
+vos besoins :
-Ce livre 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'apprentissage.
+@itemize
-@itemize @bullet
+@item
+@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{@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.
+@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 ne touchent jamais à Scheme.
+@end itemize
+
+
+@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
+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
+
+@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.
+
+@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 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
-@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.
+@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{@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
+@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{@ruser{Changing defaults}}
-explique comment ajuster finement la mise en page.
+@ruser{General input and output} : informations générales sur les
+fichiers source LilyPond et le contrôle des sorties.
@item
-@emph{@ruser{Non-musical notation}}
-traite de sorties non musicales comme les titres, les mouvements
-multiples, et la sélection des instruments MIDI.
+@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{@ruser{Spacing issues}}
-traite de sujets affectant la sortie globale, comme sélectionner
-la taille de papier ou spécifier les sauts de page.
+@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{@ruser{Interfaces for programmers}}
-explique comment créer des fonctions de musique.
+@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.
-@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
+@itemize
@item
-@ifhtml
-La
-@end ifhtml
-@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.
+@ruser{Literature list} : choix de livres de référence, pour en savoir
+plus sur la notation et la gravure.
@item
-Le
-@emph{@ruser{Scheme tutorial}}
-propose une courte introduction à Scheme, le langage de programmation
-utilisé dans les fonctions de musique.
+@ruser{Notation manual tables} : tableaux montrant les noms d'accord,
+les instruments MIDI, les noms de couleur, et la police Feta.
@item
-@ifhtml
-Les
-@end ifhtml
-@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.
+@ruser{Cheat sheet} : référence pratique des commandes LilyPond les
+plus courantes.
@item
-Les
-@emph{@ruser{Templates}}
-de pièces LilyPond. Copiez et collez un modèle
-dans un fichier, ajoutez les notes, et c'est prêt !
+@ruser{LilyPond command index} : index de toutes les @code{\commandes}
+LilyPond.
@item
-L'
-@emph{@ruser{Cheat sheet}}
-est une référence pratique des commandes LilyPond les plus courantes.
+@ruser{LilyPond index} : un index complet.
-@item
-L'
-@emph{@ruser{LilyPond command index}}
-est un index de toutes les @code{\commandes} LilyPond.
+@end itemize
-@item
-L'
-@emph{@ruser{LilyPond index}}
-est un index complet.
-@end itemize
+@node About the Application Usage
+@unnumberedsubsec About the Application Usage
-@subheading Utilisation du programme
+@cindex Utilisation des programmes
+@cindex intégration de LilyPond avec d'autres programmes
-Ce livre explique l'exécution du programme et l'intégration de
+Ce manuel explique l'exécution des programmes et l'intégration de
partitions LilyPond dans d'autres programmes.
-@itemize @bullet
+@itemize
@item
-@emph{@rprogram{Install}}
-explique l'installation (et pour les personnes intéressées la
-compilation) de LilyPond.
+@rprogram{Install} : installation --- et éventuellement 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.
+@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
-@emph{@rprogram{LilyPond-book}}
-détaille la création de documents intégrant des exemples musicaux,
-comme ce manuel.
+@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
-@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}.
+@rprogram{LilyPond-book} : création de documents intégrant des
+extraits musicaux, comme ce manuel.
+
+@item
+@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
-@end ignore
-@subsubheading Autre documentation
+@node About the Snippet List
+@unnumberedsubsec About the Snippet List
-D'autres documents constituent de précieuses sources d'information.
+@cindex snippets
+@cindex extraits de code
+@cindex LSR
+@cindex LilyPond Snippet Repository
-@itemize @bullet
-@cindex jargon
-@cindex terminologie
-@cindex langues étrangères
-@cindex langue
-@cindex langage
-@iftex
-Le glossaire de musique explique les termes musicaux, et inclut
-leur traduction dans diverses langues. C'est un document séparé,
-disponible aux formats HTML et PDF.
-@end iftex
-@ifnottex
-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
-terminologie, il est conseillé de consulter le glossaire, notamment
-pour les parties non encore traduites de la documentation.
+@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.
-@cindex exemples de code
-@cindex LSR
-@item
-Les
-@ifhtml
-@uref{source/input/lsr/collated-files.html,Exemples de code}
-@end ifhtml
-@ifnothtml
-Exemples de code
-@end ifnothtml
-sont une vaste sélection de petits exemples montrant des trucs, astuces
-et fonctionnalités particulières de LilyPond. La plupart de ces
-exemples sont également disponibles sur le
-@uref{http://lsr.dsi.unimi.it/,LilyPond Snippet Repository}. Ce site
-Web possède également le manuel de LilyPond avec une fonctionnalité de
-recherche.
+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.
-@item
-La
-@iftex
-référence du programme
-@end iftex
-@ifnottex
-@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
-fonction de LilyPond. Cette documentation est produite directement à
-partir des définitions de formatage utilisées.
+La liste des exemples correspondant à chacun des sous-chapitres du
+manuel de notation est accessible par des liens dans le paragraphe
+@strong{Voir aussi}.
+
+
+@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 renvoie à 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.
-@end itemize
-Lorsque vous serez un utilisateur expérimenté, vous pourrez consulter le
-manuel comme une référence : il y a un index complet@footnote{Si vous
-cherchez quelque chose sans le trouver dans la documentation, c'est un
-bogue. Dans ce cas, merci d'envoyer un rapport de bogue.}, mais le
-manuel est aussi disponible en
-@iftex
-une seule grande page,
-@end iftex
+@node Other documentation
+@unnumberedsubsec Other documentation
+
+Pour finir, présentons d'autres précieuses sources de documentation.
+
+@itemize
+
+@item
@ifhtml
-@uref{source/Documentation/user/lilypond-big-page.html, une seule grande
-page},
+@ifset bigpage
+@uref{../topdocs/NEWS.html,Nouveautés} :
+@end ifset
+@ifclear bigpage
+@uref{../../topdocs/NEWS.html,Nouveautés} :
+@end ifclear
@end ifhtml
-ce qui facilite la recherche avec la fonction de recherche de votre
-navigateur.
-
-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é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
-répértoire racine de l'archive source. Par exemple,
+@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
+relativement au répértoire racine de l'archive source. Par exemple,
@file{input/@/test/@/bla@/.ly} peut référer au fichier
@file{lilypond@/2.x.y/@/input/@/test/@/bla@/.ly}. Dans les paquets
-binaires pour les plateformes Unix, la documentation et les exemples se
-trouvent généralement sous @file{/usr/@/share/@/doc/@/lilypond/}. Les
-fichiers d'initialisation, par exemple @file{scm/@/lily@/.scm}, ou
+binaires pour les plateformes Unix, la documentation et les exemples
+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 retoucher
-@cindex variables
-@cindex propriétés
-@cindex lilypond-internals
-@cindex documentation du fonctionnement interne
-@cindex Scheme
-@cindex étendre lilypond
-@cindex index
-
-Pour finir, ce manuel et les autres sont disponibles en ligne, à la
-fois aux formats PDF et HTML, à partir du site Web, 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