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