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