[ << Introduction ] | [Racine][Table des matières][Index][ ? ] | [ Tutoriel >> ] | ||
[ < Exemples d’application ] | [ Plus haut: Introduction ] | [ À propos du manuel d’initiation > ] |
1.2 À propos de la documentation
Cette partie présente les différents volumes de la documentation.
À propos du manuel d’initiation | introduction à LilyPond, ce manuel explique aux débutants la création de partitions. | |
À propos du glossaire musicologique | ce document explique de nombreux termes musicaux et en donne la traduction dans d’autres langues. | |
À propos du manuel de notation | ce manuel représente la partie la plus volumineuse de la documentation. Il fournit tous les détails sur la création de notation musicale. La lecture de cet ouvrage requiert une bonne compréhension des concepts exposés dans le manuel d’initiation. | |
À propos du manuel d’utilisation | ce manuel aborde l’exécution des programmes LilyPond et les particularités dépendant du système d’exploitation. | |
À propos des morceaux choisis | ce document rassemble une collection d’extraits de code LilyPond. | |
À propos des références du programme | ce manuel constitue une source d’information sur le fonctionnement interne de LilyPond. C’est une référence complète pour l’élaboration de retouches. | |
Autres sources de documentation | d’autres sources de documentation sont disponibles, telles que les notes de nouveautés et les archives des listes de diffusion. |
[ << Introduction ] | [Racine][Table des matières][Index][ ? ] | [ Tutoriel >> ] | ||
[ < À propos de la documentation ] | [ Plus haut: À propos de la documentation ] | [ À propos du glossaire musicologique > ] |
À propos du manuel d’initiation
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.
- Tutoriel : introduction en douceur à la typographie musicale. Les utilisateurs débutants sont invités à commencer par ce chapitre.
-
Concepts fondamentaux : 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 ! - Retouche de partition : introduction aux retouches de gravure avec LilyPond.
- Travail sur des projets LilyPond : 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 :
- Modèles de pièces LilyPond. Copiez et collez un modèle dans un fichier, ajoutez les notes, et c’est prêt !
- Tutoriel Scheme : 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.
[ << Introduction ] | [Racine][Table des matières][Index][ ? ] | [ Tutoriel >> ] | ||
[ < À propos du manuel d’initiation ] | [ Plus haut: À propos de la documentation ] | [ À propos du manuel de notation > ] |
À propos du glossaire musicologique
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.
[ << Introduction ] | [Racine][Table des matières][Index][ ? ] | [ Tutoriel >> ] | ||
[ < À propos du glossaire musicologique ] | [ Plus haut: À propos de la documentation ] | [ À propos du manuel d’utilisation > ] |
À propos du manuel de notation
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.
- Notation musicale générale : 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.
- Notation spécialisée : cette partie détaille des éléments de notation spécifiques à certains instruments ou styles. Les sujets sont groupés par type de notation.
- Généralités en matière d’entrée et sortie : informations générales sur les fichiers source LilyPond et le contrôle des sorties.
- Gestion de l’espace : 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.
- Modification des réglages prédéfinis : 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 pour les programmeurs : 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.
- Bibliographie : choix de livres de référence, pour en savoir plus sur la notation et la gravure.
- Tables du manuel de notation : tableaux montrant les noms d’accord, les instruments MIDI, les noms de couleur, et la police Feta.
- Aide-mémoire : référence pratique des commandes LilyPond les plus courantes.
-
Index des commandes LilyPond : index de toutes les
\commandes
LilyPond. - Index de LilyPond : un index complet.
[ << Introduction ] | [Racine][Table des matières][Index][ ? ] | [ Tutoriel >> ] | ||
[ < À propos du manuel de notation ] | [ Plus haut: À propos de la documentation ] | [ À propos des morceaux choisis > ] |
À propos du manuel d’utilisation
Ce manuel explique l’exécution des programmes et l’intégration de partitions LilyPond dans d’autres programmes.
- Installation : installation — et éventuellement compilation — de LilyPond.
- Environnement de travail : configuration de votre système pour une utilisation optimale de LilyPond, comprenant l’utilisation d’environnements adaptés pour certains éditeurs de tecte.
- Exécution de 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.
-
Conversion à partir d’autres 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
.
[ << Introduction ] | [Racine][Table des matières][Index][ ? ] | [ Tutoriel >> ] | ||
[ < À propos du manuel d’utilisation ] | [ Plus haut: À propos de la documentation ] | [ À propos des références du programme > ] |
À propos des morceaux choisis
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.
[ << Introduction ] | [Racine][Table des matières][Index][ ? ] | [ Tutoriel >> ] | ||
[ < À propos des morceaux choisis ] | [ Plus haut: À propos de la documentation ] | [ Autres sources de documentation > ] |
À propos des références du programme
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.
[ << Introduction ] | [Racine][Table des matières][Index][ ? ] | [ Tutoriel >> ] | ||
[ < À propos des références du programme ] | [ Plus haut: À propos de la documentation ] | [ Tutoriel > ] |
Autres sources de 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/’.
[ << Introduction ] | [Racine][Table des matières][Index][ ? ] | [ Tutoriel >> ] | ||
[ < À propos des références du programme ] | [ Plus haut: À propos de la documentation ] | [ Tutoriel > ] |