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: fa8dd31ed29a5ef35d76f127a795b5c2d951f5dd
   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,@rlearningnamed{Top,Initiation}}
  47 une introduction pas-à-pas à LilyPond.
  48 @details{Initiation}
  49
  50 @item @ifWebLinks{@manualStableGlossarySplitNoName,@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,@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,@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,@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,@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,@rchangesnamed{Top,Nouveautés}}
 106 changements depuis la dernière version stable.
 107 @details{Nouveautés}
 108
 109 @item @ifWebLinks{@manualStableExtendingSplitNoName,@rextendnamed{Top,Extension}}
 110 programmation avancée d'ajustements et retouches dans LilyPond.
 111 @details{Extension}
 112
 113 @item @ifWebLinks{@manualStableInternalsSplitNoName,@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{Development} :
 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 * Web::
 155 * FAQ::                 Foire aux questions
 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,
 195   @manualStableLearningBig, 1.5 MB,
 196   @manualStableLearningPdf, 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,
 221   @manualStableGlossaryBig, 1 MB,
 222   @manualStableGlossaryPdf, 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,
 250   @manualStableEssayBig, 2 MB,
 251   @manualStableEssayPdf, 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,
 279   @manualStableNotationBig, 7 MB,
 280   @manualStableNotationPdf, 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,
 304   @manualStableUsageBig, 300 KB,
 305   @manualStableUsagePdf, 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,
 339   @manualStableSnippetsBig, 2.5 MB,
 340   @manualStableSnippetsPdf, 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 Décidez-en donc vous-même ; 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{Why does the syntax change?}.
 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 @docLinks{Web, web,
 407   @ref{Top,,,,Web},
 408   @manualStableWebSplit,
 409   @manualStableWebBig, 1 MB,
 410   @manualStableWebPdf, 2 MB}
 411
 412 @divEnd
 413
 414
 415 @node Nouveautés
 416 @unnumberedsec Nouveautés
 417 @translationof Changes
 418
 419 @divClass{column-left-top}
 420 @subheading Nouveautés
 421
 422 C'est une liste des changements visibles pour l'utilisateur et des
 423 nouvelles fonctionnalités de LilyPond depuis la dernière version stable.
 424
 425 @divEnd
 426
 427 @divClass{column-right-bottom}
 428
 429 @docLinks{Nouveautés, changes,
 430   @rglosnamed{Top,Nouveautés},
 431   @manualStableChangesSplit,
 432   @manualStableChangesBig, 6 KB,
 433   @manualStableChangesPdf, 200 KB}
 434
 435 @divEnd
 436
 437
 438 @node Extension
 439 @unnumberedsec Extension
 440 @translationof Extend
 441
 442 @untranslated
 443
 444
 445 @node Propriétés internes
 446 @unnumberedsec Propriétés internes
 447 @translationof Internals
 448
 449 @divClass{column-left-top}
 450 @subheading Référence des propriétés internes
 451
 452 C'est un ensemble de pages étroitement liées entre elles, qui documente
 453 les moindres petits détails de chaque classe, objet et fonction de
 454 LilyPond.  Cette documentation est produite directement à partir des
 455 définitions de formatage du code source.
 456
 457 Presque toutes les fonctions de formatage utilisées en interne sont
 458 directement disponibles pour l'utilisateur.  Par exemple, toutes les
 459 variables qui contrôlent les épaisseurs, les distances etc., peuvent
 460 être modifiées dans les fichiers d'entrée.  Il y a un grand nombre
 461 d'options de formatage, et elles sont toutes décrites dans ce document.
 462 Chaque section du manuel de notation a un paragraphe @b{Voir aussi}, qui
 463 renvoie à la documentation générée automatiquement.
 464
 465 @divEnd
 466
 467 @divClass{column-right-bottom}
 468
 469 @docLinks{Référence des propriétés internes, internals,
 470   @rinternalsnamed{Top,Référence des propriétés internes},
 471   @manualStableInternalsSplit,
 472   @manualStableInternalsBig, 2.5 MB,
 473   @manualStableInternalsPdf, 2.8 MB}
 474
 475 @divEnd
 476
 477
 478 @node Traductions
 479 @unnumberedsec Traductions
 480 @translationof Translated
 481
 482 @divClass{column-center-bottom}
 483 @subheading État des traductions
 484
 485 Désolé, l'état des traductions est indisponible en ce moment.
 486
 487 @divEnd
 488
 489
 490 @node Tous
 491 @unnumberedsec Tous
 492 @translationof All
 493
 494 @divClass{column-left-top}
 495 @subheading Versions disponibles au téléchargement
 496
 497 @ifclear web_version
 498 L'intégrale de la documentation est disponible sous forme d'archive à
 499 l'adresse @uref{http://lilypond.org}
 500 @end ifclear
 501 @ifset web_version
 502
 503 @divClass{keep-bullets}
 504 @itemize
 505
 506 @item @doctarballStable
 507
 508 @end itemize
 509
 510 @divEnd
 511 @end ifset
 512
 513 @divEnd
 514
 515 @divClass{column-right-bottom}
 516 @subheading Versions stables antérieures
 517
 518 @divClass{keep-bullets}
 519 @itemize
 520
 521 @item @uref{http://lilypond.org/doc/v2.12/Documentation/,
 522 LilyPond 2.12 Documentation}
 523
 524 @item @uref{http://lilypond.org/doc/v2.10/Documentation/,
 525 LilyPond 2.10 Documentation}
 526
 527 @item @uref{http://lilypond.org/doc/v2.8/Documentation/,
 528 LilyPond 2.8 Documentation}
 529
 530 @help anybody want to write this stuff?
 531
 532 @end itemize
 533
 534 @divEnd
 535 @divEnd
 536 @node FDL
 537 @unnumberedsec FDL
 538 @translationof FDL
 539
 540 @divClass{column-center-top}
 541 @subheading Licence de la documentation
 542
 543 La documentation de GNU LilyPond est poubliée selon les termes de la
 544 @emph{GNU Free Documentation License}.  Une brève introduction à cette
 545 licence ainsi que les motifs qui nous ont fait l'adopter se trouvent à
 546 la page @ref{Liberté}.
 547
 548 @divEnd
 549
 550 @divClass{column-center-bottom}
 551 @subheading GNU Free Documentation License 1.1
 552
 553 @include fdl.itexi
 554
 555 @divEnd