GNU LilyPond – Manuel d’initiation : 1.2 About the documentation
Description: GNU LilyPond – Manuel d'initiation: 1.2 About the documentation
Keywords: GNU LilyPond – Manuel d'initiation: 1.2 About the documentation

## 1.2 About the documentation

Cette partie présente les différents volumes de la documentation.

### About the Learning Manual

Ce manuel explique comment débuter avec LilyPond, et expose de manière simple quelques concepts clés. Il est conseillé de lire ces chapitres de manière linéaire.

Dans ce manuel se trouve à chaque section un paragraphe 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.

- Introduction : le pourquoi du comment de LilyPond.
- Tutorial : introduction en douceur à la typographie musicale. Les utilisateurs débutants sont invités à commencer par ce chapitre.
- Fundamental concepts : concepts généraux du format de fichier `ly` spécifique à LilyPond. Si vous n’êtes pas certain de l’endroit où placer une commande, lisez ce chapitre !
- Tweaking output : introduction aux retouches de gravure avec LilyPond.
- 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 !

Ce volume contient aussi des annexes que vous pouvez consulter au gré de vos besoins :

- Templates de pièces LilyPond. Copiez et collez un modèle dans un fichier, ajoutez les notes, et c’est prêt !
- Scheme tutorial : courte introduction à Scheme, le langage de programmation utilisé dans les fonctions de musique. Ces quelques lignes vous aideront à construire des retouches avancées ; nombre d’utilisateurs ne touchent jamais à Scheme.

### About the Music Glossary

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.

### About the Notation Reference

Ce manuel détaille toutes les commandes LilyPond produisant une notation musicale. La lecture de cet ouvrage requiert une bonne compréhension des concepts exposés dans le manuel d’initiation.

- 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.
- 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.
- General input and output : informations générales sur les fichiers source LilyPond et le contrôle des sorties.
- 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.
- 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.
- Interfaces for programmers : création de fonctions de musique à l’aide de Scheme.

Les annexes de ce manuel contiennent entre autres des tableaux de référence pratiques.

- Literature list : choix de livres de référence, pour en savoir plus sur la notation et la gravure.
- Notation manual tables : tableaux montrant les noms d’accord, les instruments MIDI, les noms de couleur, et la police Feta.
- Cheat sheet : référence pratique des commandes LilyPond les plus courantes.
- LilyPond command index : index de toutes les `\commandes` LilyPond.
- LilyPond index : un index complet.

### About the Application Usage

Ce manuel explique l’exécution des programmes et l’intégration de partitions LilyPond dans d’autres programmes.

- Install : installation — et éventuellement compilation — de LilyPond.
- Setup : configuration de votre système pour une utilisation optimale de LilyPond, comprenant l’utilisation d’environnements adaptés pour certains éditeurs de tecte.
- 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.
- LilyPond-book : création de documents intégrant des extraits musicaux, comme ce manuel.
- 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 `.ly`.

### About the Snippet List

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 LilyPond Snippet Repository (LSR). Tous ces exemples sont dans le domaine public.

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 ‘`input/new/`’ des sources de LilyPond.

La liste des exemples correspondant à chacun des sous-chapitres du manuel de notation est accessible par des liens dans le paragraphe Voir aussi.

### About the Internals Reference

Référence des propriétés internes : c’est un ensemble de pages HTML étroitement liées entre elles, qui documente les moindres petits détails de chaque classe, objet et fonction de LilyPond. Cette documentation est produite directement à partir des définitions de formatage utilisées.

Presque toutes les fonctions de formatage utilisées en interne sont directement disponibles pour l’utilisateur. Par exemple, toutes les variables qui contrôlent les épaisseurs, les distances etc., peuvent être modifiées dans les fichiers d’entrée. Il y a un grand nombre d’options de formatage, et elles sont toutes décrites dans ce document. Chaque section du manuel de notation a un paragraphe Voir aussi, qui renvoie à la documentation générée automatiquement. Dans la documentation au format HTML, ces paragraphes disposent de liens cliquables.

### Other documentation

Pour finir, présentons d’autres précieuses sources de documentation.

- Nouveautés : ce document résume les changements importants et les nouvelles fonctionalités de LilyPond depuis la dernière version stable.
- 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. 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.
- 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.
- 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.
- 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, ‘`input/test/bla.ly`’ peut référer au fichier ‘`lilypond2.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 ‘`/usr/share/doc/lilypond/`’. Les fichiers d’initialisation, par exemple ‘`scm/lily.scm`’, ou ‘`ly/engraver-init.ly`’, se trouvent généralement dans le répertoire ‘`/usr/share/lilypond/`’.

Other languages: English, español, deutsch.

#### Manuel d’initiation