Documentation/fr/web/manuals.itexi

   1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
   2 @c This file is part of web.texi
   3 @ignore
   4    Translation of GIT committish: c66c7bc1b97947e74978c20ffbf55f2c6e2c4d97
   5
   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..
   9 @end ignore
  10
  11 @c Translators: John Mandereau
  12 @c Translation checkers: Jean-Charles Malahieude
  13
  14 @node Manuels
  15 @unnumbered Manuels
  16 @translationof Manuals
  17
  18 @macro details{reference}
  19 @spanClass{detail}
  20 (@ref{\reference\, détails de \reference\})
  21 @spanEnd
  22 @end macro
  23
  24
  25 @divClass{heading-center}
  26 @ifclear web_version
  27   @heading Documentation pour LilyPond @version
  28 @end ifclear
  29 @ifset web_version
  30   @heading Documentation pour LilyPond @versionStable
  31 @end ifset
  32
  33 @divEnd
  34
  35 @divClass{link-headings}
  36
  37 @divClass{column-center-top}
  38 @subheading Introduction
  39
  40 @itemize
  41
  42 @item
  43 @ref{Entrée sous forme de texte} :
  44 LilyPond est un système de gravure musicale @strong{en mode texte}.  Si
  45 vous ne savez pas du tout ce que ça veut dire, lisez tout d'abord
  46 ceci@tie{}!
  47
  48 @item
  49 @ifWebLinks{@manualStableLearningSplitNoName-fr,@rlearningnamed{Top,Initiation}}
  50 une introduction pas-à-pas à LilyPond.
  51 @details{Initiation}
  52
  53 @item
  54 @ifWebLinks{@manualStableGlossarySplitNoName,@rglosnamed{Top,Glossaire}}
  55 @emph{(lecture optionnelle)} répertoire de définition et de traduction
  56 de termes musicaux, utile en particulier pour connaître les termes
  57 musicaux en anglais.
  58 @details{Glossaire}
  59
  60 @item
  61 @ifWebLinks{@manualStableEssaySplitNoName-fr,@ressaynamed{Top,Essai}}
  62 @emph{(lecture optionnelle)} essai sur la conception des processus de
  63 gravure d'après l'esthétique et la technique de la gravure
  64 traditionnelle avec poinçons et plaques de plomb.
  65 @details{Essai}
  66
  67 @end itemize
  68
  69 @divEnd
  70
  71 @divClass{column-left-top}
  72 @subheading Utilisation courante
  73
  74 @itemize
  75
  76 @item
  77 @ifWebLinks{@manualStableNotationSplitNoName-fr,@rusernamed{Top,Notation}}
  78 partie la plus importante de la documentation, ce manuel fournit toutes
  79 les informations détaillées dont vous aurez besoin en matière de notation.
  80 @details{Notation}
  81
  82 @item
  83 @ifWebLinks{@manualStableUsageSplitNoName-fr,@rprogramnamed{Top,Utilisation}}
  84 présentation des différentes composantes de LilyPond, ainsi que les
  85 particularités de certains systèmes d'exploitation.
  86 @details{Utilisation}
  87
  88 @item
  89 @ifWebLinks{@manualStableSnippetsSplitNoName,@rlsrnamed{Top,Morceaux choisis}}
  90 courts extraits, trucs, modèles et autres exemples.
  91 @details{Morceaux choisis}
  92
  93 @end itemize
  94
  95 @divEnd
  96
  97
  98 @divClass{column-right-top}
  99 @subheading Utilisation ponctuelle
 100
 101 @itemize
 102
 103 @item
 104 @ref{FAQ} :
 105 la Foire Aux Questions.
 106
 107 @item
 108 @ref{Web} :
 109 ce document.
 110 @details{Web}
 111
 112 @item
 113 @ifWebLinks{@manualStableChangesSplitNoName,@rchangesnamed{Top,Nouveautés}}
 114 changements depuis la dernière version stable.
 115 @details{Nouveautés}
 116
 117 @item
 118 @ifWebLinks{@manualStableExtendingSplitNoName,@rextendnamed{Top,Extension}}
 119 programmation avancée d'ajustements et retouches dans LilyPond.
 120 @details{Extension}
 121
 122 @item
 123 @ifWebLinks{@manualStableInternalsSplitNoName,@rinternalsnamed{Top,Propriétés internes}}
 124 information sur les structures internes de LilyPond, nécessaire en
 125 particulier pour élaborer des retouches.
 126 @details{Propriétés internes}
 127
 128 @end itemize
 129
 130 @divEnd
 131
 132
 133 @divClass{column-center-bottom}
 134 @subheading Autre documentation
 135
 136 @itemize
 137
 138 @item
 139 @ref{Tous} :
 140 liens rapides, manuels téléchargeables, et documentation des anciennes
 141 versions.
 142
 143 @item
 144 @ref{Traductions} :
 145 état des traductions pour les lecteurs non anglophones.
 146
 147 @item
 148 @uref{http://lsr@/.dsi@/.unimi@/.it,LilyPond Snippet Repository} :
 149 collection d'exemples, trucs et astuces élaborés par des utilisateurs.
 150
 151 @item
 152 @ref{Développement} :
 153 manuels pour la version de développement.
 154
 155 @item
 156 @ref{FDL} :
 157 ces manuels sont publiés sous la licence GNU de documentation libre FDL.
 158
 159 @end itemize
 160
 161 @divEnd
 162
 163 @divClass{column-center-bottom}
 164 @subheading Format des manuels
 165
 166 Les manuels de LilyPond sont disponibles sous différents formats : HTML
 167 multifichiers, fichier monolithique HTML ou PDF.@*
 168 Le HTML découpé en plusieurs fichiers est tout à fait adapté à une
 169 consultation en ligne. Les formats HTML en fichier unique -- certains
 170 ont une taille conséquente -- contiennent l'intégralité d'un manuel sur
 171 une seule page. Les exemplaires PDF sont plutôt destinés au
 172 téléchargement pour consultation hors ligne. Ces trois formats sont
 173 accessibles en suivant le lien « détail de@dots{} » de chacun des manuels.
 174
 175 @divEnd
 176
 177 @divEnd
 178
 179
 180 @divClass{hide}
 181 @menu
 182 * Initiation::          Premiers pas
 183 * Glossaire::           Glossaire musicologique multilingue
 184 * Essai::               Pourquoi LilyPond
 185 * Notation::            Référence en matière de notation
 186 * Utilisation::         Les différentes composantes de LilyPond
 187 * Morceaux choisis::    Exemples de code, trucs et astuces
 188 * FAQ::                 Foire aux questions
 189 * Web::                 Le site de LilyPond
 190 * Nouveautés::          Ce qui change au fil des versions
 191 * Extension::           Programmation au sein de LilyPond
 192 * Propriétés internes:: Références du programme
 193 * Traductions::         État d'avancement des différentes traductions
 194 * Tous::                Tous les manuels
 195 * FDL::                 Licence.
 196 @end menu
 197
 198 @divEnd
 199
 200
 201 @c TRANSLATORS, most of the text in this file came from
 202 @c LM 1.1 About the documentation  (before this section was
 203 @c removed in July 2009).
 204
 205 @node Initiation
 206 @unnumberedsec Initiation
 207 @translationof Learning
 208
 209 @divClass{column-left-top}
 210 @subheading Manuel d'initiation
 211
 212 Ce manuel explique comment débuter avec LilyPond, et expose de manière
 213 simple quelques concepts clés.  Il est conseillé de lire ces chapitres
 214 de manière linéaire.
 215
 216 Dans ce manuel se trouve à chaque section un paragraphe @strong{Voir
 217 aussi} contenant des références vers d'autres sections : il est
 218 conseillé de ne pas les suivre en première lecture ; lorsque vous
 219 aurez lu l'ensemble du manuel d'initiation, vous pourrez en relisant
 220 certaines sections suivre ces références pour approfondir certains
 221 aspects.
 222 @divEnd
 223
 224 @divClass{column-right-bottom}
 225
 226 @docLinks{Initiation, learning,
 227   @rlearningnamed{Top,Initiation},
 228   @manualStableLearningSplit-fr,
 229   @manualStableLearningBig-fr, @w{3 MB},
 230   @manualStableLearningPdf-fr, @w{5 MB}}
 231
 232 @divEnd
 233
 234
 235 @node Glossaire
 236 @unnumberedsec Glossaire
 237 @translationof Glossary
 238
 239 @divClass{column-left-top}
 240 @subheading Glossaire
 241
 242 Ce document explique en anglais des termes musicaux, et donne leur
 243 traduction dans diverses langues.  Si vous n'êtes pas familier avec la
 244 notation et la terminologie musicales, il est conseillé de consulter le
 245 glossaire, notamment pour les parties non encore traduites de la
 246 documentation.
 247
 248 @divEnd
 249
 250 @divClass{column-right-bottom}
 251
 252 @docLinks{Glossaire musical, music-glossary,
 253   @rglosnamed{Top,Glossaire musical},
 254   @manualStableGlossarySplit,
 255   @manualStableGlossaryBig, @w{1 MB},
 256   @manualStableGlossaryPdf, @w{1,5 MB}}
 257
 258 @divEnd
 259
 260
 261 @node Essai
 262 @unnumberedsec Essai
 263 @translationof Essay
 264
 265 @divClass{column-left-top}
 266 @subheading Essai
 267
 268 Ce document résume l'histoire de la typographie musicale, puis examine
 269 les techniques de gravure à l'œuvre dans LilyPond.  Il inclut également
 270 des comparaisons entre LilyPond et d'autres logiciels de notation
 271 musicale.
 272
 273 @warning{il est plus facile d'examiner les détails typographiques dans
 274 l'édition de ce manuel au format PDF, car elle peut être vue à une plus
 275 haute résolution.}
 276
 277 @divEnd
 278
 279 @divClass{column-right-bottom}
 280
 281 @docLinks{Essai, essay,
 282   @ressaynamed{Top,Essai},
 283   @manualStableEssaySplit-fr,
 284   @manualStableEssayBig-fr, @w{1 MB},
 285   @manualStableEssayPdf-fr, @w{2 MB}}
 286
 287 @divEnd
 288
 289
 290 @node Notation
 291 @unnumberedsec Notation
 292 @translationof Notation
 293
 294 @divClass{column-left-top}
 295 @subheading Manuel de notation
 296
 297 Ce manuel détaille toutes les commandes LilyPond produisant une notation
 298 musicale.  La lecture de cet ouvrage requiert une bonne compréhension des
 299 concepts exposés dans le manuel d'initiation.
 300
 301 @warning{L'utilisation optimale du manuel de notation requiert une
 302 familiarité avec les concepts et fonctions de base exposés dans le
 303 manuel d'initiation, ainsi que les concepts musicaux exposés dans le
 304 glossaire.}
 305
 306 @divEnd
 307
 308 @divClass{column-right-bottom}
 309
 310 @docLinks{Notation, notation,
 311   @rusernamed{Top,Notation},
 312   @manualStableNotationSplit-fr,
 313   @manualStableNotationBig-fr, @w{9 MB},
 314   @manualStableNotationPdf-fr, @w{35 MB}}
 315
 316 @divEnd
 317
 318
 319 @node Utilisation
 320 @unnumberedsec Utilisation
 321 @translationof Usage
 322
 323 @divClass{column-left-top}
 324 @subheading Manuel d'utilisation des programmes
 325
 326 Ce manuel explique l'exécution des programmes et l'intégration de
 327 partitions LilyPond dans d'autres programmes, et suggère des « bonnes
 328 pratiques » pour une utilisation plus efficace.  Sa lecture est
 329 recommandée avant d'aborder de grands projets.
 330
 331 @divEnd
 332
 333 @divClass{column-right-bottom}
 334
 335 @docLinks{Utilisation des programmes, usage,
 336   @rprogramnamed{Top,Utilisation des programmes},
 337   @manualStableUsageSplit-fr,
 338   @manualStableUsageBig-fr, @w{400 KB},
 339   @manualStableUsagePdf-fr, @w{650 KB}}
 340
 341 @divEnd
 342
 343
 344 @node Morceaux choisis
 345 @unnumberedsec Morceaux choisis
 346 @translationof Snippets
 347
 348 @divClass{column-left-top}
 349 @subheading Morceaux choisis
 350
 351 Il s'agit d'une sélection de petits exemples montrant des trucs,
 352 astuces et fonctionnalités particulières de LilyPond, issus de
 353 @uref{http://lsr@/.dsi@/.unimi@/.it,LilyPond Snippet Repository}
 354 (LSR).  Tous ces exemples sont dans le domaine public.
 355
 356 Notez bien que cette annexe n'est en aucune manière un miroir ou même
 357 une partie du LSR.  Dans la mesure où le LSR repose sur une version
 358 stable de LilyPond, les exemples illustrant des fonctionnalités
 359 introduites dans la dernière version de développement ne peuvent y
 360 figurer ; c'est pourquoi vous les trouverez dans le répertoire
 361 @file{Documentation/snippets/new/} des sources de LilyPond.
 362
 363 La liste des exemples correspondant à chacun des sous-chapitres du
 364 manuel de notation est accessible par des liens dans le paragraphe
 365 @strong{Voir aussi}.
 366 @divEnd
 367
 368 @divClass{column-right-bottom}
 369
 370 @docLinks{Morceaux choisis, snippets,
 371   @rlsrnamed{Top, Morceaux choisis},
 372   @manualStableSnippetsSplit,
 373   @manualStableSnippetsBig, @w{1,5 MB},
 374   @manualStableSnippetsPdf, @w{12,5 MB}}
 375
 376 @divEnd
 377
 378
 379 @node FAQ
 380 @unnumberedsec FAQ
 381 @translationof FAQ
 382
 383 @divClass{column-center-top}
 384 @subheading Foire aux questions
 385
 386 @subsubheading Où sont la vue graphique, les menus et barres d'outils ?
 387
 388 LilyPond demande que la musique soit écrite comme du texte.  Lisez la
 389 partie intitulée @ref{Entrée sous forme de texte}.
 390
 391
 392 @subsubheading La documentation est si longue !  Dois-je vraiment la lire ?
 393
 394 Vous devez lire le @ref{Initiation,manuel d'initiation}.  Pour le reste
 395 de la documentation, vous n'avez besoin de lire que ce qui est en
 396 rapport avec la notation musicale que vous voulez produire.
 397
 398
 399 @subsubheading Ça fait encore beaucoup à lire !  Ai-je besoin de lire tout cela ?
 400
 401 C'est vous qui voyez ; les raisons pour lesquelles vous souhaitez
 402 utiliser LilyPond se trouvent peut-être dans notre @ref{Introduction}.
 403
 404 @divEnd
 405
 406 @divClass{column-center-bottom}
 407 @subheading Questions d'utilisation
 408
 409 @subsubheading Quelque chose ne fonctionne pas !  Comment je le répare ?
 410
 411 C'est expliqué dans @rprogram{Résolution de problèmes}.
 412
 413
 414 @subsubheading Pourquoi changez-vous la syntaxe ?
 415
 416 C'est expliqué dans @rprogram{LilyPond est une langue vivante}.
 417
 418 @divEnd
 419
 420
 421 @node Web
 422 @unnumberedsec Web
 423 @translationof Web
 424
 425 @divClass{column-left-top}
 426 @subheading Web
 427
 428 Ce document fournit des informations générales sur LilyPond et sur les
 429 outils de la communauté, c'est-à-dire les listes de discussion, les
 430 rapports de bogues et le développement.
 431
 432 @divEnd
 433
 434 @divClass{column-right-bottom}
 435 @subheading À lire
 436
 437 @subsubheading La version que vous consultez actuellement
 438
 439 @divClass{keep-bullets}
 440 @itemize
 441 @ref{Top,Web}
 442 @end itemize
 443 @divEnd
 444
 445 @subsubheading Web de la version @versionDevel
 446
 447 @docLinks{Web, web,
 448   @ref{Top,Web},
 449   @manualStableWebSplit-fr,
 450   @manualStableWebBig-fr, @w{2,5 MB},
 451   @manualStableWebPdf-fr, @w{3,5 MB}}
 452
 453 @divEnd
 454
 455
 456 @node Nouveautés
 457 @unnumberedsec Nouveautés
 458 @translationof Changes
 459
 460 @divClass{column-left-top}
 461 @subheading Nouveautés
 462
 463 C'est une liste des changements visibles pour l'utilisateur et des
 464 nouvelles fonctionnalités de LilyPond depuis la dernière version stable.
 465
 466 @divEnd
 467
 468 @divClass{column-right-bottom}
 469
 470 @docLinks{Nouveautés, changes,
 471   @rchcangesnamed{Top,Nouveautés},
 472   @manualStableChangesSplit,
 473   @manualStableChangesBig, @w{90 KB},
 474   @manualStableChangesPdf, @w{80 KB}}
 475
 476 @divEnd
 477
 478
 479 @node Extension
 480 @unnumberedsec Extension
 481 @translationof Extending
 482
 483 @divClass{column-left-top}
 484 @subheading Extension des fonctionnalités de LilyPond
 485
 486 Ce manuel vous donnera des pistes en matière de programmation
 487 avancée d’ajustements et retouches dans LilyPond.
 488
 489 @divEnd
 490
 491 @divClass{column-right-bottom}
 492
 493 @docLinks{Extension, extending,
 494   @rextendnamed{Top,Extension},
 495   @manualStableExtendingSplit-fr,
 496   @manualStableExtendingBig-fr, @w{300 KB},
 497   @manualStableExtendingPdf-fr, @w{500 KB}}
 498
 499 @divEnd
 500
 501
 502 @node Propriétés internes
 503 @unnumberedsec Propriétés internes
 504 @translationof Internals
 505
 506 @divClass{column-left-top}
 507 @subheading Référence des propriétés internes
 508
 509 C'est un ensemble de pages étroitement liées entre elles, qui documente
 510 les moindres petits détails de chaque classe, objet et fonction de
 511 LilyPond.  Cette documentation est produite directement à partir des
 512 définitions de formatage du code source.  Elle n'est à ce jour
 513 disponible qu'en anglais.
 514
 515 Presque toutes les fonctions de formatage utilisées en interne sont
 516 directement disponibles pour l'utilisateur.  Par exemple, toutes les
 517 variables qui contrôlent les épaisseurs, les distances, etc. peuvent
 518 être modifiées dans les fichiers d'entrée.  Il y a un grand nombre
 519 d'options de formatage, et elles sont toutes décrites dans ce document.
 520 Chaque section du manuel de notation a un paragraphe @b{Voir aussi}, qui
 521 renvoie à la documentation générée automatiquement.
 522
 523 @divEnd
 524
 525 @divClass{column-right-bottom}
 526
 527 @docLinks{Référence des propriétés internes, internals,
 528   @rinternalsnamed{Top,Référence des propriétés internes},
 529   @manualStableInternalsSplit,
 530   @manualStableInternalsBig, @w{3 MB},
 531   @manualStableInternalsPdf, @w{4 MB}}
 532
 533 @divEnd
 534
 535
 536 @node Traductions
 537 @unnumberedsec Traductions
 538 @translationof Translated
 539
 540 @divClass{column-center-bottom}
 541 @subheading État des traductions
 542
 543 @include translations.itexi
 544
 545 @divEnd
 546
 547
 548 @node Tous
 549 @unnumberedsec Tous
 550 @translationof All
 551
 552 @divClass{column-left-top}
 553 @subheading Versions disponibles au téléchargement
 554
 555 @ifclear web_version
 556 L'intégrale de la documentation est disponible sous forme d'archive à
 557 l'adresse @uref{http://lilypond.org}
 558 @end ifclear
 559 @ifset web_version
 560
 561 @divClass{keep-bullets}
 562 @itemize
 563
 564 @item @doctarballStable-fr
 565
 566 @end itemize
 567
 568 @divEnd
 569 @end ifset
 570
 571 @divEnd
 572
 573 @divClass{column-right-bottom}
 574 @subheading Versions stables antérieures
 575
 576 @divClass{keep-bullets}
 577 @itemize
 578
 579 @item @uref{http://lilypond.org/doc/v2.14/Documentation/web/manuals.fr.html,
 580 LilyPond 2.14 Documentation}
 581
 582 @item @uref{http://lilypond.org/doc/v2.12/Documentation/index.fr.html,
 583 LilyPond 2.12 Documentation}
 584
 585 @item @uref{http://lilypond.org/doc/v2.10/Documentation/,
 586 LilyPond 2.10 Documentation}
 587
 588 @item @uref{http://lilypond.org/doc/v2.8/Documentation/,
 589 LilyPond 2.8 Documentation}
 590
 591 @item @uref{http://lilypond.org/doc/v2.6/Documentation/,
 592 LilyPond 2.6 Documentation}
 593
 594 @item @uref{http://lilypond.org/doc/v2.4/Documentation/out-www/,
 595 LilyPond 2.4 Documentation}
 596
 597 @item @uref{http://lilypond.org/doc/v2.2/Documentation/out-www/,
 598 LilyPond 2.2 Documentation}
 599
 600 @item @uref{http://lilypond.org/doc/v2.0/Documentation/out-www/,
 601 LilyPond 2.0 Documentation}
 602
 603 @item @uref{http://lilypond.org/doc/v1.8/Documentation/out-www/,
 604 LilyPond 1.8 Documentation}
 605
 606 @item @uref{http://lilypond.org/doc/v1.6/Documentation/out-www/,
 607 LilyPond 1.6 Documentation}
 608
 609 @end itemize
 610
 611 @divEnd
 612 @divEnd
 613 @node FDL
 614 @unnumberedsec FDL
 615 @translationof FDL
 616
 617 @divClass{column-center-top}
 618 @subheading Licence de la documentation
 619
 620 La documentation de GNU LilyPond est publiée selon les termes de la
 621 @emph{GNU Free Documentation License}.  Une brève introduction à cette
 622 licence ainsi que les motifs qui nous ont fait l'adopter se trouvent à
 623 la page @ref{Liberté}.
 624
 625 @divEnd
 626
 627 @divClass{column-center-bottom}
 628 @subheading GNU Free Documentation License 1.1
 629
 630 @include fdl.itexi
 631
 632 @divEnd