]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/user/converters.itely
lilypond-book robustness: ensure EOL at the end of @verbatim
[lilypond.git] / Documentation / fr / user / converters.itely
index 05860428ea7cf3539d7ab621c53bb27097d3fda4..58fa6f00fd8649c15f395dbcf3071ca45c3ae0df 100644 (file)
@@ -1,13 +1,15 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
-@c This file is part of lilypond.tely
+@c This file is part of lilypond-program.tely
 @ignore
-    Translation of GIT committish: d56aa8181857c5feabf303ae88e716eba069f0a9
-
+    Translation of GIT committish: e2070eadd7d3d7a87450aab195a48945ee0b144a
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
+@c \version "2.12.0"
+
+@c Translators: Jean-Charles Malahieude
 
 @node Converting from other formats
 @chapter Converting from other formats
@@ -16,26 +18,30 @@ 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
 permettent de générer du code LilyPond, comme par exemple des
-seéquenceurs en mode graphique ou des convertisseurs XML.  Pour plus
+séquenceurs en mode graphique ou des convertisseurs XML.  Pour plus
 de détails, rendez-vous sur le @uref{http://@/lilypond@/.org,site}.
 
-Il s'agit de programmes distinct de lilypond qui se lancent en ligne
-de commande.  Par @qq{ligne de commande}, nous parlons de la ligne de
-commande du système.  Les utilisateurs de Windows parlent de
-@qq{commande MSDos} ou @qq{invite de commande}, les utilisateurs
-d'OSX de @qq{terminal} ou de @qq{console}.  Concernant OSX,
-veuillez consuler @ref{Notes for the MacOS X app}.
-
-Décrire l'utilisation du système n'est pas le propos de ce manuel.
-Aussi nous invitons ceux qui ne seraient pas familiers de la ligne de
-commande, à consulter d'autres documentations sur ce sujet. 
-
-@menu 
-* Invoking midi2ly::
-* Invoking etf2ly::
-* Invoking musicxml2ly::
-* Invoking abc2ly::
-* Generating LilyPond files::
+Il s'agit de programmes distincts de @command{lilypond} qui se lancent
+en ligne de commande.  Pour plus de précisions, reportez-vous au
+chapitre @ref{Command-line usage}.  Si vous utilisez MacOS 10.3 ou 10.4
+et recontrez quelque problème avec l'un de ces scripts, comme
+@code{convert-ly}, reportez-vous au chapitre @ref{Setup for MacOS X}. 
+
+@knownissues
+
+Les développeurs ne sont malheureusement pas suffisament nombreux et
+disponibles pour maintenir à jour ces programmes, considérez-les donc
+@emph{en l'état}.  Nous acceptons les patches avec plaisir, mais il y a
+peu de chance pour que nous soyons en mesure de résoudre les bogues de
+ces programmes.
+
+@menu
+* Invoking midi2ly::            importation de musique au format MIDI.
+* Invoking musicxml2ly::        importation de partitions au format MusicXML.
+* Invoking abc2ly::             importation de partitions au format ABC.
+* Invoking etf2ly::             importation de partitions Finale.
+* Generating LilyPond files::   interfaces graphiques, outils de
+                                transcription et de composition algorithmique.
 @end menu
 
 
@@ -56,11 +62,11 @@ cette faculté prend tout son intérêt lorsqu'un programme dispose d'un
 convertisseur capable d'importer directement un fichier.
 
 @command{midi2ly} convertit les pistes en contextes de portée
-(@internalsref{Staff}) et les canaux en contextes de voix
-(@internalsref{Voice}).  Les hauteurs sont rendues en mode relatif, et
-les durées spécifiées lorsque nécessaires.
+(@rinternals{Staff}) et les canaux en contextes de voix
+(@rinternals{Voice}).  Les hauteurs sont rendues en mode relatif, et
+les durées spécifiées lorsque nécessaire.
 
-Vous pouvez enregistrer un fichier MIDI grace à un clavier
+Vous pouvez enregistrer un fichier MIDI grâce à un clavier
 électronique et ensuite le convertir en fichier @file{.ly}.  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
@@ -73,12 +79,12 @@ manuellement.
 
 Pour le lancer en ligne de commande, procédez ainsi :
 @example
-midi2ly [@var{option}]@dots{} @var{midi-file}
+midi2ly [@var{option}]@dots{} @var{fichier-midi}
 @end example
 
 Notez bien que, par @qq{ligne de commande}, nous parlons de la ligne de
-commande du système. Pour plus de détails, voir @ref{Converting from
-other formats}.
+commande du système.  Pour plus de précisions, reportez-vous à
+@ref{Command-line usage}. 
 
 @command{midi2ly} accepte les options suivantes :
 
@@ -97,14 +103,14 @@ Afficher un résumé des utilisations.
 
 @item -k, --key=@var{acc}[:@var{minor}]
 Déterminer la tonalité par défaut.  @math{@var{acc} > 0} fixe le
-nombre de dièses ; @math{@var{acc} < 0} le nombre de bémols.  Un ton
-mineur est spécifié par l'emploi de @samp{:1}.
+nombre de dièses ; @math{@var{acc} < 0} le nombre de bémols.  Une
+tonalité mineure est spécifiée par l'emploi de @code{:1}.
 
 @item -o, --output=@var{file}
 Générer le résultat dans le fichier @var{file}.
 
 @item -s, --start-quant=@var{DUR}
-Quantiser le début des notes sur DUR.
+Quantiser le début des notes sur @var{DUR}.
 
 @item -t, --allow-tuplet=@var{DUR}*@var{NUM}/@var{DEN}
 Accepter des n-olets de valeur @var{DUR}*@var{NUM}/@var{DEN}.
@@ -123,108 +129,112 @@ Interpréter le texte comme des paroles.
 @end table
 
 
-@refbugs
+@knownissues
 
 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.
 
 
-@node Invoking etf2ly
-@section Invoking @command{etf2ly}
+@node Invoking musicxml2ly
+@section Invoking @code{musicxml2ly}
 
-@cindex ETF
-@cindex enigma
-@cindex Finale
-@cindex Coda Technology
+@cindex MusicXML
 
-ETF (Enigma Transport Format) est l'un des formats utilisés par le
-logiciel Finale, édité par Coda Music Technology.  @command{etf2ly}
-convertit partiellement les fichiers ETF en fichiers source LilyPond.
+@uref{http://@/www.@/musicxml@/.org/,MusicXML} est un
+dialecte XML pour représenter la notation musicale.
 
+@command{musicxml2ly} extrait, à partir d'un fichier MusicXML, les
+notes, articulations, structure de la partition, paroles, etc. 
+et les écrit dans un fichier @var{.ly}.  Il se lance en ligne de
+commande.
 
 Pour le lancer en ligne de commande, procédez ainsi :
 @example
-midi2ly [@var{option}]@dots{} @var{midi-file}
+musicxml2ly [@var{option}]@dots{} @var{fichier-xml}
 @end example
 
 Notez bien que, par @qq{ligne de commande}, nous parlons de la ligne de
-commande du système. Pour plus de détails, voir @ref{Converting from
-other formats}.
-
-@command{midi2ly} accepte les options suivantes :
+commande du système.  Pour plus de précisions, reportez-vous à
+@ref{Command-line usage}. 
 
-@table @code
-@item -h,--help
-Afficher cette aide.
+Si le nom du fichier est @file{-}, @command{musicxml2ly} lira
+directement à partir de la ligne de commande.  
 
-@item -o, --output=@var{file}
-Générer le résultat dans le fichier @var{file}.
+@command{musicxml2ly} accepte les options suivantes :
 
-@item -v, --version
-Afficher le numéro de version.
-@end table
+@table @code
+@item -a, --absolute
+Rendu en hauteurs absolues.
 
+@item -h,--help
+Afficher un résumé des utilisations.
 
-@refbugs
+@item -l, --language=LANG
+Utiliser un autre fichier de définition liguistique @file{LANG.ly} 
+et les noms de notes correspondants, comme par exemple 
+@var{deutsch} pour @file{deutsch.ly} et noms de notes en allemand.
 
-La liste des scripts d'articulation est incomplète.  Les mesures vides
-perturbent @command{etf2ly}.  Les séquences ne notes d'ornement ne se
-terminent pas de manière satisfaisante.
+@item --lxml
+Utiliser le paquetage Python lxml.etree, moins gourmand en mémoire et
+temps de calcul, pour effectuer l'annalyse XML.
 
-@node Invoking musicxml2ly
-@section Invoking @code{musicxml2ly}
+@item --nd --no-articulation-directions
+Ne pas convertir la direction (@code{^}, @code{_} ou @code{-}) des
+articulations, nuances, etc.
 
-@uref{http://@/www.@/recordarde@/.com/xml@/.html,MusicXML} est un
-dialecte XML pour représenter la notation musicale.
+@item --no-beaming
+Ne pas convertir les informations de ligature ; laisser LilyPond gérer
+les ligatures automatiquement. 
 
-@command{musicxml2ly} extrait des notes à partir de fichiers MusicXML,
-et les écrit dans un fichier @var{.ly}.  Il se lance en ligne de
-commande.
+@item -o,--output=@var{fichier}
+Générer le résultat dans le fichier @var{fichier}.  S'il n'est pas
+déterminé, ce sera @var{fichier-xml}@file{.ly} ; @file{-} produira le
+résultat sur la sortie standard (@var{stdout}).
 
-Notez bien que, par @qq{ligne de commande}, nous parlons de la ligne de
-commande du système. Pour plus de détails, voir @ref{Converting from
-other formats}.
+@item -r,--relative
+Rendu en hauteurs relatives (mode par défaut).
 
-@command{musicxml2ly} accepte les options suivantes :
+@item -v,--verbose
+Mode verbeux.
 
-@table @code
-@item -h,--help
-Afficher un résumé des utilisations.
-@item -o,--output=@var{file}
-Générer le résultat dans le fichier @var{file}.  (par défaut :
-affichage écran)
-@item -v,--version
+@item --version
 Afficher le numéro de version.
+
+@item -z,--compressed
+Le fichier d'entrée est un fichier MusicXML zippé.
 @end table
 
+
 @node Invoking abc2ly
 @section Invoking @code{abc2ly}
 
 @cindex ABC
 
 ABC est un format relativement simple basé sur l'ASCII.  Sa
-description est disponible sur le site d'ABC à l'adresse :
-
-@quotation
-@uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/abc2mtex/@/abc@/.txt}.
-@end quotation
+description est disponible sur le 
+@uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/learn@/.html,site
+d'ABC}. 
 
-@command{abc2ly} traduit du formt ABC au format LilyPond.
+@command{abc2ly} traduit du format ABC au format LilyPond.
 
 Pour le lancer en ligne de commande, procédez ainsi :
 @example
-abc2ly [@var{option}]@dots{} @var{abc-file}
+abc2ly [@var{option}]@dots{} @var{fichier-abc}
 @end example
 
 @command{abc2ly} accepte les options suivantes :
 
 @table @code
+@item -b,--beams=None
+Préserver la notion de lien de croches propre à ABC.
 @item -h,--help
 Afficher un résumé des utilisations.
 @item -o,--output=@var{file}
 Générer le résultat dans le fichier @var{file}.
-@item -v,--version
+@item -s,--strict
+Être strict sur la réussite.
+@item --version
 Afficher le numéro de version.
 @end table
 
@@ -235,7 +245,7 @@ source ABC.  Ainsi, l'assertion
 %%LY voices \set autoBeaming = ##f
 @end example
 
-aura pour conséquence d'insérer le texte qui suit le mot-clé @q{voices}
+aura pour conséquence d'insérer le texte qui suit le mot-clé @qq{voices}
 dans la voix correspondante du fichier LilyPond.
 
 De la même manière,
@@ -244,12 +254,12 @@ De la même manière,
 %%LY slyrics more words
 @end example
 
-placera le texte suivant le mot-clé @q{slyrics} dans une ligne de paroles.
+placera le texte suivant le mot-clé @qq{slyrics} dans une ligne de paroles.
 
 
-@refbugs
+@knownissues
 
-Le standard ABC n'est pas si @q{standard} que cela.  Pour des
+Le standard ABC n'est pas si @qq{standard} que cela.  Pour des
 fonctionnalités étendues, comme la polyphonie, existent différentes
 conventions.
 
@@ -261,20 +271,61 @@ ABC synchronise paroles et musique en début de ligne ;
 @command{abc2ly} ignore les ligatures ABC.
 
 
+@node Invoking etf2ly
+@section Invoking @command{etf2ly}
+
+@cindex ETF
+@cindex Enigma
+@cindex Finale
+@cindex Coda Technology
+
+ETF (Enigma Transport Format) est l'un des formats utilisés par le
+logiciel Finale, édité par Coda Music Technology.  @command{etf2ly}
+convertit partiellement les fichiers ETF en fichiers source LilyPond.
+
+
+Pour le lancer en ligne de commande, procédez ainsi :
+@example
+etf2ly [@var{option}]@dots{} @var{fichier-etf}
+@end example
+
+Notez bien que, par @qq{ligne de commande}, nous parlons de la ligne de
+commande du système.  Pour plus de précisions, reportez-vous à
+@ref{Command-line usage}. 
+
+@command{etf2ly} accepte les options suivantes :
+
+@table @code
+@item -h,--help
+Afficher cette aide.
+@item -o, --output=@var{file}
+Générer le résultat dans le fichier @var{file}.
+@item --version
+Afficher le numéro de version.
+@end table
+
+
+@knownissues
+
+La liste des scripts d'articulation est incomplète.  Les mesures vides
+perturbent @command{etf2ly}.  Les séquences de notes d'ornement ne se
+terminent pas de manière satisfaisante.
+
+
 
 @node Generating LilyPond files
 @section Generating LilyPond files
 
-@cindex External programs, generating LilyPond files
+@cindex programmes externes générant des fichiers LilyPond
 
 LilyPond ne prend pas en charge d'autre format. Cependant, certains
 outils indépendants permettent de générer des fichiers LilyPond.
 
 Nous citerons entre autres
 
-@itemize @bullet
+@itemize 
 @item
-@uref{http://@/denemo@/.sourceforge@/.net/,Denemo}, une interface
+@uref{http://@/denemo@/.org,Denemo}, une interface
 graphique pour l'édition de partition.
 @item
 @uref{http://www@/.volny@/.cz/smilauer/rumor/rumor@/.html,Rumor}, un
@@ -283,16 +334,24 @@ convertisseur temps-réel de MIDI monophonique à LilyPond.
 @uref{http://nicolas@/.sceaux@/.free@/.fr/lilypond/lyqi@/.html,lyqi}, un
 mode majeur pour Emacs.
 @item
-@uref{http://@/www@/.nongnu@/.org/@/xml2ly/, xml2ly}, qui importe
-@uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}
+@uref{http://@/www@/.nongnu@/.org/@/xml2ly/, xml2ly}, qui importe du
+@uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}.
 @item
 @uref{http://@/noteedit@/.berlios@/.de,NoteEdit}
-qui importe @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}
+qui importe du @uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}. 
 @item
 @uref{http://@/www@/.rosegardenmusic@/.com,Rosegarden},
-qui importe MIDI
+qui importe du MIDI.
 @item
 @uref{http://@/common-lisp@/.net/project/fomus/,FOMUS},
 une bibliothèque LISP pour générer de la notation musicale. 
+@item
+@uref{http://@/vsr@/.informatik@/.tu-chemnitz@/.de/staff/jan/nted/nted.xhtml,NtEd}
+assure, de manière expérimentale, un export vers LilyPond. 
+@item
+@uref{http://@/www@/.tuxguitar@/.com@/.ar/,TuxGuitar} peut exporter au
+format LilyPond. 
+@item
+@uref{http://@/musescore@/.org,MuseScore} peut exporter au format LilyPond.
 @end itemize