1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: c299f84d574ac9b97ab7ffbb640b5c3a1cdca5cc
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @c Translators: Jean-Charles Malahieude
15 @node Programmes externes
16 @chapter Programmes externes
17 @translationof External programs
19 LilyPond peut interagir avec d'autres programmes, selon différentes
24 * LilyPond et les éditeurs de texte::
25 * Conversion à partir d'autres formats::
26 * Inclusion de partition LilyPond dans d'autres programmes::
27 * Inclusion du travail des autres::
32 @section Pointer-cliquer
33 @translationof Point and click
35 Le pointer-cliquer ajoute des liens au sein des documents pdf, pour
36 certains événements musicaux.
39 * Activation du pointer-cliquer::
40 * Pointer-cliquer sélectif::
43 @node Activation du pointer-cliquer
44 @unnumberedsubsec Activation du pointer-cliquer
45 @translationof Enabling point and click
47 @cindex pointer-cliquer
48 @cindex point and click
50 Le pointer-cliquer (@emph{point and click}) permet de se retrouver
51 directement dans le fichier source, à la note que l'on pointe dans le
52 visionneur de PDF. Ceci facilite grandement le repérage des erreurs à
53 partir du fichier imprimable.
55 Lorsque cette fonctionnalité est active, LilyPond ajoute des hyperliens
56 au fichier PDF. Ces liens sont transmis au navigateur internet qui se
57 charge d'ouvrir un éditeur de texte à l'endroit même où le curseur
60 Afin que cette chaîne de traitement soit pleinement opérationnelle, il
61 faut configurer votre visionneur de PDF de façon à ce qu'il suive les
62 liens grâce au script @file{lilypond-invoke-editor} fourni avec
65 Pour Xpdf, sous UNIX, vous devrez insérer la ligne suivante dans
66 le fichier @file{xpdfrc} -- soit @file{/etc/xpdfrc}, soit dans votre
67 répertoire personnel @file{.xpdfrc}.
70 urlCommand "lilypond-invoke-editor %s"
73 @file{lilypond-invoke-editor} est un petit programme assistant. Il
74 se charge d'appeler un éditeur pour les identifants de ressource
75 (@emph{URI}) de type @code{textedit}, et un navigateur pour les autres.
76 Il teste en outre la variable d'environnement @code{EDITOR} pour les cas
81 sera alors lancée la commande
83 emacsclient --no-wait +@var{line}:@var{column} @var{file}
87 sera alors lancée la commande
89 gvim --remote +:@var{line}:norm@var{column} @var{file}
93 sera alors lancée la commande
95 nc -noask +@var{line} @var{file}'
99 La variable d'environnement @code{LYEDITOR} permet d'anticiper cette
100 affectation, puisqu'elle contient la commande qui permet de lancer
101 l'éditeur en tenant compte des valeurs respectives de @code{%(file)s},
102 @code{%(column)s} et@code{%(line)s}. Par exemple,
105 emacsclient --no-wait +%(line)s:%(column)s %(file)s
109 en variable d'environnement @code{LYEDITOR} revient au lancement d'un
110 client emacs standard.
113 @cindex ficher de sortie, taille
115 @cindex taille du ficher de sortie
117 L'option pointer-cliquer accroît la taille des fichiers de manière
118 significative. Afin de réduire la taille des fichiers PDF et PS, il est
119 toujours possible de désactiver le pointer-cliquer en ajoutant
126 dans le fichier @file{.ly}. Il peut alors être activé de manière
133 Le pointer-cliquer peut aussi être désactivé au moment de la compilation
134 en ligne de commande@tie{}:
137 lilypond -dno-point-and-click file.ly
140 @warning{Lorsqu'un fichier LilyPond est destiné à être redistribué,
141 pensez à désactiver le pointer-cliquer, de telle sorte que les chemins
142 d'accès et autres informations propres à votre système ne se retrouvent
143 pas inclus dans le fichier @file{.pdf}.}
146 @node Pointer-cliquer sélectif
147 @unnumberedsubsec Pointer-cliquer sélectif
148 @translationof Selective point-and-click
150 Pour certaines applications interactives, il est parfois préférable de
151 limiter la fonctionnalité du pointer-cliquer à quelques éléments
152 seulement. Par exemple, si vous avez l'intention de créer une
153 application lançant l'audio et la vidéo à partir d'une note en
154 particulier, il serait mal venu qu'un clic sur la note vous amène à
155 l'altération ou une liaison qui l'affecterait.
157 Les événements générateurs de lien peuvent se gérer@tie{}:
161 En dur dans votre fichier @file{.ly} :
164 \pointAndClickTypes #'note-event
173 #(ly:set-option 'point-and-click 'note-event)
180 En ligne de commande :
183 lilypond -dpoint-and-click=note-event example.ly
188 Plusieurs types d'événement peuvent être mentionnés@tie{}:
192 En dur dans votre fichier @file{.ly} :
195 \pointAndClickTypes #'(note-event dynamic-event)
204 #(ly:set-option 'point-and-click '(note-event dynamic-event))
211 En ligne de commande :
215 -e"(ly:set-option 'point-and-click '(note-event dynamic-event))" \
223 @node LilyPond et les éditeurs de texte
224 @section LilyPond et les éditeurs de texte
225 @translationof Text editor support
230 @cindex modes, éditeur
231 @cindex syntaxe, coloration
232 @cindex coloration syntaxique
234 Certains éditeurs de texte prennent en charge LilyPond.
244 @unnumberedsubsec Mode Emacs
245 @translationof Emacs mode
247 Emacs dispose d'un @file{lilypond-mode} qui fournit l'autocomplétion
248 des mots-clés, l'indentation, les appariements spécifiques à LilyPond,
249 la coloration syntaxique, ainsi que des raccourcis pour compiler et
250 consulter les manuels de LilyPond en mode info. Si le
251 @file{lilypond-mode} n'était pas installé sur votre système, procédez
254 Le répertoire @file{elisp} inclus dans les sources contient aussi un
255 mode pour saisir la musique et lancer LilyPond. Faites @command{make
256 install} pour l'installer dans votre @var{elispdir}. Le fichier
257 @file{lilypond-init.el} devrait trouver sa place dans
258 @var{load-path}@file{/site-start.d/} ou bien ajouté à votre
259 @file{~/.emacs} ou @file{~/.emacs.el}.
261 En tant que simple utilisateur, vous pouvez toujours ajouter votre
262 propre répertoire (par exemple @file{~/site-lisp/}) à votre
263 @var{load-path} en ajoutant la ligne suivante -- modifiée en conséquence
264 -- à votre @file{~/.emacs}@tie{}:
266 @c any reason we do not advise: (push "~/site-lisp" load-path)
268 (setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))
273 @unnumberedsubsec Mode Vim
274 @translationof Vim mode
276 En ce qui concerne @uref{http://@/www@/.vim@/.org,Vim}, LilyPond fournit
277 tout le nécessaire pour gérer la coloration syntaxique et l'indentation.
278 Le mode spécifique à Vim doît être indiqué dans le fichier
279 @file{$HOME/.vimrc}. Localisez ce fichier, ou créez-le, et
280 ajoutez-y les trois lignes suivantes@tie{}:
284 set runtimepath+=/usr/local/share/lilypond/current/vim/
289 Si LilyPond est installé dans un autre répertoire que
290 @file{/usr/local/}, modifiez ce chemin en conséquence. Pour de plus
291 amples détails, consultez @rlearning{Autres sources de documentation}.
294 @node Autres éditeurs
295 @unnumberedsubsec Autres éditeurs
296 @translationof Other editors
298 LilyPond est pris en charge par d'autres éditeurs, aussi bien en mode
299 texte qu'avec une interface graphique. Dans la mesure où leurs fichiers
300 de configuration ne sont pas fournis avec LilyPond, nous vous invitons à
301 consulter leur documentation pour plus d'information. Certains de ces
302 éditeurs sont mentionnés à la page @rweb{Facilités d'édition}.
305 @node Conversion à partir d'autres formats
306 @section Conversion à partir d'autres formats
307 @translationof Converting from other formats
309 La musique peut aussi être récupérée par importation d'un autre
310 format. Ce chapitre passe en revue les différents outils prévus à cet
311 effet et inclus dans la distribution. Il existe d'autres outils qui
312 permettent de générer du code LilyPond, comme par exemple des
313 séquenceurs en mode graphique ou des convertisseurs XML. Pour plus
314 de détails, rendez-vous sur le @uref{http://@/lilypond@/.org,site}.
316 Il s'agit de programmes distincts de @command{lilypond} qui se lancent
317 en ligne de commande. Pour plus de précisions, reportez-vous au
318 chapitre @ref{Utilisation en ligne de commande}. Si vous utilisez MacOS
319 10.3 ou 10.4 et recontrez quelque problème avec l'un de ces scripts,
320 comme @code{convert-ly}, reportez-vous à la page @rweb{MacOS X}.
324 Les développeurs ne sont malheureusement pas suffisament nombreux et
325 disponibles pour maintenir à jour ces programmes, considérez-les donc
326 @emph{en l'état}. Nous acceptons les patches avec plaisir, mais il y a
327 peu de chance pour que nous soyons en mesure de résoudre les bogues de
331 * Utilisation de midi2ly:: importation de musique au format MIDI.
332 * Utilisation de musicxml2ly:: importation de partitions au format MusicXML.
333 * Utilisation d'abc2ly:: importation de partitions au format ABC.
334 * Utilisation d'etf2ly:: importation de partitions Finale.
340 @node Utilisation de midi2ly
341 @subsection Utilisation de @code{midi2ly}
342 @translationof Invoking midi2ly
346 @command{midi2ly} traduit un fichier MIDI de Type@tie{}1 en un fichier
349 MIDI (Music Instrument Digital Interface) constitue un standard pour
350 les instruments. Il spécifie le cablage, un protocole série et un
351 format de fichier. Le format de fichier MIDI est de ce fait un format
352 standard pour exporter de la musique à partir d'autres programmes, et
353 cette faculté prend tout son intérêt lorsqu'un programme dispose d'un
354 convertisseur capable d'importer directement un fichier.
356 @command{midi2ly} convertit les pistes en contextes de portée
357 (@rinternals{Staff}) et les canaux en contextes de voix
358 (@rinternals{Voice}). Les hauteurs sont rendues en mode relatif, et
359 les durées spécifiées lorsque nécessaire.
361 Vous pouvez enregistrer un fichier MIDI grâce à un clavier
362 électronique et ensuite le convertir en fichier @file{.ly}. Néanmoins
363 le rythme humain n'a pas une précision suffisante pour qu'une
364 conversion MIDI à ly ne se fasse sans surprise. En le couplant à une
365 quantisation (options @option{-s} et @option{-d}), @command{midi2ly}
366 tente de compenser dans la mesure du possible ces problèmes de
367 temporisation. C'est la raison pour laquelle le recours à
368 @command{midi2ly} n'est pas recommandé pour des fichiers midi générés
371 Pour le lancer en ligne de commande, procédez ainsi@tie{}:
374 midi2ly [@var{option}]@dots{} @var{fichier-midi}
377 Notez bien que, par @qq{ligne de commande}, nous parlons de la ligne de
378 commande du système. Pour plus de précisions, reportez-vous à
379 @ref{Conversion à partir d'autres formats}.
381 @command{midi2ly} accepte les options suivantes@tie{}:
384 @item -a, --absolute-pitches
385 Rendu en hauteurs absolues.
387 @item -d, --duration-quant=@var{DUR}
388 Quantiser les durées à partir de @var{DUR}.
390 @item -e, --explicit-durations
391 Rendu explicite des durées.
394 Afficher un résumé des utilisations.
396 @item -k, --key=@var{acc}[:@var{minor}]
397 Déterminer la tonalité par défaut. @math{@var{acc} > 0} fixe le
398 nombre de dièses, @math{@var{acc} < 0} le nombre de bémols. Une
399 tonalité mineure est spécifiée par l'emploi de @code{:1}.
401 @item -o, --output=@var{file}
402 Générer le résultat dans le fichier @var{file}.
404 @item -s, --start-quant=@var{DUR}
405 Quantiser le début des notes sur @var{DUR}.
407 @item -t, --allow-tuplet=@var{DUR}*@var{NUM}/@var{DEN}
408 Accepter des n-olets de valeur @var{DUR}*@var{NUM}/@var{DEN}.
414 Afficher le numéro de version.
417 Afficher les mentions de garantie et de copyright.
419 @item -x, --text-lyrics
420 Interpréter le texte comme des paroles.
426 Le tuilage en arpège ne sera pas rendu correctement. La première note
427 sera lue et les suivantes ignorées. Affectez-leur une durée unique et
428 ajoutez une indication de phrasé ou de pédale.
431 @node Utilisation de musicxml2ly
432 @subsection Utilisation de @code{musicxml2ly}
433 @translationof Invoking musicxml2ly
437 @uref{http://@/www.@/musicxml@/.org/,MusicXML} est un
438 dialecte XML pour représenter la notation musicale.
440 @command{musicxml2ly} extrait, à partir d'un fichier MusicXML, les
441 notes, articulations, structure de la partition, paroles, etc.
442 et les écrit dans un fichier @file{.ly}. Il se lance en ligne de
445 Pour le lancer en ligne de commande, procédez ainsi :
447 musicxml2ly [@var{option}]@dots{} @var{fichier-xml}
450 Notez bien que, par @qq{ligne de commande}, nous parlons de la ligne de
451 commande du système. Pour plus de précisions, reportez-vous à
452 @ref{Conversion à partir d'autres formats}.
454 Si le nom du fichier est @file{-}, @command{musicxml2ly} lira
455 directement à partir de la ligne de commande.
457 @command{musicxml2ly} accepte les options suivantes@tie{}:
461 Rendu en hauteurs absolues.
464 Afficher un résumé des utilisations.
466 @item -l, --language=LANG
467 Utiliser une autre définition liguistique (LANG), comme par exemple
468 @var{deutsch} pour des noms de notes en allemand.
470 @item --loglevel=@var{loglevel}
471 Détermine le degré de verbosité à @var{loglevel}. Les valeurs
472 autorisées sont @code{NONE}, @code{ERROR}, @code{WARNING},
473 @code{PROGRESS} (par defaut) et @code{DEBUG}.
476 Utiliser le paquetage Python @code{lxml.etree}, moins gourmand en
477 mémoire et temps de calcul, pour effectuer l'annalyse XML.
479 @item --nd --no-articulation-directions
480 Ne pas convertir la direction (@code{^}, @code{_} ou @code{-}) des
481 articulations, nuances, etc.
484 Ne pas convertir les informations de ligature@tie{}; laisser LilyPond
485 gérer les ligatures automatiquement.
487 @item -o,--output=@var{file}
488 Générer le résultat dans le fichier @var{fichier}. S'il n'est pas
489 déterminé, ce sera @var{fichier-xml}@file{.ly}@tie{}; @file{-}
490 produira le résultat sur la sortie standard (@var{stdout}).
493 Rendu en hauteurs relatives (mode par défaut).
499 Afficher le numéro de version.
501 @item -z,--compressed
502 Le fichier d'entrée est un fichier MusicXML zippé.
506 @node Utilisation d'abc2ly
507 @subsection Utilisation de @code{abc2ly}
508 @translationof Invoking abc2ly
510 @warning{Ce programme ne bénéficie d'aucune maintenance. Il est
511 susceptible d'être suprimé des versions futures de LilyPond.}
515 ABC est un format relativement simple basé sur l'ASCII. Sa
516 description est disponible sur le
517 @uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/learn@/.html,site
520 @command{abc2ly} traduit du format ABC au format LilyPond.
522 Pour le lancer en ligne de commande, procédez ainsi@tie{}:
525 abc2ly [@var{option}]@dots{} @var{fichier-abc}
528 @command{abc2ly} accepte les options suivantes@tie{}:
531 @item -b,--beams=None
532 Préserver la notion de lien de croches propre à ABC.
535 Afficher un résumé des utilisations.
537 @item -o,--output=@var{file}
538 Générer le résultat dans le fichier @var{file}.
541 Être strict sur la réussite.
544 Afficher le numéro de version.
547 Il est possible d'ajouter des bribes de code LilyPond dans un fichier
548 source ABC. Ainsi, l'assertion
551 %%LY voices \set autoBeaming = ##f
554 aura pour conséquence d'insérer le texte qui suit le mot-clé @qq{voices}
555 dans la voix correspondante du fichier LilyPond.
560 %%LY slyrics more words
563 placera le texte suivant le mot-clé @qq{slyrics} dans une ligne de
569 Le standard ABC n'est pas si @qq{standard} que cela. Pour des
570 fonctionnalités étendues, comme la polyphonie, existent différentes
573 Un fichier comportant plusieurs morceaux ne peut être converti.
575 ABC synchronise paroles et musique en début de ligne@tie{};
576 @command{abc2ly} ne le fait pas.
578 @command{abc2ly} ignore les ligatures ABC.
581 @node Utilisation d'etf2ly
582 @subsection Utilisation de @code{etf2ly}
583 @translationof Invoking etf2ly
585 @warning{Ce programme ne bénéficie d'aucune maintenance. Il est
586 susceptible d'être suprimé des versions futures de LilyPond.}
591 @cindex Coda Technology
593 ETF (Enigma Transport Format) est l'un des formats utilisés par le
594 logiciel Finale, édité par Coda Music Technology. @command{etf2ly}
595 convertit partiellement les fichiers ETF en fichiers source LilyPond.
598 Pour le lancer en ligne de commande, procédez ainsi@tie{}:
601 etf2ly [@var{option}]@dots{} @var{fichier-etf}
604 Notez bien que, par @qq{ligne de commande}, nous parlons de la ligne de
605 commande du système. Pour plus de précisions, reportez-vous à
606 @ref{Conversion à partir d'autres formats}.
608 @command{etf2ly} accepte les options suivantes@tie{}:
614 @item -o, --output=@var{file}
615 Générer le résultat dans le fichier @var{file}.
618 Afficher le numéro de version.
624 La liste des scripts d'articulation est incomplète. Les mesures vides
625 perturbent @command{etf2ly}. Les séquences de notes d'ornement ne se
626 terminent pas de manière satisfaisante.
630 @subsection Autres formats
631 @translationof Other formats
633 @cindex programmes externes générant des fichiers LilyPond
635 LilyPond ne prend pas en charge d'autre format. Cependant, certains
636 outils indépendants permettent de générer des fichiers LilyPond, comme
637 indiqué à la page @rweb{Facilités d'édition}.
640 @node Inclusion de partition LilyPond dans d'autres programmes
641 @section Inclusion de partition LilyPond dans d'autres programmes
642 @translationof LilyPond output in other programs
644 Nous allons nous intéresser ici à différents moyens d'associer texte
645 et musique, en laissant de côté l'automatisation grâce à
646 @command{lilypond-book}.
649 * Extraction de plusieurs fragments d'une grande partition::
650 * Insertion du résultat de LilyPond dans OpenOffice.org::
651 * Insertion du résultat de LilyPond dans d'autres programmes::
655 @node Extraction de plusieurs fragments d'une grande partition
656 @unnumberedsubsec Extraction de plusieurs fragments d'une grande partition
657 @translationof Many quotes from a large score
659 Si d'aventure vous deviez recopier un certain nombre d'extraits d'une
660 même partition, vous pouvez recourir à @qq{l'emporte pièce} -- la
661 fonction @emph{clip systems} -- comme indiqué au chapitre
662 @ruser{Extraction de fragments musicaux}.
665 @node Insertion du résultat de LilyPond dans OpenOffice.org
666 @unnumberedsubsec Insertion du résultat de LilyPond dans OpenOffice.org
667 @translationof Inserting LilyPond output into OpenOffice.org
669 @cindex OpenOffice.org
671 @uref{http://@/ooolilypond@/.sourceforge@/.net@/,OOoLilyPond} permet
672 d'insérer directement des partitions LilyPond dans OpenOffice.org.
675 @node Insertion du résultat de LilyPond dans d'autres programmes
676 @unnumberedsubsec Insertion du résultat de LilyPond dans d'autres programmes
677 @translationof Inserting LilyPond output into other programs
679 Dans le cas où vous cherchez à insérer le résultat de LilyPond dans
680 d'autres programmes, utilisez @code{lilypond} plutôt que
681 @code{lilypond-book}. Chaque extrait devra être généré séparément avant
682 d'être inséré dans votre document. De très nombreux programmes sont
683 capables de contenir le résultat de LilyPond, que ce soit au format
684 @file{PNG}, @file{EPS} ou @file{PDF}.
686 Les options suivantes vous permettront de réduire notablement les
687 contours de l'image LilyPond@tie{}:
695 bookTitleMarkup = ##f
696 scoreTitleMarkup = ##f
702 En procédant comme ci-après, vous obtiendrez des fichiers images@tie{}:
707 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts monfichier.ly
711 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts --png monfichier.ly
713 PNG avec transparence
715 lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts \
716 -dpixmap-format=pngalpha --png monfichier.ly
720 @node Inclusion du travail des autres
721 @section Inclusion du travail des autres
722 @translationof Independent includes
724 Certains ont écrit des lignes et des lignes de code -- souvent bien
725 utiles -- qui peuvent servir à différents projets. En attendant le jour
726 où elles pourraient faire partie intégrante de LilyPond, vous pouvez
727 toujours les télécharger et les utiliser avec la commande
732 * MIDI et articulations::
736 @node MIDI et articulations
737 @subsection MIDI et articulations
738 @translationof MIDI articulation
740 LilyPond sait produire des fichiers MIDI, principalement dans le but de
741 @qq{contrôle-qualité} -- heureux détenteurs d'une oreille absolue -- de
742 ce qui a été saisi. Ne seront toutefois reproduits, en plus des notes
743 et durées, que les nuances et tempi explicites.
745 Le projet @emph{articulate} (site en anglais) s'est donné pour objectif
746 de reproduire plus d'informations dans le MIDI. Les notes qui ne sont
747 pas liées sont ainsi raccourcies dans le but @qq{d'articuler}. Ce
748 raccourcissement dépend de l'articulation appliquée à la note@tie{}: un
749 @emph{staccato} raccourcira la note de moitié, un @emph{tenuto} lui
750 gardera sa durée entière@dots{} Ce script réalise aussi les trilles et
751 @emph{grupettos} et compte bien traiter d'autres ornements tels que les
755 @uref{http://@/www@/.nicta@/.com@/.au/@/people/@/chubbp/@/articulate}
761 Ce projet ne peut traiter que ce qu'il connaît@tie{}: tout ce qui peut
762 ressembler à un @emph{markup} -- et donc pas à la propriété d'une note