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