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