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