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