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