@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+
@ignore
- Translation of GIT committish: 952705bbbb000581a13836e6a733df04511e93c5
+ Translation of GIT committish: 5c35684285613e8960e2dd4324559e1ee3774b9b
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Guide, node Updating translation committishes..
@end ignore
-@c \version "2.16.0"
+@c \version "2.17.11"
@c Translators: Jean-Charles Malahieude, Valentin Villenave
@example
\score @{
-...
+@dots{}
@}
@end example
Les commentaires constituent l'une des rares exceptions à cette règle
immuable -- voir @ref{Structure de fichier} pour les autres. Qu'il
-s'agisse d'une seule ligne ou de tout un bloc -- délimité par @code{%@{
-.. %@}} -- un commentaire peut se placer n'importe où dans le fichier
-source, aussi bien à l'intérieur qu'à l'extérieur du bloc @code{\score},
-ou encore à l'intérieur ou à l'extérieur de l'expression musicale
-contenue dans un bloc @code{\score}.
+s'agisse d'une seule ligne ou de tout un bloc -- délimité par
+@code{%@{ @dots{} %@}} -- un commentaire peut se placer n'importe où
+dans le fichier source, aussi bien à l'intérieur qu'à l'extérieur du
+bloc @code{\score}, ou encore à l'intérieur ou à l'extérieur de
+l'expression musicale contenue dans un bloc @code{\score}.
Lorsqu'un fichier ne comprend qu'un bloc @code{\score}, celui-ci est
implicitement inclus dans un bloc @code{\book}. Le bloc @code{\book}
@example
\score @{
- @var{..musique..}
+ @var{@dots{}musique@dots{}}
@}
@end example
@example
\markup @{
- @var{..texte..}
+ @var{@dots{}texte@dots{}}
@}
@end example
@example
\score @{
- @var{..}
+ @var{@dots{}}
@}
\markup @{
- @var{..}
+ @var{@dots{}}
@}
\score @{
- @var{..}
+ @var{@dots{}}
@}
@end example
\header @{ piece = "Romance" @}
@}
\markup @{
- ..texte du second couplet..
+ @dots{}texte du second couplet@dots{}
@}
\markup @{
- ..texte du troisième couplet..
+ @dots{}texte du troisième couplet@dots{}
@}
\score @{
@dots{}
@funindex \bookpart
-Plusieurs pièces seront regroupées dans un même @qq{chapitre} à l'aide
-d'un bloc @code{\bookpart}. Ces différents @qq{chapitres} sont séparés
+Plusieurs pièces seront regroupées dans un même « chapitre » à l'aide
+d'un bloc @code{\bookpart}. Ces différents « chapitres » sont séparés
par un saut de page et peuvent comporter un titre à l'instar de
l'ouvrage dès lors que vous y insérez un bloc @code{\header}.
@example
\book @{
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
@end example
\book @{
\bookOutputSuffix "Romance"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\bookOutputSuffix "Menuet"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\bookOutputSuffix "Nocturne"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
@end example
\book @{
\bookOutputName "Romance"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\bookOutputName "Menuet"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\bookOutputName "Nocturne"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
@end example
différents contenus seront combinés, à ceci près qu'en cas de
déclarations conflictuelles, la dernière aura préséance. Des
informations complémentaires sont disponibles à la rubrique
-@ref{Le bloc \layout}.
+@ref{Le bloc layout}.
@item
Une expression Scheme pure, telle que
@w{@code{#(ly:set-option 'point-and-click #f)}}.
@item
-Un bloc @code{\header}, dont le contenu sera de portée globale -- ce qui
-est le cas en général pour le titre ou l'auteur entre autres.
+Un bloc @code{\header}, dont le contenu sera valide pour tout le
+fichier. Il comporte en général les valeurs par défaut des champs de
+titrage, tels le titre ou l'auteur entre autres, communs à tous les
+blocs @code{\book} inclus dans le fichier -- voir
+@ref{Généralités en matière de titrages}.
@item
Un bloc @code{\score} pour la partition. Cette partition sera assemblée
avec les autres partitions se trouvant au même niveau pour composer le
@code{\book}. Vous pouvez modifier ce comportement à l'aide de la
-variable @code{toplevel-score-handler} placée en tête.
-@ignore
-@c FIXME - I cannot read "toplevel-score-handler" in scm/lily.scm -jcm
-The default handler is defined in the init file @file{../scm/lily.scm}.
-@end ignore
+variable @code{toplevel-score-handler} placée en tête. Le gestionnaire
+par défaut est défini dans le fichier d'initialisation
+@file{../scm/lily.scm}.
@item
Un bloc @code{\book} permet de regrouper naturellement plusieurs
un document lilypond-book qui reprendrait plusieurs @code{\score} ou
@code{\markup} dans un même extrait. Vous pouvez modifier ce
comportement à l'aide de la variable @code{toplevel-book-handler}
-placée en tête.
-@ignore
-@c FIXME - I cannot read "toplevel-book-handler" in scm/lily.scm -jcm
-The default handler is defined in the init file @file{../scm/lily.scm}.
-@end ignore
+placée en tête. Le gestionnaire par défaut est défini dans le fichier
+d'initialisation @file{../scm/lily.scm}.
@item
Un bloc @code{\bookpart}. Un ouvrage peut se découper en plusieurs
@end example
Vous pouvez modifier ce comportement à l'aide de la variable
-@code{toplevel-music-handler} placée en tête.
-@ignore
-@c FIXME - I cannot read "toplevel-music-handler" in scm/lily.scm -jcm
-The default handler is defined in the init file @file{../scm/lily.scm}.
-@end ignore
+@code{toplevel-music-handler} placée en tête. Le gestionnaire par
+défaut est défini dans le fichier d'initialisation
+@file{../scm/lily.scm}.
@item
Du texte sous forme de @emph{markup} comme les paroles d'un couplet
Une ligne de commentaire, introduite par le signe @code{%}.
@item
-Un bloc de commentaire, délimité par @code{%@{ .. %@}}.
+Un bloc de commentaire, délimité par @code{%@{ @dots{} %@}}.
@end itemize
@itemize
@item
-Autour d'une accolade, qu'elle soit ouvrant ou fermante ;
+Autour d'une accolade, qu'elle soit ouvrante ou fermante ;
@item
Après chaque commande ou variable, autrement dit tout élément qui
Pour séparer les éléments d'une expression Scheme ;
@item
-En mode parole -- @code{lyricmode} -- pour séparer les termes des
-commandes @code{\override} et @code{\set}. Précisons à ce sujet qu'en
-plus d'ajouter une espace avant et après l'intégralité de la commande,
-vous devrez encadrer d'espaces le point et le signe égal qu'elle peut
-contenir, comme dans
-@w{@code{\override Score . LyricText #'font-size = #5}}.
+En mode parole -- @code{lyricmode} -- avant et après les commandes
+@code{\override} et @code{\set}.
@end itemize
@rlearning{Organisation des fichiers LilyPond}.
Manuel de notation :
-@ref{Le bloc \layout}.
+@ref{Généralités en matière de titrages},
+@ref{Le bloc layout}.
@node Titres et entêtes
@translationof Titles and headers
La plupart de la musique qui est éditée comporte un titre et le nom de
-son compositeur ; certains ouvrages divulguent beaucoup plus
-d'information.
+son compositeur ; certains ouvrages dispensent beaucoup plus
+d'informations.
@menu
* Création de titres et entête ou pied de page::
@translationof Creating titles headers and footers
@menu
-* Contenu des blocs de titrage::
-* Mise en forme par défaut des titrages::
+* Généralités en matière de titrages::
+* Mise en forme par défaut des titrages subalternes::
* Mise en forme par défaut des entête et pied de page::
@end menu
-@node Contenu des blocs de titrage
-@unnumberedsubsubsec Contenu des blocs de titrage
-@translationof Title blocks explained
+@node Généralités en matière de titrages
+@unnumberedsubsubsec Généralités en matière de titrages
+@translationof Titles explained
-@c TODO: figure out how \bookpart titles work
+Chaque bloc @code{\book} apparaissant dans un même fichier source
+résultera en un fichier indépendant, comme indiqué à la rubrique
+@ref{Structure de fichier}. Chacun de ces fichiers résultants comporte
+trois endroits où placer des titrages : le @strong{titrage de l'ouvrage}
+au début de chaque recueil (@emph{book}), les @strong{titrages de
+partie} au début de chaque partie (@emph{bookpart}) et les
+@strong{titrages de morceau} avant chaque pièce (@emph{score}).
-Il existe en fait deux types de blocs de titrage : un bloc pour
-contenir le titre principal qui doit apparaître avant le tout premier
-@code{\score} d'un ouvrage, et un autre attaché à chacun des blocs
-@code{\score} qui le composent. Dans les deux cas, les champs qui
-composent un bloc de titrage se saisissent dans un bloc @code{\header}.
+La valeur des champs de titrage @code{title} (le titre) et
+@code{composer} (le compositeur) se définissent dans des blocs
+@code{\header} -- la syntaxe appropriée et la liste des différents
+champs disponibles par défaut sont à la section
+@ref{Mise en forme par défaut des titrages subalternes}.
+Les titrages d'un ouvrage, de ses parties ou des morceaux qu'il contient
+peuvent tous comporter les même champs bien que, par défaut, le titrage
+d'un morceau se limite à @code{piece} et @code{opus}.
-Lorsque l'ouvrage ne comporte qu'un seul morceau, le bloc @code{\header}
-peut se placer en dehors ou au sein même du bloc @code{\score}.
+Les blocs @code{\header} peuvent se placer à quatre endroits différents
+qui formeront une hiérarchie descendante :
-Dans le cas où le bloc @code{\header} est défini à l'intérieur du bloc
-@code{\score}, seuls les champs @code{piece} et @code{opus} seront
-imprimés.
+@itemize
-@lilypond[papersize=a5,quote,verbatim,noragged-right]
-\score {
- { c'4 }
- \header {
- title = "title" % not printed
- piece = "piece"
- opus = "opus"
- }
-}
-@end lilypond
+@item
+En tête du fichier source, avant même tout bloc @code{\book},
+@code{\bookpart} ou @code{\score} ;
-@funindex print-all-headers
-@noindent
-Vous pouvez modifier ce comportement et imprimer tous les champs d'un
-bloc @code{\header} défini dans un bloc @code{\score} en ajoutant
+@item
+Au sein d'un bloc @code{\book} et en dehors de tout bloc
+@code{\bookpart} ou @code{\score} qu'il contient ;
-@example
-\paper@{
- print-all-headers = ##t
-@}
-@end example
+@item
+Au sein d'un bloc @code{\bookpart} et en dehors de tout bloc
+@code{\score} qu'il contient ;
+
+@item
+Après l'expression musicale incluse dans un bloc @code{\score}.
+
+@end itemize
+
+La valeur des différents champs sera filtrée en respectant cette
+hiérarchie ; les valeurs persisteront à moins d'être écrasées par une
+autre valeur à un niveau inférieur. Ainsi :
+
+@itemize
+@item
+Le titre d'un ouvrage découle des champs définis en tête de fichier
+source, modifiés par les champs définis au sein du bloc @code{\book}.
+Les champs résultants serviront à affecter un titre de recueil à
+l'ouvrage, si tant est que quoi que ce soit génère une page au début de
+cet ouvrage, avant la première partie -- un simple saut de page forcé
+(@code{\pageBreak}) suffit.
+
+@item
+Le titre d'une partie découle des champs définis en tête du fichier
+source, modifiés par les champs définis au sein du bloc @code{\book}
+puis par ceux définis au sein du bloc @code{\bookpart}. Les valeurs qui
+en résulteront permettront d'imprimer les titrages de partie pour cette
+partie.
+
+@item
+Le titre d'un morceau découle des champs définis en tête du fichier
+source, modifiés par les champs définis au sein du bloc @code{\book}
+puis par ceux définis au sein du bloc @code{\bookpart}, et enfin par
+ceux définis au sein du bloc @code{\score}. Les valeurs qui en
+résulteront permettront d'imprimer les titrages de morceau pour ce
+morceau. Notez toutefois que, pour un morceau, seuls les champs
+@code{piece} et @code{opus} seront imprimés, à moins d'avoir valorisé
+à @code{#t} la variable @code{print-all-headers} dans la section
+@code{\paper}.
+
+@end itemize
@warning{N'oubliez pas que lorsqu'il est placé à l'intérieur d'un bloc
@code{@bs{}score}, le bloc @code{@bs{}header} doit impérativement se
trouver @strong{à la suite} de l'expression musicale.}
+Nul n'est besoin de fournir un bloc @code{\header} à chacun des quatre
+niveaux ; on peut se passer aussi bien de l'un d'eux que de tous. Dans
+la même veine, un fichier source simpliste peut ne pas mentionner de
+bloc @code{\book} ou @code{\bookpart} qui seront alors créés
+implicitement.
+
+Lorsque l'ouvrage ne comporte qu'un seul morceau, le bloc @code{\header}
+devrait prendre place en tête de fichier, de telle sorte que soit produit
+un titrage de partie qui met à disposition tous les champs de titrage.
+
+Lorsque l'ouvrage comporte plusieurs morceaux, différents arrangements
+du bloc @code{\header} permettent d'obtenir différents styles de
+publication musicale. Par exemple, si la publication comprend plusieurs
+pièces du même compositeur, un bloc @code{\header} placé en tête de
+fichier définira le titre de l'ouvrage et le compositeur, que l'on
+complètera par un bloc @code{\header} dans chaque bloc @code{\score}
+pour définir les champs @code{piece} et @code{opus}, comme ici :
+
@lilypond[papersize=a5,quote,verbatim,noragged-right]
\header {
title = "SUITE I."
}
@end lilypond
-Tous les champs appartenant au titrage principal d'un ouvrage peuvent se
-reporter dans chaque bloc @code{\score} ou être supprimés manuellement :
+Des agencements plus élaborés sont aussi réalisables. Par exemple, les
+champs appartenant au titrage principal d'un ouvrage peuvent se
+reporter dans chaque bloc @code{\score}, certains étant modifiés voire
+supprimés manuellement :
@c KEEP LY
@lilypond[papersize=a5,quote,verbatim,noragged-right]
@seealso
Manuel de notation :
@ref{Structure de fichier},
-@ref{Mise en forme personnalisée des blocs de titrage}.
+@ref{Mise en forme par défaut des titrages subalternes},
+@ref{Mise en forme personnalisée des titrages}.
-@node Mise en forme par défaut des titrages
-@unnumberedsubsubsec Mise en forme par défaut des titrages
-@translationof Default layout of book and score title blocks
+@node Mise en forme par défaut des titrages subalternes
+@unnumberedsubsubsec Mise en forme par défaut des titrages subalternes
+@translationof Default layout of bookpart and score titles
Voici les différentes variables attachées au bloc @code{\header} :
@c KEEP LY
-@lilypond[papersize=a7,quote,verbatim,noragged-right]
+@lilypond[papersize=a6landscape,quote,verbatim,noragged-right]
\book {
\header {
% Les champs suivants sont centrés
subtitle = "Sous-titre"
subsubtitle = "Sous-sous-titre"
% Les champs suivants sont répartis sur une même ligne, et
- % le champ "instrument" apparaîtra sue les pages suivantes
+ % le champ "instrument" apparaîtra sur les pages suivantes
instrument = \markup \with-color #green "Instrument"
poet = "Librettiste"
composer = "Compositeur"
{ s1 }
\header {
% Les champs suivants sont en opposition sur la même ligne
- piece = "Pièce 3 sue une nouvelle page"
+ piece = "Pièce 3 sur une nouvelle page"
opus = "Opus 3"
}
}
@item
Seuls seront imprimés les champs @code{piece} et @code{opus} inclus dans
un bloc @code{\score} dès lors que la variable @code{print-all-headers}
-reste désactivée (valeur à @code{##f}).
+reste désactivée (valeur à @code{##f}).
@item
@c Is the bit about \null markups true? -mp
@end itemize
Les possibilités de modifier la mise en forme par défaut sont abordées à
-la rubrique @ref{Mise en forme personnalisée des blocs de titrage}.
+la rubrique @ref{Mise en forme personnalisée des titrages}.
@cindex breakbefore
+Un bloc @code{\book} qui commencerait directement par un bloc
+@code{\bookpart} ne verra pas ses titrages apparaître puisqu'il n'y a
+aucune page où imprimer le titre. Si toutefois le titre de l'ouvrage
+est requis, le bloc @code{\book} devra commencer par un @emph{markup} ou
+une commande @code{\pageBreak}.
+
La variable @code{breakbefore} activée dans un bloc @code{\header} situé
dans un bloc @code{\score} force le saut de page avant le morceau
contenu dans ce @code{\score}. Vous pourrez ainsi séparer le titre
principal de la musique.
-@lilypond[papersize=a8landscape,verbatim,noragged-right]
+@lilypond[papersize=c7landscape,verbatim,noragged-right]
\book {
\header {
title = "This is my Title"
@rlearning{Organisation des fichiers LilyPond}.
Manuel de notation :
-@ref{Mise en forme personnalisée des blocs de titrage},
+@ref{Mise en forme personnalisée des titrages},
@ref{Structure de fichier}.
Fichiers d'initialisation :
@unnumberedsubsubsec Mise en forme par défaut des entête et pied de page
@translationof Default layout of headers and footers
-Les entête et pied -- @emph{headers} et @emph{footers} -- sont des
+Les entête et pied -- @emph{header} et @emph{footer} -- sont des
lignes de textes qui apparaissent en haut et en bas de chaque page,
indépendamment du texte de l'ouvrage. Ils sont contrôlés par les
variables suivantes, attachées au bloc @code{\paper} :
@end itemize
-@lilypond[papersize=a8landscape]
-\book {
- \score {
- \relative c' {
- c4 d e f
- }
- }
-}
-@end lilypond
-
La mention spéciale se modifie en alimentant le champ @code{tagline} au
niveau du bloc @code{\header} principal.
@node Titrages personnalisés
@subsection Titrages personnalisés
-@translationof Custom headers footers and titles
+@translationof Custom titles headers and footers
@c TODO: somewhere put a link to header spacing info
@c (you'll have to explain it more in NR 4).
@menu
* Mise en forme personnalisée des champs de titrage::
-* Mise en forme personnalisée des blocs de titrage::
+* Mise en forme personnalisée des titrages::
* Mise en forme personnalisée des entête et pied de page::
@end menu
@translationof Custom text formatting for title blocks
Toutes les commandes de mise en forme d'un @code{\markup} permettent de
-personnaliser le texte des entête, pied de page et éléments de titre
+personnaliser le texte des entête, pied de page et éléments de titrage
contenus dans un bloc @code{\header}.
@lilypond[quote,verbatim,noragged-right]
{ s1 }
\header {
piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
- opus = \markup { \italic "(Excerpt)" }
+ opus = \markup { \italic "BWV 846" }
}
}
@end lilypond
@ref{Mise en forme du texte}.
-@node Mise en forme personnalisée des blocs de titrage
-@unnumberedsubsubsec Mise en forme personnalisée des blocs de titrage
-@translationof Custom layout for title blocks
+@node Mise en forme personnalisée des titrages
+@unnumberedsubsubsec Mise en forme personnalisée des titrages
+@translationof Custom layout for titles
@cindex bookTitleMarkup
@cindex scoreTitleMarkup
Le positionnement des titres, avec les valeurs par défaut de ces
variables @code{\markup}, est illustré à la rubrique
-@ref{Mise en forme par défaut des titrages}.
+@ref{Mise en forme par défaut des titrages subalternes}.
Voici les réglages par défaut de @code{scoreTitleMarkup}, tels que
définis dans le fichier @file{ly/titling-init.ly} :
@example
scoreTitleMarkup = \markup @{ \column @{
- \on-the-fly #print-all-headers @{ \bookTitleMarkup \hspace #1 @}
+ \on-the-fly \print-all-headers @{ \bookTitleMarkup \hspace #1 @}
\fill-line @{
\fromproperty #'header:piece
\fromproperty #'header:opus
}
@end lilypond
-Voici comment positionner le champ @code{piece}, dont nous modifions
-la taille et la graisse, au centre de cette ligne :
+Voici comment redéfinir le @code{scoreTitleMarkup} de telle sorte que le
+champ @code{piece}, dont nous modifions la taille et la graisse, se
+place au centre de cette ligne :
@lilypond[papersize=a5,quote,verbatim,noragged-right]
\book {
}
@end lilypond
-Les champs normalement réservés au bloc de titrage principal seront
-reportés au niveau inférieur dès lors que vous aurez activé
-l'instruction @code{print-all-headers} au sein du bloc @code{\paper}.
-Le principal inconvénient de cette fonction réside dans le fait que les
-champs réservés au bloc @code{\header} principal devront être supprimés
-dans chacun des blocs @code{\score} de votre fichier source -- voir
-@ref{Contenu des blocs de titrage}.
+Les champs normalement absents du @code{\header} d'un bloc @code{\score}
+seront toutefois imprimés dès lors que vous aurez activé l'instruction
+@code{print-all-headers} au sein du bloc @code{\paper}. Le principal
+inconvénient de cette fonction réside dans le fait que les champs
+dévolus au titrage des parties devront être supprimés dans
+chacun des blocs @code{\score} de votre fichier source -- voir
+@ref{Généralités en matière de titrages}.
Afin d'éviter ce désagrément, ajoutez le champ que vous désirez voir
apparaître à la définition de @code{scoreTitleMarkup}. Nous allons,
dans l'exemple suivant, ajouter au @code{scoreTitleMarkup} le champ
@code{composer}, normalement associé au @code{bookTitleMarkup} ;
-chaque @code{\score} pourra mentionner un compositeur différent.
+chaque @code{\score} pourra alors mentionner un compositeur différent.
@lilypond[papersize=a5,quote,verbatim,noragged-right]
\book {
@seealso
Manuel de notation :
-@ref{Contenu des blocs de titrage}.
+@ref{Généralités en matière de titrages}.
@node Mise en forme personnalisée des entête et pied de page
@cindex markup conditionnel
@cindex condition et markup
-@cindex on-the-fly
+@cindex on-the-fly (à la volée)
+
@funindex \on-the-fly
L'instruction @code{\on-the-fly} au sein d'un @code{\markup} permet
@example
@code{variable} = @code{\markup} @{
- ...
- @code{\on-the-fly} #@var{procédure} @var{markup}
- ...
+ @dots{}
+ @code{\on-the-fly} \@var{procédure} @var{markup}
+ @dots{}
@}
@end example
La @var{procédure} est appelée à chaque fois que la commande
@code{\markup} où elle apparaît est évaluée. La @var{procédure}
-effectuera un test de conformité particulière et interprètera, autrement
+effectuera un test de conformité particulier et interprètera, autrement
dit imprimera l'argument @var{markup} si et seulement si cette
condition est remplie.
@headitem Nom de la procédure @tab Condition testée
@item print-page-number-check-first @tab il faut imprimer ce numéro de page.
-@item create-page-number-stencil @tab 'print-page-numbers est vrai.
-@item print-all-headers @tab 'print-all-headers est vrai.
+@item create-page-number-stencil @tab print-page-numbers est vrai.
+@item print-all-headers @tab print-all-headers est vrai.
@item first-page @tab c'est la première page du @emph{book}.
-@item (on-page nombre) @tab page number = nombre
+@item (on-page nombre) @tab numéro de page = nombre
@item last-page @tab c'est la dernière page du @emph{book}.
@item not-first-page @tab ce n'est la première page du @emph{book}.
@item part-first-page @tab c'est la première page de la partie.
@end multitable
@end quotation
-L'exemple suivant illustre la manière de centrer son numéro au bas de
-chaque page. Il nous faut tout d'abord annuler la définition de
+L'exemple suivant illustre la manière de centrer son numéro au bas de
+chaque page. Il nous faut tout d'abord annuler les définitions de
@code{oddHeaderMarkup} et @code{evenHeaderMarkup} à l'aide d'un
@emph{markup} @code{\null}. Nous redéfinissons ensuite
@code{oddFooterMarkup} pour qu'il contienne le numéro de page, centré.
evenHeaderMarkup = \markup \null
oddFooterMarkup = \markup {
\fill-line {
- \on-the-fly #print-page-number-check-first
+ \on-the-fly \print-page-number-check-first
\fromproperty #'page:page-number-string
}
}
l'autre se cumulent. Ainsi, par exemple,
@example
- @code{\on-the-fly #first-page}
- @code{\on-the-fly #last-page}
- @code{@{ \markup ... \fromproperty #'header: ... @}}
+ @code{\on-the-fly \first-page}
+ @code{\on-the-fly \last-page}
+ @code{@{ \markup @dots{} \fromproperty #'header: @dots{} @}}
@end example
teste si la sortie tient sur une page unique.
@seealso
Manuel de notation :
-@ref{Contenu des blocs de titrage},
-@ref{Mise en forme par défaut des titrages}.
+@ref{Généralités en matière de titrages},
+@ref{Mise en forme par défaut des titrages subalternes}.
fichiers d'initialisation :
@file{../ly/titling-init.ly}.
@subsection Notes de bas de page
@translationof Creating footnotes
-LilyPond dispose de deux méthodes pour créer des notes de bas de page,
-l'une automatisée, et l'autre manuelle.
+@cindex bas de page, notes
+@cindex footnotes
+
+Les notes de bas de page sont utiles dans bien des situations. Dans
+tous les cas, un « appel de note » vient se placer en référence dans te
+texte ou la musique, et le « texte de la note » est reporté en bas de la
+page.
+
+Selon qu'elle est référencée dans une expression musicale ou dans du
+texte indépendant, une note de bas de page sera créée suivant une
+procédure différente.
@menu
-* Considérations générales en matière de note de bas de page::
-* Notes de bas de page automatiques::
-* Notes de bas de page manuelles::
+* Notes de bas de page dans une expression musicale::
+* Notes de bas de page dans du texte indépendant::
@end menu
-@node Considérations générales en matière de note de bas de page
-@unnumberedsubsubsec Considérations générales en matière de note de bas de page
-@translationof Footnotes overview
+@node Notes de bas de page dans une expression musicale
+@unnumberedsubsubsec Notes de bas de page dans une expression musicale
+@translationof Footnotes in music expressions
-Il est parfois judicieux, notamment lorsqu'une annotation ou un
-commentaire gênerait la lecture de la partition, de les reporter en bas
-de page.
+@cindex musique et note de bas de page
+@funindex \footnote
+
+@subsubsubheading Généralités sur l'annotation de musique
+@c VO Music footnotes overview
-Les notes de bas de page automatiques font appel à un compteur
-numérique incrémenté automatiquement ; les notes de bas de page
-manuelles vous laissent le libre choix de l'appel (l'indicateur). Une
-note de bas de page s'applique comme un @code{\tweak} ; elle peut donc
-s'attacher directement à un objet graphique créé par la plupart des
-éléments musicaux ou événements rattachés. Lorsque ce n'est pas
-possible, par exemple sur une barre de mesure ou un changement de
-métrique -- l'objet étant alors le résultat d'une modification de
-propriété --, les notes de bas de page peuvent être spécifiées en tant
-qu'événement musical indépendant et affectant tous les objets d'un
-type particulier à un instant particulier.
+Il existe deux catégories d'annotation concernant une expression
+musicale :
-Examinons la forme développée d'une commande de note de bas de page :
+@table @emph
+@item Les annotations événementielles
+se rattachent à des événements particuliers, comme une note individuelle,
+un élément d'interprétation (doigté, accent ou nuance) ou des événements
+postérieurs (liaison, ligature manuelle). Une note de bas de page
+événementielle se libelle généralement sous la forme :
@example
-\footnote @var{marque} @var{décalage} @var{nom-grob} @var{annotation}
-@var{musique}
+[@var{position}] \footnote [@var{marque}] @var{décalage} @var{annotation} @var{musique}
@end example
-Ses arguments peuvent se définir ainsi :
+@item Les annotations temporelles
+se rapportent à un point particulier du déroulement d'un contexte
+musical. Certaines commandes, telles @code{\time} et @code{\clef}, ne
+reposent pas sur un événement pour la création de l'objet métrique ou
+clef. Il en va de même pour un accord : sa hampe ou ses crochets ne
+sont créés qu'à la fin d'un moment (plus exactement au travers de l'un
+des événements note qui le composent). Il n'est pas possible de
+connaître assurément lequel des événements note d'un accord est
+plus particulièrement à l'origine de la hampe ou du crochet. Il
+est donc plus aisé, pour de tels éléments, d'utiliser des
+annotations temporelles.
+
+Une annotation temporelle permet d'annoter des objets de rendus
+sans se référer à un événement. Elle se libelle généralement sous
+la forme :
+
+@example
+\footnote [@var{marque}] @var{décalage} @var{annotation} [@var{Contexte}.]@var{nom-grob}
+@end example
+
+@end table
+
+Les arguments, quelle que soit la catégorie d'annotation, peuvent se
+définir ainsi :
@table @var
+@item position
+Lorsque la commande @code{\footnote} s'applique à un élément
+d'interprétation ou un événement rattaché, et uniquement dans ces cas,
+elle doit être précédée d'un indicateur de positionnement (@code{-, _}
+ou @code{^}) de façon à rattacher @var{musique} (avec sa marque) à
+la note ou au silence qui précède.
+
@item marque
-un @emph{markup} ou une chaîne de caractères identifiant l'annotation
+Un @emph{markup} ou une chaîne de caractères identifiant l'annotation
tant au niveau de l'appel que de la note qui apparaîtra au bas de la
page. L'absence de cet élément -- ou une valeur de @code{\default} --
-incrémentera le compteur.
+incrémentera automatiquement le compteur. Ce compteur est réinitialisé
+à chaque page comportant une annotation.
@item décalage
-une paire de nombres -- @samp{#(2 . 1)} par exemple -- spécifiant le
+Une paire de nombres -- @samp{#(2 . 1)} par exemple -- spécifiant le
décalage de la marque, en abscisse et en ordonnée, par rapport au point
-de référence.
-
+de référence. Des valeurs positives décalent vers la droite ou le
+haut, des valeurs négatives vers la gauche ou le bas ; des valeurs à
+zéro centrent la marque sur le point de référence. Le décalage
+s'exprime en espace de portée.
+
+@item Contexte
+Le contexte auquel appartient l'objet à annoter. Cet argument
+peut être omis dès lors qu'il s'agit d'un contexte de bas niveau
+tel que @code{Voice}.
+
@item nom-grob
-le type d'objet à annoter -- @samp{#'Flag} par exemple. Lorsque cet
+Le type d'objet à annoter -- @samp{Flag} par exemple. Lorsque cet
élément est spécifié, c'est l'objet en question qui servira de point de
référence, même s'il trouve son origine non pas directement dans
-l'élément @var{musique} mais dans un objet en résultant. Son absence ou
-une valeur de @code{\default} ne permet d'annoter que des objets
-directement créés.
+une expression musicale mais dans tout objet du type spécifié
+intervenant à cet instant précis de la partition.
@item annotation
un @emph{markup} ou une chaîne de caractères qui sera reporté au bas de
@item musique
l'élément qui fait l'objet du commentaire, qu'il s'agisse d'un
événement musical, de l'un des constituants d'un accord ou d'un
-événement rattaché. Bien qu'il ne puisse être omis, il peut être
-remplacé par @code{\default}, auquel cas l'annotation ne sera pas
-rattachée à une expression musicale particulière, mais plutôt à un
-instant précis. L'argument @var{nom-grob} est alors obligatoire pour
-sélectionner le type d'objet affecté -- @samp{#'TimeSignature} par
-exemple.
+événement rattaché.
+
@end table
-Tout comme pour la commande @code{\tweak}, lorsqu'un @code{\footnote}
-s'applique à un événement rattaché ou à une articulation, il devra être
-précédé d'un @code{-} de telle sorte que l'analyseur syntaxique en
-attache le résultat à la note ou au silence précédant.
+@subsubsubheading Notes de bas de page événementielles
+@c VO Event-based footnotes
-@node Notes de bas de page automatiques
-@unnumberedsubsubsec Notes de bas de page automatiques
-@translationof Automatic footnotes
+@cindex événementielle, note de bas de page
-@cindex note de bas de page automatique
-@cindex bas de page, note automatique
+Ce type de note de bas de page s'attache à un objet de rendu
+généré directement par l'événement correspondant à @var{musique}.
+Il répond à la syntaxe :
-@funindex \footnote
-@funindex footnote
+@example
+\footnote [@var{décalage}] @var{décalage} @var{annotation} @var{musique}
+@end example
+
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
+\book {
+ \header { tagline = ##f }
+ \relative c'' {
+ \footnote #'(-1 . 3) "Une note" a4
+ a4
+ \footnote #'(2 . 2) "Un silence" r4
+ a4
+ }
+}
+@end lilypond
-La commande @code{\footnote} permet de générer automatiquement des notes
-de bas de page. Elle requiert quatre arguments : la position
-@samp{(x . y)} de l'appel de note, le @var{nom-grob} optionnel
-spécifiant l'objet de rendu auquel s'applique le commentaire,
-l'@var{annotation} qui apparaîtra au bas de la page, et enfin la
-@var{musique} à laquelle se rapporte l'annotation.
+Un accord @emph{dans son intégralité} ne peut pas faire l'objet
+d'une note de bas de page événementielle : un accord, même s'il ne
+contient qu'une seule et unique note, ne génère aucun événement en
+propre. Une des notes @emph{au sein} de l'accord peut toutefois
+se voir attribuer une annotation :
@c KEEP LY
-@lilypond[verbatim,quote,ragged-right,papersize=a8]
+@lilypond[quote,verbatim,papersize=a8landscape]
\book {
\header { tagline = ##f }
- \relative c' {
- \footnote #'(0.5 . -2)
- \markup { La première note }
- a'4 b8
- \footnote #'(0.5 . 1) #'Flag
- \markup { La troisième note }
- e\noBeam c4 d4
+ \relative c'' {
+ \footnote #'(2 . 3) "Résultat non probant" <a-3>2
+ <\footnote #'(-2 . -3) "Résultat probant" a-3>4
+ <a-3 \footnote #'(3 . 1/2) "Tout aussi probant" c-5>4
}
}
@end lilypond
-L'annotation d'un accord suit la même règle :
+Lorsque l'annotation concerne un événement postérieur ou une
+articulation, la commande @code{\footnote} @strong{doit} être
+précédée d'un indicateur de position (@code{-, _} ou @code{^}) et
+suivie de l'événement postérieur ou l'articulation comme argument
+@var{musique}. Dans ce cas, la commande @code{\footnote} peut se
+considérer comme une copie de son dernier argument auquel on
+attache une annotation. La syntaxe consacrée est :
+
+@example
+@var{position} \footnote [@var{marque}] @var{décalage} @var{annotation} @var{musique}
+@end example
@c KEEP LY
-@lilypond[verbatim,quote,ragged-right,papersize=a8]
+@lilypond[quote,verbatim,papersize=a8landscape]
\book {
\header { tagline = ##f }
- \relative c' {
- <
- \footnote #'(1 . -1.25) "Voici un do" c
- \footnote #'(2 . -0.25) \markup { \italic "Un mi bémol" } es
- \footnote #'(2 . 3) \markup { \bold "Ceci est un sol" } g
- >1
+ \relative c'' {
+ a4_\footnote #'(0 . -1) "Une liaison arbitrairement en dessous" (
+ b8^\footnote #'(1 . 0.5) "Une ligature manuelle forcée en haut" [
+ b8 ]
+ c4 )
+ c-\footnote #'(1 . 1) "Tenuto" --
}
}
@end lilypond
-@warning{Lorsque plusieurs notes de bas de page se rapportent à un même
-empilement vertical, les notes apparaîtront dans l'ordre vertical des
-appels, autrement dit celui positionné le plus haut en premier, et ainsi
-de suite.}
+Les appels de note peuvent être personnalisés, et le trait reliant
+l'objet à l'appel supprimé :
-Voici quelques exemples d'objets annotés automatiquement. Vous pouvez
-constater l'agencement des annotations correspondantes avec le copyright
-et le pied de page.
-@lilypond[verbatim,quote,ragged-right,papersize=a8]
+@subsubsubheading Notes de bas de page temporelles
+@c VO Time-based footnotes
+
+@cindex temporelle, note de bas de page
+
+Lorsque la note de bas de page se réfère à un objet de rendu résultant
+d'un événement -- @code{Accidental} ou @code{Stem} découlent d'un
+@code{NoteHead} --, l'argument @var{nom-grob} de l'objet en question est
+requis après le texte de l'annotation, en lieu et place de
+@var{musique} :
+
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
\book {
- \header { copyright = \markup { "Copyright 1970" } }
- \relative c' {
- a'4-\footnote #'(-3 . 0) \markup { \bold Forte } \f
- -\footnote #'(0 . 1.5) \markup { A slur } (
- b8)-\footnote #'(0 . -2) \markup { Beam } [ e]
- \footnote #'(1 . -1) #'Stem
- \markup { \teeny { This is a stem } }
- c4
- \footnote #'(0 . 0.5) #'AccidentalCautionary
- \markup \italic { A cautionary accidental }
- \footnote #'(1 . 1) "The note itself"
- dis?4-\footnote #'(0.5 . -0.5) \markup \italic { Slow Down }
- _"rit."
+ \header { tagline = ##f }
+ \relative c'' {
+ \footnote #'(-1 . -3) "Un bémol" Accidental
+ aes4 c
+ \footnote #'(-1 . 0.5) "Un autre bémol" Accidental
+ ees
+ \footnote #'(1 . -2) "Une hampe" Stem
+ aes
}
}
@end lilypond
-Une note de bas de page affectant un @code{\markup} de haut niveau
-s'introduit par la commande @code{\auto-footnote} :
+Notez bien que, lorsque @var{nom-grob} est spécifié, tous les objets de
+ce type qui se trouvent à ce même instant se verront attacher une
+annotation :
-@lilypond[verbatim,quote,ragged-right,papersize=a8]
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
\book {
\header { tagline = ##f }
- \markup { \auto-footnote "A simple tune" \italic "By me" }
\relative c' {
- a'4 b8 e c4 d
+ \footnote #'(-1 . 3) "Un bémol" Accidental
+ <ees ges bes>4
+ \footnote #'(2 . 0.5) "Une articulation" Script
+ c'->-.
}
}
@end lilypond
+Une note incluse dans un accord peut individuellement se voir attribuer
+une annotation événementielle. Une tête de note (@code{NoteHead}) est
+le @emph{seul} objet directement généré par un constituant d'accord ;
+elle peut donc être affectée d'une annotation événementielle. Tous les
+autres objets constituant un accord sont générés indirectement. La
+commande @code{\footnote} ne dispose pas d'une syntaxe permettant de
+spécifier @emph{à la fois} un type d'objet @emph{et} un événement
+particulier auquel s'attacher. De tels objets pourront toutefois faire
+l'objet d'une annotation temporelle, préfixée d'un @code{\single} afin
+d'annoter l'événement directement consécutif :
-@node Notes de bas de page manuelles
-@unnumberedsubsubsec Notes de bas de page manuelles
-@translationof Manual footnotes
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
+\book {
+ \header { tagline = ##f }
+ \relative c'' {
+ < \footnote #'(1 . -2) "Un la" a
+ \single \footnote #'(-1 . -1) "Un dièse" Accidental
+ cis
+ \single \footnote #'(0.5 . 0.5) "Un bémol" Accidental
+ ees fis
+ >2
+ }
+}
+@end lilypond
-@cindex note de bas de page manuelle
-@cindex bas de page, note manuelle
+@warning{Lorsque plusieurs notes de bas de page se rapportent à un même
+empilement vertical comme ci-dessus, elles sont numérotées et
+apparaîtront selon l'ordre vertical des éléments présentés, autrement dit
+celui positionné le plus haut en premier, non dans leur ordre
+d'apparition dans le fichier source.}
+
+Les objets de rendu tels que changement de clef ou d'armure tirent leur
+origine dans la modification d'une propriété plutôt que d'un véritable
+événement. D'autres, comme les barres ou numéros de mesure, dépendent
+directement de la temporisation. C'est la raison pour laquelle de tels
+objets doivent s'annoter en fonction de leur survenance au fil de la
+musique. Les notes de bas de page temporelles sont la solution à
+privilégier lorsqu'il s'agit d'annoter les hampes ou ligatures affectant
+des accords : bien qu'une telle fonctionnalité puisse s'appliquer à l'un
+des événements constituant l'accord, rien ne laisse présager lequel
+serait le plus approprié.
+
+En matière de note de bas de page temporelle, l'objet de rendu considéré
+doit toujours être mentionné explicitement, ainsi que le contexte si
+l'objet est créé dans un autre contexte que celui du plus bas niveau.
-LilyPond permet aussi de créer des notes de bas de page manuelles :
-la commande @code{\footnote} prend alors un argument supplémentaire :
-la @var{marque}, qui contient l'appel qui s'attache à la note ou à
-l'objet référencé. Contrairement aux notes de bas de page automatiques,
-l'annotation en bas de page ne sera pas précédée de la @var{marque} ;
-l'indicateur visuel est laissé à l'appréciation de l'utilisateur.
-LilyPond ne s'attache ici qu'à faire apparaître l'annotation au bas de
-la même page.
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
+\book {
+ \header { tagline = ##f }
+ \relative c'' {
+ r1 |
+ \footnote #'(-0.5 . -1) "Changement de métrique" Staff.TimeSignature
+ \time 3/4
+ \footnote #'(1 . -1) "Hampe de l'accord" Stem
+ <c e g>4 q q
+ \footnote #'(-0.5 . 1) "Barre de mesure" Staff.BarLine
+ q q
+ \footnote #'(0.5 . -1) "Changement d'armure" Staff.KeySignature
+ \key c \minor
+ q
+ }
+}
+@end lilypond
-La commande @code{\footnote} s'utilise de la même manière que dans le
-cas de notes automatiques.
+Les appels de note peuvent être personnalisés, et le trait reliant
+l'objet à l'appel supprimé :
-@lilypond[verbatim,quote,ragged-right,papersize=a8]
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
\book {
\header { tagline = ##f }
\relative c' {
- \footnote
- "1" #'(0.5 . -2)
- \markup { \italic "1. The first note" }
- a'4
- b8
- \footnote
- \markup { \bold "2" } #'(0.5 . 1)
- "2. The second note"
- e
- c4
- d-\footnote "3" #'(0.5 . -1) "3. Piano" \p
+ \footnote "*" #'(0.5 . -2) \markup { \italic "* La première note" }
+ a'4 b8
+ \footnote \markup { \super "$" } #'(0.5 . 1)
+ \markup { \super "$" \italic " La deuxième note" }
+ e c4
+ \once \override Score.FootnoteItem #'annotation-line = ##f
+ b-\footnote \markup \tiny "+" #'(0.1 . 0.1)
+ \markup { \super "+" \italic " Éditorial" } \p
}
}
@end lilypond
-L'annotation d'un accord suit la même règle :
+D'autres exemples de personnalisation des appels de note sont donnés à
+la rubrique @ref{Notes de bas de page dans du texte indépendant}.
+
+
+@node Notes de bas de page dans du texte indépendant
+@unnumberedsubsubsec Notes de bas de page dans du texte indépendant
+@translationof Footnotes in stand-alone text
+
+@cindex texte indépendant et note de bas de page
+
+De telles notes de bas de page affectent les @emph{markup} extérieurs
+aux expressions musicales. Il n'est pas nécessaire en pareil cas
+d'indiquer un point de référence par un trait ; l'appel de note vient
+juste s'accoler au @emph{markup} qui fait l'objet de l'annotation. Les
+appels de note peuvent être gérés automatiquement, auquel cas ils seront
+numériques, ou bien manuellement en fournissant un indicateur
+particulier.
+
+Les notes de bas de page concernant du texte indépendant se gèrent
+différemment selon qu'elles sont automatiques ou manuelles.
+
+
+@subsubsubheading Notes de bas de page automatiques dans du texte
+@c VO Footnotes in stand-alone text with automatic marks
+
+La syntaxe consacrée dans le cas d'une gestion automatique des appels
+de note est :
+
+@example
+\markup @{ @dots{} \auto-footnote @var{texte} @var{annotation} @dots{} @}
+@end example
+
+Ses les éléments sont :
+
+@table @var
+
+@item texte
+le @emph{markup} ou la chaîne de caractères sur lequel porte
+l'annotation ;
+
+@item annotation
+un @emph{markup} ou une chaîne de caractères constituant le texte de
+l'annotation qui sera reportée en bas de page.
+
+@end table
+
+Par exemple :
@lilypond[verbatim,quote,ragged-right,papersize=a8]
\book {
\header { tagline = ##f }
+ \markup {
+ "A simple"
+ \auto-footnote "tune" \italic " By me"
+ "is shown below. It is a"
+ \auto-footnote "recent" \italic " Aug 2012"
+ "composition."
+ }
\relative c' {
- <
- \footnote "1" #'(1 . -1.25) "1. C" c
- \footnote
- \markup { \bold "b" } #'(2 . -0.25) "b. E-flat" es
- \footnote "3" #'(2 . 3) \markup { \italic "iii. G" } g
- >1
+ a'4 b8 e c4 d
}
}
@end lilypond
-@warning{Lorsque plusieurs notes de bas de page se rapportent à un même
-empilement vertical, les notes apparaîtront dans l'ordre vertical des
-appels, autrement dit celui positionné le plus haut en premier, et ainsi
-de suite.}
-Voici quelques exemples d'objets annotés manuellement. Vous pouvez
-constater l'agencement des annotations correspondantes avec le copyright
-et le pied de page.
+@subsubsubheading Notes de bas de page personnalisées dans du texte
+@c VO Footnotes in stand-alone text with custom marks
+
+La syntaxe consacrée dans le cas d'une gestion personnalisée des appels
+de note est :
+
+@example
+\markup @{ @dots{} \footnote @var{appel} @var{annotation} @dots{} @}
+@end example
+
+Ses les éléments sont :
+
+@table @var
+
+@item appel
+un @emph{markup} ou une chaîne de caractères représentant l'appel de
+note affecté à ce point de référence. Notez bien que cette marque ne
+sera @strong{pas} reproduite automatiquement avant le texte proprement
+dit de l'annotation.
+
+@item annotation
+un @emph{markup} ou une chaîne de caractères constituant le texte de
+l'annotation qui sera reportée en bas de page, précédé de l'@var{appel}.
+
+@end table
+
+N'importe quel caractère simple tel que @code{*} ou @code{+} peut
+s'utiliser en tant qu'appel de note, comme nous l'avons vu à la rubrique
+@ref{Notes de bas de page dans une expression musicale}. D'autres
+caractères particuliers sont accessibles sous forme de raccourci -- voir
+la rubrique @ref{Équivalents ASCII} :
@lilypond[verbatim,quote,ragged-right,papersize=a8]
\book {
+ \paper { #(include-special-characters) }
\header { tagline = ##f }
+ \markup {
+ "A simple tune"
+ \footnote "*" \italic "* By me"
+ "is shown below. It is a recent"
+ \footnote \super † \concat {
+ \super † \italic " Aug 2012"
+ }
+ "composition."
+ }
\relative c' {
- a'4-\footnote
- \markup { \teeny 1 } #'(-3 . 0)
- \markup { 1. \bold Forte } \f
- -\footnote
- \markup { \teeny b } #'(0 . 1.5)
- \markup { b. A slur } (
- b8)-\footnote
- \markup { \teeny 3 } #'(0 . -2)
- \markup { 3. Beam } [
- e]
- \footnote
- \markup { 4 } #'(1 . -1) #'Stem
- \markup { \bold 4. { This is a stem } }
- c4
- \footnote
- \markup \concat \teeny { "sharp (v)" }
- #'(0 . 0.5) #'AccidentalCautionary
- \markup \italic { v. A cautionary accidental }
- dis?4-\footnote
- \markup \concat \teeny { "a" } #'(0.5 . -0.5)
- \markup \italic { a. Slow Down } _"rit."
- \footnote
- \markup { \teeny \musicglyph #"rests.4" }
- #'(1.5 . -0.25)
- \markup { \null } \breathe
+ a'4 b8 e c4 d
}
}
@end lilypond
-L'annotation manuelle d'un @code{\markup} de haut niveau répond à la
-syntaxe suivante :
+Un appel de note peut aussi se libeller sous la forme d'un point de code
+unicode -- voir la rubrique @ref{Unicode} :
@lilypond[verbatim,quote,ragged-right,papersize=a8]
\book {
\header { tagline = ##f }
- \markup { "A simple tune" \footnote "*" \italic "* By me" }
+ \markup {
+ "A simple tune"
+ \footnote \super \char##x00a7 \concat {
+ \super \char##x00a7 \italic " By me"
+ }
+ "is shown below. It is a recent"
+ \footnote \super \char##x00b6 \concat {
+ \super \char##x00b6 \italic " Aug 2012"
+ }
+ "composition."
+ }
\relative c' {
- a'4 b8 e c4 d4
+ a'4 b8 e c4 d
}
}
@end lilypond
Manuel de notation :
@ref{Commentaires textuels},
+@ref{Équivalents ASCII},
@ref{Indications textuelles},
@ref{Info-bulle},
-@ref{Mise en forme de la page},
-@ref{Titres et entêtes}.
+@ref{Liste des caractères spéciaux},
+@ref{Unicode}.
Référence des propriétés internes :
@rinternals{FootnoteEvent},
@rinternals{Footnote_engraver}.
@knownissues
-Un silence multimesures ne peut se voir affecter une note de bas de
-page.
-
Les notes de bas de page ne peuvent que s'empiler l'une au-dessus de
l'autre ; elles ne seront jamais présentées à la queue leu leu.
+
+Silences multimesures, ligatures automatiques et paroles ne peuvent se
+voir affecter de note de bas de page.
+
Les notes de bas de page peuvent générer des chevauchements quand elles
sont trop nombreuses sur une même page.
-Dès lors que vous utilisez une commande de note de bas de page manuelle,
-le bloc @code{\paper} doit contenir la mention
-@w{@code{footnote-auto-number = ##f}}.
-
@node Référencement des numéros de page
@subsection Référencement des numéros de page
\tocItem \markup "Premier mouvement"
\score {
{
- c'4 % ...
+ c'4 % @dots{}
\tocItem \markup "Passage spécifique du premier mouvement"
- d'4 % ...
+ d'4 % @dots{}
}
}
\tocItem \markup "Second mouvement"
\score {
{
- e'4 % ...
+ e'4 % @dots{}
}
}
@end verbatim
@verbatim
\paper {
- %% Translate the toc title into French:
+ %% Traduit le titre de la table des matières en français :
tocTitleMarkup = \markup \huge \column {
\fill-line { \null "Table des matières" \null }
\hspace #1
}
- %% use larger font size
+ %% des fontes un peu plus grandes
tocItemMarkup = \markup \large \fill-line {
\fromproperty #'toc:text \fromproperty #'toc:page
}
@example
\include "parties/VI.ly"
\include "parties/VII.ly"
-... etc.
+etc.
@end example
Les fichiers à inclure peuvent eux-mêmes contenir des instructions
fichier principal ; leur argument doit donc comporter le chemin
relativement au fichier principal et non par rapport au fichier dans
lequel cette inclusion est mentionnée. Vous pouvez toutefois influer
-sur ce comportement à l'aide de l'option @w{@code{-drelative-includes}}
-en ligne de commande ou en ajoutant une clause
-@code{#(ly:set-option 'relative-includes #t)} en tête du fichier
-principal. Une fois @code{relative-include} activé, le chemin à suivre
-pour chacune des commandes @code{\include} sera pris relativement au
-fichier qui la contient. Cette option est vouée à être activée par
+sur ce comportement de manière globale à l'aide de l'option
+@w{@code{-drelative-includes}} en ligne de commande ou en ajoutant une
+clause @code{#(ly:set-option 'relative-includes #t)} en tête du fichier
+principal.
+
+Lorsque @code{relative-include} est valorisé à @code{#t}, le chemin à
+suivre pour chacune des commandes @code{\include} sera pris relativement
+au fichier qui la contient. Cette option est vouée à être activée par
défaut dans une future version de LilyPond.
+Selon l'endroit où @code{relative-includes} est valorisé à @code{#t} ou
+@code{#f}, la commande @code{\include} permettra d'incorporer des
+fichiers contenus dans l'arborescence du répertoire principal et des
+fichiers situés ailleurs. Si, par exemple, une biblothèque générale
+libA a été créée pour utiliser des sous-fichiers à l'aide
+d'inclusions dans un fichier catalogue, les clauses @code{\include}
+devront être précédées d'un
+@code{#(ly:set-option #relative-includes #t)} de telle sorte
+qu'elles soient interprétées correctement lorsque rapatriées dans
+le fichier @file{.ly} principal. Examinons cela dans les faits :
+
+@example
+libA/
+ libA.ly
+ A1.ly
+ A2.ly
+ @dots{}
+@end example
+
+@noindent
+puis le fichier catalogue, @code{libA.ly}, qui contient
+
+@example
+#(ly:set-option 'relative-includes #t)
+\include "A1.ly"
+\include "A2.ly"
+@dots{}
+% retour au réglage par défaut
+#(ly:set-option 'relative-includes #f)
+@end example
+
+Tout fichier @code{.ly} peut désormais consulter l'intégralité de cette
+bibliothèque grâce à un simple
+
+@example
+\include "~/libA/libA.ly"
+@end example
+
+Un positionnement judicieux des commutateurs permet de gérer des
+structures de fichiers plus complexes.
+
Vous pouvez inclure des fichiers dont vous spécifierez le chemin d'accès
sur la ligne de commande au moment de lancer la compilation. L'appel à
ces fichiers ne mentionnera alors que leur nom. Par exemple, si vous
@example
\include "VI.ly"
\include "VII.ly"
-... etc
+ etc.
@end example
Lorsqu'un fichier est voué à être inclus dans nombre de partitions, vous
Au moment où vous lancez LilyPond, un certain nombre de fichiers se
retrouvent inclus par défaut ; il suffit d'activer le mode verbeux
-en faisant @w{@code{lilypond --verbose}} pour s'en rendre compte. Vous
+en faisant @w{@code{lilypond --verbose}} pour s'en rendre compte. Vous
verrez ainsi défiler, en plus de nombreuses informations, le nom d'un
certain nombre de fichiers et de chemins d'accès. Les fichiers les plus
important sont mentionnés au chapitre
@tab Résultat
@item
-Musique balisée précédée de @code{\keepWithTag #'@var{nom}}
- @tab Musique non balisée et musique balisée par @var{nom} seront
- incluses ; la musique balisée autrement est exclue.
+Musique balisée précédée de @code{\keepWithTag #'@var{nom}} ou
+ @code{\keepWithTag #'(@var{nom1} @var{nom2}@dots{})}
+@tab Musique non balisée et musique balisée par l'un des noms de
+ balise fournis seront incluses ; la musique balisée
+ autrement est exclue.
@item
-Musique balisée précédée de @code{\removeWithTag #'@var{nom}}
- @tab Musique non balisée et fragments appelés autrement que @var{nom}
- seront inclus ; la musique balisée par @var{nom} est exclue.
+Musique balisée précédée de @code{\removeWithTag #'@var{nom}} ou
+ @code{\removeWithTag #'(@var{nom1} @var{nom2}@dots{})}
+@tab Musique non balisée et fragments appelés autrement que par
+ l'un des noms fournis seront inclus ; la musique balisée
+ par autre chose que les noms mentionnés est exclue.
@item
Musique balisée non précédée de @code{\keepWithTag} ou
}
@end lilypond
-Ce principe de filtrage peut s'appliquer aux articulations, textes etc.
+Ce principe de filtrage peut s'appliquer aux articulations, textes, etc.
Il suffit de positionner
@example
un texte.
Vous pouvez baliser différemment la même expression musicale en
-saisissant plusieurs @code{\tag} :
+saisissant plusieurs @code{\tag} ou bien en combinant plusieurs
+balises dans une liste :
@lilypond[quote,verbatim]
music = \relative c'' {
\tag #'a \tag #'both { a4 a a a }
- \tag #'b \tag #'both { b4 b b b }
+ \tag #'(b both) { b4 b b b }
}
<<
\keepWithTag #'a \music
@end lilypond
L'application concomitante de plusieurs filtres @code{\removeWithTag} à
-la même expression musicale permet d'exclure plusieurs balisages :
+la même expression musicale permet d'exclure plusieurs balisages.
+Une liste fournie en argument à un unique @code{\removeWithTag}
+produira le même effet :
@lilypond[verbatim,quote]
music = \relative c'' {
-\tag #'A { a4 a a a }
-\tag #'B { b4 b b b }
-\tag #'C { c4 c c c }
-\tag #'D { d4 d d d }
+ \tag #'A { a4 a a a }
+ \tag #'B { b4 b b b }
+ \tag #'C { c4 c c c }
+ \tag #'D { d4 d d d }
}
-{
-\removeWithTag #'B
-\removeWithTag #'C
-\music
+\new Voice {
+ \removeWithTag #'B
+ \removeWithTag #'C
+ \music
+ \removeWithTag #'(B C)
+ \music
}
@end lilypond
expression musicale aboutit à l'exclusion de @b{tous} les balisages.
En effet, si le premier filtre exclut tous les autres balisages,
l'application du second exclura les effets du premier.
+L'utilisation d'une unique commande @code{\keepWithTag} avec une
+liste de balises est en pareil cas des plus pertinente : seront
+exclus tous les fragments non concernés par l'une quelconque des
+balises mentionnées.
Il peut arriver que vous ayez besoin de raccorder quelque chose en un
point particulier d'une expression musicale. Les commandes
@ref{Regroupement automatique de parties},
@ref{Insertion de fichiers LilyPond}.
-
-@ignore
-@c This warning is more general than this placement implies.
-@c Rests are not merged whether or not they come from tagged sections.
-@c Should be deleted? -td
-
@knownissues
-Lorsqu'elles comportent des silences, ceux-ci ne seront pas fusionnés
-si vous imprimez une partition avec les deux sections balisées.
-
-@end ignore
+L'application d'un @code{\relative} à une expression musicale
+obtenue par filtrage à l'aide de @code{\keepWithTag} ou
+@code{\removeWithTag} peut générer des changements d'octave,
+puisque seules les hauteurs récupérées dans ce filtre seront
+prises en considération. Une instruction @code{\relative} qui
+précède les commandes @code{\keepWithTag} ou
+@code{\removeWithTag} permet d'éviter ce risque, dans la mesure où
+elle viendra « recaler » ces hauteurs récupérées.
@node Globalisation des réglages
}
\addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
}
-\markup { "Copyright 2008--2012" \char ##x00A9 }
+\markup { "Copyright 2008--2014" \char ##x00A9 }
@end lilypond
@cindex copyright
processus de correction, vous pouvez @qq{escamoter} le reste et ne
générer que les dernières mesures en insérant
-@verbatim
+@example
showLastLength = R1*5
-\score { ... }
-@end verbatim
+\score @{ @dots{} @}
+@end example
@noindent
dans votre fichier source. Ceci aura pour effet de ne générer que les
@c NOTE: these images are a bit big, but that's important
@c for the font comparison. -gp
-@sourceimage{Gonville_after,,,}
+@sourceimage{Gonville_after,15cm,,}
Et ces même mesures avec la police de LilyPond, Feta :
-@sourceimage{Gonville_before,,,}
+@sourceimage{Gonville_before,15cm,,}
@subsubheading Instructions d'installation pour MacOS
@menu
* Création de fichiers MIDI::
+* Instrument MIDI::
* Le bloc MIDI::
* Contenu de la sortie MIDI::
* Répétitions et MIDI::
@example
\score @{
- @var{...musique...}
+ @var{@dots{}musique@dots{}}
\midi @{ @}
@}
@end example
@example
\score @{
- @var{...musique...}
+ @var{@dots{}musique@dots{}}
\midi @{ @}
\layout @{ @}
@}
lilypond … -dmidi-extension=midi fichierLily.ly
@end example
-
-@unnumberedsubsubsec Noms d'instrument
-@translationof Instrument names
-
-@cindex instrument, nom d'
-@funindex Staff.midiInstrument
-
-L'instrument MIDI affecté à un canal particulier est déterminé par la
-propriété @code{Staff.midiInstrument}. Vous pouvez choisir l'un des
-instruments répertoriés à l'annexe @ref{Instruments MIDI}.
-
-@example
-\new Staff @{
- \set Staff.midiInstrument = #"glockenspiel"
- @var{...notes...}
-@}
-@end example
-
-@example
-\new Staff \with @{midiInstrument = #"cello"@} @{
- @var{...notes...}
-@}
-@end example
-
-Lorsque l'instrument choisi ne correspond pas exactement à l'une des
-dénominations consacrées, LilyPond le replacera par un piano de concert
-(@code{"acoustic grand"}).
-
@snippets
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{changing-midi-output-to-one-channel-per-voice.ly}
@uref{http://@/timidity@/.sourceforge@/.net/,timidity} le font sans
problème.
+@node Instrument MIDI
+@subsection Instrument MIDI
+@translationof MIDI Instruments
+
+@cindex instrument, nom d'
+@cindex MIDI, instruments
+@funindex Staff.midiInstrument
+
+L'instrument MIDI affecté à un canal particulier est déterminé par la
+propriété @code{Staff.midiInstrument}. Vous pouvez choisir l'un des
+instruments répertoriés à l'annexe @ref{Instruments MIDI}.
+
+@example
+\new Staff @{
+ \set Staff.midiInstrument = #"glockenspiel"
+ @var{@dots{}notes@dots{}}
+@}
+@end example
+
+@example
+\new Staff \with @{midiInstrument = #"cello"@} @{
+ @var{@dots{}notes@dots{}}
+@}
+@end example
+
+Lorsque l'instrument choisi ne correspond pas exactement à l'une des
+dénominations consacrées, LilyPond le replacera par un piano de concert
+(@code{"acoustic grand"}).
+
@node Le bloc MIDI
@subsection Le bloc MIDI
@example
\score @{
- @var{...musique...}
+ @var{@dots{}musique@dots{}}
\midi @{
\tempo 4 = 72
@}
270 croches à la minute :
@example
-tempoWholesPerMinute = #(ly:make-moment 270 8)
+tempoWholesPerMinute = #(ly:make-moment 270/8)
@end example
@cindex MIDI et définition de contexte
@example
\midi @{
- ...
+ @dots{}
\context @{
\Voice
\remove "Dynamic_performer"
@c TODO Check grace notes - timing is suspect?
+@menu
+* Éléments pris en compte dans le MIDI::
+* Éléments non pris en compte dans le MIDI::
+@end menu
+
+@node Éléments pris en compte dans le MIDI
@unnumberedsubsubsec Éléments pris en compte dans le MIDI
@translationof Supported in MIDI
alors inclus :
@itemize
-@item articulations (lié, staccato, etc.),
+@item articulations (lié, staccato, etc.),
@item trilles et groupettos,
@item rallentando et accelerando.
@end itemize
+@node Éléments non pris en compte dans le MIDI
@unnumberedsubsubsec Éléments non pris en compte dans le MIDI
@translationof Unsupported in MIDI
@example
\score @{
- @var{..musique..}
- \layout @{ .. @}
+ @var{@dots{}musique@dots{}}
+ \layout @{ @dots{} @}
@}
\score @{
- \unfoldRepeats @var{..musique..}
- \midi @{ .. @}
+ \unfoldRepeats @var{@dots{}musique@dots{}}
+ \midi @{ @dots{} @}
@}
@end example
volume général, celui des indications de nuance ainsi que celui des
différents instruments.
+@menu
+* Indications de nuance::
+* Amplitude du volume en MIDI::
+* Égalisation de plusieurs instruments (i)::
+* Égalisation de plusieurs instruments (ii)::
+@end menu
+
+@node Indications de nuance
@unnumberedsubsubsec Indications de nuance
@translationof Dynamic marks
Le dernier exemple de cette partie illustre la manière de procéder.
+@node Amplitude du volume en MIDI
@unnumberedsubsubsec Amplitude du volume en MIDI
@translationof Overall MIDI volume
Les valeurs extrêmes du volume MIDI des nuances se contrôlent à l'aide
des propriétés @code{midiMinimumVolume} et @code{midiMaximumVolume} qui
agissent au niveau @code{Score}. Ces propriétés sont effectives dès
-lors qu'une nuance est indiquée ; une nuance de départ est donc
+lors qu'une nuance est indiquée ; une nuance de départ explicite est donc
requise pour que le volume soit ajusté dès le début de la partition.
Vous pouvez alors modifier la fraction correspondant à chaque nuance à
l'aide de la formule
@end example
Voici comment ajuster les nuances tout en limitant l'amplitude du volume
-entre 0,2 et 0,5 :
+entre 0,2 et 0,5 :
@lilypond[verbatim,quote]
\score {
>>
\layout {}
\midi {
+ \tempo 2 = 72
\context {
\Score
- tempoWholesPerMinute = #(ly:make-moment 72 2)
midiMinimumVolume = #0.2
midiMaximumVolume = #0.5
}
@end lilypond
+@node Égalisation de plusieurs instruments (i)
@unnumberedsubsubsec Égalisation de plusieurs instruments (i)
@translationof Equalizing different instruments (i)
@end lilypond
+@node Égalisation de plusieurs instruments (ii)
@unnumberedsubsubsec Égalisation de plusieurs instruments (ii)
@translationof Equalizing different instruments (ii)
@example
\unfoldRepeats \articulate <<
- tout le reste du bloc contenant la partition...
+ tout le reste du bloc contenant la partition@dots{}
>>
@end example
LilyPond affichera le résultat sous forme de message en console, au
milieu de toutes les informations de compilation. Afin d'isoler ces
messages et enregistrer le résultat de la fonction
-@code{\display@{MATÉRIAU@}}, pensez à rediriger la sortie vers un
-fichier.
+@code{\displayLilyMusic}, pensez à rediriger la sortie vers un fichier.
@example
lilypond fichier.ly > affichage.txt
nombre de paramètres optionnels.
@example
-@var{temps} @var{type} @var{...paramètres...}
+@var{temps} @var{type} @var{@dots{}paramètres@dots{}}
@end example
Ces informations peuvent faire l'objet d'un retraitement par d'autres
projects / lilypond.git / blobdiff