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