1.6 À propos de ce manuel

Le manuel est divisé en chapitres comme suit :

• 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 ficheir 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.
• 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.
• Questions d'espacement 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.
• 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.
• 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é par 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, ajouter les notes, et c'est prêt !
• La Feuille aide-mémoire est une référence pratique des commandes LlyPond les plus courantes.
• L' Index des commandes LilyPond est un index de toutes les \commandes LilyPond.
• L' Index de LilyPond est un index complet.

Une fois que vous êtes un utilisateur expérimenté, vous pouvez utiliser le manuel comme référence : il y a un index exhaustif¹, mais ce document est aussi disponible en une seule grande page, dans laquelle la fonction recherche d'un navigateur Web est très utile pour trouver quelque chose. 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. Le Music glossary explique les termes musicaux et inclut les traductions vers divers languages. Il est également disponible au format PDF.

Ce manuel ne serait pas complet sans un certain nombre d'autres documents. Ils ne sont pas tous disponibles au format papier, mais devraient être inclus dans le paquetage de documentation pour votre plateforme.

• Program reference.

  La référence du programme est un groupe de pages HTML étroitement liées entre elles, qui documente tous les petits détails de chaque classe, objet et fonction de LilyPond. Elle 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 réfère à la documentation générée automatiquement. Dans la documentation au format HTML, ces sous-sections ont des liens cliquables.

• Exemples de source divers.

  Cette ensemble de fichiers montre des trucs et astuces variés, sous la forme d'un large fichier HTML, avec des images et des textes explicatifs.

• Les tests de régression.

  Cet ensemble de fichiers teste chaque fonctionnalité de notation et de gravure de Lilypond en un seul fichier. L'ensemble est surtout présent pour nous aider à deboguer les problèmes, mais peut également être instructif pour voir comment nous testons le logiciel. Le format est identique au document de trucs et astuces.

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é 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 de LilyPond, accessible à l'adresse http://www.lilypond.org/.

Other languages: English.