1.6 À propos de ce manuel

Le manuel est divisé en quatres livres.

Manuel d'apprentissage

Ce livre explique comment débuter avec LilyPond, et expose de manière simple quelques concepts clés.

• Le Tutoriel propose une introduction en douceur à la typographie musicale. Les utilisateurs débutants sont invités à commencer ici.
• Tout mettre en ordre 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 !
• Travailler sur des projets LilyPond montre des utilisations pratiques de LilyPond et donne des conseils afin d'éviter les problèmes les plus courants.
• Retoucher les résultats est une introduction aux retouches de gravure avec LilyPond.

Manuel de référence

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

• Notation de base 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.
• Notation spécifique 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.
• Notation avancée traite de sujets groupés par type de notation. Cette section donne des précisions à propos de notations compliquées et inhabituelles
• Changer les réglages prédéfinis explique comment ajuster finement la mise en page.
• Objets non musicaux traite de sorties non musicales comme les titres, les mouvements multiples, et la sélection des instruments MIDI.
• Gestion de l'espace traite de sujets affectant la sortie globale, comme sélectionner la taille de papier ou spécifier les sauts de page.
• Interfaces pour les programmeurs explique comment créer des fonctions de musique.

Utilisation du programme

Ce livre explique comment exécuter le programme et comment intégrer les partitions LilyPond dans d'autres programmes.

• Lancer LilyPond montre comment lancer LilyPond et ses programmes auxiliaires. De plus, cette section explique comment mettre à jour des fichiers source écrits pour d'anciennes versions de LilyPond.
• LilyPond-book explique comment créer des documents intégrant des exemples musicaux, comme ce manuel.
• Convertir à partir d'autres formats explique comment exécuter les programmes de conversion. Ces programmes sont livrés avec le paquetage LilyPond, et convertissent une variété de formats musicaux vers le format .ly.

Annexes

Ce livre contient des tables de référence pratiques.

• La Bibliographie contient un choix de livres de référence utiles pour ceux qui veulent en savoir plus sur la notation et la gravure.
• Le Tutoriel Scheme propose une courte introduction à Scheme, le langage de programmation utilisé dans les fonctions de musique.
• Les Tables du manuel de notation sont un ensemble de tableaux montrant les noms d'accord, les instruments MIDI, les noms de couleur, et la police Feta.
• Les Modèles de pièces LilyPond. Copiez et collez un modèle dans un fichier, ajoutez les notes, et c'est prêt !
• La Aide-mémoire est une référence pratique des commandes LilyPond les plus courantes.
• L' Index des commandes LilyPond est un index de toutes les \commandes LilyPond.
• L' Index de LilyPond est un index complet.

Autre documentation

D'autres documents constituent de précieuses sources d'information.

Le glossaire musical explique les termes musicaux et inclut les traductions dans diverses langues. Il est également disponible au format PDF. Si vous n'êtes pas familier avec la notation musicale ou la terminologie, il est conseillé de consulter le glossaire, notamment pour les parties non encore traduites de la documentation.
• Les Exemples de code sont une vaste sélection de petits exemples montrant des trucs, astuces et fonctionnalités particulières de LilyPond. La plupart de ces exemples sont également disponibles sur le LilyPond Snippet Repository. Ce site Web possède également le manuel de LilyPond avec une fonctionnalité de recherche.
• La référence du programme. 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 une section Voir aussi qui renvoie à la documentation générée automatiquement. Dans la documentation au format HTML, ces sous-sections ont des liens cliquables.

Lorsque vous serez un utilisateur expérimenté, vous pourrez consulter le manuel comme une référence : il y a un index complet¹, mais le manuel est aussi disponible en une seule grande page, ce qui facilite la recherche avec la fonction de recherche de votre navigateur.

Dans tous les documents HTML qui incluent des fragments musicaux, le code Lilypond utilisé pour produire l'image peut être vu en cliquant 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épértoire /usr/share/lilypond/.

Pour finir, ce manuel et les autres sont disponibles en ligne, à la fois aux formats PDF et HTML, à partir du site Web, accessible à l'adresse http://www.lilypond.org/.

Autres langues : English, español, deutsch.