# Introduction à LilyPond/Afficher du texte

* Principe général
* Structure du fichier
* La hauteur des notes
* Le rythme
* Une ligne mélodique complète
* Partition de chant et grille d'accords
* Association de plusieurs voix
* Gestion de partitions volumineuses
* Notation spécifique à certains instruments
* Mise en forme d'une partition
* Génération d'un fichier de son
* Afficher du texte
* Programmation
* LilyPond et Python
* Voir aussi
* Index
* Principe général
* Structure du fichier
* La hauteur des notes
* Le rythme
* Une ligne mélodique complète
* Partition de chant et grille d'accords
* Association de plusieurs voix
* Gestion de partitions volumineuses
* Notation spécifique à certains instruments
* Mise en forme d'une partition
* Génération d'un fichier de son
* Afficher du texte
* Programmation
* LilyPond et Python
* Voir aussi
* Index
[ Modifier le sommaire ]
Nous avons vu à plusieurs endroits comment afficher du texte. Nous regroupons ici les informations.

## Comment afficher du texte
### Chaîne de caractères

Dans LilyPond, le texte à afficher peut être :
* mis entre guillemets anglais ", par exemple : "Texte à afficher" ; c'est la solution utilisée lorsque le texte est simple : sans caractère spécial, sans mise en forme (pas d'italique ni de gras, pas de retour à la ligne…) ;
* mis dans un environnement \markup{…}, par exemple : \markup{Texte à afficher}.
La chaîne vide s'écrit donc "" ou bien \markup.

### Dans l'en-tête

Il y a du texte qui est lié à l'en-tête du document : il est mis dans des variables dédiées. C'est en particulier le cas du titre de la pièce (dans la variable title) et du nom du compositeur (dans la variable composer) :
La liste des variable de l'en-tête est donnée au chapitre Partition de chant et grille d'accords > En-tête.

### Dans la nomenclature

Il y a du texte qui est lié à la portée, il est lui aussi mis dans des variables ; il s'agit du nom de l'instrument (dans les variables instrumentName et shortInstrumentName) qui s'affiche dans la nomenclature (marge à gauche de la portée) :

### Au niveau des fonctions qui structurent la partition

Il y a du texte attaché à certaines fonctions qui structurent la partition. C'est par exemple le cas de l'indication textuelle du tempo (qui suit la commande \tempo), des noms de section (qui suivent la commande \sectionLabel) ou des marques de répétition (qui suivent la commande \mark) :
Concernant les sections :
* cette fonctionnalité a été introduite avec la version 2.23
* la commande \section indique un changement de section et place automatiquement une double-barre de mesure || ;
* si l'on veut donner une indication avant la double-barre, par exemple une indication de saut (type D.C. ou D.S.) , on la met après une commande \jump, le texte est alors en italiques.

### Au niveau des notes ou des mesures

Il y a du texte qui est affiché au-dessus ou en dessous d'une note ; il s'agit en général d'un commentaire ou d'une indication de jeu. Pour placer ce texte, on le met après un trait d'union - pour laisser LilyPond placer le texte librement au-dessus ou en dessous ; après un tiret de soulignement _ pour le placer sous la portée, et après un accent circonflexe ^ pour le mettre au-dessus de la portée :
Il y a du texte attaché aux mesures ; il est placé au-dessus de la portée. Si le texte doit être aligné au début de la portée, on utilise une commande \textMark ; pour l'aligner à la fin de la mesure, on utilise \textEndMark.

### Paroles

Il y a le texte des paroles d'un chant. Il est dans un environnement \lyricmode. Ce mode est activé automatiquement avec la commande \addlyrics{…} (pour les chants simples) ou bien \lyricsto{…} (qui permet d'attacher les paroles à une voix Voice donnée) :
Pour avoir tout le texte en italique :

### Texte indépendant de la partition

On peut mettre un bloc de texte avant ou après un environnement \score{…}, par exemple pour mettre une introduction et des notes de fin.

### Note

Dans tous les exemples ci-dessous, on peut utiliser un environnement \markup{…} et des variables.
Par exemple :

## Mise en forme globale

Le bloc \layout{…} permet de définir des paramètres de mise en forme valables pour la partition pour certains contextes.

## Mise en forme d'une portée

Les paramètres de mise en forme concernant une portée sont placés dans l'environnement \with, ou ben au sein de l'environnement avec un \set :
Cela concerne :
* la nomenclature (nom de l'instrument) ;
* la clef ;
* le chiffrage de la mesure.

## Mise en forme d'un texte donné

Pour mettre en forme une chaîne de caractère, il faut utiliser le contexte \markup{…}.
Pour avoir du texte en italique, on utilise \italic ; pour du gras : \bold. La commande \upright revient à des lettres droites (inverse de \italic), la commande \medium revient à la graisse normale (inverse de \bold)). On peut souligner avec la commande \underline.
Pour le type de police, on a : \roman (police à empattement type Times), \sans (police sans empattement type Arial), \typewriter pour une police à chasse fixe (type Courier).
On peut mettre tout en capitales avec \caps et en petites capitales avec \smallCaps. On peut avoir une notation en supérieur (exposant) et en inférieur (indice) avec \super et \sub.