X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Ffr%2Fusage%2Fsuggestions.itely;h=864b06a4d736a89a84afaa576455c46d319395a6;hb=612eac7df053e25c785d378e54a9f6f948547835;hp=3e729b5ffc1b6656f107af2c72c3caf2e48638b6;hpb=166a77d895035e94a898a8a484e599ea65b5838d;p=lilypond.git

diff --git a/Documentation/fr/usage/suggestions.itely b/Documentation/fr/usage/suggestions.itely
index 3e729b5ffc..864b06a4d7 100644
--- a/Documentation/fr/usage/suggestions.itely
+++ b/Documentation/fr/usage/suggestions.itely
@@ -1,24 +1,25 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+
 @ignore
-   Translation of GIT committish: 6ee1c53e30a461d9b36fe5045e23815a57e1e819
+   Translation of GIT committish: bd751630011a6fbfcf069ec1fc41a8eaed8a6b87
 
    When revising a translation, copy the HEAD committish of the
    version that you are working on.  For details, see the Contributors'
     Guide, node Updating translation committishes..
 @end ignore
 
-@c \version "2.12.0"
+@c \version "2.16.0"
 
 @c Translators: Ludovic Sardain, Jean-Charles Malahieude
-@c Translation checkers: Jean-Yves Baudais, Valentin Villenave, John Mandereau, Jean-Charles Malahieude
+@c Translation checkers: Jean-Yves Baudais, Valentin Villenave, John Mandereau
 
 @node Suggestions pour la saisie de fichiers LilyPond
-@chapter Suggestions pour la saisie de fichiers
+@chapter Suggestions pour la saisie de fichiers LilyPond
 @translationof Suggestions for writing files
 
 Maintenant vous êtes prêt à travailler sur de plus gros fichiers
 LilyPond -- des pièces entières, et plus seulement les petits
-exemples du tutoriel.  Mais comment devriez-vous vous y prendre ?
+exemples 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
@@ -26,32 +27,35 @@ organisé.  Néanmoins, quelques critères doivent être pris en compte
 lorsque l'on écrit un fichier LilyPond.
 
 @itemize
-@item Si vous faites une erreur, la structure même du fichier LilyPond
+@item
+Si vous faites une erreur, la structure même du fichier LilyPond
 peut permettre de la localiser plus ou moins facilement.
 
-@item 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'oeil, d'autres vous feront vous arracher les cheveux
-pendant une heure.
-
-@item 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
-@code{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.
+@item
+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 pendant une heure.
+
+@item
+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 @code{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.
 @end itemize
 
 @menu
-* Suggestions générales::         
-* Gravure de musique existante::  
-* Projets d'envergure::              
+* Suggestions générales::
+* Gravure de musique existante::
+* Projets d'envergure::
 * Résolution de problèmes::
-* De la commande make et des fichiers Makefile::             
+* De la commande make et des fichiers Makefile::
 @end menu
 
+
 @node Suggestions générales
 @section Suggestions générales
 @translationof General suggestions
@@ -61,48 +65,53 @@ en résoudre d'autres.
 
 @itemize
 @item @strong{Ajoutez le numéro de version dans chaque fichier}.
-Notez que chaque fichier modèle contient une ligne @w{@code{\version
-"@version{}"}}.  Nous vous conseillons fortement d'inclure cette ligne,
-même pour de petits fichiers.  Par expérience, il est très difficile
-de se rappeler quelle version de LilyPond on utilisait quelques
-années auparavant.  L'utilitaire @command{convert-ly} demande que vous
-spécifiiez la version de LilyPond vous utilisiez alors.
-
-@item @strong{Ajoutez des contrôles} : @ruser{Vérifications d'octave}
-et @ruser{Vérification des limites et numéros de mesure}.  Si vous avez
-ajouté des contrôles de loin en loin, et que vous faites une erreur,
-vous pourrez la retrouver plus rapidement.  @qq{De loin en loin},
-qu'est-ce à dire ?  Cela dépend de la complexité de la musique.  Pour de
-la musique très simple, peut-être une ou deux fois.  Pour de la musique
-très complexe, peut-être à chaque mesure.
-
-@item @strong{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 doît corriger vos fichiers.
-
-@item @strong{Ajoutez des commentaires}.  Utilisez soit des
-numéros de mesure (assez souvent), soit des références au contenu
-musical -- @qq{second thème des violons}, @qq{quatrième variation}, 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.
-
-@item @strong{Indentez les accolades}.  Beaucoup de problèmes
-viennent d'un défaut de parité entre @code{@{} et @code{@}}.
-
-@item @strong{Mentionnez les durées} au début de chaque section ou
-variable.  Si vous saisissez @code{c4 d e} au début d'une phrase, vous
-vous épargnerez des problèmes si, plus tard, vous modifiez votre musique.
-
-@item @strong{Séparez les affinages de mise en forme} de la musique
-elle-même.  Voyez 
-@ref{Économie de saisie grâce aux identificateurs et fonctions} et
-@ref{Feuilles de style}.
+Notez que chaque fichier modèle contient une ligne
+@code{\version "@version{}"}.  Nous vous conseillons fortement
+d'inclure cette ligne, même pour de petits fichiers.  Par expérience, il
+est très difficile de se rappeler quelle version de LilyPond on
+utilisait quelques années auparavant.  L'utilitaire @command{convert-ly}
+demande que vous spécifiiez la version de LilyPond vous utilisiez alors.
+
+@item @strong{Ajoutez des contrôles}
+@rusernamed{Vérifications d'octave,d'octaviation} et
+@rusernamed{Vérification des limites et numéros de mesure,de limite ou
+numéro de mesure}.  Si vous avez ajouté des contrôles de loin en loin,
+et que vous faites une erreur, vous pourrez la retrouver plus
+rapidement.  @qq{De loin en loin}, qu'est-ce à dire ?  Cela dépend
+de la complexité de la musique.  Pour de la musique très simple,
+peut-être une ou deux fois.  Pour de la musique très complexe, peut-être
+à chaque mesure.
+
+@item @strong{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.
+
+@item @strong{Ajoutez des commentaires}.
+Utilisez soit des numéros de mesure (assez souvent), soit des références
+au contenu musical -- @qq{second thème des violons}, @qq{quatrième
+variation}, 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.
+
+@item @strong{Indentez les accolades}.
+Beaucoup de problèmes viennent d'un défaut de parité entre @code{@{} et
+@code{@}}.
+
+@item @strong{Mentionnez les durées}
+au début de chaque section ou variable.  Si vous saisissez @code{c4 d e}
+au début d'une phrase, vous vous épargnerez des problèmes si, plus tard,
+vous modifiez votre musique.
+
+@item @strong{Séparez les affinages de mise en forme}
+de la musique elle-même.  Voyez
+@rlearning{Économie de saisie grâce aux identificateurs et fonctions} et
+@rlearning{Feuilles de style}.
 
 @end itemize
 
@@ -116,26 +125,28 @@ c'est-à-dire de la musique déjà écrite,
 
 @itemize
 
-@item n'entrez qu'un seul système de la partition originale
-à la fois -- mais toujours une seule mesure par ligne de texte --,
+@item 
+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 @code{showLastLength} et @code{showFirstLength}
-pour accélérer la compilation -- voir 
-@ruser{Ignorer des passages de la partition} ;
+pour accélérer la compilation -- voir
+@ruser{Ignorer des passages de la partition} ;
 
-@item définissez @code{mBreak = @{\break @}} et insérez
-@code{\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 @code{mBreak = @{ @}} pour enlever tous ces sauts de ligne, et
-laisser LilyPond placer les sauts de ligne selon son propre algorithme.
+@item
+définissez @code{mBreak = @{ \break @}} et insérez @code{\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 @code{mBreak = @{ @}}
+pour enlever tous ces sauts de ligne, et laisser LilyPond placer les
+sauts de ligne selon son propre algorithme ;
 
-@item encadrez les notes d'une partie pour instrument transpositeur
-dans un 
+@item
+encadrez les notes d'une partie pour instrument transpositeur dans un
 
 @example
-\transpose c @var{tonalité-naturelle} @{...@}
+\transpose c @var{tonalité-naturelle} @{@dots{}@}
 @end example
 (où @var{tonalité-naturelle} correspond à celle de l'instrument en
 question) de telle sorte que la musique comprise dans cette variable se
@@ -168,32 +179,31 @@ dans une nouvelle version de LilyPond, alors que la définition du
 @code{violon} l'est beaucoup moins.
 
 @example
-violin = \relative c'' @{
+violon = \relative c'' @{
 g4 c'8. e16
 @}
-...
+@dots{}
 \score @{
  \new GrandStaff @{
    \new Staff @{
-     \violin
+     \violon
    @}
  @}
 @}
 @end example
 
-@item @strong{Séparez les retouches} des définitions de
-musique.  Nous vous avons déjà invité à adopter une telle pratique, qui 
+@item @strong{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
-@code{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érieur de la définition
-du @code{violon}.
+pouvons avoir besoin de changer la définition de @code{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érieur de la
+définition du @code{violon}.
 
 @example
 fpuisp = _\markup@{
  \dynamic f \italic \small @{ 2nd @} \hspace #0.1 \dynamic p @}
-violin = \relative c'' @{
+violon = \relative c'' @{
 g4\fpuisp c'8. e16
 @}
 @end example
@@ -201,7 +211,7 @@ g4\fpuisp c'8. e16
 @end itemize
 
 
-@node Résolution de problèmes 
+@node Résolution de problèmes
 @section Résolution de problèmes
 @translationof Troubleshooting
 
@@ -212,7 +222,7 @@ 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 @code{%}, et le commentaire multilignes (ou
-bloc de commentaire), indiqué par @code{%@{ ... %@}}.  Si vous ne
+bloc de commentaire), indiqué par @code{%@{ @dots{} %@}}.  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
@@ -254,14 +264,12 @@ Maintenant commencez à décommenter petit à petit le partie de
 @code{basse} jusqu'à ce que vous localisiez la ligne qui pose
 problème.
 
-Une autre technique de déboguage très utile est la construction
-d'@rweb{Exemples minimaux}.
-
-
+Une autre technique de débogage très utile est la construction
+d'un @rwebnamed{Exemples minimaux,exemple minimaliste}.
 
 
 @node De la commande make et des fichiers Makefile
-@section De la commande @command{make} et des fichiers @code{Makefile}
+@section De la commande make et des fichiers Makefile
 @translationof Make and Makefiles
 
 @cindex makefiles
@@ -269,12 +277,12 @@ d'@rweb{Exemples minimaux}.
 
 La plupart des plates-formes sur lesquelles tourne LilyPond disposent
 d'un logiciel appelé @code{make}.  Ce logiciel va lire un fichier
-spécial, nommé de @code{Makefile}, qui contient tout ce qu'il
+spécial, nommé @code{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 @code{ballade.pdf} et @code{ballade.midi} à partir de 
-@code{ballade.ly} en lançant LilyPond.
+faut pour produire @file{ballade.pdf} et @file{ballade.midi} à partir de
+@file{ballade.ly} en lançant LilyPond.
 
 La création d'un @code{Makefile} peut se révéler pertinente pour
 certains projets, que ce soit par simple goût personnel ou bien par
@@ -286,25 +294,25 @@ matériel d'orchestre complet avec la partition pour le chef et une
 partition séparée pour chacun des pupitres -- ou bien si votre projet
 requiert certaines commandes particulières comme @code{lilypond-book}.
 Les @emph{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 Linux et sur MacOS@tie{}X,
-et il en existe une version pour les environnements Windows.
+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 @strong{GNU Make Manual} pour plus de détails sur ce dont 
+Consultez le @strong{GNU Make Manual} pour plus de détails sur ce dont
 @code{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 apperçu de ses possibilités.
+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 Linux et MacOS@tie{}X utilisent
-@code{bash}, Windows utilise @code{cmd}.  Dans le cas de MacOS@tie{}X,
+plate-forme : si les différents GNU/Linux et MacOS X utilisent
+@code{bash}, Windows utilise @code{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 @emph{Makefile}, avec une version pour Linux ou MacOS et une
+fichier @emph{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 :
+Pour commencer, une pièce à quatre mouvements pour orchestre et dont les
+fichiers sont répartis selon l'arborescence suivante :
 
 @example
 Symphonie/
@@ -327,7 +335,7 @@ Symphonie/
 |   `-- symphonieIV.ly
 |-- PDF/
 |-- Pupitres/
-|   |-- symphon-alto.ly
+|   |-- symphonie-alto.ly
 |   |-- symphonie-cello.ly
 |   |-- symphonie-cor.ly
 |   |-- symphonie-hautbois.ly
@@ -336,12 +344,12 @@ Symphonie/
 `-- symphonieDefs.ily
 @end example
 
-Les fichiers @code{.ly} des répertoires @code{Partitions} et
-@code{Pupitres} récupèreront la notation des fichiers @code{.ily}
-contenus dans le répertoire @code{Notes} :
+Les fichiers @file{.ly} des répertoires @code{Partitions} et
+@code{Pupitres} récupéreront la notation des fichiers @file{.ily}
+contenus dans le répertoire @code{Notes} :
 
 @example
-%%% début du fichier "symphone-cello.ly"
+%%% début du fichier "symphonie-cello.ly"
 \include ../symphonieDefs.ily
 \include ../Notes/cello.ily
 @end example
@@ -352,7 +360,7 @@ mouvements au format conducteur) et @code{pupitres} (une partition par
 pupitre).  Il contient aussi une cible @code{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 @emph{Makefile}
-pour Linux ou MacOS@tie{}X.  Ce fichier doit être enregistré sous le nom
+pour GNU/Linux ou MacOS X.  Ce fichier doit être enregistré sous le nom
 de @code{Makefile} à la racine du projet -- ici @code{Symphonie}.
 
 @warning{Lorsque vous définissez une cible ou une règle sur plusieurs
@@ -385,7 +393,7 @@ VPATH = \
 # Les .pdf résultants iront dans le sous-répertoire "PDF" et les fichiers
 # .midi dans le sous-répertoire "MIDI".
 %.pdf %.midi: %.ly
-        $(LILY_CMD) $<; \           # cette ligne commence par une tabulation
+        $(LILY_CMD) $<; \       # cette ligne commence par une tabulation
         if test -f "$*.pdf"; then \
             mv "$*.pdf" PDF/; \
         fi; \
@@ -418,8 +426,8 @@ $(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.
+# Lancer `make score' pour générer l'intégrale des quatre mouvements
+# en un seul fichier.
 .PHONY: score
 score: $(piece).pdf
 
@@ -445,7 +453,7 @@ mouvements: $(piece)I.pdf \
 all: score parties mouvements
 
 archive:
-        tar -cvvf symphonie.tar \      # cette ligne commence par une tabulation
+        tar -cvvf symphonie.tar \    # cette ligne commence par une tabulation
         --exclude=*pdf --exclude=*~ \
         --exclude=*midi --exclude=*.tar \
         ../Symphonie/*
@@ -458,10 +466,10 @@ d'accès au programme @emph{Make} -- dans les variables d'environnement
 du système --  afin que l'interpréteur de commandes DOS puisse le
 localiser.  Pour cela, faites un clic droite sur @qq{Poste de travail},
 choisissez @code{Propriétés} puis @code{Avancées}.  Cliquez sur
-@code{Variables d'environnement} puis, dans l'onglet @w{@code{Variables
-système}}, mettez @code{path} en surbrillance et cliquez sur
-@code{Modifier}.  Ajoutez alors le chemin d'accès complet à l'exécutable
-de GNU Make, qui devrait ressembler à :
+@code{Variables d'environnement} puis, dans l'onglet
+@code{Variables système}, mettez @code{path} en surbrillance et
+cliquez sur @code{Modifier}.  Ajoutez alors le chemin d'accès complet à
+l'exécutable de GNU Make, qui devrait ressembler à :
 
 @example
 C:\Program Files\GnuWin32\bin
@@ -549,7 +557,7 @@ Le @emph{Makefile} suivant convient pour un document
 @command{lilypond-book} réalisé avec @LaTeX{}.  Ce projet contiendra un
 index, ce qui nécessitera de lancer une deuxième fois @command{latex}
 pour mettre à jour les liens.  Les fichiers résultants iront dans le
-répertoire @code{out} pour ce qui est des .pdf et dans le répertoire
+répertoire @code{out} pour ce qui est des pdf et dans le répertoire
 @code{htmlout} pour ce qui est du html.
 
 @example
@@ -612,7 +620,7 @@ réduire le nombre de processus à lancer dans une seule commande.  Vous
 devrez enregistrer les lignes suivantes dans un fichier
 @code{construire.bat} ou @code{construire.cmd}.  Ce fichier pourra être
 exécuté soit en ligne de commande, soit par un double clic sur son
-icone. 
+icône.
 
 @example
 lilypond-book --output=out --pdf monprojet.lytex
@@ -624,8 +632,7 @@ cd ..
 copy out\monprojet.pdf MonProjet.pdf
 @end example
 
-
 @seealso
 Manuel d'utilisation :
 @ref{Utilisation en ligne de commande},
-@ref{LilyPond-book}
+@ref{lilypond-book}