Home

LilyPond Utilisation des programmes

Contents

1. gt d done sh s les fichiers partag s pour ghostscript cp L r usr share ghostscript usr share les fichiers partag s pour ImageMagick cp L r usr lib ImageMagick usr lib Partant du principe que test ly est dans mnt lilyloop lilyhome on devrait pouvoir lancer Attention lilyprefix bin lilypond est un script qui d finit LD_LIBRARY_PATH c est primordial lilyprefix bin lilypond jlily lily mnt lilyloop lilyhome test Lu 1 3 Messages d erreur Diff rents messages d erreur sont susceptibles d apparaitre au cours de la compilation d un fichier Chapitre 1 Ex cution de lilypond 13 Warning Avertissement Ce type de message est mis lorsque LilyPond d tecte quelque chose de suspect Si vous avez demand quelque chose qui sort de l ordinaire vous saurez probablement ce quoi il est fait r f rence et ignorerez de tels messages sans remord N anmoins les messages d avertissement indiquent la plupart du temps une incoh rence dans le fichier source Error Erreur LilyPond a d tect une erreur L tape en cours qu il s agisse de l analyse de l interpr tation des donn es ou bien du formatage sera men e son terme puis LilyPond s arr tera Fatal error Erreur fatale LilyPond est confront une anomalie bloquante Ceci ne se produit que tr s rarement et la plupart du temps en raison d une installation d fectueuse des fontes Schem
2. D cale le bord gauche du typon EPS d une valeur donn e en millim tres Charge les fontes grace Ghostscript Limite les fontes charg es par Ghostscript aux seules fontes LilyPond Travaille silencieusement et redirige tout le verbiage dans un fichier journal Note a l attention des utilisateurs de Windows toutes les informations concernant le traitement apparaissent au fur et mesure dans l interpr teur de commandes lorsque vous lancez le pro gramme lilypond exe a l inverse de lilypond windows exe qui vous renvoie simplement la main L option dgui vous permettra alors de rediriger ces informations dans un fichier journal help include book title preview f t Affiche cette aide Inclut les titres de l ouvrage dans les images de pr visualisation Chapitre 1 Ex cution de lilypond include eps fonts include settings job count log file max markup depth midi extension music strings to paths paper size pixmap format point and click preview t f f f fichier 1024 midi f a4 pngi6m t f Inclut les fontes dans chaque fichier EPS con tenant un syst me Inclut un fichier contenant les r glages globaux Ce fichier sera inclus avant traitement de la partition Traite plusieurs fichiers en parall le selon le nombre de jobs Fournir TOTO en second argument redirigera la sortie dans le fichier journal TOTO log Pr
3. pour d terminer le num ro de l ancienne version Mettre jour votre fichier ne vous demande que de lancer Chapitre 2 Mise jour avec convert ly 18 convert ly e monfichier ly dans le dossier o il se trouve monfichier ly sera mis jour avec un nouveau bum ro en argument version et vous aurez une copie de l original monfichier ly Note convert ly effectuera les conversions jusqu aux modifications de syntaxe les plus r centes qu il contient C est la raison pour laquelle le num ro de version modifi est la plupart du temps inf rieur au propre num ro de version de convert 1ly Vous pouvez convertir tous les fichiers d un dossier en lan ant convert ly e ly Les utilisatuers de Gnu Linux ou de MacOS X peuvent lancer cette commande dans un terminal Les utilisateurs de MacOS X disposent d une entr e sp cifique dans le menu Compile gt Update syntax Un utilisateur de Windows lancera la commande convert ly py e ly dans l interpr teur de commandes qui se trouve normalement sous D marrer gt Accessoires gt Interpr teur de commandes ou pour la version 8 en faisant une recherche sur interpr teur de commande La conversion d un jeu de fichiers r partis dans diff rents sous r pertoires s obtient en lan ant find name ly exec convert ly e Ceci aura pour effet de rechercher et convertir tous les fichiers sources dans le r pertoire en cours et dans
4. symphonie ly symphoniel ly symphonieII ly symphonielll ly symphonielV ly PDF Pupitres symphonie alto ly symphonie cello ly symphonie cor ly symphonie hautbois ly symphonie violonUn 1ly symphonie violonDeux 1ly symphonieDefs ily Les fichiers 1y des r pertoires Partitions et Pupitres r cup reront la notation des fichiers ily contenus dans le r pertoire Notes hhh d but du fichier symphonie cello ly include symphonieDefs ily include Notes cello ily Le Makefile r pertorie des cibles correspondant score l int grale au format conducteur mouvements chacun des mouvements au format conducteur et pupitres une partition par pupitre Il contient aussi une cible archive charg e de g n rer une archive des fichiers source qui pourra tre diffus e sur la toile ou transmise par courriel Voici ce que contiendrait ce Makefile pour GNU Linux ou MacOS X Ce fichier doit tre enregistr sous le nom de Makefile 4 la racine du projet ici Symphonie Note Lorsque vous d finissez une cible ou une r gle sur plusieurs lignes les lignes partir de la deuxi me doivent d buter par une tabulation non pas par des espaces Le pr fixe au nom des fichiers r sultants piece symphonie D termination du nombre de processeurs CPU_CORES cat proc cpuinfo grep m1 cpu cores sed s x La commande d appel a l
5. Le fait de placer les notes dans des voix auxquelles sont attach s orientation de hampe et d calage comme voiceOne ou autre peut permettre d viter ces avertissements Les notes se trouvant dans des voix au num ro plus l v voiceThree ou voiceFour sont automatiquement d cal es pour viter que les empilements se chevauchent Ceci aura pour r sultat de visuellement d caler les notes affubl es de hampe sans toutefois bouger les rondes hormis dans le cas d un r el chevauchement ou lorsque ces voix se croisent voiceThree au dessus de voiceOne Voir aussi Manuel d initiation Section Instanciation explicite des voix dans Manuel d initiation Section Exemple concret dans Manuel d initiation Manuel de notation Section Polyphonie sur une port e dans Manuel de notation Section R solution des collisions dans Manuel de notation Chapitre 2 Mise jour avec convert ly 17 2 Mise jour avec convert ly Au fur et mesure des am liorations de LilyPond la syntaxe ou fa on de libeller les fonctions et commandes peut tre amen e voluer Ceci peut avoir pour effet de g n rer des erreurs ou avertissements intempestifs voire une sortie erron e lorsque des fichiers cr s avec une version ant rieure sont trait s par une version plus r cente du progamme L utilitaire convert ly permet alors de mettre ces fichiers en conformit au fur et mesure que de nouvelles versions d
6. ly do convert ly e x Toutes les volutions du langage ne sont pas forc ment prises en charge convert ly ne tol re qu une seule option de sortie la fois La mise jour automatique du code Scheme inclus dans les fichiers LilyPond est plus qu hasardeuse attendez vous devoir mettre les mains dans le cambouis 2 5 Conversions manuelles En th orie un programme tel que convert 1ly devrait pouvoir traiter n importe quel changement de syntaxe En effet si un programme informatique sait interpr ter aussi bien une version que l autre un autre programme informatique doit alors tre capable de traduire un fichier donn Le projet LilyPond ne dispose cependant que de ressources limit es les conversions ne sont pas toutes automatis es Voici une liste de probl mes clairement identifi s 1 6 gt 2 0 Doesn t always convert figured bass correctly specifically things like lt gt Mats comment on working around this To be able to run convert ly on it I first replaced all occurrences of lt to some dummy like and similarly I replaced gt with amp After the conversion I could then change back from to lt and from amp to gt Doesn t convert all text markup correctly In the old markup syntax it was possible to group a number of markup commands together within parentheses e g bold italic string This will incorrectly be converted into markup bold itali
7. cor ily hautbois ily trioCordes ily alto ily violonUn ily violonDeux ily piece I pdf piece I ly notes piece II pdf piece II ly notes piece III pdf piece III ly notes piece IV pdf piece IV ly notes piece pdf piece ly notes piece cello pdf piece cello ly cello ily piece cor pdf piece cor ly cor ily piece hautbois pdf piece hautbois ly hautbois ily piece alto pdf piece alto ly alto ily piece violonUn pdf piece violonUn ly violonUn ily piece violonDeux pdf piece violonDeux ly violonDeux ily PHONY score score piece pdf PHONY parties parties piece cello pdf piece violonUn pdf piece violonDeux pdf piece alto pdf piece hautbois pdf piece cor pdf PHONY mouvements mouvements piece I pdf piece II pdf piece III pdf piece IV pdf Chapitre 5 Suggestions pour la saisie de fichiers Lily Pond 59 all score parties mouvements Le Makefile suivant convient pour un document 1ilypond book r alis avec IATEX Ce projet contiendra un index ce qui n cessitera de lancer une deuxi me fois latex pour mettre jour les liens Les fichiers r sultants iront dans le r pertoire out pour ce qui est des pdf et dans le r pertoire htmlout pour ce qui est du html SHELL bin sh FILE monprojet OUTDIR out WEBDIR htmlout VIEWER acroread BROWSER firefox LILYBOOK_PDF lilypond book out
8. lt p gt Un document pour lilypond book peut absolument m langer musique et texte Par exemple lt lilypond gt relative a 4 bcd lt lilypond gt lt p gt lt p gt Pourquoi pas un peu plus de lilypond avec des options pour changer lt lilypond fragment quote staffsize 26 verbatim gt a4 bcd lt lilypond gt lt p gt lt body gt lt html gt Chapitre 3 Association musique texte avec 1ilypond book 39 3 6 4 xelatex documentclass article usepackage ifxetex ifxetex pour ce qui est de xetex usepackage xunicode fontspec xltxtra setmainfont Numbers 01dStyle Times New Roman setsansfont Arial else inutile en l absence de pdftex usepackage T1 fontenc usepackage ut f8 inputenc usepackage mathptmx Times usepackagefhelvet Helvetica fi hici les paquetages que pdftex sait interpr ter usepackage ngerman finnish english babel usepackage graphicx begin document title Un petit document avec LilyPond et xelatex maketitle Les commandes habituelles de textbf fontes sont fonctionnelles y compris au fil du texte tant donn qu textsf elles sont prises en charge par LaTeX and XeteX Lorsque vous avez besoin de commandes particuli res du style verb XeTeX pensez les inclure dans un environnement verb ifxetex Vous pourrez ainsi utiliser la ifxetex commande XeTeX else commande XeTeX fi qui elle n est pas reconnue par le LaTeX tradition
9. un unique r pertoire d termin par la valeur de dir Agencement des lieux LilyPond a besoin d un certain nombre de fichiers pour pouvoir tourner correctement Ces fichiers devront donc tous se retrouver dans l environnement prot g distribu s selon la m me arborescence que dans le syst me d origine Ainsi l int gralit de l installation de LilyPond en principe usr share lilypond doit y tre dupliqu e En cas de probl me lancer LilyPond en utilisant strace devrait vous permettre de d terminer quels fichiers manquent l appel Lancement de LilyPond 1 loglevel DEGR Dans un environnement prot g mont avec l option noexec il est im possible de lancer un quelconque programme ext rieur LilyPond ne saurait donc avoir recours un moteur de traitement qui le mettrait dans cette situation Comme nous l avons vu plus haut LilyPond sera lanc avec les privil ges de l administrateur privil ges qu il perdra aussit t ce qui peut n cessiter le recours la commande sudo Il est par ailleurs judicieux de limiter le temps processeur allou LilyPond gr ce ulimit t par exemple ainsi que si votre syst me le per met la taille de la m moire Voir aussi Ex cution de Lily Pond en mode prot g page 11 R gle le niveau de verbosit des messages console a DEGRE Les diff rentes valeurs sont NONE ERROR WARN Aucun verbiage m me pas les messages d erreur
10. Uniquement les messages d erreur pas de message d avertissement ni de progression Messages d avertissement ou d erreur pas d information de progression BASIC_PROGRESS Information de progression basique r ussite et avertissements ou er reurs PROGRESS Toutes les informations de progression avertissements et erreurs INFO par d faut DEBUG Informations de progression avertissements et erreurs ainsi que d autres informations relatives l ex cution Tout ce qui peut tre affich y compris le verbiage utile au d bogage o output FICHIER ou REPERTOIRE D termine le nom par d faut du fichier r sultant FICHIER lorsque l argument REPERTOIRE correspond a un r pertoire d ja existant c est la que les fichiers Chapitre 1 Ex cution de lilypond 5 r sultants seront d pos s Le suffixe ad quat sera ajout par ex pdf pour du pdf dans tous les cas ps G n re du PostScript png G n re une image par page au format PNG ceci sous entend l utilisation de ps La r solution de l image en DPI peut se r gler en ajoutant par exemple dresolution 110 pdf G n re du PDF Ceci sous entend l utilisation de ps v version Affiche le num ro de version V verbose Active le mode verbeux affichage de l int gralit du chemin d acc s de chaque fichier et information des temps de traitement w warranty Affiche les informations de garantie
11. aide de lilypondfile et que les r pertoires mentionn s par les options output dir et lily output dir diff rent V verbose lilypond book sait tre volubile Cette option est quivalente a loglevel DEBUG vy version Affiche le num ro de version Probl mes connus et avertissements lilypond book ne sait pas interpr ter la commande Texinfo Gpagesize Dans le m me ordre d id e des commandes TFX modifiant les marges et longueur de ligne mentionn es apr s le pr ambule seront ignor es Lorsqu une section LilyPond contient plusieurs score seul le premier sera trait Chapitre 3 Association musique texte avec 1ilypond book 37 3 5 Extensions de nom de fichier Vous pouvez affecter votre fichier source n importe quelle extension Nous vous recommandons cependant un certain nombre d extensions selon le format de sortie d sir voir Section 3 4 Utilisation de lilypond book page 33 Une extension hors du commun vous obligera sp cifier le format de sortie alors que 1ilpond book est en mesure de d terminer le format de sortie en fonction de l extension du fichier source extension format r sultant html HTML htmly HTML itely Texinfo latex LTEX lytex LTEX lyxml DocBook tely Texinfo tex LTEX texi Texinfo texinfo Texinfo xml HTML Lorsque le fichier source a la m me extension que celle que lilypond book affectera au fichier r sultant et que vous lancez lilypond book pa
12. dno gs load fonts dinclude eps fonts dpixmap format pngalpha png myfile 1ly Si d aventure vous deviez recopier un certain nombre d extraits d une m me partition vous pouvez recourir a l emporte pi ce la fonction clip systems comme indiqu au chapitre Section Extraction de fragments musicaux dans Manuel de notation 4 5 Inclusion du travail des autres Certains utilisateurs ont pour obtenir des effets particuliers crit des fichiers qu il est toujours possible d int grer LilyPond avec l instruction include Plusieurs sont m me d sormais inclus dans le programme Voir aussi Section Travail sur des fichiers texte dans Manuel de notation 4 5 1 MIDI et articulations Le projet articulate http www nicta com au people chubbp articulate site en anglais s est donn pour objectif d am liorer la sortie MIDI de LilyPond Les notes qui ne sont pas li es sont ainsi raccourcies dans le but a d articuler Ce raccourcissement d pend de l articulation appliqu e a la note un staccato raccourcira la note de moiti un tenuto lui gardera sa dur e enti re Voir Section Am lioration du rendu MIDI dans Manuel de notation Chapitre 5 Suggestions pour la saisie de fichiers LilyPond 51 5 Suggestions pour la saisie de fichiers LilyPond Maintenant vous tes pr t travailler sur de plus gros fichiers Lily Pond des pi ces enti res et plus seulement les petits exemples
13. f f f f f f Variables d environnement 10 Force le crash en pr sence des points d exception de virgule flottante Inf ou NaN infini ou non nombre Supprime lors du nommage des fichiers r sultant la partie correspondant au r pertoire des fichiers sources Force l ajustement des traits PostScript Cette option trouve toute son utilit pour g n rer du PDF partir de PostScript lajustement des traits est en principe automatiquement activ pour les p riph riques bitmap faible r solution Sans cette option les visionneurs de PDF ont tendance ne pas rendre de mani re constante l paisseur des hampes dans les r solutions habituelles des crans Bien que n affectant pas notoirement la qualit d impression cette option accroit notablement la taille des fichiers PDF Utilise avec le moteur SVG les fontes woff Lorsque celles ci sont utilis es correctement nul n est besoin d installer les fontes que les fichiers SVG utiliseront dans l environnement du visionneur N anmoins LilyPond ne dis pose pas de fichier de fonte woff textuelle La pr sence du fichier de fonte woff est un pr requis Enregistre l utilisation de la cellule Scheme plusieurs fois par seconde dans les fichiers FICHIER stacks et FICHIER graph Enregistre la couverture des fichiers Scheme dans FILE cov Passe en mode verbeux ce qui correspond un niveau de journalisation DEBUG lectur
14. i sed s gt C 7 1 mkdir p 1 amp amp cp L 1 2 1 2 sed s t C C C mkdir p 1 amp amp cp L 1 2 1 2 sed gt d done Exemple de script fonctionnel en 32 bit sur Ubuntu 8 04 bin sh les r glages par d faut username lily Chapitre 1 Ex cution de lilypond 12 home home loopdevice dev loop0 jaildir mnt lilyloop le pr fixe sans slash au d but lilyprefix usr local le r pertoire du syst me ot lilypond est install lilydir lilyprefix lilypond userhome home username loopfile userhome loopfile adduser username dd if dev zero of loopfile bs 1k count 200000 mkdir jaildir losetup loopdevice loopfile mkfs t ext3 loopdevice 200000 mount t ext3 loopdevice jaildir mkdir jaildir lilyhome chown username jaildir lilyhome cd jaildir mkdir p bin usr bin usr share usr lib usr share fonts lilyprefix tmp chmod a w tmp cp r L lilydir lilyprefix cp L bin sh bin rm bin cp L usr bin convert usr bin gs usr bin cp L usr share fonts truetype usr share fonts la formule magique de recopie des biblioth ques for i in lilydir usr bin lilypond lilydir usr bin guile bin sh bin rm usr bin gs usr bin convert do ldd i sed s gt C 4 ZN NCL x mkdir p 1 amp amp cp L 1 2 1 2 sed s t C x 0 C x mkdir p 1 amp amp cp L 1 2 1 2 A sed
15. midi21y convertit les pistes en contextes de port e Section Staff dans R f rence des pro pri t s internes et les canaux en contextes de voix Section Voice dans R f rence des pro pri t s internes Les hauteurs sont rendues en mode relatif et les dur es sp cifi es lorsque n cessaire Vous pouvez enregistrer un fichier MIDI gr ce un clavier lectronique et ensuite le con vertir en fichier 1y N anmoins le rythme humain n a pas une pr cision suffisante pour qu une conversion MIDI ly ne se fasse sans surprise En le couplant une quantisation options s et d midi21y tente de compenser dans la mesure du possible ces probl mes de temporisation C est la raison pour laquelle le recours midi21y n est pas recommand pour des fichiers midi g n r s manuellement Pour le lancer en ligne de commande proc dez ainsi midi2ly option fichier midi Notez bien que par ligne de commande nous parlons de la ligne de commande du syst me Pour plus de pr cisions reportez vous Section 4 3 Conversion partir d autres formats page 45 midi21y accepte les options suivantes a absolute pitches Rendu en hauteurs absolues d duration quant DUR Quantiser les dur es partir de DUR e explicit durations Rendu explicite des dur es h help Afficher un r sum des utilisations k key acc minor D terminer la tonalit par d faut acc gt 0 fixe l
16. nous vous pr sentons les deux m thodes Chapitre 3 Association musique texte avec 1ilypond book 35 f format format format Sp cifie le type de document traiter html latex texi valeur par d faut ou docbook Lorsque cette option n est pas mentionn e lilypond book tente de d terminer automatiquement le format voir Section 3 5 Extensions de nom de fichier page 37 A Vheure actuelle texi est quivalant texi html F filtre filter filtre Passe les extrait au travers de filtre avant de traiter le fichier Cette option permet de par exemple appliquer les mises jour de LilyPond aux extraits avant de traiter le fichier lilypond book filter convert ly from 2 0 0 mon book tely h help Affiche un bref r sum des options I dir include r pertoire Ajoute r pertoire au chemin des inclusions Si des extraits ont d j t compil s dans Pun des r pertoires inclus lilypond book ne les r crira pas dans le r pertoire de sortie il sera donc n cessaire dans la suite du traitement par makeinfo ou latex de penser utiliser cette m me option I r pertoire l loglevel loglevel loglevel D termine le degr de verbosit a loglevel Les diff rentes valeurs admises sont NONE ERROR WARNING PROGRESS par d faut et DEBUG Lorsque cette option n est pas activ e c est le niveau d termin par la variable d environnement LILYPOND_BOOK_LOGLEVEL qui sera utilis o
17. particularly header must come after the music Chapitre 3 Association musique texte avec 1ilypond book 22 3 Association musique texte avec 1ilypond book Vous pouvez inclure des partitions dans un document tout comme vous feriez pour n importe quelle image Ces images sont g n r es s par ment que ce soit sous forme de description PostScript ou au format PNG puis incluses dans votre document ATEX ou HTML lilypond book permet d automatiser ces op rations le programme extrait de votre docu ment les fragments de musique les traite gr ce lilypond puis en restitue la partition dans votre document Largeur de ligne et taille de la fonte sont adapt es pour correspondre a la mise en forme de votre document lilypond book est un script ind pendant de lilypond et se lance en ligne de commande pour plus de pr cisions consultez Section 1 2 Utilisation en ligne de commande page 1 Si vous utilisez MacOS ou Windows et rencontrez quelque difficult avec lilypond book r f rez vous Section MacOS X dans Informations g n rales ou Section Windows dans Informations g n rales lilypond book s applique aux documents ATEX HTML Texinfo et DocBook 3 1 Exemple de document musicologique Un certain nombre d ouvrages peuvent tre illustr s par des extraits musicaux qu il s agisse d un trait de musicologie d un carnet de chant ou d un manuel l exemple de celui que vous consulte
18. riv du module GUILE safe r5rs ajoute un certain nombre de fonctions list es dans scm safe lily scm l API de LilyPond De plus le mode safe ne permet ni l utilisation de directives include ni le recours aux obliques invers es backslash dans les cha nes TEX L import de variables LilyPond dans du code Scheme n est pas possible en mode s curis L option dsafe ne d tecte pas l utilisation abusive des ressources Il est donc possible que le programme finisse par rester sans r ponse si on lui envoie une boucle sans fin C est la raison pour laquelle nous recommandons lorsque LilyPond tourne sur un serveur accessible au public d en limiter aussi bien les ressources processeur que m moire Notez bien que l utilisation du mode s curitaire emp chera aussi la compilation d un certain nombre de fragments LilyPond L option jail est dans ce cas une excellente alternative en terme de s curit m me si elle requiert plus de temps mettre en place voir Options basiques de lilypond page 2 separate log files f Pour les fichiers FICHIER1 1y FICHIER2 1y etc enregistre le d roulement dans les journaux FICHIER1 1log FICHIER2 log show available fonts f Liste le nom des fontes disponibles Chapitre 1 Ex cution de lilypond strict infinity checking strip output dir strokeadjust svg woff trace memory frequency trace scheme coverage verbose warning as error L t
19. tex texi et xml n cessitent un traitement compl mentaire Instructions sp cifiques certains formats Chapitre 3 Association musique texte avec 1ilypond book 34 ETEX Un document LATEX destin l impression ou la publication peut se traiter de deux mani res diff rentes g n rer directement un PDF l aide de PDFIATRX ou bien g n rer un fichier avec ATEX qui sera ensuite pass un traducteur DVI PostScript comme dvips La premi re fa on est de loin la plus simple et c est celle que nous vous recommandons quelque soit votre pr f rence sachez que vous pouvez aller du PostScript au PDF avec des outils tels que ps2pdf et pdf2ps tous deux inclus dans la distribution de Ghostscript La production d un PDF avec PDFITRX se fait en lan ant les commandes lilypond book pdf monfichier lytex pdflatex monfichier tex La s quence ATEX dvips ps2pdf suivante permet de produire un PDF lilypond book monfichier lytex latex monfichier tex dvips Ppdf monfichier dvi ps2pdf monfichier ps Le fichier dvi g n r lors de ce traitement ne contient aucune t te de note ce qui est tout a fait normal elles seront incluses lors de la g n ration du ps puis dans le pdf La commande dvips peut d clencher certains messages concernant des fontes que vous pou vez ignorer sans scrupule Si vous utilisez latex en mode colonnage n oubliez pas d ajouter t landscape aux options de dvips Les environnement
20. use modules guile user en t te de votre fichier 1y Note Les utilisateurs de Windows doivent utiliser des guillemets doubles en lieu et place des guillemets simples format format D termine le format produire Il peut s agir de ps pdf ou png Exemple lilypond fpng monfichier ly help Affiche un r sum des commandes header CHAMP Recopie le champ d ent te dans le fichier RACINE CHAMP init fichier D finit fichier par d faut init 1ly en tant que fichier d initialisation include r pertoire Ajoute r pertoire au chemin de recherche pour les inclusions Vous pouvez mentionner plusieurs fois l option I auquel cas la recherche com mencera dans le premier r pertoire inclus et si le fichier en question ne s y trouve pas les r pertoires suivants seront examin s l un apr s l autre jail user group jail dir Lance lilypond dans un environnement prot g L option jail est une alternative qui offre plus de flexibilit que option safe lorsque LilyPond est install sur un serveur web ou traite des fichiers externes voir Options avanc es de lilypond page 5 L option jail va d tourner la racine de 1ilypond sur jail juste avant d effectuer la compilation proprement parler L utilisateur et le groupe sont modifi s en cons quence et le r pertoire en cours devient dir Ces r glages assurent du moins en th orie l impossibilit de s chap
21. votre load path en ajoutant la ligne suivante modifi e en cons quence votre emacs setq load path append list expand file name site lisp load path Mode Vim En ce qui concerne Vim http www vim org LilyPond fournit tout le n cessaire pour g rer la coloration syntaxique et l indentation Le mode sp cifique Vim doit tre indiqu dans le fichier HOME vimrc Localisez ce fichier ou cr ez le et ajoutez y les trois lignes suivantes filetype off set runtimepath usr local share lilypond current vim filetype on syntax on Si LilyPond est install dans un autre r pertoire que usr local modifiez ce chemin en cons quence Pour de plus amples d tails consultez Section Autres sources de documentation dans Manuel d initiation Autres diteurs LilyPond est pris en charge par d autres diteurs aussi bien en mode texte qu avec une interface graphique Dans la mesure o leurs fichiers de configuration ne sont pas fournis avec LilyPond nous vous invitons consulter leur documentation pour plus d information Certains de ces diteurs sont mentionn s la page Section Facilit s d dition dans Informations g n rales 4 3 Conversion partir d autres formats La musique peut aussi tre r cup r e par importation d un autre format Ce chapitre passe en revue les diff rents outils pr vus cet effet et inclus dans la distribution Il existe d autres outils qui
22. P paper size ligne de commande 8 PDF Portable Document Format output 5 PNG Portable Network Graphics output 5 Annexe B Index de LilyPond lee ET RER 42 point and click ligne de commande 5 pointer cliquer 42 pointer cliquer ligne de commande 5 Portable Document Format PDF output 5 Portable Network Graphics PNG output 5 PostScript output 5 pr visualisation d image 30 preview ligne de commande 8 programmes externes g n rant des fichiers LilyPond EE 49 Programming error 13 PS PostScript output 5 R r pertoire de destination 4 recherche de fichier 0 00 c ce eee eee eee ees 3 recopie d extraits 50 redirection EE 4 S Scheme Grir d Mere nde ee ne Malta re 13 Scheme valuation d expression 2 sortie format 2525 SEET REN diem 3 SWILENES neo ia eg eatin ele Va i s wie tials nan add 2 syntaxe coloration 45 69 T taille du ficher de sortie 43 COXA EN EU ETS ere EET 22 EE 22 Texinfo musique et 22 thumbnails arte eden etoile 30 titrage et HTML 3
23. alin eae E 38 SC BE elt ee Lt eA E et A ete MR de hs AE A Co ak AEN 39 3 7 Gestion de la table des mati res 40 3 8 Autres m thodes d association texte musique 41 4 Programmes externes 42 ArT Porinter CHduers eg dite et A MASA El Ee RS mt ee EA 42 4 1 1 Configuration du sest me cece eee eee e nee eee 42 Utilisation avec X pdt NEES EEN add dites rh eds 42 Utilisation avec GNOME 2 242 43 Utilisation avec GNOME 3 43 Configuration sp cifique Evince 22 43 Activation du pointer cliquer 43 Pointer cliquer s lectif sissssassesgma dans ea eaa anne tien 44 42 LilyPond et les diteurs de texte 45 Mode Emag esite onen Mann ten tte alt ni anne dti alle 45 Mode Vire E eet nee ea ek See ne een ed NEE tee 45 Autres diteurs evene wide Sudha hie eh ier ais moe ie we dead ee 45 4 3 Conversion partir d autres formats 45 4 3 1 Utilisation de midi21y 46 4 3 2 Utilisation de musicxml21y 47 4 3 3 Utilisation de aber e e a E aE hac
24. applicables GNU LilyPond il est livr SANS GARANTIE Options avanc es de lilypond d nom option valeur define default nom option valeur Affecte la valeur Scheme valeur l option interne nom option du programme dbackend svg En l absence de valeur le programme utilisera t Pr fixer nom option d un no vous permet de d sactiver une option Ainsi dno point and click revient au m me que dpoint and click f Voici les diff rentes options disponibles ainsi que leur valeur par d faut Symbole Valeur Observations anti alias factor 1 Adopte une r solution sup rieure selon le fac teur donn puis r duit au niveau du r sultat afin d viter les a distorsions des images PNG aux files t G n re les fichiers tex texi et count pour le moteur de rendu EPS backend ps D termine le format de sortie utiliser par le moteur de traitement Les fichiers PostScript format par d faut incluent les fontes TTF Typei et OTF et aucune substitution ne sera op r e pour ces fontes Si vous utilisez des jeux de caract res orientaux le fichier aura vite fait d atteindre une taille cons quente Chapitre 1 Ex cution de lilypond 6 eps G n re du PostScript encapsul Chaque page syst me fera l objet d un fichier EPS par ticulier sans fontes auquel sera associ un fichier EPS qui lui contiendra toutes les pages syst mes et les fontes Notez qu il s agit du mode que
25. arr te imm diatement le traitement du fichier source en cours l insertion du expandafter permet de repousser ce endinput apr s le fi la clause if fi sera alors respect e Gardez l esprit que betweenLilyPondSystem est effectif tant que TEX n est pas sorti du groupe en cours tel que l environnement TEX ou cras par une nouvelle d finition pour la suite du document la plupart du temps Pour r initialiser cette d finition ins rez let betweenLilyPondSystem undefined dans votre document DES La cr ation d une macro TEX permet de se simplifier la vie def onlyFirstNSystems 1 def betweenLilyPondSystem 1 ifnum 1 lt 1 else expandafter endinput fi Il suffit alors avant chacun des fragments inclure de sp cifier le nombre de syst mes requis onlyFirstNSystems 3 begin lilypond end lilypond Chapitre 3 Association musique texte avec 1ilypond book 28 onlyFirstNSystems 1 begin lilypond end lilypond Voir aussi lilypond book dispose d options en ligne de commande particuli res Elles sont consultables ainsi que d autres d tails sp cifiques au traitement de documents WIES au chapitre Section 3 4 Utilisation de lilypond book page 33 3 2 2 Texinfo Texinfo est le format standard pour toute la documentation du projet GNU titre d exemple toute la documentation de LilyPond qu il s agisse des versions HTML PDF ou info est g n r e partir de docum
26. avez pas encore parcouru lisez le Section Tutoriel dans Manuel d initiation Si vous utilisez un diteur alternatif pour r diger vos fichiers LilyPond r f rez vous la documentation de celui ci 1 2 Utilisation en ligne de commande Nous nous int resserons ici aux sp cificit s de LilyPond employ en ligne de commande La ligne de commande permet de faire appel certaines options particuli res D autre part certains utilitaires associ s tel que midi21y ne sont disponibles qu en ligne de commande Par ligne de commande nous entendons l interface de commande du syst me Les util isateurs de Windows seront certainement plus familiers des termes fen tre DOS ou invite de commande Quant aux utilisateurs de MacOS X ils connaissent assur ment les termes console et a terminal Les param trages sp cifiques au syst me MacOS font l objet d un Section chapitre particulier dans Informations g n rales Notre propos n est pas ici d expliquer ce qu est l interface de commande pour un syst me informatique ni comment elle fonctionne Aussi si vous ne savez de quoi il retourne nous vous renvoyons aux nombreuses documentations que vous pourrez trouver sur ce sujet Lancement de LilyPond L ex cutable lilypond en ligne de commande se lance ainsi lilypond option fichier Lorsque le fichier est fourni sans extension LilyPond pr sume qu il s agit de Le Pour in terp
27. balise externe qu il s agisse d un mediaobject ou d un inlinemediaobject comporte un bloc textobject qui contiendra le programlisting G n ration du document DocBook lilypond book g n re partir d un fichier lyxml un document DocBook tout fait valide extension xml que vous pourrez ensuite traiter avec votre application habituelle Dans le Chapitre 3 Association musique texte avec 1ilypond book 31 cas de dblatex http dblatex sourceforge net vous obtiendrez alors automatiquement un fichier PDF Les feuilles de style XSL DocBook officielles permettent de g n rer du HTML HTML Help JavaHelp etc vous pourriez n anmoins devoir y apporter quelques adaptations 3 3 Options applicables aux fragments de musique Dans les lignes qui suivent l appellation commande LilyPond fait r f rence toutes celles vues plus haut et qui font appel lilypond book pour produire un extrait musical Pour plus de simplicit nous ne parlerons que de la syntaxe applicable lt Nous attirons votre attention sur le fait que les diff rentes options sont lues de la gauche vers la droite Si une option est transmise plusieurs fois seule la derni re sera prise en compte Les commandes LilyPond acceptent les options suivantes staffsize hauteur D finit la taille de port e hauteur exprim e en points ragged right Produit des lignes en pleine largeur avec un espacement naturel En d autres ter
28. d fier ebe doe Re Eder 49 VAT EE 43 expression Scheme valuation 2 extraits EE 50 68 F fatal error stri israel se 13 ficher de sortie taille 43 fichier de destination 4 RER 49 format de sortie 3 format de sortie d finition 8 fragments musicaux 50 H SR NO DEET EEER 22 HTML musique et 22 L lancement de lilypond 2 LANG en nn net ete need EN dE 10 Ta Tex stees eg Se Se mnt Gef gra 22 LaTeX musique et 22 le projet Articulate 50 LibreOffice orgs eieren yian ui pea EEN AE 49 ligne de commande options pour lilypond 2 LILYPOND_DATADIR 10 loglevel 2 A 0342008 ENEE ANEREN ENN dE 4 EE 49 Juste strains een AE EEN A aes 49 M Make EE 54 makehilesii c sessions EN RS 54 Manuels ne ed ee ee 1 MATS Toe ei eh sisted tind Se En Iv ee BAG any aa 46 50 mise jour d anciens fichiers 17 mise jour de fichiers LilyPond 17 modes diteur 45 musicologie Ate 2280 A RENE ES 22 Music X ME eet nbs M dits ne 47 OOoLilyPond 22 sages Re er hee sae 49 OpenO Mice orgie seen santa nee wee ns 49 options ligne de commande 2
29. dir output r pertoire Regroupe les fichiers g n r s dans r pertoire 1ilypond book cr e un certain nom bre de fichiers usage de LilyPond Afin d viter de polluer votre r pertoire source nous vous conseillons d utiliser option output puis de vous rendre dans ce r pertoire pour y lancer les commandes latex ou makeinfo lilypond book output out monfichier lytex cd out skip lily check D sactive la mise en chec en l absence de sortie de lilypond Option utilis e pour la documentation au format Info sans images skip png check D sactive la mise en chec en l absence d images PNG correspondant aux fichiers EPS Option utilis e pour la documentation au format Info sans images lily output dir r p Ecrit les fichiers lily XXX dans r p et cr e un lien vers le r pertoire sp cifi par output Cette option permet d conomiser du temps lors de la g n ration de documents qui se trouvent dans diff rents r pertoires et partagent un certain nombre d extraits identiques Chapitre 3 Association musique texte avec 1ilypond book 36 lily loglevel loglevel D termine le degr de verbosit lors des appels lilypond Les valeurs autoris e de loglevel sont NONE ERROR WARNING BASIC_PROGRESS PROGRESS INFO par d faut et DEBUG Lorsque cette option n est pas activ e c est le niveau d termin par la variable d environnement LILYPOND_LOGLEVEL qui sera utilis info images d
30. document les macros suivantes seront appel es avant chaque extrait musical e preLilyPondExample avant la musique e postLilyPondExample apr s la musique e betweenLilyPondSystem 1 entre les syst mes si tant est que lilypond book a d coup la partition en plusieurs fichiers PostScript Elle requiert un param tre et re oit le nombre de fichiers inclus dans l extrait Par d faut elle ins re simplement un linebreak Morceaux choisis Lorsque pour les besoins de la d monstration certains l ments musicaux tels que des liaisons de phras ou de prolongation continuent apr s le fragment qui vous int resse il suffit d ins rer un saut de ligne et de limiter le nombre de syst mes inclure En ce qui concerne ATEX vous devrez d finir betweenLilyPondSystem de telle sorte que l inclusion cesse d s que le nombre de syst mes requis est atteint Dans la mesure o betweenLilyPondSystem n est appel qu apr s le premier syst me inclure un seul syst me est un jeu d enfant def betweenLilyPondSystem 1 endinput begin lilypond fragment c 1 C e ci break ci d e f end lilypond Pour un plus grand nombre de syst mes il suffit d ins rer un test conditionnel TFX avant le endinput A partir de exemple qui suit remplacez le 2 par le nombre de syst mes dont vous aurez besoin def betweenLilyPondSystem 1 ifnum 1 lt 2 else expandafter endinput fi tant donn que endinput
31. du tutoriel Mais comment devriez vous vous y prendre Tant que LilyPond parvient comprendre vos fichiers et produit le r sultat que vous souhaitez peu importe la mani re dont le code est organis N anmoins quelques crit res doivent tre pris en compte lorsque l on crit un fichier LilyPond Si vous faites une erreur la structure m me du fichier Lily Pond peut permettre de la localiser plus ou moins facilement Et si vous souhaitez partager vos fichiers avec quelqu un d autre ou si vous souhaitez modifier vos propres fichiers dans quelques ann es Si certains fichiers LilyPond sont compr hensibles au premier coup d il d autres vous feront vous arracher les cheveux pen dant une heure Et si vous souhaitez mettre jour votre fichier pour l utiliser avec une version plus r cente de LilyPond La syntaxe du langage d entr e change parfois lorsque LilyPond s am liore La plupart des changements peuvent tre appliqu s automatiquement avec convert ly mais quelques uns peuvent requ rir une intervention manuelle Vos fichiers LilyPond peuvent tre structur s de mani re faciliter leur mise jour 5 1 Suggestions g n rales Voici quelques conseils qui vous permettront d viter voire m me r soudre la plupart des probl mes de saisie Ajoutez toujours le num ro de version dans chaque fichier quelle que soit sa taille Par exp rience il est tr s difficile de se rappeler quelle version de LilyPond
32. extrait devra apparaitre dans une construction de type book book header title LilyPond fait ses gammes relative c defgabc Chapitre 3 Association musique texte avec 1ilypond book LilyPond fait ses gammes Music engraving by LilyPond 2 19 31 www lilypond org 25 Chapitre 3 Association musique texte avec 1ilypond book 26 3 2 Association musique texte Nous allons nous int resser dans les lignes qui suivent la mani re d int grer LilyPond selon diff rents types de format 3 2 1 BIFX LTEX peut tre consid r comme le standard de publication dans le domaine des sciences exactes Il repose sur le moteur typographique TEX le nec plus ultra en la mati re Consultez The Not So Short Introduction to ATEX en fran ais http www ctan org tex archive info lshort french pour un aper u des possibilit s de LATEX Afin d ins rer de la musique dans vos fichiers TEX 1ilypond book dispose des environ nements et commandes suivantes e la commande lilypond qui permet de directement saisir du code LilyPond simple e l environnement begin lilypond end lilypond qui permet de saisir directement du code LilyPond plus labor e la commande lilypondfile qui permet d ins rer un fichier LilyPond e la commande musicxmlfile qui permet d ins rer un fichier MusicX ML qui sera alors trait par musicxml21y puis lilypond Il suffit pour inclur
33. int gralit de ce chemin devra tre born par des guillemets informatiques forfiles s p C Documents Mes Partitions M ly c cmd Ze lilypond file Options basiques de lilypond Diff rentes options sont disponibles en ligne de commande b bigpdfs Les fichiers PDF g n r s peuvent tre beaucoup plus lourd que la normale selon le degr d optimisation des fontes N anmoins lorsque plusieurs fichiers PDF sont inclus dans un document pdftex xetex ou luatex ils peuvent faire l objet d un traitement suppl mentaire par ghostscript afin de fusionner les donn es de fontes redondantes et ainsi obtenir un fichier PDF significativement plus l ger lilypond b monfichier Puis lancer ghostscript gs q sDEVICE pdfwrite o gsout pdf monfichier pdf pdfsizeopt py vient alors en compl ment pour optimiser encore la taille du fichier pdfsizeopt py use multivalent no gsout pdf final pdf d define default variable valeur Voir Options avanc es de lilypond page 5 Chapitre 1 Ex cution de lilypond 3 e evaluate expr Evalue expression Scheme expr avant d analyser tout fichier ly Lorsque vous sp cifiez l option e plusieurs reprises l valuation sera faite en s quence Dans la mesure o l expression est valu e par le module guile user vous devrez d s lors que expr utilise des d finitions sp cifier lilypond e define public a 42 en ligne de commande et ajouter la ligne
34. is in electronic form Otherwise they must appear on printed covers that bracket the whole aggregate 8 TRANSLATION Translation is considered a kind of modification so you may distribute translations of the Document under the terms of section 4 Replacing Invariant Sections with translations requires special permission from their copyright holders but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections You may include a translation of this License and all the license notices in the Document and any Warranty Disclaimers provided that you also include the original English version of this License and the original versions of those notices and disclaimers In case of a disagreement between the translation and the original version of this License or a notice or disclaimer the original version will prevail If a section in the Document is Entitled Acknowledgements Dedications or History the requirement section 4 to Preserve its Title section 1 will typically require changing the actual title 9 TERMINATION You may not copy modify sublicense or distribute the Document except as expressly provided under this License Any attempt otherwise to copy modify sublicense or distribute it is void and will automatically terminate your rights under this License However if you cease all violation of this License then your license from a particul
35. la cr ation implicite d un contexte peut aboutir l apparition d une port e a parasite On s attend par exemple en lisant le code qui suit ce que toutes les t tes de note soient en rouge alors que le r sultat nous pr sente deux port es et que les notes plac es sur la port e inf rieure restent en noir override Staff NoteHead color red new Staff a Etant donn qu aucun contexte Staff n existe lorsque la d rogation est introduite LilyPond le cr e implicitement pour lui appliquer la directive consid r e Survient alors la commande new Staff qui a son tour cr e une nouvelle port e pour contenir les notes qui suivent Voici la syntaxe correcte pour obtenir ces notes en rouge new Staff override Staff NoteHead color red Chapitre 1 Ex cution de lilypond 15 Message d erreur Unbound variable Ce message d erreur qu il apparaisse sur le terminal ou en fin de fichier journal est associ un message du type GUILE a signal une erreur Il survient chaque fois qu un commentaire LilyPond est ind ment plac dans une routine Scheme Un commentaire LilyPond est introduit par le signe pourcent et ne doit en aucun cas se trouver dans une routine Scheme En Scheme les commentaires s introduisent par un point virgule Message d erreur FT_Get_Glyph_Name Ce message d erreur qu il apparaisse sur le terminal ou en fin de fichier journal survient lors
36. list If you have Invariant Sections without Cover Texts or some other combination of the three merge those two alternatives to suit the situation If your document contains nontrivial examples of program code we recommend releasing these examples in parallel under your choice of free software license such as the GNU General Public License to permit their use in free software Annexe B Index de LilyPond Annexe B Index de LilyPond ELE UE RAR RNA cu tate toe Saver ton 45 header et document IATEX 27 A ABC wits Meek Saint teen aad tak 48 Aborted core dumped 13 AVELLISSEMENE 1 reg dee gei oat nt EE ee eek 13 Cal trates ics ieee A Ladd hinds Led dees 13 chemin de recherche 3 chroot jail fonctionnement 3 Coda Technology rers xd EELER onde 49 coloration syntaxique 45 commutateurs Sarid beeen Pid cna sleep ees 2 ee E cite at oe ends gel marient Sass 17 D AOCDOOK a Seet genug deeg dE 22 DocBook musique et 22 documents ajout de musique 22 AVIDS 5x2 Lendemain ares d chet Seanad Uy 34 e TEE 45 E E 49 Enigma Transport Format 49 Erreur de programmation 13 erreur MeESSageS is 48e users 12 EG chy leila etre de SE de EE 13 errors message format 13 RTR
37. on consid re simplement qu elle se prolonge sur la mesure suivante Des d bordements r p tition finissent par g n rer une musique comprim e ou qui sort de la page pour la simple et bonne raison que les sauts de ligne automatiques ne peuvent intervenir qu la fin d une mesure compl te autrement dit lorsque toutes les notes sont termin es avant la fin de la mesure Note Une dur e erron e peut emp cher les sauts de ligne ce qui conduit une musique compress e voire un d bordement de la page Une erreur de dur e sera bien plus facilement localisable si vous positionnez r guli rement des contr les de barre de mesure voir Section V rification des limites et num ros de mesure dans Manuel de notation Si vous tenez absolument encha ner de tels d bordements vous devrez ins rer des barres de mesure invisibles l o vous souhaitez positionner un saut de ligne Consultez le chapitre Section Barres de mesure dans Manuel de notation pour plus de d tails Apparition d une port e suppl mentaire Lorsque les contextes ne sont pas cr s explicitement par la commande new ils le seront si la commande ex cuter n est pas cens e s appliquer au contexte en cours Pour des partitions simples le fait que les contextes soient automatiquement cr s rend bien des services et c est d ailleurs le cas pour la majorit des exemples contenus dans les manuels de LilyPond Cepen dant
38. rieur de la d finition du violon fpuisp _ markup dynamic f italic small 2nd hspace 0 1 dynamic p violon relative g 4 fpuisp c 8 e16 5 4 R solution de probl mes T t ou tard vous crirez un fichier que LilyPond ne peut pas compiler Les messages que LilyPond affiche peuvent vous aider trouver l erreur mais dans beaucoup de cas vous aurez besoin de faire quelques recherches pour d terminer la source du probl me Pour ce faire les outils les plus puissants sont le commentaire de fin de ligne indiqu par 1 et le commentaire multilignes ou bloc de commentaire indiqu par Si vous ne pouvez localiser le probl me commencez par mettre en commentaire de grandes parties de votre fichier source Apr s avoir mis en commentaire une section essayez de compiler nouveau Si cela fonctionne c est que le probl me se situe dans cette partie du fichier Si cela ne fonctionne pas continuez mettre en commentaire d autres sections jusqu ce que vous ayez quelque chose qui compile Dans un cas extr me vous pourriez en arriver score lt lt Chapitre 5 Suggestions pour la saisie de fichiers LilyPond 54 melodie harmonie basse gt gt layout c est dire un fichier sans aucune musique Si cela se produit ne vous d couragez pas D commentez un peu la partie de basse par exemple et voyez si a fonctionne Si ce n est pas le cas placez en commentai
39. 0 titrage et lilypond book 27 trace Scheme 13 typel Poles ssi dan es Padoue Les ee 34 U utilisation de dvips 34 V verbosit d finir le degr de 4 Viene Aegae E UN UT Sien En 45 WALES Ad de A erg oh aes e 13
40. 5 Message d erreur unexpected new 15 Cette voix requiert un voiceXx ou un r glage shiftXx 16 2 Mise jour avec convert ly 17 2 1 LilyPond est une langue vivante 22 17 2 2 LPx cution d Convert Lynn Me SE nina Oe tee eee 17 2 3 Options en ligne de commande pour convert 1ly 18 2 4 Probl mes d ex cution de convert ly 19 2 5 Conversions manuelles 8 urgentes SEENEN mines dd 20 3 Association musique texte avec lilypond book 22 3 1 Exemple de document musicologique 22 3 2 Association musique texte 26 CH D E E E ER 26 See a nn ee a T Lena a antes EE 28 3 2 3 APM Lies ii saci se ee van a eee ene eee ca a OE AE 29 32204 DocBook inerat ea dr anus ea ee a See oe a eee 30 3 3 Options applicables aux fragments de musique 31 3 4 Utilisation de lilypond book 33 3 5 Extensions de nom de Dchier 00 cece eee arreo e ene eenes 37 3 6 Mod les pour Dlvpond book erennere rrrern 37 RE EE 37 30 2 D Ee eege er Re nr ote tat Mets oat dade te teats 38 310 8 html gee eet Riet Rabe enced ease edna en Seu De rene
41. Document An MMC is eligible for relicensing if it is licensed under this License and if all works that were first published under this License somewhere other than this MMC and subsequently incorporated in whole or in part into the MMC 1 had no cover texts or invariant sections and 2 were thus incorporated prior to November 1 2008 The operator of an MMC Site may republish an MMC contained in the site under CC BY SA on the same site at any time before August 1 2009 provided the MMC is eligible for relicensing Annexe A GNU Free Documentation License 67 ADDENDUM How to use this License for your documents To use this License in a document you have written include a copy of the License in the document and put the following copyright and license notices just after the title page Copyright C year your name Permission is granted to copy distribute and or modify this document under the terms of the GNU Free Documentation License Version 1 3 or any later version published by the Free Software Foundation with no Invariant Sections no Front Cover Texts and no Back Cover Texts A copy of the license is included in the section entitled GNU Free Documentation License If you have Invariant Sections Front Cover Texts and Back Cover Texts replace the with Texts line with this with the Invariant Sections being list their titles with the Front Cover Texts being list and with the Back Cover Texts being
42. EEA a aE dN 48 dt Utilisation de ett te Cer spider SR de ee Aes La ie gee St 49 4 3 5 Autres formats ist donnee Me ere ENN a ele en eee Syed de 49 4 4 Inclusion de partition LilyPond dans d autres programmes 49 AA NAM OK sie os Ba Rae ee nt Le SS a nt Enter ee SU RER Si attttags 49 OpenOffice et Lubre fice 49 AULTES ROESER ri Tenores ENEE ical ade en ne ten oe fee A EES 49 4 5 Inclusion du travail des autres 50 St MIDI et artieulations ss 2e r EE deen Meade mean hauls Rd 50 5 Suggestions pour la saisie de fichiers LilyPond 51 5 1 Suggestions g n rales 22 51 5 2 Gravure de musique existante 52 5 3 Projets d envergure issues ENEE EEN Seta Mae be nent 53 5 4 R solution de probl mes 0 cece cence een e ene e nee eenees 53 5 5 De la commande make et des fichiers Makefile 54 Annexe GNU Free Documentation License 61 Annexe B Index de LilyPond 68 Chapitre 1 Ex cution de lilypond 1 1 Ex cution de lilypond Ce chapitre passe en revue ce qui se passe lorsque vous lancez LilyPond 1 1 Utilisation habituelle La plupart des utilisateurs de Lily Pond le font au travers d une interface graphique GUI pour graphical user interface Si vous ne l
43. Lily Pond Le syst me de gravure musicale Utilisation des programmes L quipe de d veloppement de LilyPond Ce document constitue le manuel d utilisation des programmes de GNU LilyPond 2 19 31 De plus ce manuel sugg re des a bonnes pratiques pour une utilisation plus efficace Pour conna tre la place qu occupe ce manuel dans la documentation consultez la page Section Manuels dans Informations g n rales Si vous ne disposez pas de certains manuels la documentation compl te se trouve sur http www lilypond org Copyright 1999 2015 par les auteurs The translation of the following copyright notice is provided for courtesy to non English speakers but only the notice in English legally counts La traduction de la notice de droits d auteur ci dessous vise faciliter sa compr hension par le lecteur non anglophone mais seule la notice en anglais a valeur l gale Vous avez le droit de copier distribuer et ou modifier ce document selon les ter mes de la Licence GNU de documentation libre version 1 1 ou tout autre version ult rieure publi e par la Free Software Foundation sans aucune section invariante Une copie de la licence est fournie a la section Licence GNU de documentation li bre Permission is granted to copy distribute and or modify this document under the terms of the GNU Free Documentation License Version 1 1 or any later version published by the Free Software Founda
44. SCII Sa description est disponible sur le site 7 ABC http www walshaw plus com abc learn html abc21y traduit du format ABC au format LilyPond Pour le lancer en ligne de commande proc dez ainsi abc2ly option fichier abc abc21y accepte les options suivantes b beams None Pr server la notion de lien de croches propre ABC h help Afficher un r sum des utilisations o output file G n rer le r sultat dans le fichier file s strict Etre strict sur la r ussite version Afficher le num ro de version Il est possible d ajouter des bribes de code LilyPond dans un fichier source ABC Ainsi Vassertion AALY voices set autoBeaming f aura pour cons quence d ins rer le texte qui suit le mot cl voices dans la voix correspon dante du fichier LilyPond De la m me mani re AKLY slyrics more words placera le texte suivant le mot cl a slyrics dans une ligne de paroles Probl mes connus et avertissements Le standard ABC n est pas si a standard que cela Pour des fonctionnalit s tendues comme la polyphonie existent diff rentes conventions Un fichier comportant plusieurs morceaux ne peut tre converti ABC synchronise paroles et musique en d but de ligne abc21y ne le fait pas abc21y ignore les ligatures ABC Chapitre 4 Programmes externes 49 4 3 4 Utilisation de etf2ly Note Ce programme ne b n ficie d aucune maintenance Il est susce
45. YDOC_LOCALEDIR qui pointera vers un r pertoire contenant l arborescence des catalogues de messages fichiers d extension mo du domaine lilypond doc addversion Cette option effective uniquement avec Texinfo permet d ajouter une ligne version Cw version au verbatim Chapitre 3 Association musique texte avec 1ilypond book 33 texidoc Option disponible uniquement avec Texinfo D s lors qu un fichier toto 1ly contient dans sa section header un champ texidoc Vappel de lilypond avec l option header texidoc cr era le fichier toto texidoc Par ailleurs c est le contenu de ce toto texidoc qui sera ensuite recopi par lilypond book en pr ambule de l extrait de partition soit avant l environnement example cr par un quote Prenons par exemple le fichier toto 1ly dont le contenu est header texidoc This file demonstrates a single note c 4 et quelque part dans notre document Texinfo test texinfo lilypondfile texidoc toto ly La ligne de commande suivante produira le r sultat escompt lilypond book pdf process lilypond dbackend eps header texidoc test texinfo La plupart des fichiers de test contenus dans le r pertoire input de la distribution est constitu e de la sorte Cette option est fort utile dans le cadre de l adaptation en langue trang re En effet s il est sp cifi dans le document Texinfo une clause documentlanguage LANGUE la pr sence d une variable
46. a mention de version est port la valeur de la r gle appliqu e la plus r cente Chapitre 2 Mise jour avec convert ly 19 e edit pour diter directement le fichier d origine Le fichier originel est renomm en que monfichier 1ly Ce fichier de sauvegarde selon le syst me d exploitation peut tre a cach Vous pouvez aussi affecter un autre nom au fichier mis jour et conserver votre fichier original en l tat convert ly monfichier ly gt monnouveaufichier 1ly et pour les utilisateurs de windows convert ly py monfichier ly gt monnouveaufichier ly b backup numbered combine l option e pour num roter les sauvegardes de telle sorte qu aucune version ant rieure ne soit cras e Les fichiers de sauvegarde selon le syst me d exploitation peuvent tre a cach s H f from from patchlevel pour d finir le num ro de version partir duquel vous voulez effectuer les conver sions Lorsque cette option n est pas activ e convert ly tentera de le d terminer sur la foi de la mention de version contenue dans le fichier Cette option s utilise sous la forme from 2 10 25 h help visualiser l aide et quitter l loglevel loglevel loglevel pour r gler le degr de verbosit loglevel Les diff rentes valeurs sont NONE ERROR WARNING PROGRESS par d faut et DEBUG n no version Normalement convert ly ajoutera une indication de version votre fich
47. a servi au moment de la cr ation d un fichier Ceci s av rera d autant plus utile lors d une Section mise jour dans Utilisation des programmes convert ly requiert la pr sence d une ligne version ou si vous transmettez votre fichier d autres utilisateurs y compris pour demander de l aide sur les listes de diffusion Vous noterez par ailleurs que tous les fichiers mod les de LilyPond ont une mention version Une mesure par ligne de texte Si la musique en elle m me ou le r sultat que vous d sirez contient quelque chose de compliqu il est souvent bon de n crire qu une seule mesure par ligne conomiser de la place en tassant huit mesures par ligne a ne vaut pas vraiment le coup si l on doit corriger vos fichiers Ajoutez des contr les Section d octaviation dans Manuel de notation et Section de limite ou num ro de mesure dans Manuel de notation Si vous avez ajout des contr les de loin en loin et que vous faites une erreur vous pourrez la retrouver plus rapidement De loin en loin qu est ce dire Cela d pend de la complexit de la musique Pour de la musique tr s simple certains endroits strat giques Pour de la musique tr s complexe ou avec une multiplicit de voix peut tre chaque mesure Ajoutez des commentaires Utilisez soit des num ros de mesure assez souvent soit des r f rences au contenu musical a second th me des violons a quatri me v
48. abr g e Chapitre 3 Association musique texte avec 1ilypond book 29 C lilypond fragment staffsize 11 lt c er g gt produit Contrairement Dir lilypond ne va pas int grer d image dans le document mais g n rer un paragraphe 3 2 3 HTML Afin d ins rer de la musique dans vos fichiers HTML 1ilypond book dispose des environnements et commandes suivantes e lacommande lt lilypond gt qui permet de directement saisir du code LilyPond simple e l environnement lt lilyond gt lt lilypond gt qui permet de saisir directement du code Lily Pond plus labor e la commande lt lilypondfile gt lt lilypondfile gt qui permet d ins rer un fichier Lily Pond e la commande lt musicxmlfile gt lt musicxmlfile gt qui permet d ins rer un fichier Mu sicX ML qui sera alors trait par musicxml2ly puis lilypond Il suffit pour inclure de la musique d utiliser l une des instructions suivantes dans votre fichier source lt lilypond liste des options gt VOTRE CODE LILYPOND lt lilypond gt lt lilypond liste des options VOTRE CODE LILYPOND gt lt lilypondfile liste des options gt fichier lt lilypondfile gt lt musicxmlfile liste des options gt fichier lt musicxmlfile gt Il suffit pour inclure de la musique d utiliser lt lilypond fragment relative 2 gt key c minor c4 es g2 lt lilypond gt lilypond book produira alors un fichier HTML contenant les balises d image
49. adfile f to readfile tmp edef do noexpand g addto macro noexpand 1 readfile tmp do ifeof readfile f elsey readfile line 1 fiy D def readfile 1 2 Chapitre 3 Association musique texte avec 1ilypond book 41 openin readfile f 1 ifeof readfile fy typeout No TOC file 1 available else gdef 2 readfile line 2 fi closein readfile f Di newcommand includescore 1 def oly fname oly basename ifmtarg 1 _ 1 let oly addtotoc undefined readfile oly xxxxxxxxx oly addtotoc ifx oly addtotoc undefined includepdf pages oly fname else edef includeit noexpand includepdf pages addtotoc oly addtotoc oly fname includeit fi 3 8 Autres m thodes d association texte musique D autres moyens de m langer musique et texte sans recourir lilypond book sont abord s au chapitre Section 4 4 Inclusion de partition LilyPond dans d autres programmes page 49 Chapitre 4 Programmes externes 42 4 Programmes externes LilyPond peut interagir avec d autres programmes selon diff rentes mani res 4 1 Pointer cliquer Le pointer cliquer point and click permet de se retrouver directement dans le fichier source la note que l on pointe dans le visionneur de PDF Ceci facilite grandement le rep rage des erreurs partir du fichier imprimable 4 1 1 Configuration du syst me Lorsque cette fonctionnalit est active LilyPond ajoute de
50. ar copy right holder is reinstated a provisionally unless and until the copyright holder explicitly and finally terminates your license and b permanently if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation Moreover your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means this is the first time you have received notice of violation of this License for any work from that copyright holder and you cure the violation prior to 30 days after your receipt of the notice Annexe A GNU Free Documentation License 66 10 11 Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License If your rights have been terminated and not permanently reinstated receipt of a copy of some or all of the same material does not give you any rights to use it FUTURE REVISIONS OF THIS LICENSE The Free Software Foundation may publish new revised versions of the GNU Free Doc umentation License from time to time Such new versions will be similar in spirit to the present version but may differ in detail to address new problems or concerns See http www gnu org copyleft Each version of the License is given a distinguishing version number If the Document specifies that a particular numbered versi
51. ariation etc Vous pouvez ne pas avoir besoin des commentaires lorsque vous crivez une pi ce pour la premi re fois mais si vous souhaitez y revenir deux ou trois ans plus tard pour changer quelque chose ou si vous donnez le fichier source un ami ce sera beaucoup plus difficile de d terminer vos intentions ou la mani re dont votre fichier est structur si vous n y avez pas adjoint de commentaires Mentionnez les dur es au d but de chaque section ou variable Si vous saisissez c4 d e au d but d une phrase vous vous pargnerez des probl mes si plus tard vous modifiez votre musique Chapitre 5 Suggestions pour la saisie de fichiers LilyPond 52 e Indentez les accolades et indications de musique en parall le Beaucoup de probl mes vien nent d un d faut de parit entre et ou lt lt et gt gt Par exemple new Staff relative r4 g 8 g c8 c4d e4 r8 Ossia section lt lt f8ccl l new Staff fe e gt gt r4 est bien plus facile appr hender que new Staff relative r4 g 8 g c4 c8 d e4 r8 Ossia section lt lt f8 c c new Staff f8 f c gt gt r4 e S parez les affinages de mise en forme de la musique elle m me ne serait ce qu en position nant les d rogations au sein du bloc layout score musique layout override TabStaff Stemstencil f Ceci n aura par pour effet de g n rer un contexte suppl mentaire
52. c string instead of the correct markup bold italic string 2 0 gt 2 2 Doesn t handle partcombine Doesn t do addlyrics gt lyricsto this breaks some scores with multiple stanzas 2 0 gt 2 4 magnify isn t changed to fontsize magnify m gt fontsize f where f 61n m 1n 2 remove tag isn t changed applyMusic remove tag gt keepWithTag first page number isn t changed first page number no gt print first page number f Line breaks in header strings aren t converted as line break in header strings gt markup center align lt First Line Second Line gt Crescendo and decrescendo terminators aren t converted rced gt rc gt 2 2 gt 2 4 l Ceci est r alisable tant que le fichier LilyPond ne contient pas de Scheme D s lors qu un fichier contient du Scheme des bribes de langage volu se retrouvent danas le fichier Lily Pond ce qui conduit immanquablement au a probl me de l arr t bien connu en informatique Chapitre 2 Mise jour avec convert ly 21 turnOff used in set Staff VoltaBracket turnUff is not properly converted 2 4 2 gt 2 5 9 markup center align lt gt should be converted to markup center align line but now line is missing 2 4 gt 2 6 Special LaTeX characters such as in text are not converted to UTF8 2 8 score must now begin with a music expression Anything else
53. collection consisting of the Document and other documents released under this License and replace the individual copies of this License in the various documents with a single copy that is included in the collection provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects You may extract a single document from such a collection and distribute it individually under this License provided you insert a copy of this License into the extracted document and follow this License in all other respects regarding verbatim copying of that document 7 AGGREGATION WITH INDEPENDENT WORKS A compilation of the Document or its derivatives with other separate and independent documents or works in or on a volume of a storage or distribution medium is called an aggregate if the copyright resulting from the compilation is not used to limit the legal rights of the compilation s users beyond what the individual works permit When the Document is included in an aggregate this License does not apply to the other works in the aggregate which are not themselves derivative works of the Document If the Cover Text requirement of section 3 is applicable to these copies of the Document then if the Document is less than one half of the entire aggregate the Document s Cover Texts may be placed on covers that bracket the Document within the aggregate or the electronic equivalent of covers if the Document
54. ctave de d part de l extrait 1 correspond au do central Cette option relative n a d effet que si elle est utilis e en combinaison avec l option fragment autrement dit l option fragment est implicite d s lors que relative est explicit La documentation de LilyPond comme nous l avons d j vu use abondamment de lilypond book Elle utilise cet effet quelques options particuli res verbatim L argument de la commande LilyPond est recopi textuellement dans le fichier g n r avant l image de la partition Cependant cette option n est pas pleinement op rationnelle lorsqu un 1ilypond se trouve au milieu d un paragraphe L utilisation conjointe d un verbatim et de la commande lilypondfile permet de n inclure textuellement qu une seule partie du fichier source 1ilypond book repro duira alors textuellement la partie du fichier source comprise entre les commentaires begin verbatim et ventuellement end verbatim Si l on consid re le fichier source suivant la musique sera interpr t e en mode relatif mais la recopie du code ne com portera pas l assertion du bloc relative relative begin verbatim c 4 e2 g4 f2 e end verbatim donnera dans un bloc verbatim pr c dant la partition c4 e2 g4 f2 e Si d aventure vous d sirez traduire les commentaires et noms de variable dans le rendu textuel plut t que dans le fichier source vous devrez d finir la vari able d environnement L
55. ction de fragments musicaux dans Manuel de notation Bien entendu aucun fragment ne sera extrait si Ton utilise l option dno print pages datadir D termine le pr fixe des fichiers de donn es lecture seule Chapitre 1 Ex cution de lilypond debug gc debug gc assert parsed dead debug lexer debug page breaking scoring debug parser debug property callbacks debug skylines delete intermediate files dump cpu profile dump profile dump signatures eps box padding gs load fonts gs load lily fonts gui f f f f f f f t f f f f f f f G n re une copie brute de la m moire aux fins de d bogage Pour d bogage de la m moire s assure que toute r f rence des objets analys s est effac e Il s agit d une option interne qui est automatiquement activ e par l option ddebug gc D bogage de l analyseur lexical flex Purge les calculs des configurations de saut de page D bogage de l analyseur bison D bogage des chaines de callback cycliques D bogage des lignes d horizon Supprime les fichiers ps inutiles cr es lors de la compilation G n re une copie brute des informations de timing d pend du syst me G n re une copie brute de la m moire et des temps de traitement pour chaque fichier G n re une copie des signatures de chaque syst me Cette option est utilis e pour les tests de r gression
56. des ou des doubles chevrons Des accolades placeront ces clauses new en s quence score new Staff a a a a ai a new Staff g g g g Chapitre 1 Ex cution de lilypond 16 Die 2112 alors que des doubles chevrons les placeront en parall le autrement dit LilyPond les traitera simultan ment score lt lt new Staff a ai a ai new Staff g g g g gt gt aaa Cette voix requiert un voiceXx ou un r glage shiftXx Lorsque des notes affect es a des voix diff rentes et ayant la m me orientation de hampe interviennent au m me instant musical et qu aucun d calage sp cifique a la voix n a t sp cifi LilyPond met Avertissement Cette voix requiert un voiceXx ou un r glage shiftXx warning this voice needs a voiceXx or shiftXx setting Cet avertissement est mis m me lorsque ces notes n ont pas de hampe visible comme par exemple des rondes si les hampes des dur es inf rieures ces m me hauteurs avaient la m me orientation N oublions pas que l orientation des hampes d pend de la position des notes sur la port e moins que cette orientation n ait t sp cifi e par exemple l aide d un voiceOne ou autre clause En pareil cas l avertissement ne sera mis que lorsque les hampes auront la m me orientation autrement dit lorsque les notes seront dans la m me moiti de la port e
57. diaobject et inlinemediaobject de telle sorte que ces inclusions soient incorpor es directement ou non dans le document final Les options de formatage des extraits en question sont fournies par la propri t role de l l ment central voir les paragraphes suivants Les balises sont d termin es de mani re ce que les diteurs DocBook prennent en charge du mieux possible leur contenu Les fichiers DocBook destin s un traitement par 1ilypond book doivent avoir une extension lyxml Inclusion d un fichier LilyPond Il s agit en fait du cas le plus simple Le fichier inclure doit avoir une extension ly et sera ins r comme n importe quel imageobject en respectant la structure suivante lt mediaobject gt lt imageobject gt lt imagedata fileref musici ly role printfilename gt lt imageobject gt lt mediaobject gt Vous pouvez utiliser en tant que balise externe aussi bien mediaobject que inlinemediaobject Inclusion de code LilyPond L inclusion de code LilyPond se r alise l aide d un programlisting auquel on associe le langage lilypond En voici la syntaxe lt inlinemediaobject gt lt textobject gt lt programlisting language lilypond role fragment verbatim staffsize 16 ragged right re context Staff with remove Time_signature_engraver remove Clef_engraver c4 fis lt programlisting gt lt textobject gt lt inlinemediaobject gt Comme vous le remarquez la
58. distribution GNU Linux Ubuntu et n cessiteront l utilisation de sudo autant que de besoin e Installation des paquetages n cessaires LilyPond Ghostscript et ImageMagick e Cr ation de l utilisateur lily adduser lily Ceci par la m me occasion cr era un groupe sp cifique pour l utilisateur lily ainsi que son r pertoire personnel home 1lily e Cr ation dans le r pertoire personnel de l utilisateur lily d un espace agissant en tant que syst me de fichiers dd if dev zero of home lily loopfile bs 1k count 200000 Cette commande a cr un fichier de 200 MB utilisable par le syst me prot g e Cr ation d un pseudo p riph rique g n ration d un syst me de fichiers et chargement de celui ci puis cr ation d un r pertoire accessible en criture pour l utilisateur lily mkdir mnt lilyloop losetup dev loopO home lily loopfile mkfs t ext3 dev loopO 200000 mount t ext3 dev loopO mnt lilyloop mkdir mnt lilyloop lilyhome chown lily mnt lilyloop lilyhome e Affectation au niveau configuration du serveur de mnt lilyloop en tant que JAIL et lilyhome en tant que DIR e Cr ation d une arborescence dans l espace prot g et recopie de tous les fichiers n cessaires voir le script plus loin Le recours l utilitaire sed permet de cr er les commandes de copie de tout ce qui est n cessaire amp un ex cutable for i in usr local lilypond usr bin lilypond bin sh usr bin do ldd
59. e c 2 f f ou ly set option point and click note event relative c 2 f f J e En ligne de commande lilypond dpoint and click note event exemple ly Plusieurs types d v nement peuvent tre mentionn s e En dur dans votre fichier 1y pointAndClickTypes note event dynamic event relative c 2 f f ou ly set option point and click note event dynamic event relative c 2 f f e En ligne de commande lilypond e ly set option point and click note event dynamic event exemple ly Chapitre 4 Programmes externes 45 4 2 LilyPond et les diteurs de texte Certains diteurs de texte prennent en charge LilyPond Mode Emacs Emacs dispose d un lilypond mode qui fournit l autocompl tion des mots cl s l indentation les appariements sp cifiques LilyPond la coloration syntaxique ainsi que des raccourcis pour compiler et consulter les manuels de LilyPond en mode info Si le lilypond mode n tait pas install sur votre syst me proc dez comme ci dessous Le r pertoire elisp inclus dans les sources contient aussi un mode pour saisir la musique et lancer LilyPond Faites make install pour l installer dans votre elispdir Le fichier lilypond init el devrait trouver sa place dans load path site start d ou bien ajout votre emacs ou emacs el En tant que simple utilisateur vous pouvez toujours ajouter votre propre r pertoire par exemple site lisp
60. e LilyPond sont disponibles 2 1 LilyPond est une langue vivante La syntaxe de LilyPond change de temps en temps que ce soit pour rendre les fichiers plus faciles lire et crire ou pour int grer de nouvelles fonctionnalit s En voici un exemple flagrant Tous les noms des propri t s de paper et layout sont libell s sous la forme premier deuxi me troisi me Nous avons constat une fois la version 2 11 60 mise disposition que la propri t printallheaders ne respectait pas cette convention Aurions nous d la laisser telle que au risque de d router les nouveaux utilisateurs par cette exception au formatage ou bien la modifier ce qui allait obliger ceux qui l avaient d j utilis e se mettre en chasse Pour ce cas d esp ce nous avons d cid de changer le nom de cette propri t en print all headers et de permettre ceux qui avaient utilis l ancienne syntaxe de modifier automatiquement leurs fichiers l aide de notre utilitaire convert 1ly Malheureusement convert ly ne peut pas r aliser toutes les modifications Par exemple dans les versions de LilyPond ant rieures la 2 4 2 les accents et les lettres non anglaises taient entr es en utilisant IATEX par exemple No el A partir de la version 2 6 le caract re doit tre entr directement dans le fichier LilyPond comme caract re UTF 8 convert ly ne peut pas changer tous les caract res ATFX en caract res UTF 8 vous dev
61. e de la musique d utiliser l une des instructions suivantes begin lilypond liste des options VOTRE CODE LILYPOND end lilypond lilypond liste des options VOTRE CODE LILYPOND lilypondfile liste des options fichier musicxmlfile liste des options fichier Par ailleurs la commande lilypondversion vous permet d afficher le num ro de version de LilyPond Lancer 1ilypond book produira un fichier qui sera ensuite trait par TEX Voici quelques exemples L environnement lilypond begin lilypond quote fragment staffsize 26 c d e f g 2 g 2 end lilypond produit La version abr g e lilypond quote fragment staffsize 11 lt c er g gt produit Dans l tat actuel des choses il n est pas possible d inclure des accolades ou dans un lilypond cette commande n est donc pertinente que lorsque conjugu e l option fragment Chapitre 3 Association musique texte avec 1ilypond book 27 La longueur par d faut des port es sera ajust e en fonction des commandes contenues dans le pr ambule du document ce qui pr c de la ligne begin document La commande lilypond book les transmet TFX afin de conna tre la largeur du texte et par voie de cons quence d terminer la longueur des port es Notez bien que cet algorithme heuristique n est pas infaillible vous devrez alors recourir l option line width D s lors qu elles auront t d finies dans votre
62. e error Erreur Scheme Les erreurs qui interviennent lors de l ex cution de code Scheme sont g r es par Vinterpr teur Scheme L utilisation du mode verbeux options V ou verbose vous permettra de localiser l appel de fonction d lictueux Programming error Erreur de programmation LilyPond est confront une incoh rence interne Ce type de message est destin venir en aide aux d veloppeurs et d bogueurs En r gle g n rale vous pouvez tout simplement les ignorer Parfois il y en a tant qu ils masquent ce qui pourrait vous int resser Aborted core dumped Abandon Ce type de message indique que LilyPond a plant en raison d une grave erreur de programmation La survenance d un tel message est consid r e comme de la plus haute importance Si vous y tiez confront transmettez un rapport de bogue Lorsque l avertissement ou l erreur est directement li au fichier source le message est libell sous la forme fichier ligne colonne message contenu de la ligne litigieuse Un saut de ligne est plac dans la ligne de code indiquant l endroit pr cis du probl me comme ici test ly 2 19 erreur n est pas une dur e 5 c 4 e 5g Notez que ces coordonn es constituent l approximation au mieux par LilyPond dans le code ayant d clench l avertissement ou l erreur En r gle g n rale erreurs et avertissements survien nent lorsque LilyPond rencontre quelque chose d inattendu Lor
63. e les diff rentes commandes successives Bien que cette mani re de proc der ne tienne aucun compte des d pendances entre fichiers elle permet de r duire le nombre de processus lancer dans une seule commande Vous devrez enregistrer les lignes suivantes dans un fichier construire bat ou construire cmd Ce fichier pourra tre ex cut soit en ligne de commande soit par un double clic sur son ic ne lilypond book output out pdf monprojet lytex cd out pdflatex monprojet makeindex monprojet pdflatex monprojet cd copy out monprojet pdf MonProjet pdf Voir aussi Manuel d utilisation Section 1 2 Utilisation en ligne de commande page 1 Chapitre 3 lilypond book page 22 Annexe A GNU Free Documentation License 61 Annexe A GNU Free Documentation License Version 1 3 3 November 2008 Copyright 2000 2001 2002 2007 2008 Free Software Foundation Inc http fsf org Everyone is permitted to copy and distribute verbatim copies of this license document but changing it is not allowed 0 PREAMBLE The purpose of this License is to make a manual textbook or other functional and useful document free in the sense of freedom to assure everyone the effective freedom to copy and redistribute it with or without modifying it either commercially or noncommercially Secondarily this License preserves for the author and publisher a way to get credit for their work while not being considered responsible for modi
64. e nombre de di ses acc lt 0 le nombre de b mols Une tonalit mineure est sp cifi e par l emploi de 1 o output file G n rer le r sultat dans le fichier file s start quant DUR Quantiser le d but des notes sur DUR t allow tuplet DUR NUM DEN Accepter des n olets de valeur DUR NUM DEN v verbose Mode verbeux Chapitre 4 Programmes externes 47 V version Afficher le num ro de version w warranty Afficher les mentions de garantie et de copyright x text lyrics Interpr ter le texte comme des paroles Probl mes connus et avertissements Le tuilage en arp ge ne sera pas rendu correctement La premi re note sera lue et les suivantes ignor es Affectez leur une dur e unique et ajoutez une indication de phras ou de p dale 4 3 2 Utilisation de musicxml2ly MusicXML http www musicxml org est un dialecte XML pour repr senter la notation musicale musicxml21y extrait partir d un fichier MusicXML les notes articulations structure de la partition paroles etc et les crit dans un fichier 1y Il se lance ainsi en ligne de commande musicxml2ly option fichier xml Notez bien que par ligne de commande nous parlons de la ligne de commande du syst me Pour plus de pr cisions reportez vous Section 4 3 Conversion partir d autres formats page 45 Si le nom du fichier est musicxm121y lira directement partir de la ligne de commande musicxml21
65. e seule Consid re tous les messages d avertissement et erreur de programmation comme tant de v ritables erreurs lilypond reconnait les variables d environnement suivantes LILYPOND_DATADIR Cette variable sp cifie le r pertoire o seront recherch s par d faut les diff rentes versions des messages ainsi qu un certain nombre de fichiers n cessaires au traite ment Il devrait contenir les sous r pertoires ly ps tex etc LANG Cette variable d termine la langue dans laquelle seront mis les messages Chapitre 1 Ex cution de lilypond 11 LILYPOND_LOGLEVEL Cette variable d termine le niveau par d faut de verbosit En l absence de niveau explicite autrement dit la ligne de commande ne comporte pas de loglevel c est cette valeur qui sera utilis e LILYPOND_GC_YIELD Cette variable permet d ajuster l empreinte m moire et le rendement de la machine Il s agit en fait d un pourcentage d allocation de m moire lorsqu il est lev le programme favorisera l utilisation de la m moire une faible valeur consommera plus de temps processeur Par d faut cette valeur est fix e 70 Ex cution de LilyPond en mode prot g Param trer un serveur afin qu il puisse faire fonctionner LilyPond en mode prot g sur un pseudo p riph rique est une t che sensible Les diff rentes tapes suivre sont r pertori es ci dessous Les exemples qu elle comportent proviennent d une
66. ents Texinfo Afin d ins rer de la musique dans vos fichiers Texinfo 1ilypond book dispose des environ nements et commandes suivantes e la commande lilypond qui permet de directement saisir du code LilyPond simple e l environnement lilypond end lilypond qui permet de saisir directement du code LilyPond plus labor e la commande lilypondfile qui permet d ins rer un fichier LilyPond e la commande Gmusicxmlfile qui permet d ins rer un fichier MusicX ML qui sera alors trait par musicxml12ly puis lilypond Il suffit pour inclure de la musique d utiliser l une des instructions suivantes dans votre fichier source lilypond liste des options VOTRE CODE LILYPOND end lilypond lilypond liste des options VOTRE CODE LILYPOND lilypondfile liste des options fichier musicxmlfile liste des options fichier Par ailleurs l utilisation d un lilypondversion permet d afficher la version de LilyPond utilis e Le traitement du fichier source par lilypond book g n re un fichier Texinfo extension itexi qui contiendra les balises image pour les formats HTML Info ou imprimable Les images g n r es par 1ilypond book sont au format EPS et PDF en vue d une impression et au format PNG pour leur utilisation en HTML ou Info En voici deux exemples Un environnement lilypond lilypond fragment Cc d e f g 2 g Cend lilypond produit Ke La version
67. erse si besoin lorsque vous ferez appel cette variable Des erreurs de transposition Chapitre 5 Suggestions pour la saisie de fichiers LilyPond 53 seront moins susceptibles de se produire si la musique de toutes les variables est dans la m me et unique tonalit De la m me mani re prenez toujours le do comme note de d part ou d arriv e Ceci aura pour simple cons quence que les autres tonalit s que vous utiliserez seront celles propres chacun des instruments sib pour une trompette en si b mol ou lab pour une clarinette en la b mol 5 3 Projets d envergure Lorsque l on travaille sur un gros projet il devient vital de structurer clairement ses fichiers LilyPond e Utilisez un identificateur pour chaque voix avec un minimum de structure dans la d finition La structure de la section score est la plus susceptible de changer notamment dans une nouvelle version de LilyPond alors que la d finition du violon l est beaucoup moins violon relative g 4 c 8 e16 score new GrandStaff new Staff violon e S parez les retouches des d finitions de musique Nous vous avons d j invit adopter une telle pratique qui par ailleurs devient vitale pour des projets d importance Nous pouvons avoir besoin de changer la d finition de fpuisp mais dans ce cas nous n aurons besoin de le faire qu une seule fois et nous pourrons encore viter de modifier quoi que ce soit l int
68. es ou bien si votre projet requiert certaines commandes particuli res comme lilypond book Les Makefiles varient tant en complexit qu en flexibilit selon les besoin et les aptitudes de celui qui les cr e Le programme GNU Make est install par d faut sur les distributions GNU Linux et sur MacOS X et il en existe une version pour les environnements Windows Consultez le GNU Make Manual pour plus de d tails sur ce dont make est capable vous pourrez m me en trouver des versions fran aises l aide des moteurs de recherche dans la mesure o ce qui suit ne donne qu un bref aper u de ses possibilit s Les commandes permettant de d finir les r gles diff rent selon la plate forme si les diff rents GNU Linux et MacOS X utilisent bash Windows utilise cmd Dans le cas de MacOS X vous devrez toutefois configurer votre syst me de telle sorte qu il utilise l interpr teur en ligne de commande Voici quelques exemples de fichier Makefile avec une version pour GNU Linux ou MacOS et une pour Windows Pour commencer une pi ce quatre mouvements pour orchestre et dont les fichiers sont r partis selon l arborescence suivante Symphonie MIDI Chapitre 5 Suggestions pour la saisie de fichiers LilyPond 55 Makefile Notes alto ily cor ily cello ily figures ily hautbois ily trioCordes ily violonUn ily violonDeux ily Partitions
69. es lignes dans un fichier nomm lilybook lytex puis dans un terminal lancez lilypond book output out pdf lilybook lytex lilypond book GNU LilyPond 2 19 31 Lecture de lilybook lytex nous vous pargnons le verbiage de la console Compilation de lilybook tex cd out pdflatex lilybook nous vous pargnons le verbiage de la console xpdf lilybook remplacez xpdf par votre lecteur de PDF habituel Le traitement par lilypond book puis latex va g n rer un certain nombre de fichiers tem poraires susceptibles d encombrer inutilement votre r pertoire de travail aussi nous vous recom mandons d utiliser option output r pertoire afin que les fichiers cr s soient isol s dans le sous r pertoire r pertoire Pour terminer voici le r sultat de cet exemple pour IATEX 1 Ce manuel tant r alis avec Texinfo il se peut que la mise en forme diverge quelque peu Chapitre 3 Association musique texte avec 1ilypond book 24 R sultat Un document destin tre trait par 1ilypond book peut tout fait m langer de la musique et du texte Par exemple mr Les options sont indiqu es entre crochets c 4 16 va Des extraits plus cons quents peuvent faire l objet d un fichier ind pendant alors inclus avec lilypondfile Lorsque vous d sirez y inclure un tagline personnalis ou non l int gralit de l
70. ez mettre jour vos vieux fichiers LilyPond manuellement Les r gles de conversion de convert ly reposent sur la recherche et le remplacement de motifs textuels plut t que sur les capacit s intellectuelles de LilyPond en cons quence de quoi e La fiabilit de la conversion d pend de la qualit m me de chaque jeu de r gles ainsi que sur la complexit des modifications respectives apporter Certaines conversions peuvent donc requ rir une intervention manuelle la version de d part devrait toujours rester disponible pour comparaison e Seules des conversions une syntaxe plus r cente sont possibles aucune r gle ne permet de revenir en arri re La copie de travail d un fichier LilyPond ne devrait donc tre mise jour que lorsque la version sur laquelle il repose n est plus maintenue Des syst me de gestion de version tels que Git permettent de se tenir jour sur plusieurs versions e LilyPond ainsi que Scheme g rent plut t bien l emplacement ou l absence d espaces les r gles utilis es par convert ly tendent cependant effectuer certains postulats en mati re de style Suivre le style adopt dans les diff rent manuels est un gage de mise jour sans probl me si l on consid re que ces manuels sont eux m me mis jour avec convert ly 2 2 Ex cution de convert ly La commande convert ly utilise les mentions de version que vous n avez s rement pas oubli de porter dans vos fichiers
71. f plus such following pages as are needed to hold legibly the material this License requires to appear in the title page For works in formats which do not have any title page as such Title Page means the text near the most prominent appearance of the work s title preceding the beginning of the body of the text The publisher means any person or entity that distributes copies of the Document to the public A section Entitled XYZ means a named subunit of the Document whose title either is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another language Here XYZ stands for a specific section name mentioned below such as Acknowledgements Dedications Endorsements or History To Preserve the Title of such a section when you modify the Document means that it remains a section Entitled XYZ according to this definition The Document may include Warranty Disclaimers next to the notice which states that this License applies to the Document These Warranty Disclaimers are considered to be included by reference in this License but only as regards disclaiming warranties any other implication that these Warranty Disclaimers may have is void and has no effect on the meaning of this License 2 VERBATIM COPYING You may copy and distribute the Document in any medium either commercially or noncom mercially provided that this License the copyright notices a
72. fications made by others This License is a kind of copyleft which means that derivative works of the document must themselves be free in the same sense It complements the GNU General Public License which is a copyleft license designed for free software We have designed this License in order to use it for manuals for free software because free software needs free documentation a free program should come with manuals providing the same freedoms that the software does But this License is not limited to software manuals it can be used for any textual work regardless of subject matter or whether it is published as a printed book We recommend this License principally for works whose purpose is instruction or reference 1 APPLICABILITY AND DEFINITIONS This License applies to any manual or other work in any medium that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License Such a notice grants a world wide royalty free license unlimited in duration to use that work under the conditions stated herein The Document below refers to any such manual or work Any member of the public is a licensee and is addressed as you You accept the license if you copy modify or distribute the work in a way requiring permission under copyright law A Modified Version of the Document means any work containing the Document or a portion of it either copied verbatim or with mod
73. fit legibly you should put the first ones listed as many as fit reasonably on the actual cover and continue the rest onto adjacent pages If you publish or distribute Opaque copies of the Document numbering more than 100 you must either include a machine readable Transparent copy along with each Opaque copy or state in or with each Opaque copy a computer network location from which the general network using public has access to download using public standard network protocols a complete Transparent copy of the Document free of added material If you use the latter option you must take reasonably prudent steps when you begin distribution of Opaque copies in quantity to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy directly or through your agents or retailers of that edition to the public It is requested but not required that you contact the authors of the Document well before redistributing any large number of copies to give them a chance to provide you with an updated version of the Document 4 MODIFICATIONS You may copy and distribute a Modified Version of the Document under the conditions of sections 2 and 3 above provided that you release the Modified Version under precisely this License with the Modified Version filling the role of the Document thus licensing distribution and modification of the Modified Version to
74. format par d faut savoir a4 notime D sactive l impression des m triques et barres de mesure pour l int gralit de la partition fragment Laisse lilypond book le soin d ajouter ce qui est indispensable de telle sorte que vous pouvez vous contenter d un c 4 sans layout score etc Chapitre 3 Association musique texte avec 1ilypond book 32 nofragment N ajoute rien ce qui se trouve dans l environnement LilyPond A noter qu il s agit de l option par d faut indent taille unit D finit indentation du premier syst me taille exprim e en unit cm mm in ou pt Cette option n affecte que LilyPond et en aucun cas la mise en forme du texte noindent Ram ne l indentation du premier syst me z ro Cette option n affecte que Lily Pond et en aucun cas la mise en forme du texte Dans la mesure o il s agit du comportement par d faut point n est besoin de sp cifier noindent quote R duit la longueur des lignes musicales de 2 x 0 4in soit 2 10 16 mm pour renvoyer l extrait dans un bloc de citation La valeur 0 4 pouce est contr l e par Voption exampleindent exampleindent D termine la valeur de l indentation qui sera utilis e par option quote relative relative n Utilise le mode d octave relative Les notes sont donc par d faut positionn es rela tivement au do central L argument un nombre entier fourni l option relative sp cifie l o
75. g lilypond fichier ly 2 gt stderr log lilypond fichier ly amp gt tous log redirigeront respectivement le a verbiage normal les erreurs ou tout dans un fichier texte Consultez avant tout la documentation de votre interpr teur habituel terminal console etc pour v rifier qu il prend en charge les options dans cette syntaxe Voici comment traiter un jeu de fichiers r partis dans un r pertoire donn ainsi que tous ses diff rents sous r pertoires Les fichiers r sultants seront regroup s dans le r pertoire partir duquel la commande a t ex cut e non selon emplacement des fichiers sources find name ly exec lilypond Cette commande bien qu effective uniquement dans un terminal devrait tre fonctionnelle aussi pour les utilisateurs de MacOS X Les utilisateurs de windows utiliseront l instruction forfiles Ze M ly c cmd c lilypond file dans l interpr teur de commandes qui se trouve normalement sous D marrer gt Accessoires gt Interpr teur de commandes ou pour la version 8 en faisant une recherche sur interpr teur de commande Par ailleurs il est possible de sp cifier de mani re explicite le chemin d acc s au dossier comportant des sous r pertoires o se trouvent les fichiers sources l aide de l option p forfiles s p C Documents MesPartitions M ly c cmd c lilypond file Dans le cas o ce chemin d acc s comporte des espaces l
76. ge cdr label page format f a section 1 ak an page text label formatted toc items map format line toc items whole string string join formatted toc items n output name ly parser output name outfilename format a toc output name outfile open output file outfilename if output port outfile display whole string outfile ly warning _ Impossible d ouvrir le fichier a contenant les informations de TdM outfilename close output port outfile paper define page post process layout pages oly create toc file layout pages Import de la table dans BIFX L ent te de votre fichier ATEX doit comporter les lignes usepackage pdfpages includescore nomdelapartition o includescore est d fini ainsi hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhlh lh includescore PossibleExtension Ahhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh Read in the TOC entries for a PDF file from the corresponding toc file This requires some heave latex tweaking since reading in things from a file and inserting it into the arguments of a macro is not easily possible Solution by Patrick Fimml on latex on April 18 2009 readfile filename variable reads in the contents of the file into variable undefined if file doesn t exist newread readfile f def readfile line 1 catcode M 10 global read re
77. ier s il n en comporte pas Cette option permet de passer outre s show rules pour afficher les conversions applicables t to to patchlevel pour n appliquer les conversions que jusqu une version d termin e Il s agit par d faut de la derni re version disponible Le niveau demand doit tre sup rieur la version de d part convert ly to 2 14 1 monfichier ly Lorsqu il s agit de fragments inclus dans un fichier texinfo il vous faudra lancer convert ly from to no version itely Lorsque vous d sirez savoir quels changements de syntaxe sont intervenus entre deux versions de LilyPond lancez convert ly from ancienne to r cente s 2 4 Probl mes d ex cution de convert ly Sous Windows lorsque le nom du fichier original ou le chemin qui y m ne comporte des espaces Vinterpr teur de commande requiert qu il soit entour de triples guillemets comme ci dessous convert ly D Mes Partitions Ode ly gt D Mes Partitions nouveau Ode Lorsque la commande convert ly e ly choue parce que son expansion d passe la taille maximale d une ligne vous pouvez lancer convert ly dans une boucle L exemple suivant per met sous Unix de convertir tous les fichiers 1y d un m me r pertoire Lef Chapitre 2 Mise jour avec convert ly 20 for f in ly do convert ly e f done Avec l interpr teur de commandes de Windows la syntaxe consacr e est for x in
78. ifications and or translated into another language A Secondary Section is a named appendix or a front matter section of the Document that deals exclusively with the relationship of the publishers or authors of the Document to the Document s overall subject or to related matters and contains nothing that could fall directly within that overall subject Thus if the Document is in part a textbook of mathematics a Secondary Section may not explain any mathematics The relationship could be a matter of historical connection with the subject or with related matters or of legal commercial philosophical ethical or political position regarding them The Invariant Sections are certain Secondary Sections whose titles are designated as being those of Invariant Sections in the notice that says that the Document is released under this License If a section does not fit the above definition of Secondary then it is not allowed to be designated as Invariant The Document may contain zero Invariant Sections If the Document does not identify any Invariant Sections then there are none The Cover Texts are certain short passages of text that are listed as Front Cover Texts or Back Cover Texts in the notice that says that the Document is released under this License A Front Cover Text may be at most 5 words and a Back Cover Text may be at most 25 words Annexe A GNU Free Documentation License 62 A Transparent copy of the Docume
79. ily piece cor pdf piece cor ly cor ily piece hautbois pdf piece hautbois ly hautbois ily piece violonUn pdf piece violonUn ly violonUn ily piece violonDeux pdf piece violonDeux ly violonDeux ily Lancer make score pour g n rer l int grale des quatre mouvements en un seul fichier PHONY score score piece pdf Chapitre 5 Suggestions pour la saisie de fichiers LilyPond 57 Lancer make parties pour obtenir tous les pupitres Lancer make toto pdf pour obtenir la partie instrumentale de toto Par exemple make symphonie cello pdf PHONY parties parties piece cello pdf piece violonUn pdf piece violonDeux pdf piece alto pdf piece hautbois pdf piece cor pdf Lancer make mouvements pour g n rer un fichier s par pour chacun des mouvements PHONY mouvements mouvements piece I pdf piece II pdf piece III pdf piece IV pdf all score parties mouvements archive tar cvvf symphonie tar cette ligne commence par une tabulation exclude pdf exclude exclude midi exclude tar Symphonie Les choses se compliquent sous Windows Une fois GNU Make pour Windows t l charg et install il vous faudra correctement d finir le chemin d acc s au programme Make dans les variables d environnement du syst me afin que l interpr teur de commandes DOS puisse le localiser Pour cela faites un c
80. ilypond LILY_CMD lilypond ddelete intermediate files dno point and click djob count CPU_CORES Les suffixes utilis s dans ce Makefile SUFFIXES ly ily pdf midi Chapitre 5 Suggestions pour la saisie de fichiers Lily Pond 56 Les fichiers sources et r sultants sont recherch s dans les r pertoires list s dans la variable VPATH Ceux ci sont tous des sous r pertoires du r pertoire courant fourni par la variable de GNU make CURDIR VPATH CURDIR Partitions CURDIR PDF CURDIR Pupitres CURDIR Notes La r gle type pour cr er un PDF et un MIDI partir d un fichier source LY Les pdf r sultants iront dans le sous r pertoire PDF et les fichiers midi dans le sous r pertoire MIDI h pdf midi ly LILY_CMD lt cette ligne commence par une tabulation if test f pdf then mv pdf PDF fi if test f midi then mv midi MIDI fi H HH St notes alto ily cello ily cor ily hautbois ily violonUn ily violonDeux ily Les d pendances selon le mouvement piece I pdf piece I ly notes piece II pdf piece II ly notes piece III pdf piece III ly notes piece IV pdf piece IV ly notes Les d pendances pour la partition int grale piece pdf piece ly notes Les d pendances pour les pupitres piece alto pdf piece alto ly alto ily piece cello pdf piece cello ly cello
81. intement avec l option dpreview Chapitre 1 Ex cution de lilypond 9 profile property accesses f Enregistre des statistiques des appels la fonc tion get_property protected scheme parsing t Continue en d pit des erreurs que l analyseur syntaxique d tecterait dans du code Scheme inclus Lorsque bascul sur f stoppe le traite ment s il y a erreur et affiche une trace de la pile read file list f Sp cifie un fichier listant les diff rents fichiers fichier sources traiter relative includes f Face une instruction include recherche les fichiers inclure relativement l endroit o se trouve le fichier en cours de traitement plut t que par rapport au fichier ma tre resolution 101 D termine en dpi la r solution des pixmaps PNG g n rer selon la valeur donn e safe f Ne pas avoir une confiance aveugle dans le code Ly Lorsque LilyPond est accessible au travers d un serveur web il est imp ratif d utiliser les options safe ou jail L option safe aura pour effet d emp cher tout code Scheme inclus de mettre en p ril votre installation gr ce quelque chose du style s ystem rm rf trop dangeureux crire sans faute c4 ly gulp file etc passwd malveillant mais pas destructeur L option dsafe forcera l valuation au fil de l eau et par un module s curis des expres sions Scheme contenues dans le fichier source Ce module s curitaire d
82. ir r pertoire Formate la sortie Texinfo de telle sorte que Info cherche les images de musique dans r pertoire latex program programme Utilise l ex cutable programme en lieu et place de latex C est l option que vous utiliserez si vous pr f rez xelatex par exemple left padding distance D cale les figures EPS de distance exprim e en millim tres 3 par d faut Cette option est utile lorsque les lignes de musique d bordent sur la marge droite Rappelez vous que la largeur d un systeme d pend des l ment contenus dans sa marge gauche tels que num ro de mesure et nom d instrument Cette option permet de raccourcir les lignes et de les d caler vers la droite de la distance donn e en argument P commande process commande Traite les extraits LilyPond avec commande Par d faut il s agit de lilypond Rappelez vous que lilypond book ne peut en m me temps traiter l option filter et option process pdf Cr e des fichiers PDF pour les retraiter avec PDFIATEX redirect lilypond output Le r sultat des commandes est habituellement affich dans le terminal Cette option permet de rediriger tout le verbiage dans un journal situ dans le m me r pertoire que le fichier source use source file names Cette option permet d affecter aux fichiers correspondant aux extraits de musique le m me nom que leur source Elle n est fonctionnelle que dans le cas ot la partition est incluse l
83. item stating at least the title year new authors and publisher of the Modified Version as given on the Title Page If there is no section Entitled History in the Document create one stating the title year authors and publisher of the Document as given on its Annexe A GNU Free Documentation License 64 Title Page then add an item describing the Modified Version as stated in the previous sentence J Preserve the network location if any given in the Document for public access to a Transparent copy of the Document and likewise the network locations given in the Document for previous versions it was based on These may be placed in the History section You may omit a network location for a work that was published at least four years before the Document itself or if the original publisher of the version it refers to gives permission K For any section Entitled Acknowledgements or Dedications Preserve the Title of the section and preserve in the section all the substance and tone of each of the contributor acknowledgements and or dedications given therein L Preserve all the Invariant Sections of the Document unaltered in their text and in their titles Section numbers or the equivalent are not considered part of the section titles M Delete any section Entitled Endorsements Such a section may not be included in the Modified Version N Do not retitle any existing section to be Entitled Endorsemen
84. l que tmp que l on appelera lilypond invoke editor desktop Il devra avoir le contenu suivant Desktop Entry Version 1 0 Name lilypond invoke editor GenericName Textedit URI handler Comment URI handler for textedit Exec lilypond invoke editor u Terminal false Type Application MimeType x scheme handler textedit Categories Editor NoDisplay true puis ex cuter les commandes xdg desktop menu install lilypond invoke editor desktop xdg mime default lilypond invoke editor desktop x scheme handler textedit Apr s cette invocation gnome open textedit etc issue 1 0 0 devrait appeler lilypond invoke editor pour ouvrir les fichiers Configuration sp cifique Evince Il se peut que bien que gnome open soit fonctionnel Evince refuse d ouvir les liens pointer cliquer pour des raisons d autorisation S impose alors une modification du profil Apparmor d Evince c est lui qui contr le le type d action qu Evince est autoris r aliser Sur une distribution Ubuntu cela consiste diter le fichier etc apparmor d local usr bin evince et lui ajouter les lignes suivantes Pour les liens Textedit usr local bin lilypond invoke editor Cx gt sanitized_helper puis lancer la commande sudo apparmor_parser r T W etc apparmor d usr bin evince Evince devrait alors tre en mesure d ouvrir les liens pointer cliquer Une telle configuration devrait tre fonctionnelle pour d autres visionneurs Activatio
85. lic droite sur Poste de travail choisissez Propri t s puis Avanc es Cliquez sur Variables d environnement puis dans l onglet Variables syst me mettez path en surbrillance et cliquez sur Modifier Ajoutez alors le chemin d acc s complet l ex cutable de GNU Make qui devrait ressembler C Program Files GnuWin32 bin Il va galement falloir adapter le makefile aux particularit s de l interpr teur de commandes et la pr sence d espaces dans le nom de certains r pertoire de ce syst me La cible archive est tout bonnement supprim e puisque Windows ne dispose pas de la commande tar Enfin les fichiers MIDI ont une extension par d faut propre Windows VERSION POUR WINDOWS piece symphonie LILY_CMD lilypond ddelete intermediate files dno point and click djob count NUMBER_OF_PROCESSORS D termination du nom de CURDIR sous sa forme 8 3 solution pour les espaces dans le PATH workdir shell for f tokens tb in CURDIR do echo sb SUFFIXES ly ily pdf mid Chapitre 5 Suggestions pour la saisie de fichiers Lily Pond 58 VPATH workdir Partitions workdir PDF workdir Pupitress workdir Notes h pdf mid 1y LILY_CMD lt cette ligne commence par une tabulation if exist pdf move Y pdf PDF tabulation au d but if exist mid move Y mid MIDI tabulation au d but notes cello ily figures ily
86. lilypond book utilise par d faut null Ne g n re aucun fichier imprimable Cette op tion est quivalente dno print pages scm Recopie litt ralement les commandes Scheme internes de formatage svg G n re du Scalable Vector Graphics Cette op tion permet de cr er un fichier SVG par page Dans la mesure o aucune information concer nant les fontes n est incorpor e elles devront tre install es afin d obtenir le meilleur rendu possible Il est pr f rable de ne pas recourir aux alias de police ni aux listes de fontes si le vi sionneur de fichier SVG ne peut le traiter cor rectement L option svg woff voir ci apr s permet d utiliser les fontes woff avec le moteur SVG Note propos du moteur SVG Les polices par d faut de LilyPond LilyPond Serif LilyPond Sans Serif et LilyPond Monospace ne sont que des alias au niveau local Le recours au moteur SVG requiert donc que ces polices par d faut soient explicitement d finies paper define fonts make pango font tree TeX Gyre Schola TeX Gyre Heros TeX Gyre Cursor staff height pt 20 Voir aussi Section Choix des fontes par d faut dans Manuel de notation check internal types f V rifie qu a chaque propri t est bien affect un type clip systems f Extrait des fragments musicaux d une partition Ceci requiert que la fonction clip regions a t d finie au sein du bloc layout voir Section Extra
87. mais s appliquera d s sa cr ation Voyez Section Economie de saisie grace aux identificateurs et fonctions dans Manuel d initiation et Section Feuilles de style dans Manuel d initiation 5 2 Gravure de musique existante Si vous saisissez de la musique a partir d une partition existante c est a dire de la musique d ja crite e n entrez qu un seul syst me de la partition originale la fois avec toujours une seule mesure par ligne de texte et v rifiez chaque syst me lorsqu il est termin Vous pouvez utiliser les commandes showLastLength et showFirstLength pour acc l rer la compilation voir Section Ignorer des passages de la partition dans Manuel de notation e d finissez mBreak break et ins rez mBreak dans le fichier d entr e pour obtenir des sauts de ligne identiques la partition originale Cela facilite la comparaison entre la partition originale et la partition de LilyPond Lorsque vous avez fini de relire votre musique vous pouvez d finir mBreak pour enlever tous ces sauts de ligne et laisser LilyPond placer les sauts de ligne selon son propre algorithme e encadrez les notes d une partie pour instrument transpositeur dans un transpose c tonalit naturelle o tonalit naturelle correspond celle de l instrument en question de telle sorte que la musique comprise dans cette variable se retrouve en ut Vous pourrez toujours transposer l inv
88. mes sera ajout e la commande de mise en forme ragged right t Il s agit de Voption par d faut de la commande lilypond en l absence d option line width C est aussi option par d faut pour l environnement lilypond lorsque l option fragment est activ e sans avoir d fini explicitement de longueur de ligne noragged right Dans le cas o l extrait tient sur une seule ligne la port e sera tir e pour corre spondre la longueur de ligne du texte Autrement dit la commande de mise en forme ragged right f s ajoute l extrait LilyPond line width line width taille unit D termine la longueur de ligne a taille exprim e en unit unit peut prendre les valeurs cm mm in ou pt Cette option n affectera que le r sultat de LilyPond la longueur de la port e et en aucun cas la mise en forme du texte En l absence d argument la longueur de ligne sera d finie une valeur par d faut telle que calcul e par un algorithme heuristique Lorsque l option line width n est pas utilis e lilypond book tentera de d terminer des valeurs par d faut pour les cas o les environnements lilypond ne font pas appel ragged right papersize cha ne D termine le format du papier cha ne tel que d fini dans le fichier scm paper scm ab quarto 11x17 etc Toute valeur non mentionn e dans scm paper scm sera rejet e lilypond book mettra un message d avertissement et l extrait utilisera le
89. mmand lilypond invoke editor s Dans un environnement Ubuntu il est fort probable que la version de Xpdf install e avec le syst me plante louverture de tout fichier PDF c est un probl me connu et persistant depuis plusieurs ann es et d a des incoh rences de biblioth ques La solution consiste alors installer une version jour des paquetages xpdf et libpoppler directement partir de Debian Une fois assur que tout fonctionne correctement la commande sudo apt mark hold xpdf permet d emp cher Ubuntu de le remplacer par un paquetage d fectueux la prochaine a mise jour Chapitre 4 Programmes externes 43 Utilisation avec GNOME 2 En ce qui concerne l environnement GNOME 2 et les lecteur de PDF associ s la succession de commandes suivante permet de r gler le syst me pour la gestion des URI par textedit gconftool 2 t string s desktop gnome url handlers textedit command lilypond invoke editor s gconftool 2 s desktop gnome url handlers textedit needs_terminal false t bool gconftool 2 t bool s desktop gnome url handlers textedit enabled true Apr s ces invocations gnome open textedit etc issue 1 0 0 devrait appeler lilypond invoke editor pour ouvrir les fichiers Utilisation avec GNOME 3 En ce qui concerne l environnement GNOME 3 les URI sont g r s par la surcouche a gvfs au lieu de gconf Il faut donc cr er un fichier dans un r pertoire local te
90. n du pointer cliquer La fonctionnalit de pointer cliquer est activ e par d faut pour ce qui est des fichiers PDF et SVG Chapitre 4 Programmes externes 44 L option pointer cliquer accro t la taille des fichiers de mani re significative Afin de r duire la taille de ces fichiers ainsi que du PS il est toujours possible de d sactiver le pointer cliquer en ajoutant pointAndClickOff dans le fichier 1y Il peut alors tre activ de mani re explicite gr ce pointAndClickOn Le pointer cliquer peut aussi tre d sactiv au moment de la compilation en ligne de com mande lilypond dno point and click file ly Note Lorsqu un fichier LilyPond est destin tre redistribu pensez d sactiver le pointer cliquer de telle sorte que les chemins d acc s et autres informations propres votre syst me ne se retrouvent pas inclus dans le fichier PDF Pointer cliquer s lectif Pour certaines applications interactives il est parfois pr f rable de limiter la fonctionnalit du pointer cliquer quelques l ments seulement Par exemple si vous avez l intention de cr er une application lan ant l audio et la vid o partir d une note en particulier il serait mal venu qu un clic sur la note vous am ne l alt ration ou une liaison qui l affecterait Les v nements g n rateurs de lien peuvent se g rer e En dur dans votre fichier 1y pointAndClickTypes note event relativ
91. nd the license notice saying this License applies to the Document are reproduced in all copies and that you add no other conditions whatsoever to those of this License You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute However you may accept compensation in exchange for copies If you distribute a large enough number of copies you must also follow the conditions in section 3 You may also lend copies under the same conditions stated above and you may publicly display copies 3 COPYING IN QUANTITY If you publish printed copies or copies in media that commonly have printed covers of the Document numbering more than 100 and the Document s license notice requires Cover Texts you must enclose the copies in covers that carry clearly and legibly all these Cover Texts Front Cover Texts on the front cover and Back Cover Texts on the back cover Both Annexe A GNU Free Documentation License 63 covers must also clearly and legibly identify you as the publisher of these copies The front cover must present the full title with all words of the title equally prominent and visible You may add other material on the covers in addition Copying with changes limited to the covers as long as they preserve the title of the Document and satisfy these conditions can be treated as verbatim copying in other respects If the required texts for either cover are too voluminous to
92. nel Vous pouvez inclure des commandes LilyPond directement dans votre texte comme ici begin lilypond a2 b c 8 c c c end lilypond noindent puis reprendre le fil de votre discours Les fontes utilis es dans les extraits LilyPond devront tre d finies au sein de l extrait Lisez le manuel d utilisation si vous ne maitrisez pas lilypond book selectlanguage ngerman Auch Umlaute funktionieren ohne die LaTeX Befehle wie auch alle anderen seltsamen Zeichen 8 ul wenn sie von der Schriftart unterst tzt werden end document Chapitre 3 Association musique texte avec 1ilypond book 40 3 7 Gestion de la table des mati res Les fonctions ici mentionn es sont incluses dans le paquetage OrchestralLily disponible sur http repo or cz w orchestrallily git Certains utilisateurs privil gient la flexibilit dans la gestion du texte ils g n rent la table des mati res partir de LilyPond et la r cup rent dans IATEX Export de la table partir de LilyPond Nous partons du principe que LilyPond a g n r un seul fichier comportant tous les mouvement de la partition define oly create toc file layout pages let label table ly output def lookup layout label page table if not null label table let format line lambda toc item let label car toc item text caddr toc item label page and list label table assoc label label table page and label pa
93. nt means a machine readable copy represented in a format whose specification is available to the general public that is suitable for revising the document straightforwardly with generic text editors or for images composed of pixels generic paint programs or for drawings some widely available drawing editor and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters A copy made in an otherwise Transparent file format whose markup or absence of markup has been arranged to thwart or discourage subsequent modification by readers is not Transparent An image format is not Transparent if used for any substantial amount of text A copy that is not Transparent is called Opaque Examples of suitable formats for Transparent copies include plain ASCII without markup Texinfo input format LaTEX input format SGML or XML using a publicly available DTD and standard conforming simple HTML PostScript or PDF designed for human modifica tion Examples of transparent image formats include PNG XCF and JPG Opaque formats include proprietary formats that can be read and edited only by proprietary word proces sors SGML or XML for which the DTD and or processing tools are not generally available and the machine generated HTML PostScript or PDF produced by some word processors for output purposes only The Title Page means for a printed book the title page itsel
94. ofondeur maximale de l arborescence de markups Si un markup tait plus profond part du principe qu on aboutira pas met un aver tissement et renvoie alors un markup vide D termine l extension par d faut des fichiers MIDI selon la cha ne donn e en argument Convertit les cha nes textuelles en chemins lorsque les glyphes font partie d une fonte mu sicale D termine la taille par d faut du papier Veillez ne pas oublier d encadrer la valeur par des guillemets chapp s D termine le format de sortie en images pix lis es pour Ghostscript Ajoute les liens point amp click la sor tie PDF ou SVG Voir Section 4 1 Pointer cliquer page 42 G n re une pr visualisation en plus de la sortie normale Cette option disponible dans tous les formats de sortie imprimables pdf png ps eps et svg g n re un fichier de la forme monFichier preview extension comprenant le titrage et le premier syst me S il existe plusieurs sections book bookpart ce fichier contiendra les titrage et premier syst me de chacun des book bookpart et score d s lors que la variable print all headers du bloc paper est activ e Pour l viter utilisez conjointement l une des options dprint pages ou dno print pages selon vos besoins print pages t G n re l int gralit des pages de la parti tion L option dno print pages est partic uli rement utile lorsqu utilis e conjo
95. on of this License or any later version applies to it you have the option of following the terms and conditions either of that specified version or of any later version that has been published not as a draft by the Free Software Foundation If the Document does not specify a version number of this License you may choose any version ever published not as a draft by the Free Software Foundation If the Document specifies that a proxy can decide which future versions of this License can be used that proxy s public statement of acceptance of a version permanently authorizes you to choose that version for the Document RELICENSING Massive Multiauthor Collaboration Site or MMC Site means any World Wide Web server that publishes copyrightable works and also provides prominent facilities for anybody to edit those works A public wiki that anybody can edit is an example of such a server A Massive Multiauthor Collaboration or MMC contained in the site means any set of copyrightable works thus published on the MMC site CC BY SA means the Creative Commons Attribution Share Alike 3 0 license published by Creative Commons Corporation a not for profit corporation with a principal place of business in San Francisco California as well as future copyleft versions of that license published by that same organization Incorporate means to publish or republish a Document in whole or in part as part of another
96. ond book les utilisateurs de LuaTex peuvent int grer le r sultat de LilyPond dans leurs documents l aide de l extension lyluatex https github com jperon lyluatex blob master README md OpenOffice et LibreOffice OOoLilyPond http ooolilypond sourceforge net permet d ins rer directement des par titions LilyPond dans OpenOffice ou LibreOffice Bien que son d veloppement soit suspendu cette extension est op rationnelle avec la version 4 des deux suites Autres programmes Pour les nombreux programmes qui sont capables de contenir des images que ce soit au format PNG EPS ou PDF mieux vaut utiliser Lilypond que lilypond book Chaque extrait devra tre Chapitre 4 Programmes externes 50 g n r s par ment avant d tre ins r dans votre document Consultez la documentation du logiciel en question quant l insertion de fichiers provenant d autres sources Les options suivantes vous permettront de r duire notablement les contours de l image Lily Pond paper indent 0 mm line width 120 mm oddFooterMarkup f oddHeaderMarkup f bookTitleMarkup f scoreTitleMarkup f musique En proc dant comme ci apr s vous obtiendrez des images EPS lilypond dbackend eps dno gs load fonts dinclude eps fonts monfichier ly des images PNG lilypond dbackend eps dno gs load fonts dinclude eps fonts png monfichier ly ou bien des images PNG avec transparence lilypond dbackend eps
97. per de la cellule Notez cependant que pour que l option jail soit fonctionnelle Lilypond doit tre lanc en tant qu administrateur ce qui se r alise ais ment l aide de la commande sudo La cr ation d un environnement s curis requiert quelques pr cautions dans la mesure o LilyPond doit disposer de tout ce dont il a besoin pour compiler le fichier source l int rieur de la cellule L ermitage avant d tre viable requiert donc les tapes suivantes Cr ation d un syst me de fichiers ind pendant L int r t d un syst me de fichiers d di LilyPond r side dans le fait qu on peut le brider l aide des options noexec nodev et nosuid Il sera de fait impossible de lancer des ex cutables ou d crire sur un Chapitre 1 Ex cution de lilypond 4 p riph rique partir de LilyPond Si vous n avez pas l intention de cr er un tel syst me sur une partition s par e vous pouvez avoir recours un pseudo p riph rique loop device mont partir d un simple fichier de taille raisonnable D autre part le recours un syst me de fichiers ind pendant permet de limiter l espace d volu LilyPond Cr ation d un utilisateur sp cifique L utilisation de LilyPond au sein de la cellule devrait tre r serv un utilisateur aux droits restreints Il faudra donc cr er un utilisateur et un groupe sp cifiques disons 1ily 1ily qui n aura acc s en criture qu
98. permettent de g n rer du code LilyPond comme par exemple des s quenceurs en mode graphique ou des convertisseurs XML Pour plus de d tails rendez vous sur le site http lilypond org Il s agit de programmes distincts de 1ilypond qui se lancent en ligne de commande Pour plus de pr cisions reportez vous au chapitre Section 1 2 Utilisation en ligne de commande page 1 Si vous utilisez MacOS 10 3 ou 10 4 et rencontrez quelque probl me avec l un de ces scripts comme convert ly reportez vous la page Section MacOS X dans Informations g n rales Probl mes connus et avertissements Les d veloppeurs ne sont malheureusement pas suffisamment nombreux et disponibles pour maintenir jour ces programmes consid rez les donc en l tat Nous acceptons les patches avec Chapitre 4 Programmes externes 46 plaisir mais il y a peu de chance pour que nous soyons en mesure de r soudre les bogues de ces programmes 4 3 1 Utilisation de midi2ly midi21y traduit un fichier MIDI de Type 1 en un fichier source LilyPond MIDI Music Instrument Digital Interface constitue un standard pour les instruments Il sp cifie le c blage un protocole s rie et un format de fichier Le format de fichier MIDI est de ce fait un format standard pour exporter de la musique partir d autres programmes et cette facult prend tout son int r t lorsqu un programme dispose d un convertisseur capable d importer directement un fichier
99. pour les fragments de musique Pour ins rer l image au fil du texte il suffit d utiliser lt lilypond gt tout en s parant options et musique par un caract re deux points comme ici De la musique lt lilypond relative 2 a b c gt au milieu d une ligne de texte Lorsque l inclusion concerne des fichiers ind pendants utilisez lt lilypondfile option option2 gt fichier lt lilypondfile gt La syntaxe pour lt musicXmlfile gt est identique celle de lt lilypondfile gt ceci pr s qu elle fait r f rence un fichier MusicX ML plut t qu un fichier LilyPond Chapitre 3 Association musique texte avec 1ilypond book 30 Une liste des diff rentes options utilisables avec les balises lilypond et lilypondfile est disponible la rubrique Section 3 3 Options applicables aux fragments de musique page 31 Par ailleurs la commande lt lilypondversion gt vous permet d afficher le num ro de version de LilyPond 3 2 4 DocBook L inclusion de documents LilyPond ne doit nuire en rien la conformit du document DocBook l utilisation d diteurs sp cialis s ainsi que d outils de validation en sera ainsi pr serv e C est la raison pour laquelle nous ne d finirons pas de balise sp cifique nous respecterons plut t les conventions des l ments standard de DocBook Conventions communes Quel que soit le type d extrait inclure nous utiliserons les l ments me
100. ptible d tre supprim des versions futures de LilyPond ETF Enigma Transport Format est l un des formats utilis s par le logiciel Finale dit par Coda Music Technology etf21y convertit partiellement les fichiers ETF en fichiers source LilyPond Pour le lancer en ligne de commande proc dez ainsi etf2ly option fichier etf Notez bien que par ligne de commande nous parlons de la ligne de commande du syst me Pour plus de pr cisions reportez vous Section 4 3 Conversion partir d autres formats page 45 etf21y accepte les options suivantes h help Afficher cette aide o output file G n rer le r sultat dans le fichier file version Afficher le num ro de version Probl mes connus et avertissements La liste des scripts d articulation est incompl te Les mesures vides perturbent etf2ly Les s quences de notes d ornement ne se terminent pas de mani re satisfaisante 4 3 5 Autres formats LilyPond ne prend pas en charge d autre format Cependant certains outils ind pendants per mettent de g n rer des fichiers LilyPond comme indiqu la page Section Facilit s d dition dans Informations g n rales 4 4 Inclusion de partition LilyPond dans d autres programmes Nous allons nous int resser ici diff rents moyens d associer texte et musique en laissant de c t l automatisation gr ce lilypond book 4 4 1 LuaTex Tout comme avec lilyp
101. put OUTDIR pdf FILE lytex LILYBOOK_HTML lilypond book output WEBDIR FILE lytex PDF cd OUTDIR E pdflatex FILE HTML cd WEBDIR amp amp latex2html FILE INDEX cd OUTDIR amp amp makeindex FILE PREVIEW VIEWER OUTDIR FILE pdf E all pdf web keep pdf LILYBOOK_PDF tabulation en d but de ligne PDF tabulation en d but de ligne INDEX tabulation en d but de ligne PDF tabulation en d but de ligne PREVIEW tabulation en d but de ligne web LILYBOOK_HTML tabulation en d but de ligne HTML tabulation en d but de ligne cp R WEBDIR FILE tabulation en d but de ligne BROWSER FILE FILE html amp tabulation en d but de ligne keep pdf cp OUTDIR FILE pdf FILE pdf tabulation en d but de ligne clean rm rf OUTDIR tabulation en d but de ligne web clean rm rf WEBDIR tabulation en d but de ligne archive tar cvvf monprojet tar tabulation en d but de ligne exclude out exclude htmlout A exclude monprojet exclude midi exclude pdf exclude Chapitre 5 Suggestions pour la saisie de fichiers LilyPond 60 MonProjet AVENIR faire que a marche sous Windows Ce makefile n est malheureusement pas op rationnel sous Windows La seule alternative qui s offre aux utilisateurs de Windows consiste cr er un fichier de traitement par lot bat qui contienn
102. qu un fichier source contient des caract res non ASCII et qu il n a pas t enregistr avec un encodage UTF 8 Pour plus de d tails reportez vous au chapitre Section Caract res sp ciaux dans Manuel de notation staff affinities devraient aller en ordre d croissant Cet avertissement est mis lorsque la partition ne comporte pas de port e comme par exemple une feuille de chant avec un contexte ChordName et un contexte Lyrics Ce message dispara tra d s lors que vous autoriserez l un de ces contextes se comporter comme une port e l aide de l instruction override VerticalAxisGroup staff affinity f que vous ins rerez d s sa cr ation Pour plus d information reportez vous la rubrique Section Espacement des lignes rattach es des port es dans Manuel de notation Message d erreur unexpected new Un bloc score ne peut contenir qu une seule expression musicale Si par contre il comporte plusieurs new Staff new StaffGroup ou autres contextes introduits par une commande new qui ne seraient pas born s par des accolades ou des doubles chevrons lt lt gt gt comme ici score Invalide G n re l erreur syntax error unexpected new en frangais erreur de syntaxe new inattendu new Staff new Staff vous obtiendrez ce message d erreur Cette erreur sera vit e d s lors que toutes les instances de new sont born es par des accola
103. r ter directement l entr e standard stdin fournissez un tiret en lieu et place de fichier Le traitement de monfichier ly produira monfichier ps et monfichier pdf Vous pouvez sp cifier plusieurs fichiers la fois ils seront trait s ind pendamment les uns des autres Lorsque monfichier ly contient plus d une section book les fichiers produits partir du deuxi me seront num rot s Par ailleurs la valeur affect e output suffix sera ins r e entre la racine et le num ro Par exemple un fichier racine qui contiendrait define output suffix violon score define output suffix cello score fournira gr ce LilyPond racine violon pdf et racine cello 1 pdf Utilisation de LilyPond avec les fonctionnalit s standard de l interpr teur Dans la mesure o LilyPond est une application qui fonctionne en ligne de commande les fonctionnalit s de l interpr teur utilis pour lancer LilyPond peuvent se r v ler utiles Par exemple Le statut de GUILE n tant pas r initialis apr s traitement d un fichier ly veillez ne pas modifier les r glages par d faut du syst me partir d assertions en Scheme Chapitre 1 Ex cution de lilypond 2 lilypond 1ly traitera tous les fichiers LilyPond pr sents dans le r pertoire en cours Rediriger par exemple dans un fichier ce qui est mis l cran peut s av rer utile lilypond fichier ly 1 gt stdout lo
104. re toute la partie de basse mais laissez basse d comment dans le bloc score basse relative c 4ccc dddd ht Maintenant commencez d commenter petit petit la partie de basse jusqu ce que vous localisiez la ligne qui pose probl me Une autre technique de d bogage tr s utile est la construction d un Section exemple mini maliste dans Informations g n rales 5 5 De la commande make et des fichiers Makefile La plupart des plates formes sur lesquelles tourne LilyPond disposent d un logiciel appel make Ce logiciel va lire un fichier sp cial nomm Makefile qui contient tout ce qu il faut les d pendances entre certains fichiers les instructions successives traiter par le syst me pour aboutir au fichier que vous d sirez obtenir Il pourrait par exemple contenir tout ce qu il faut pour produire ballade pdf et ballade midi partir de ballade 1ly en lan ant LilyPond La cr ation d un Makefile peut se r v ler pertinente pour certains projets que ce soit par simple go t personnel ou bien par respect de ceux qui pourront acc der vos sources Cette mani re de proc der est particuli rement indiqu e lorsque vous travaillez sur un projet de grande envergure impliquant de nombreuses inclusions de fichiers et diff rentes ditions par exemple un conducteur et un mat riel d orchestre complet avec la partition pour le chef et une parti tion s par e pour chacun des pupitr
105. rtir du r pertoire le contenant vous verrez assur ment un message du type La sortie va craser le fichier d entr e Aussi ne saurions nous trop vous conseiller d utiliser l option output 3 6 Mod les pour lilypond book Voici quelques canevas d di s lilypond book Si vous ne savez pas de quoi il retourne lisez le chapitre Chapitre 3 lilypond book page 22 3 6 1 BTEX Vous pouvez inclure des partitions LilyPond dans un document LaTeX documentclass article begin document Des bananes alit es sur du LaTeX begin lilypond relative a 4bcd end lilypond Encore des banalit s LaTeX puis quelques options entre crochets begin lilypond fragment relative 2 quote staffsize 26 verbatim d4 cba end lilypond end document Chapitre 3 Association musique texte avec 1ilypond book 38 3 6 2 Texinfo Un document Texinfo est tout fait capable de comporter des fragments de partition LilyPond Si vous ne le savez pas encore sachez que l int gralit de ce manuel est r dig e en Texinfo input texinfo node Top top Du verbiage a la mode Texinfo lilypond relative a4 bcd Cend lilypond Toujours plus de texte Texinfo puis des options entre crochets lilypond verbatim fragment ragged right d4cba end lilypond bye 3 6 3 html lt DOCTYPE HTML PUBLIC W3C DTD HTML 4 01 Transitional EN gt lt header_tag gt lt HTML gt lt body gt
106. s hyperliens au fichier PDF ou SVG Ces liens sont transmis un URI helper gt ou au navigateur internet qui se charge d ouvrir un diteur de texte l endroit m me o le curseur pointe Afin que cette cha ne de traitement soit pleinement op rationnelle il faut configurer votre visionneur de PDF de fa on ce qu il suive les liens gr ce au script lilypond invoke editor fourni avec LilyPond lilypond invoke editor est un petit programme assistant I se charge d appeler un diteur pour les identifiants de ressource URI de type textedit et un navigateur pour les autres Il teste en outre la variable d environnement EDITOR pour les cas suivant emacs sera alors lanc e la commande emacsclient no wait line column file gvim sera alors lanc e la commande gvim remote line normcolumn file nedit sera alors lanc e la commande nc noask line file La variable d environnement LYEDITOR permet d anticiper cette affectation puisqu elle con tient la commande qui permet de lancer l diteur en tenant compte des valeurs respectives de 4 ile s 4 column s et line s Par exemple emacsclient no wait line s column s file s en variable d environnement LYEDITOR revient au lancement d un client emacs standard Utilisation avec Xpdf Pour Xpdf sous UNIX vous devrez ins rer la ligne suivante dans le fichier xpdfrc soit etc xpdfrc soit dans votre r pertoire personnel HOME xpdfrc urlCo
107. s tels que begin lilypond end lilypond ne sont pas interpr t s par TEX En fait 1ilypond book extrait ces a environnements dans des fichiers accessoires et les traite par LilyPond Il r cup re ensuite les graphiques r sultants et cr e un fichier res dans lequel les macros begin lilypond end lilypond sont alors remplac es par des commandes d inclusion de graphique C est seulement ce moment l que ATEX est lanc bien que TEX aura pr alablement tourn cela aura t en fait sur un document vide et pour calculer certains l ments comme linewidth Probl mes connus et avertissements La commande pageBreak est inop rante dans un environnement begin lilypond end lilypond Il en va de m me pour un certain nombre de variables appartenant au bloc paper Utilisez entre autres un newcommand avec la macrocommande betweenLilyPondSystem dans le pr ambule newcommand betweenLilyPondSystem 1 vspace 36mm linebreak Texinfo La g n ration d un document Texinfo quel que soit le format final s obtient grace aux commandes Texinfo habituelles c est dire texi2pdf texi2dvi ou makeinfo selon le r sultat que vous d sirez obtenir Pour plus de d tails consultez la documentation de Texinfo Options en ligne de commande lilypond book accepte les options suivantes 1 Sachant que vous ne disposez pas forc ment de PDFIATEX et IATEX pour compiler un document IATEX
108. sion to use their names for publicity for or to assert or imply endorsement of any Modified Version 5 COMBINING DOCUMENTS You may combine the Document with other documents released under this License under the terms defined in section 4 above for modified versions provided that you include in the combination all of the Invariant Sections of all of the original documents unmodified and list them all as Invariant Sections of your combined work in its license notice and that you preserve all their Warranty Disclaimers The combined work need only contain one copy of this License and multiple identical Invariant Sections may be replaced with a single copy If there are multiple Invariant Sections with the same name but different contents make the title of each such section unique by adding at the end of it in parentheses the name of the original author or publisher of that section if known or else a unique number Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work Annexe A GNU Free Documentation License 65 In the combination you must combine any sections Entitled History in the various original documents forming one section Entitled History likewise combine any sections Entitled Acknowledgements and any sections Entitled Dedications You must delete all sections Entitled Endorsements 6 COLLECTIONS OF DOCUMENTS You may make a
109. sque la ligne indiqu e ne vous semble pas comporter d l ment litigieux remontez de quelques lignes dans votre code Par ailleurs des diagnostics peuvent tre d clench s n importe quel moment au cours des diff rentes tapes du traitement Par exemple lorsque certaines parties de la source sont trait es plusieurs fois sortie MIDI et sortie imprimable ou qu une m me variable musicale est utilis e dans plusieurs contextes peut appara tre le m me message plusieurs reprises Les diagnostics effectu s une tape avanc e du traitement tels que les contr les de mesure sont aussi susceptibles d apparaitre plusieurs fois Vous trouverez d autres informations sur les erreurs au chapitre Section 1 4 Quelques erreurs des plus courantes page 14 Chapitre 1 Ex cution de lilypond 14 1 4 Quelques erreurs des plus courantes Les conditions amenant aux erreurs qui suivent sont fr quentes bien qu elles ne soient pas videntes ni facilement localisables Nous esp rons que ces explications vous aideront les r soudre plus facilement La musique d borde de la page Lorsque la musique s panche au del de la marge droite ou bien semble anormalement com prim e la raison en est le plus souvent une note a la dur e erron e cela finit par provoquer le d bordement de la derni re note d une mesure Rien ne s oppose ce que la derni re note d une mesure ne s arr te avant la barre de mesure
110. texidocLANGUE dans l ent te du fichier toto ly entra nera la reproduction par l appel lilypond header texidocLANGUE du contenu de toto texidocLANGUE en lieu et place de celui de toto texidoc doctitle Option disponible uniquement avec Texinfo Cette option fonctionne selon le m me principe que l option texidoc lorsqu un fichier toto ly contient dans son header une variable doctitle et que lilypond est appel avec l option doctitle le contenu de cette variable une simple ligne de texte sera recopi dans un fichier toto doctitle puis ins r dans le document Texinfo sous la forme lydoctitle texte lydoctitle doit faire l objet d une macro d finie dans le document Texinfo Il en va de l option doctitle comme de l option texidoc en mati re d adaptation en langue trang re nogettext Option disponible uniquement pour Texinfo Commentaires et noms de variable ne seront pas traduits dans la recopie textuelle du code printfilename Lorsqu un fichier source LilyPond est inclus l aide de lilypondfile le nom du fichier sera reproduit juste au dessus de l extrait Si le r sultat est un fichier HTML il s agira alors d un lien Seul le nom du fichier est imprim autrement dit le chemin d acc s au fichier est tronqu 3 4 Utilisation de lilypond book lilypond book produit un fichier qui aura selon le format de sortie sp cifi l extension tex texi html ou xml Les fichiers
111. tion with no Invariant Sections A copy of the license is included in the section entitled GNU Free Documentation License Pour LilyPond version 2 19 31 Table des mati res 1 Ex cution de lady pond 22 es er RS nas e 1 LE Utilisation habit ell uns oes pie Manet nt a te ae Ee 1 1 2 Utilisation en ligne de commande 1 Lancement de LilyPond ys fem anne mine E eae E dat ee Ge ne 1 Utilisation de LilyPond avec les fonctionnalit s standard de l interpr teur 1 Options basiques de lilypond 2 Options avanc es de lilypond 5 Variables d environnement 2 0 c cece ccc et eee eee eden tebe eenenes 10 Ex cution de LilyPond en mode prot g 2 11 123 Messages d erreurs avenant dupe ded Ben A nd rte eme GO ae 12 1 4 Quelques erreurs des plus courantes 14 La musique d borde de la page 20 14 Apparition d une port e suppl mentaire 14 Message d erreur Unbound variable 15 Message d erreur FT_Get_Glyph_Name 15 staff affinities devraient aller en ordre d croissant 1
112. tous ses sous r pertoires les fichiers convertis se trouveront leur emplacement d orignie tout comme les fichiers originels apr s renommage Cette commande bien ou effective uniquement dans un terminal devrait etre fonctnionnelle aussi pour les utilisateurs de MacOS X Les utilisateurs de windows utiliseront l instruction forfiles s M ly c cmd c convert ly py e fichier Par ailleurs il est possible de sp cifier de mani re explicite le chemin d acc s au dossier comportant des sous r pertoires o se trouvent les fichiers sources l aide de l option p forfiles s p C Documents MesPartitions M ly c cmd c convert ly py e fichier Dans le cas o ce chemin d acc s comporte des espaces l int gralit de ce chemin devra tre born par des guillemets informatiques forfiles s p C Documents Mes Partitions M ly c cmd c convert ly py e fich 2 3 Options en ligne de commande pour convert ly L utilitaire convert ly se lance de la mani re suivante convert ly option fichier Vous pouvez utiliser les options d diff version update actualise la valeur de version uniquement si le fichier a t effectivement modifi Un num ro de version instable sera a arrondi au niveau de la version stable suivante moins que celui ci ne soit sup rieur la version cible En l absence de cette option ou bien si une conversion quelle qu elle soit a modifi le fichier l
113. ts or to conflict in title with any Invariant Section O Preserve any Warranty Disclaimers If the Modified Version includes new front matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document you may at your option designate some or all of these sections as invariant To do this add their titles to the list of Invariant Sections in the Modified Version s license notice These titles must be distinct from any other section titles You may add a section Entitled Endorsements provided it contains nothing but endorse ments of your Modified Version by various parties for example statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard You may add a passage of up to five words as a Front Cover Text and a passage of up to 25 words as a Back Cover Text to the end of the list of Cover Texts in the Modified Version Only one passage of Front Cover Text and one of Back Cover Text may be added by or through arrangements made by any one entity If the Document already includes a cover text for the same cover previously added by you or by arrangement made by the same entity you are acting on behalf of you may not add another but you may replace the old one on explicit permission from the previous publisher that added the old one The author s and publisher s of the Document do not by this License give permis
114. whoever possesses a copy of it In addition you must do these things in the Modified Version A Use in the Title Page and on the covers if any a title distinct from that of the Document and from those of previous versions which should if there were any be listed in the History section of the Document You may use the same title as a previous version if the original publisher of that version gives permission B List on the Title Page as authors one or more persons or entities responsible for authorship of the modifications in the Modified Version together with at least five of the principal authors of the Document all of its principal authors if it has fewer than five unless they release you from this requirement C State on the Title page the name of the publisher of the Modified Version as the publisher D Preserve all the copyright notices of the Document E Add an appropriate copyright notice for your modifications adjacent to the other copy right notices F Include immediately after the copyright notices a license notice giving the public permission to use the Modified Version under the terms of this License in the form shown in the Addendum below G Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document s license notice H Include an unaltered copy of this License I Preserve the section Entitled History Preserve its Title and add to it an
115. y accepte les options suivantes a absolute Rendu en hauteurs absolues h help Afficher un r sum des utilisations l language LANG Utiliser une autre d finition linguistique LANG comme par exemple deutsch pour des noms de notes en allemand loglevel loglevel D termine le degr de verbosit loglevel Les valeurs autoris es sont NONE ERROR WARNING PROGRESS par d faut et DEBUG 1xml Utiliser le paquetage Python 1xml etree moins gourmand en m moire et temps de calcul pour effectuer l analyse XML m midi Ajouter un bloc midi nd no articulation directions Ne pas convertir la direction _ ou des articulations nuances etc no beaming Ne pas convertir les informations de ligature laisser LilyPond g rer les ligatures automatiquement o output file G n rer le r sultat dans le fichier fichier S il n est pas d termin ce sera fichier xml ly produira le r sultat sur la sortie standard stdout r relative Rendu en hauteurs relatives mode par d faut Chapitre 4 Programmes externes 48 v verbose Mode verbeux version Afficher le num ro de version Z compressed Le fichier d entr e est un fichier MusicX ML zipp 4 3 3 Utilisation de abc2ly Note Ce programme ne b n ficie d aucune maintenance Il est susceptible d tre supprim des versions futures de LilyPond ABC est un format relativement simple bas sur A
116. z actuellement Cet agencement peut se faire la main par importation d un graphique PostScript dans le traitement de texte Les d veloppeurs de LilyPond ont cependant cr un outil permettant d automatiser ces op rations pour ce qui concerne les documents HTML Tex Texinfo et DocBook Un script lilypond book se charge d extraire les fragments de musique puis de les mettre en forme avant de renvoyer la a partition correspondante Voici un court exemple utilisable avec ATEX Dans la mesure o il est suffisamment parlant nous nous abstiendrons de le commenter Fichier d entr e documentclass a4paper article begin document Un document destin tre trait par verb lilypond book peut tout fait m langer de la musique et du texte Par exemple begin lilypond relative c 2 e2 tuplet 3 2 f8 a b a2 ei d end lilypond Les options sont indiqu es entre crochets begin lilypond fragment quote staffsize 26 verbatim c 4 16 end lilypond Des extraits plus cons quents peuvent faire l objet d un fichier Chapitre 3 Association musique texte avec 1ilypond book ind pendant alors inclus avec verb lilypondfile lilypondfile quote noindent screech and boink ly Si besoin remplacez file screech and boink ly par n importe quel fichier file ly qui se trouve dans le m me r pertoire que le pr sent fichier end document Traitement 23 Enregistrez c

Download Pdf Manuals

Related Search

Related Contents

MEX-N4000BT - Sony Europe  User Manual  (LISTOS)ESManual de instrucciones ECSA  Furuno GP-1600F User's Manual  「取扱説明書」を必丶ず読んで正しい使用方法で使用しましょう。  Manuel d`utilisation Visiteurs  

Copyright © All rights reserved. Failed to retrieve file