@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@c This file is part of lilypond-kearning.tely
@ignore
- Translation of GIT committish: 27af34a245b02a6b89c9af3becefcfe676b2e19d
+ 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.51"
+@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
@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
\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
\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
@seealso
-Program reference: @rinternals{Contexts}.
+Référence du programme: @rinternals{Contexts}.
@lilypond[quote,ragged-right]
\include "engraver-example.ily"
exprimer de la musique plus complexe. Par exemple
@lilypond[quote,verbatim,fragment,relative=1]
-c4
+f4
@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
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 (LM):: introduction à LilyPond, ce volume
- explique en profondeur comment créer de la notation.
-
-* About the Music Glossary (MG):: ce volume explique de nombreux termes
- musicaux et en donne la traduction dans d'autres langues.
-
-* About the Notation Reference (NR):: ce volume représente le cœur de
- la documentation. Il fournit des informations détaillées sur la
- manière de créer de la notation. La lecture de cet ouvrage requiert
- une bonne compréhension des concepts exposés dans le manuel
- d'initiation.
-
-* About the Application Usage (AU):: ce volume traite des différentes
- composantes de LilyPond ainsi que des particularités selon les
- environements.
-
-* About the Snippet List (SL):: ce volume constitue une collection
- d'extraits réalisés avec LilyPond.
-
-* About the Internals Reference (IR):: ce volume est la source
- d'information sur le fonctionnement interne de LilyPond. Il constitue
- la base des ressources nécessaires à l'élaboration de retouches.
-
-* Other documentation:: d'autres sources de documentation sont
- disponibles, telles que les notes d'actualité et les archives des
- listes de diffusion.
-
+* 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 (LM)
-@unnumberedsubsec About the Learning Manual (LM)
+@node About the Learning Manual
+@unnumberedsubsec About the Learning Manual
-Ce volume explique comment débuter avec LilyPond, et expose de manière
+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.
+
@itemize
@item
-@ref{Introduction} :
-le pourquoi du comment de LilyPond.
+@ref{Introduction} : le pourquoi du comment de LilyPond.
@item
-@ref{Tutorial} :
-introduction en douceur à la typographie musicale.
-Les utilisateurs débutants sont invités à commencer ici.
+@ref{Tutorial} : introduction en douceur à la typographie musicale.
+Les utilisateurs débutants sont invités à commencer par ce chapitre.
@item
-@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 !
+@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
-@ref{Tweaking output} :
-introduction aux retouches de gravure avec LilyPond.
+@ref{Tweaking output} : introduction aux retouches de gravure avec
+LilyPond.
@item
-@ref{Working on LilyPond projects} :
-utilisations pratiques de LilyPond, et conseils
-afin d'éviter les problèmes les plus courants. À lire absolument avant
-de se lancer dans des travaux d'envergure.
+@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
@itemize
@item
-@ref{Templates}
-de pièces LilyPond. Copiez et collez un modèle
-dans un fichier, ajoutez les notes, et c'est prêt !
+@ref{Templates} de pièces LilyPond. Copiez et collez un modèle dans
+un fichier, ajoutez les notes, et c'est prêt !
@item
-@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.
+@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 (MG)
-@unnumberedsubsec About the Music Glossary (MG)
+@node About the Music Glossary
+@unnumberedsubsec About the Music Glossary
-@itemize
@cindex jargon
@cindex terminologie
@cindex langues étrangères
@cindex langue
-@cindex langag
+@cindex langage
-@ref{Top,Music Glossary,,music-glossary} : explication des termes
-musicaux et traduction dans diverses langues. Il est
-également disponible au format PDF.
-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.
-
-@end itemize
+@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 (NR)
-@unnumberedsubsec About the Notation Reference (NR)
+@node About the Notation Reference
+@unnumberedsubsec About the Notation Reference
-Ce volume détaille toutes les commandes LilyPond produisant une notation
+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'apprentissage.
+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
-@ruser{Musical notation} :
-sujets groupés par type de notation. Cette partie
-détaille la notation de base, qui sera utile dans la plupart des
-projets de partition.
+@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
-@ruser{Specialist notation} :
-sujets groupés par type de notation. Cette partie détaille
-des spécificités concernant certains instruments ou la voix.
+@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
-@ruser{Input syntax} :
-informations généralistes quant aux fichiers LilyPond et
-comment contrôler les sorties.
+@ruser{General input and output} : informations générales sur les
+fichiers source LilyPond et le contrôle des sorties.
@item
-@ruser{Spacing issues} :
-sujets affectant la sortie globale, comme sélectionner
-la taille de papier ou spécifier les sauts de page.
+@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
-@ruser{Changing defaults} :
-comment, grace aux retouches, obtenir de Lilypond
-presque tout ce que vous désirez.
+@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
-@ruser{Interfaces for programmers} :
-comment créer des fonctions de musique à l'aide de Scheme.
+@ruser{Interfaces for programmers} :.création de fonctions de musique
+à l'aide de Scheme.
@end itemize
-Ce volume contient aussi des annexes que vous pouvez consulter au gré de
-vos besoins :
+Les annexes de ce manuel contiennent entre autres des tableaux de
+référence pratiques.
@itemize
@item
-@ruser{Literature list} :
-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
-@ruser{Notation manual tables} :
-ensemble de tableaux montrant les noms d'accord, les
-instruments MIDI, les noms de couleur, et la police Feta.
+@ruser{Notation manual tables} : tableaux montrant les noms d'accord,
+les instruments MIDI, les noms de couleur, et la police Feta.
@item
-@ruser{Cheat sheet} :
-référence pratique des commandes LilyPond les plus courantes.
+@ruser{Cheat sheet} : référence pratique des commandes LilyPond les
+plus courantes.
@item
-@ruser{LilyPond command index} :
-index de toutes les @code{\commandes} LilyPond.
+@ruser{LilyPond command index} : index de toutes les @code{\commandes}
+LilyPond.
@item
-@ruser{LilyPond index} :
-un index complet.
+@ruser{LilyPond index} : un index complet.
@end itemize
-@node About the Application Usage (AU)
-@unnumberedsubsec About the Application Usage (AU)
-Ce volume explique l'exécution du programme et l'intégration de
+@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} :
-comment installer de LilyPond, et pour ceux que cela intéresse,
-comment le compiler.
+@rprogram{Install} : installation --- et éventuellement compilation ---
+de LilyPond.
@item
-@rprogram{Setup} :
-comment configurer votre ordinateur pour une utilisation optimale
-de LilyPond, y compris avec certains éditeurs de tecte.
+@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
-@rprogram{Running LilyPond} :
-comment lancer LilyPond et ses programmes auxiliaires. De
-plus, cette partie explique comment effectuer la mise à jour de fichiers
-source écrits avec d'anciennes versions de LilyPond.
+@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
-@rprogram{LilyPond-book} :
-comment créer des documents intégrant des exemples musicaux,
-comme ce manuel.
+@rprogram{LilyPond-book} : création de documents intégrant des
+extraits musicaux, comme ce manuel.
@item
-@rprogram{Converting from other formats} :
-comment exécuter les programmes de conversion. Ces programmes sont
-livrés avec le paquetage LilyPond, et convertissent divers formats
-musicaux vers le format @code{.ly}.
+@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
-@node About the Snippet List (SL)
-@unnumberedsubsec About the Snippet List (SL)
+@node About the Snippet List
+@unnumberedsubsec About the Snippet List
@cindex snippets
@cindex LSR
-@c FIXME: check on kainhofer.
-@ref{Top,LilyPond Snippet List,,lilypond-snippets} :
+@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}, abrégé
-sous la forme de LSR. Ils sont dans le domaine public.
+@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 mirroir du LSR.
-Dans la mesure où le LSR repose sur une version stable de LilyPond, un
-exemple qui illustrerait de nouvelles fonctionnalités de la version de
-développement devrait y être ajouté isolément. C'est la raison pour
-laquelle vous le trouverez alors dans le répertoire @file{input/new/}
-des sources de LilyPond.
+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 un lien au paragraphe
+manuel de notation est accessible par des liens dans le paragraphe
@strong{Voir aussi}.
-@node About the Internals Reference (IR)
-@unnumberedsubsec About the Internals Reference (IR)
+@node About the Internals Reference
+@unnumberedsubsec About the Internals Reference
-@c zzz
-
-@itemize
+@cindex retoucher
+@cindex variables
+@cindex propriétés
+@cindex lilypond-internals
+@cindex documentation du fonctionnement interne
+@cindex Scheme
+@cindex étendre lilypond
+@cindex index
-@item
-La
-@iftex
-référence du programme
-@end iftex
-@ifnottex
-@ref{Top,Internals Reference,,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.
+@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
ê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 un paragraphe @b{Voir
-aussi} qui renvoie à 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 paragraphes disposent de liens
cliquables.
-@end itemize
-
@node Other documentation
@unnumberedsubsec Other documentation
-FIXME: most of this should go higher up. Discuss News, mailist
-archives, ...?
+Pour finir, présentons d'autres précieuses sources de documentation.
-There are a number of other places which may be very valuable.
+@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
+@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 adéquate de votre
-navigateur.
-
-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.
-
-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