LilyPond interprète l'entrée @code{d e f} comme @qq{imprimer un ré
naturel, un mi naturel et un fa naturel}, sans tenir compte de l'armure.
Pour plus d'information à propos de la distinction entre le contenu
-musical et sa représentation, voir @ref{Accidentals and key signatures}.
+musical et sa représentation, voir @rlearning{Accidentals and key signatures}.
@lilypond[fragment,quote,ragged-right,verbatim,relative]
\key d \major
Les nouveaux utilisateurs s'embrouillent souvent dans les altérations et
les armures, car des notes naturelles prennent ou non un bécarre selon
l'armure. Pour plus d'informations, voir @ref{Accidentals} ou
-@ref{Accidentals and key signatures}.
+@rlearning{Accidentals and key signatures}.
@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
\key g \major
quelque peu radicale, puisqu'elle affectera toute la portée jusqu'à la fin de la
partition. L'espacement s'en trouve également affecté, ce qui peut être ou non
l'effet recherché. Une méthode plus sophistiquée aurait été de rendre ces objets
-transparents (voir @ref{Common tweaks}).
+transparents (voir @rlearning{Common tweaks}).
Dans l'exemple suivant, voici une mise en pratique plus utile. En temps
normal, les barres de mesure et la métrique sont synchronisées verticalement
Pour aller encore plus loin, plutôt que de simplement parler de l'objet
@code{Fingering}, ce qui ne nous avance pas à grand chose, on peut aller explorer
-son âme même, dans les fichiers source de LilyPond (voir @ref{Default files}), en
-l'occurence le fichier @file{scm/@/define@/-grobs@/.scm} :
+son âme même, dans les fichiers source de LilyPond (voir
+@rlearning{Default files}), en l'occurence le fichier
+@file{scm/@/define@/-grobs@/.scm} :
@example
(Fingering
@ifhtml
Le
@end ifhtml
-@emph{@ref{Tutorial}}
+@emph{@ruser{Tutorial}}
propose une introduction en douceur à la typographie musicale.
Les utilisateurs débutants sont invités à commencer ici.
@item
-@emph{@ref{Putting it all together}}
+@emph{@ruser{Putting it all together}}
explique des concepts généraux du format de fichier ly. Si vous n'êtes
pas certain de l'endroit où placer une commande, lisez ce chapitre !
@item
-@emph{@ref{Working on LilyPond projects}}
+@emph{@ruser{Working on LilyPond projects}}
montre des utilisations pratiques de LilyPond et donne des conseils
afin d'éviter les problèmes les plus courants.
@item
-@emph{@ref{Tweaking output}}
+@emph{@ruser{Tweaking output}}
est une introduction aux retouches de gravure avec LilyPond.
@end itemize
@itemize @bullet
@item
-@emph{@ref{Basic notation}}
+@emph{@ruser{Basic notation}}
traite de sujets groupés par type de notation. Cette section
détaille la notation de base, qui sera utile dans la plupart des
projets de partition.
@item
-@emph{@ref{Instrument-specific notation}}
+@emph{@ruser{Instrument-specific notation}}
traite de sujets groupés par type de notation. Cette section détaille
des notations spéciales qui ne seront utiles que pour des types
particuliers d'instruments ou la voix.
@item
-@emph{@ref{Advanced notation}}
+@emph{@ruser{Advanced notation}}
traite de sujets groupés par type de notation. Cette section
donne des précisions à propos de notations compliquées et
inhabituelles
@item
-@emph{@ref{Changing defaults}}
+@emph{@ruser{Changing defaults}}
explique comment ajuster finement la mise en page.
@item
-@emph{@ref{Non-musical notation}}
+@emph{@ruser{Non-musical notation}}
traite de sorties non musicales comme les titres, les mouvements
multiples, et la sélection des instruments MIDI.
@item
-@emph{@ref{Spacing issues}}
+@emph{@ruser{Spacing issues}}
traite de sujets affectant la sortie globale, comme sélectionner
la taille de papier ou spécifier les sauts de page.
@item
-@emph{@ref{Interfaces for programmers}}
+@emph{@ruser{Interfaces for programmers}}
explique comment créer des fonctions de musique.
@end itemize
Ce livre contient des tables de référence pratiques.
+@c Nous avons besoin d'ecrivez tous ca, aprez GDP est fini. -gp
+@ignore
@itemize @bullet
@item
@ifhtml
La
@end ifhtml
-@emph{@ref{Literature list}}
+@emph{@ruser{Literature list}}
contient un choix de livres de référence utiles pour ceux qui veulent
en savoir plus sur la notation et la gravure.
@item
Le
-@emph{@ref{Scheme tutorial}}
+@emph{@ruser{Scheme tutorial}}
propose une courte introduction à Scheme, le langage de programmation
utilisé dans les fonctions de musique.
@ifhtml
Les
@end ifhtml
-@emph{@ref{Notation manual tables}}
+@emph{@ruser{Notation manual tables}}
sont un ensemble de tableaux montrant les noms d'accord, les
instruments MIDI, les noms de couleur, et la police Feta.
@item
Les
-@emph{@ref{Templates}}
+@emph{@ruser{Templates}}
de pièces LilyPond. Copiez et collez un modèle
dans un fichier, ajoutez les notes, et c'est prêt !
@item
L'
-@emph{@ref{Cheat sheet}}
+@emph{@ruser{Cheat sheet}}
est une référence pratique des commandes LilyPond les plus courantes.
@item
L'
-@emph{@ref{LilyPond command index}}
+@emph{@ruser{LilyPond command index}}
est un index de toutes les @code{\commandes} LilyPond.
@item
L'
-@emph{@ref{LilyPond index}}
+@emph{@ruser{LilyPond index}}
est un index complet.
@end itemize
musicaux vers le format @code{.ly}.
@end itemize
-
+@end ignore
@subsubheading Autre documentation
disponible aux formats HTML et PDF.
@end iftex
@ifnottex
-Le @ref{Top,glossaire musical,,music-glossary} explique les termes
+Le @ruser{Top,glossaire musical,,music-glossary} explique les termes
musicaux et inclut les traductions dans diverses langues. Il est
également disponible au format PDF.
@end ifnottex
référence du programme
@end iftex
@ifnottex
-@ref{Top,référence du programme,,lilypond-internals}.
+@ruser{Top,référence du programme,,lilypond-internals}.
@end ifnottex
est un ensemble de pages HTML étroitement liées entre elles, qui
documente les moindres petits détails de chaque classe, objet et
@ref{\NAME\,,,lilypond-big-page}
@end macro
+@macro rlearing{NAME}
+@vindex \NAME\
+@ref{\NAME\,,,lilypond-learning-big-page}
+@end macro
+
+
@end ifset
@ref{\NAME\,,,lilypond}
@end macro
+@macro rlearning{NAME}
+@vindex \NAME\
+@ref{\NAME\,,,lilypond-learning}
+@end macro
+
@end ifclear
@ref{\NAME\,,,lilypond}
@end macro
+@macro rlearning{NAME}
+@vindex \NAME\
+@ref{\NAME\,,,lilypond-learning}
+@end macro
+
@c to get decent quotes in `foo'
@macro q{TEXT}
@html
@ref{\NAME\,,,lilypond}
@end macro
+@macro rlearning{NAME}
+@vindex \NAME\
+@ref{\NAME\,,,lilypond-learning}
+@end macro
+
@c to get decent quotes in `foo'
@macro q{TEXT}
`\TEXT\'
se perdre en raison de cette souplesse. Cette section présente
sommairement l'organisation du code LilyPond, en privilégiant
la simplicité au détriment de certains détails. Vous trouverez une
-description plus complète dans @ref{File structure}.
+description plus complète dans @ruser{File structure}.
La plupart des exemples de ce manuel sont de courts fragments, par exemple
variables sont sensibles à la casse, et ne peuvent contenir ni
chiffre, ni tiret, ni caractère accentué.} ; ce peut être
@code{melodie}, @code{global}, @code{maindroitepiano}, ou
-@code{laTeteAToto}. Pour plus de détails, voir @ref{Saving typing
+@code{laTeteAToto}. Pour plus de détails, voir @ruser{Saving typing
with identifiers and functions}.
Pour une description complète du format des fichiers d'entrée, voir
-@ref{File structure}.
+@ruser{File structure}.
@node Score is a single musical expression
@section Score is a single musical expression
-Dans la section précédente, @ref{How LilyPond files work}, nous
+Dans la section précédente, @ruser{How LilyPond files work}, nous
avons vu l'organisation générale des fichiers d'entrée de LilyPond.
Mais c'est comme si nous avions éludé la question essentielle : comment
diable peut-on savoir quoi mettre après @code{\score} ?
@noindent
Peut-être serait-il judicieux de relire la section
-@ref{Music expressions explained}, dans laquelle vous avez
+@ruser{Music expressions explained}, dans laquelle vous avez
appris à construire de grandes expressions musicales petit bout
par petit bout --- nous avons vu les notes, puis les accords, etc.
Maintenant, nous allons partir d'une grande expression musicale,
@noindent
Souvenez-vous que vous pouvez donner aux variables le nom que vous
voulez, à condition de respecter les caractères autorisés. Ces
-limitations sont décrites dans @ref{File structure}.
+limitations sont décrites dans @ruser{File structure}.
Quand on écrit, ou que l'on lit, une section @code{\score}, mieux vaut
y aller lentement et soigneusement. Commencez par le niveau le plus
Des informations plus détaillées sur la mise en place de conducteurs
et de parties séparées se trouvent dans le manuel : voir
-@ref{Orchestral music}.
+@ruser{Orchestral music}.
Les variables (@q{propriétés}) réglables sont abordées en détail dans
-@ref{Changing context properties on the fly}.
+@ruser{Changing context properties on the fly}.
En copiant et en collant tout le code de l'extrait ly dans un fichier
test, vous aurez un modèle de base pour faire vos expériences. Si vous
apprenez de cette façon, vous aurez probablement envie d'imprimer ou de
-garder un lien vers l'@ref{Cheat sheet}, tableau qui répertorie les
+garder un lien vers l'@ruser{Cheat sheet}, tableau qui répertorie les
commandes usuelles pour une consultation rapide.
@end ifhtml
@quotation
@table @asis
@item Entrer des hauteurs et des durées
-voir @ref{Pitches} and @ref{Durations}.
+voir @ruser{Pitches} and @ruser{Durations}.
@item Les silences
-voir @ref{Rests}.
+voir @ruser{Rests}.
@item Les chiffres de mesure et autres commandes de métrique
-voir @ref{Time signature}.
+voir @ruser{Time signature}.
@item Les clés
-voir @ref{Clef}.
+voir @ruser{Clef}.
@end table
@end quotation
@end itemize
Vous trouverez plus d'astuces pour organiser vos fichiers LilyPond dans
-@ref{Suggestions for writing LilyPond files}.
+@ruser{Suggestions for writing LilyPond files}.
@node How to read the tutorial
@subsection How to read the tutorial
-Comme nous l'avons vu dans @ref{Working on text files}, un code
+Comme nous l'avons vu dans @ruser{Working on text files}, un code
LilyPond doit être encadré par des @{ @} ou bien par @code{\relative
c'' @{ ... @}} afin d'être compris. Cependant, dans la suite de ce
manuel, la plupart des exemples ne feront pas apparaître ces signes.
@node Relative note names
@subsection Relative note names
-Comme nous l'avons vu dans @ref{Simple notation}, LilyPond calcule la
+Comme nous l'avons vu dans @ruser{Simple notation}, LilyPond calcule la
hauteur de chaque note en fonction de la précédente@footnote{Il existe
-un autre mode de saisie des hauteurs, le mode @ref{Absolute note
+un autre mode de saisie des hauteurs, le mode @ruser{Absolute note
names}, mais en pratique il est bien plus aisé et sûr d'avoir recours
au mode de hauteurs relatives.}. Si aucune indication supplémentaire
d'octaviation n'est ajoutée, il en concluera que chaque hauteur est
@quotation
@table @asis
@item Les hauteurs de note relatives
-voir @ref{Relative octaves}.
+voir @ruser{Relative octaves}.
@item Les vérifications d'octaves
-voir @ref{Octave check}.
+voir @ruser{Octave check}.
@end table
@end quotation
respectivement @samp{dd} et @samp{bb}
@c END DIV
-Pour en savoir plus sur les autres langues disponibles, voir @ref{Note
+Pour en savoir plus sur les autres langues disponibles, voir @ruser{Note
names in other languages}.
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
grandement facilitée.
De plus les altérations accidentelles
peuvent être imprimées suivant plusieurs conventions. Regardez
-@ref{Automatic accidentals} pour connaître les différentes manières dont les
+@ruser{Automatic accidentals} pour connaître les différentes manières dont les
altérations accidentelles peuvent être imprimées, suivant les règles
que vous choisirez.
@quotation
@table @asis
@item Les altérations
-voir @ref{Accidentals} and @ref{Automatic accidentals}.
+voir @ruser{Accidentals} and @ruser{Automatic accidentals}.
@item Les armures
-voir @ref{Key signature}.
+voir @ruser{Key signature}.
@end table
@end quotation
@moreinfo
@quotation
@table @asis
-@item @ref{Ties},
-@item @ref{Slurs},
-@item @ref{Phrasing slurs}.
+@item @ruser{Ties},
+@item @ruser{Slurs},
+@item @ruser{Phrasing slurs}.
@end table
@end quotation
@moreinfo
@quotation
@table @asis
-@item @ref{Articulations}.
-@item @ref{Fingering instructions}.
-@item @ref{Dynamics}.
+@item @ruser{Articulations}.
+@item @ruser{Fingering instructions}.
+@item @ruser{Dynamics}.
@end table
@end quotation
@quotation
@table @asis
@item Groupements de notes et ligatures automatiques
-voir @ref{Automatic beams}.
+voir @ruser{Automatic beams}.
@item Groupements et ligatures manuels
-voir @ref{Manual beams}.
+voir @ruser{Manual beams}.
@end table
@end quotation
@quotation
@table @asis
@item Notes d'ornement
-voir @ref{Grace notes},
+voir @ruser{Grace notes},
@item nolets
-voir @ref{Tuplets},
+voir @ruser{Tuplets},
@item levées
-voir @ref{Partial measures}.
+voir @ruser{Partial measures}.
@end table
@end quotation
@node Multiple staves
@subsection Multiple staves
-Comme nous l'avons vu dans @ref{Music expressions explained}, un fichier
+Comme nous l'avons vu dans @ruser{Music expressions explained}, un fichier
d'entrée LilyPond est fait d'expressions musicales. Si la partition
commence par plusieurs expressions simultanées, LilyPond créera
plusieurs portées. Cependant, il est plus facile de voir ce qu'il
Les chiffres de métrique indiqués sur une portée affectent toutes les
autres portées@footnote{Ce comportement peut être modifié si nécessaire,
-voir @ref{Polymetric notation}.}. En revanche l'armure d'une portée
+voir @ruser{Polymetric notation}.}. En revanche l'armure d'une portée
n'affecte @emph{pas} les autres portées.
@lilypond[quote,ragged-right,verbatim]
@cindex voix changeant manuellement de portée
La musique pour piano s'écrit sur deux portées reliées par une accolade.
Imprimer ce type de portée revient au même que dans l'exemple de musique
-polyphonique de @ref{Multiple staves}, mais maintenant cette expression
+polyphonique de @ruser{Multiple staves}, mais maintenant cette expression
entière doit être interprétée dans un contexte @code{PianoStaff} :
@example
@moreinfo
@quotation
-Voir @ref{Piano music}.
+Voir @ruser{Piano music}.
@end quotation
@moreinfo
@quotation
-Voir @ref{Basic polyphony}.
+Voir @ruser{Basic polyphony}.
@end quotation
@moreinfo
@quotation
Plus de possibilités, comme celle d'ajouter plusieurs lignes de paroles
-en dessous d'une même mélodie sont exposées dans @ref{Vocal music}.
+en dessous d'une même mélodie sont exposées dans @ruser{Vocal music}.
@end quotation
@moreinfo
@quotation
Une liste complète de modificateurs et d'autres options de mise en forme
-se trouve à la section @ref{Chords}.
+se trouve à la section @ruser{Chords}.
@end quotation
@end example
Quand le fichier est traité, le titre et le compositeur sont imprimés en
haut de la partition. Vous trouverez plus d'informations sur les titres
-à @ref{Creating titles}.
+à @ruser{Creating titles}.
@node Absolute note names
@subsection Absolute note names
@subsection After the tutorial
Après avoir parcouru ce tutoriel, vous devriez vous essayer à écrire un
-morceau ou deux. Commencez par copier l'un des @ref{Templates} types et
+morceau ou deux. Commencez par copier l'un des @ruser{Templates} types et
ajoutez-y des notes. Si vous voulez employer une notation que vous
n'avez pas trouvé dans le tutoriel, consultez la référence de notation,
-en commençant par la @ref{Basic notation}. Si vous désirez écrire pour
-un ensemble instrumental non couvert par les @ref{Templates}, lisez la
-section @ref{Extending the templates}.
+en commençant par la @ruser{Basic notation}. Si vous désirez écrire pour
+un ensemble instrumental non couvert par les @ruser{Templates}, lisez la
+section @ruser{Extending the templates}.
Après avoir écrit quelques pièces courtes, lisez les chapitres 3 à 5 du
manuel d'apprentissage. Rien ne s'oppose à ce que vous consultiez dès à
@node How to read the manual
@subsection How to read the manual
-Comme nous l'avons déjà vu dans @ref{How to read the tutorial}, de
+Comme nous l'avons déjà vu dans @ruser{How to read the tutorial}, de
nombreux exemples du tutoriel n'ont pas fait apparaître
@code{\relative c'' @{ ... @}} dans l'extrait de code affiché.
alors.
Pour en savoir plus sur l'organisation de la suite de ce manuel,
-reportez-vous à @ref{About this manual}.
+reportez-vous à @ruser{About this manual}.
persiste après la commande, ne mettez pas @code{\once}. Votre réglage
s'appliquera alors partout, jusqu'à ce que vous l'annuliez au moyen de
la commande @code{\revert}. Ceci est expliqué en détail dans
-@ref{The \override command}.
+@ruser{The \override command}.
@lilypond[quote,fragment,ragged-right,verbatim,relative=3]
% temporary code to break this example:
@seealso
-Dans ce même manuel : @ref{The \override command}, @ref{Common tweaks}.
+Dans ce même manuel : @ruser{The \override command}, @ruser{Common tweaks}.
@node Fixing overlapping notation
@section Fixing overlapping notation
-Dans la section @ref{Moving objects}, nous avons vu comment
+Dans la section @ruser{Moving objects}, nous avons vu comment
déplacer un objet @code{TextScript}. Ce même procédé peut être
appliqué à d'autres types d'objet : il vous suffira de remplacer
@code{TextScript} par le nom de l'objet en question.
Pour trouver cette dénomination, regardez les liens @q{@strong{Voir aussi}}
en bas des pages de la documentation. Par exemple, en bas de la page
-@ref{Dynamics}, nous trouvons
+@ruser{Dynamics}, nous trouvons
@quotation
@seealso
correspond l'objet. Dans la mesure où l'objet @code{MetronomeMark}
appartient au contexte @code{Score}, ses modifications affectées au
contexte @code{Voice} ne l'affecteront pas. Pour plus de détails, voir
-@ref{Constructing a tweak}.
+@ruser{Constructing a tweak}.
@cindex extra-offset
@code{annotate-spacing} peut alors être un outil d'une valeur
inestimable. Cette commande imprime les valeurs
de nombreuses commandes d'espacement concernant la mise en page.
-Consultez @ref{Displaying spacing} pour de plus amples informations. À l'aide
+Consultez @ruser{Displaying spacing} pour de plus amples informations. À l'aide
des informations données par @code{annotate-spacing}, on peut
voir quelles marges il est souhaitable de modifier afin de résoudre le
problème.
@item
Modifier l'espacement vertical avec @code{SpacingSpanner}. Reportez-vous à
-@ref{Changing horizontal spacing} pour plus de détails.
+@ruser{Changing horizontal spacing} pour plus de détails.
@lilypond[verbatim,quote]
\score {
@code{\override TextScript #'extra-offset = ( 1 . -1)}. Cependant,
l'utilisation de Scheme ouvre des possibilités encore plus grandes.
Pour des explications complètes là-dessus, consultez le
-@ref{Scheme tutorial} et les @ref{Interfaces for programmers}.
+@ruser{Scheme tutorial} et les @ruser{Interfaces for programmers}.
On peut utiliser Scheme simplement à l'aide des commandes @code{\override}.
années auparavant. L'utilitaire @code{convert-ly} demande que vous
spécifiiez la version de LilyPond vous utilisiez alors.
-@item @strong{Ajoutez des contrôles}: @ref{Bar check}, @ref{Octave
-check} et @ref{Barnumber check}. Si vous avez ajouté des contrôles de
+@item @strong{Ajoutez des contrôles}: @ruser{Bar check}, @ruser{Octave
+check} et @ruser{Barnumber check}. Si vous avez ajouté des contrôles de
loin en loin, et que vous faites une erreur, vous pourrez la retrouver
plus rapidement. @qq{De loin en loin}, qu'est-ce à dire ? Cela
dépend de la complexité de la musique. Pour de la musique très
viennent d'un défaut de parité entre @code{@{} et @code{@}}.
@item @strong{Séparez les affinages de mise en forme} de la musique
-elle-même. Voyez @ref{Saving typing with identifiers and functions} et
-@ref{Style sheets}.
+elle-même. Voyez @ruser{Saving typing with identifiers and functions} et
+@ruser{Style sheets}.
@end itemize
à la fois --- mais toujours une seule mesure par ligne de texte ---,
et vérifiez chaque système lorsqu'il est terminé. Vous pouvez
utiliser la commande @code{showLastLength} pour accélérer la
-compilation --- voir @ref{Skipping corrected music} ;
+compilation --- voir @ruser{Skipping corrected music} ;
@item définissez @code{mBreak = @{\break @}} et insérez
@code{\mBreak} dans le fichier d'entrée pour obtenir des sauts de
@end example
@item @strong{Séparez les retouches} des définitions de
-musique. Ce conseil a été vu dans @ref{General suggestions},
+musique. Ce conseil a été vu dans @ruser{General suggestions},
mais pour les projets d'importance c'est absolument vital. Nous
pouvons avoir besoin de changer la définition de
@code{fthenp}, mais dans ce cas nous n'aurons besoin de le faire
Utiliser les identificateurs est aussi un bon moyen pour vous épargner
du travail si la syntaxe de LilyPond change un jour --- voir
-@ref{Updating old files}. Si vous avez une seule définition, par
-exemple @code{\dolce}, pour tous vos fichiers (voir @ref{Style
+@ruser{Updating old files}. Si vous avez une seule définition, par
+exemple @code{\dolce}, pour tous vos fichiers (voir @ruser{Style
sheets}), et que la syntaxe change, alors vous n'aurez qu'à mettre à
jour votre seule définition @code{\dolce}, au lieu de devoir modifier
chaque fichier @code{.ly}.
@section Style sheets
La sortie que produit LilyPond peut être largement modifiée --- voir
-@ref{Tweaking output} pour plus de détails. Mais que faire si vous
+@ruser{Tweaking output} pour plus de détails. Mais que faire si vous
avez beaucoup de fichiers auxquels vous souhaitez appliquer vos
retouches ? Ou si vous souhaitez simplement séparer les retouches de
la musique elle-même ? Rien de plus facile.
Prenons un exemple. Ne vous inquiétez pas si vous ne comprenez pas
les parties avec tous les @code{#()}. Celles-ci sont expliquées dans
-@ref{Advanced tweaks with Scheme}.
+@ruser{Advanced tweaks with Scheme}.
@lilypond[quote,verbatim,ragged-right]
mpdolce = #(make-dynamic-script (markup #:hspace 1 #:translate (cons 5 0)
@end lilypond
Il y a quelques problèmes de chevauchement ; nous allons arranger
-cela en utilisant les techniques de @ref{Moving objects}. On peut
+cela en utilisant les techniques de @ruser{Moving objects}. On peut
aussi faire quelque chose pour les définitions de @code{mpdolce}
et @code{tempoMark}. Elles produisent le résultat que nous désirons,
mais nous pourrions aussi vouloir les utiliser dans une autre pièce.
Une autre technique de déboguage très utile est la construction
@iftex
-de @ref{Minimal examples}.
+de @ruser{Minimal examples}.
@end iftex
@ifnottex
-d'@ref{Minimal examples}.
+d'@ruser{Minimal examples}.
@end ifnottex
projects / lilypond.git / commitdiff