Documentation/fr/macros.itexi

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @ignore
   3     Translation of GIT committish: d59f652451ef6948d1b256808d874b7d03bd3551
   4
   5     When revising a translation, copy the HEAD committish of the
   6     version that you are working on.  For details, see the Contributors'
   7     Guide, node Updating translation committishes..
   8 @end ignore
   9
  10
  11 @include version.itexi
  12 @include common-macros.itexi
  13
  14 @ignore
  15 ****************************
  16 MACRO DEFINITIONS GUIDELINES
  17 ****************************
  18
  19 This file should contain macro defintions which are common to all
  20 languages, i.e. all macro definitions which do not contain text that
  21 should be translated (namely text visible in the output).
  22
  23 Macro definitions which contain text that should be translated in
  24 translations should be in macros.itexi.
  25 @end ignore
  26
  27 @c   ***** Displaying text *****
  28
  29 @c To get decent quotes in `foo' and ``foo''.
  30 @c FIXME: Use thin spaces for @qq.
  31
  32 @ifnotinfo
  33
  34 @macro q{TEXT}
  35 @quoteleft{}\TEXT\@quoteright{}
  36 @end macro
  37
  38 @macro qq{TEXT}
  39 @guillemetleft{}@tie{}\TEXT\@tie{}@guillemetright{}
  40 @end macro
  41
  42 @end ifnotinfo
  43
  44 @ifinfo
  45
  46 @macro q{TEXT}
  47 `\TEXT\'
  48 @end macro
  49
  50 @macro qq{TEXT}
  51 « \TEXT\ »
  52 @end macro
  53
  54 @end ifinfo
  55
  56
  57 @ifhtml
  58
  59 @macro warning{TEXT}
  60 @html
  61 <div class="warning">
  62 @end html
  63 @strong{Note :} \TEXT\
  64 @c keep the space for proper nesting of </p>
  65
  66 @html
  67 </div>
  68 @end html
  69 @end macro
  70
  71 @end ifhtml
  72
  73 @ifnothtml
  74
  75 @macro warning{TEXT}
  76 @quotation
  77 @quotation
  78 @cartouche
  79 @b{Note :} \TEXT\
  80 @end cartouche
  81 @end quotation
  82 @end quotation
  83 @end macro
  84
  85 @end ifnothtml
  86
  87 @macro docMain
  88 @cartouche
  89 Pour connaître la place qu'occupe ce manuel dans la
  90 documentation, consultez Manuels.
  91
  92 Si vous ne disposez pas de certains manuels, la documentation complète
  93 se trouve sur @w{@uref{http://@/www@/.lilypond@/.org/}}.
  94 @end cartouche
  95 @end macro
  96
  97
  98 @macro lilyTitlePage{TITLE}
  99 @c  This produces the unified index
 100 @syncodeindex fn cp
 101 @syncodeindex vr cp
 102
 103
 104 @c   ***** Copyright stuff *****
 105 @ifset FDL
 106 @copying
 107 @copyrightDeclare
 108
 109 @emph{The translation of the following copyright notice is provided
 110 for courtesy to non-English speakers, but only the notice in English
 111 legally counts.}
 112
 113 @emph{La traduction de la notice de droits d'auteur ci-dessous vise à
 114 faciliter sa compréhension par le lecteur non anglophone, mais seule la
 115 notice en anglais a valeur légale.}
 116
 117 @quotation
 118 Vous avez le droit de copier, distribuer et/ou modifier ce document
 119 selon les termes de la Licence GNU de documentation libre, version 1.1
 120 ou tout autre version ultérieure publiée par la Free Software
 121 Foundation, ``sans aucune section invariante''.
 122 Une copie de la licence est fournie à la section ``Licence GNU de documentation libre''.
 123 @end quotation
 124
 125 @quotation
 126 Permission is granted to copy, distribute and/or modify this document
 127 under the terms of the GNU Free Documentation License, Version 1.1
 128 or any later version published by the Free Software Foundation;
 129 with no Invariant Sections.
 130 A copy of the license is included in the section entitled ``GNU
 131 Free Documentation License''.
 132 @end quotation
 133 @end copying
 134 @end ifset
 135
 136 @ifclear FDL
 137 @copying
 138 Ce document a été placé dans le domaine public ; en France, les auteurs
 139 renoncent à tous leurs droits patrimoniaux.
 140 @end copying
 141 @end ifclear
 142
 143
 144 @c   ***** Title page *****
 145 @ifnottex
 146 @node Top
 147 @top LilyPond --- \TITLE\
 148
 149 @cartouche
 150 @manualIntro{}
 151 @end cartouche
 152 @end ifnottex
 153
 154 @finalout
 155
 156 @titlepage
 157 @title LilyPond
 158 @subtitle Le système de gravure musicale
 159 @titlefont{\TITLE\}
 160 @author L'équipe de développement de LilyPond
 161
 162 @vskip 60pt
 163
 164 @cartouche
 165 @manualIntro{}
 166 @end cartouche
 167
 168 @vskip 40pt
 169
 170 @docMain{}
 171
 172 @vskip 0pt plus 1filll
 173
 174 @insertcopying
 175
 176 Pour LilyPond version @version{}
 177 @end titlepage
 178
 179 @end macro
 180
 181
 182 @c   ***** Headings in a doc subsection *****
 183
 184 @c Don't insert an empty line after @predefined!  Right now
 185 @c it doesn't matter, but a future implementation will probably
 186 @c add some code which needs this restriction.
 187
 188 @macro predefined
 189 @noindent
 190 @subsubheading Commandes prédéfinies
 191 @end macro
 192
 193 @c The next macro is a dummy currently since texinfo doesn't
 194 @c provide a real ragged-right environment yet.
 195 @c
 196 @c Due to a bug in texi2html (texi2html.pl CVS versions <= 1.245)
 197 @c the macro must not be empty.
 198
 199 @macro endpredefined
 200 @c
 201 @end macro
 202
 203
 204 @macro snippets
 205 @noindent
 206 @subsubheading Morceaux choisis
 207 @end macro
 208
 209
 210 @c obsolete, remove when translation is fully updated
 211 @macro commonprop
 212 @noindent
 213 @subsubheading Propriétés couramment modifiées
 214 @end macro
 215
 216
 217 @c Don't insert an empty line after @seealso!  Otherwise we get
 218 @c unwanted extra vertical space in the PDF output.
 219
 220 @macro seealso
 221 @noindent
 222 @subsubheading Voir aussi
 223 @indent
 224 @end macro
 225
 226
 227 @macro knownissues
 228 @noindent
 229 @subsubheading Problèmes connus et avertissements
 230 @end macro
 231
 232
 233
 234
 235 @c   ***** Links and references *****
 236
 237 @c  Definitions for references:
 238 @c
 239 @c     @rweb
 240 @c     @ressay
 241 @c     @rglos
 242 @c     @rlearning
 243 @c     @ruser
 244 @c     @rprogram
 245 @c     @rlsr
 246 @c     @rinternals
 247 @c     @rextend
 248 @c     @rchanges
 249 @c     @rcontrib
 250 @c
 251 @c  All these also have a @...named version which allows to specify the
 252 @c  displayed text for the reference as second argument.
 253
 254 @c
 255 @c ***** HTML + bigpage is a special case (other manual names); all other
 256 @c formats are treated similarly.
 257
 258
 259 @c *** not TeX ***
 260
 261 @ifnottex
 262
 263 @c ** bigpage **
 264
 265 @ifset bigpage
 266
 267 @macro rweb{TEXT}
 268 @vindex \TEXT\
 269 @ref{\TEXT\,,,web-big-page,Informations générales}
 270 @end macro
 271
 272 @macro rwebnamed{TEXT,DISPLAY}
 273 @vindex \TEXT\
 274 @ref{\TEXT\,,\DISPLAY\,web-big-page,Informations générales}
 275 @end macro
 276
 277 @macro rglos{TEXT}
 278 @vindex \TEXT\
 279 @ref{\TEXT\,,,music-glossary-big-page,Glossaire}
 280 @end macro
 281
 282 @macro rglosnamed{TEXT,DISPLAY}
 283 @vindex \TEXT\
 284 @ref{\TEXT\,,\DISPLAY\,music-glossary-big-page,Glossaire}
 285 @end macro
 286
 287 @macro rlearning{TEXT}
 288 @vindex \TEXT\
 289 @ref{\TEXT\,,,learning-big-page,Manuel d'initiation}
 290 @end macro
 291
 292 @macro rlearningnamed{TEXT,DISPLAY}
 293 @vindex \TEXT\
 294 @ref{\TEXT\,,\DISPLAY\,learning-big-page,Manuel d'initiation}
 295 @end macro
 296
 297 @macro ruser{TEXT}
 298 @vindex \TEXT\
 299 @ref{\TEXT\,,,notation-big-page,Manuel de notation}
 300 @end macro
 301
 302 @macro rusernamed{TEXT,DISPLAY}
 303 @vindex \TEXT\
 304 @ref{\TEXT\,,\DISPLAY\,notation-big-page,Manuel de notation}
 305 @end macro
 306
 307 @macro ressay{TEXT}
 308 @vindex \TEXT\
 309 @ref{\TEXT\,,,essay-big-page,Essai}
 310 @end macro
 311
 312 @macro ressaynamed{TEXT,DISPLAY}
 313 @vindex \TEXT\
 314 @ref{\TEXT\,,\DISPLAY\,essay-big-page,Essai}
 315 @end macro
 316
 317 @macro rprogram{TEXT}
 318 @vindex \TEXT\
 319 @ref{\TEXT\,,,usage-big-page,Manuel d'utilisation du programme}
 320 @end macro
 321
 322 @macro rprogramnamed{TEXT,DISPLAY}
 323 @vindex \TEXT\
 324 @ref{\TEXT\,,\DISPLAY\,usage-big-page,Manuel d'utilisation du programme}
 325 @end macro
 326
 327 @macro rlsr{TEXT}
 328 @vindex \TEXT\
 329 @ref{\TEXT\,,,snippets-big-page,Morceaux choisis}
 330 @end macro
 331
 332 @macro rlsrnamed{TEXT,DISPLAY}
 333 @ref{\TEXT\,,\DISPLAY\,snippets-big-page,Morceaux choisis}
 334 @end macro
 335
 336 @macro rinternals{TEXT}
 337 @vindex \TEXT\
 338 @ref{\TEXT\,,,internals-big-page,Référence des propriétés internes}
 339 @end macro
 340
 341 @macro rinternalsnamed{TEXT,DISPLAY}
 342 @vindex \TEXT\
 343 @ref{\TEXT\,,,internals-big-page,Référence des propriétés internes}
 344 @end macro
 345
 346 @macro rextend{TEXT}
 347 @vindex \TEXT\
 348 @ref{\TEXT\,,,extending-big-page,Extension de LilyPond}
 349 @end macro
 350
 351 @macro rextendnamed{TEXT,DISPLAY}
 352 @vindex \TEXT\
 353 @ref{\TEXT\,,\DISPLAY\,extending-big-page,Extension de LilyPond}
 354 @end macro
 355
 356 @macro rchanges{TEXT}
 357 @vindex \TEXT\
 358 @ref{\TEXT\,,,changes-big-page,Nouveautés}
 359 @end macro
 360
 361 @macro rchangesnamed{TEXT,DISPLAY}
 362 @vindex \TEXT\
 363 @ref{\TEXT\,,\DISPLAY\,changes-big-page,Nouveautés}
 364 @end macro
 365
 366 @macro rcontrib{TEXT}
 367 @vindex \TEXT\
 368 @ref{\TEXT\,,,contributor-big-page,Guide des contributeurs}
 369 @end macro
 370
 371 @macro rcontribnamed{TEXT,DISPLAY}
 372 @vindex \TEXT\
 373 @ref{\TEXT\,,\DISPLAY\,contributor-big-page,Guide des contributeurs}
 374 @end macro
 375
 376 @end ifset
 377
 378
 379 @c ** not bigpage **
 380
 381 @ifclear bigpage
 382
 383 @macro rweb{TEXT}
 384 @vindex \TEXT\
 385 @ref{\TEXT\,,,web,Informations générales}
 386 @end macro
 387
 388 @macro rwebnamed{TEXT,DISPLAY}
 389 @vindex \TEXT\
 390 @ref{\TEXT\,,\DISPLAY\,web,Informations générales}
 391 @end macro
 392
 393 @macro rglos{TEXT}
 394 @vindex \TEXT\
 395 @ref{\TEXT\,,,music-glossary,Glossaire}
 396 @end macro
 397
 398 @macro rglosnamed{TEXT,DISPLAY}
 399 @vindex \TEXT\
 400 @ref{\TEXT\,,\DISPLAY\,music-glossary,Glossaire}
 401 @end macro
 402
 403 @macro rlearning{TEXT}
 404 @vindex \TEXT\
 405 @ref{\TEXT\,,,learning,Manuel d'initiation}
 406 @end macro
 407
 408 @macro rlearningnamed{TEXT,DISPLAY}
 409 @vindex \TEXT\
 410 @ref{\TEXT\,,\DISPLAY\,learning,Manuel d'initiation}
 411 @end macro
 412
 413 @macro ruser{TEXT}
 414 @vindex \TEXT\
 415 @ref{\TEXT\,,,notation,Manuel de notation}
 416 @end macro
 417
 418 @macro rusernamed{TEXT,DISPLAY}
 419 @vindex \TEXT\
 420 @ref{\TEXT\,,\DISPLAY\,notation,Manuel de notation}
 421 @end macro
 422
 423 @macro ressay{TEXT}
 424 @vindex \TEXT\
 425 @ref{\TEXT\,,,essay,Essai}
 426 @end macro
 427
 428 @macro ressaynamed{TEXT,DISPLAY}
 429 @vindex \TEXT\
 430 @ref{\TEXT\,,\DISPLAY\,essay,Essai}
 431 @end macro
 432
 433 @macro rprogram{TEXT}
 434 @vindex \TEXT\
 435 @ref{\TEXT\,,,usage,Manuel d'utilisation du programme}
 436 @end macro
 437
 438 @macro rprogramnamed{TEXT,DISPLAY}
 439 @vindex \TEXT\
 440 @ref{\TEXT\,,\DISPLAY\,usage,Manuel d'utilisation du programme}
 441 @end macro
 442
 443 @macro rlsr{TEXT}
 444 @vindex \TEXT\
 445 @ref{\TEXT\,,,snippets,Morceaux choisis}
 446 @end macro
 447
 448 @macro rlsrnamed{TEXT,DISPLAY}
 449 @ref{\TEXT\,,\DISPLAY\,snippets,Morceaux choisis}
 450 @end macro
 451
 452 @macro rinternals{TEXT}
 453 @vindex \TEXT\
 454 @ref{\TEXT\,,,internals,Référence des propriétés internes}
 455 @end macro
 456
 457 @macro rinternalsnamed{TEXT,DISPLAY}
 458 @vindex \TEXT\
 459 @ref{\TEXT\,,,internals,Référence des propriétés internes}
 460 @end macro
 461
 462 @macro rextend{TEXT}
 463 @vindex \TEXT\
 464 @ref{\TEXT\,,,extending,Extension de LilyPond}
 465 @end macro
 466
 467 @macro rextendnamed{TEXT,DISPLAY}
 468 @vindex \TEXT\
 469 @ref{\TEXT\,,\DISPLAY\,extending,Extension de LilyPond}
 470 @end macro
 471
 472 @macro rchanges{TEXT}
 473 @vindex \TEXT\
 474 @ref{\TEXT\,,,changes,Nouveautés}
 475 @end macro
 476
 477 @macro rchangesnamed{TEXT,DISPLAY}
 478 @vindex \TEXT\
 479 @ref{\TEXT\,,\DISPLAY\,changes,Nouveautés}
 480 @end macro
 481
 482 @macro rcontrib{TEXT}
 483 @vindex \TEXT\
 484 @ref{\TEXT\,,,contributor,Guide des contributeurs}
 485 @end macro
 486
 487 @macro rcontribnamed{TEXT,DISPLAY}
 488 @vindex \TEXT\
 489 @ref{\TEXT\,,\DISPLAY\,contributor,Guide des contributeurs}
 490 @end macro
 491
 492 @end ifclear
 493
 494 @end ifnottex
 495
 496
 497 @c *** TeX ***
 498
 499 @iftex
 500
 501 @c All commands below should work in the middle of the line;
 502 @c we thus must not use @vindex directly since it works only if placed
 503 @c on a line of its own.  To overcome this problem, we define a
 504 @c replacement macro using the internal definition of @vindex which
 505 @c delimits arguments in the standard way (i.e., with braces).
 506
 507 @tex
 508 \gdef\lilyvindex#1{\doind{vr}{\code{#1}}\ignorespaces}
 509 @end tex
 510
 511 @macro rweb{TEXT}
 512 @lilyvindex \TEXT\
 513 @ref{\TEXT\,,,web.fr,Informations générales}
 514 @end macro
 515
 516 @macro rwebnamed{TEXT,DISPLAY}
 517 @lilyvindex \TEXT\
 518 @ref{\TEXT\,,\DISPLAY\,web.fr,Informations générales}
 519 @end macro
 520
 521 @macro rglos{TEXT}
 522 @lilyvindex{\TEXT\}
 523 @ref{\TEXT\,,,music-glossary,Glossaire}
 524 @end macro
 525
 526 @macro rglosnamed{TEXT,DISPLAY}
 527 @lilyvindex{\TEXT\}
 528 @ref{\TEXT\,,\DISPLAY\,music-glossary,Glossaire}
 529 @end macro
 530
 531 @macro rlearning{TEXT}
 532 @lilyvindex{\TEXT\}
 533 @ref{\TEXT\,,,learning.fr,Manuel d'initiation}
 534 @end macro
 535
 536 @macro rlearningnamed{TEXT,DISPLAY}
 537 @lilyvindex{\TEXT\}
 538 @ref{\TEXT\,,\DISPLAY\,learning.fr,Manuel d'initiation}
 539 @end macro
 540
 541 @macro ruser{TEXT}
 542 @lilyvindex{\TEXT\}
 543 @ref{\TEXT\,,,notation.fr,Manuel de notation}
 544 @end macro
 545
 546 @macro rusernamed{TEXT,DISPLAY}
 547 @lilyvindex{\TEXT\}
 548 @ref{\TEXT\,,\DISPLAY\,notation.fr,Manuel de notation}
 549 @end macro
 550
 551 @macro ressay{TEXT}
 552 @vindex \TEXT\
 553 @ref{\TEXT\,,,lilypond-essay,Essai}
 554 @end macro
 555
 556 @macro ressaynamed{TEXT,DISPLAY}
 557 @vindex \TEXT\
 558 @ref{\TEXT\,,\DISPLAY\,lilypond-essay,Essai}
 559 @end macro
 560
 561 @macro rprogram{TEXT}
 562 @lilyvindex{\TEXT\}
 563 @ref{\TEXT\,,,usage.fr,Manuel d'utilisation du programme}
 564 @end macro
 565
 566 @macro rprogramnamed{TEXT,DISPLAY}
 567 @lilyvindex{\TEXT\}
 568 @ref{\TEXT\,,\DISPLAY\,usage.fr,Manuel d'utilisation du programme}
 569 @end macro
 570
 571 @macro rlsr{TEXT}
 572 @lilyvindex{\TEXT\}
 573 @ref{\TEXT\,,,snippets,Morceaux choisis}
 574 @end macro
 575
 576 @macro rlsrnamed{TEXT,DISPLAY}
 577 @lilyvindex{\TEXT\}
 578 @ref{\TEXT\,,\DISPLAY\,snippets,Morceaux choisis}
 579 @end macro
 580
 581 @macro rinternals{TEXT}
 582 @lilyvindex{\TEXT\}
 583 @ref{\TEXT\,,,internals,Référence des propriétés internes}
 584 @end macro
 585
 586 @macro rinternalsnamed{TEXT,DISPLAY}
 587 @lilyvindex{\TEXT\}
 588 @ref{\TEXT\,,,internals,Référence des propriétés internes}
 589 @end macro
 590
 591 @macro rextend{TEXT}
 592 @vindex \TEXT\
 593 @ref{\TEXT\,,,extending,Extension de LilyPond}
 594 @end macro
 595
 596 @macro rextendnamed{TEXT,DISPLAY}
 597 @vindex \TEXT\
 598 @ref{\TEXT\,,\DISPLAY\,extending,Extension de LilyPond}
 599 @end macro
 600
 601 @macro rchanges{TEXT}
 602 @vindex \TEXT\
 603 @ref{\TEXT\,,,changes,Nouveautés}
 604 @end macro
 605
 606 @macro rchangesnamed{TEXT,DISPLAY}
 607 @vindex \TEXT\
 608 @ref{\TEXT\,,\DISPLAY\,changes,Nouveautés}
 609 @end macro
 610
 611 @macro rcontrib{TEXT}
 612 @vindex \TEXT\
 613 @ref{\TEXT\,,,contributor,Guide des contributeurs}
 614 @end macro
 615
 616 @macro rcontribnamed{TEXT,DISPLAY}
 617 @vindex \TEXT\
 618 @ref{\TEXT\,,\DISPLAY\,contributor,Guide des contributeurs}
 619 @end macro
 620
 621 @end iftex
 622
 623
 624
 625 @c   ***** Macros specific to translated docs *****
 626
 627 @macro englishref
 628 Cette section n'est pas encore encore traduite, veuillez
 629 vous reporter à la documentation correspondante en anglais.
 630 @end macro
 631
 632 @c  ***** Macros specific to the web site *****
 633
 634 @ifset web
 635
 636 @macro exampleImage{IMAGE-FILE}
 637 @html
 638 <div class="float-center">
 639   <a class="clickable" href="ly-examples/\IMAGE-FILE\.png">
 640     <img src="ly-examples/\IMAGE-FILE\-small.png" alt="\IMAGE-FILE\">
 641   </a>
 642   <p style="text-align: center">
 643     (cliquez pour agrandir)
 644   </p>
 645 </div>
 646 @end html
 647 @iftex
 648 @image{examples/\IMAGE-FILE\-small,,,\IMAGE-FILE\,png}
 649 @end iftex
 650 @ifinfo
 651 @image{lilypond/examples/\IMAGE-FILE\,,,\IMAGE-FILE\,png}
 652 @end ifinfo
 653 @end macro
 654
 655 @macro help{TEXT}
 656 @html
 657 <div class="help">
 658 <strong>
 659   <span style="text-decoration:blink">À l'aide&nbsp;:</span>
 660 </strong> \TEXT\
 661 </div>
 662 @end html
 663 @end macro
 664
 665 @c LEGALESE
 666
 667 @macro logoLegalLinux
 668 Tux le pingouin Linux a été créé par
 669 @uref{mailto:lewing@@isc.tamu.edu, lewing@@isc.tamu.edu} avec
 670 @uref{http://www.isc.tamu.edu/~lewing/gimp/,GIMP}.
 671
 672 @end macro
 673
 674 @macro logoLegalFreeBSD
 675 Le logo FreeBSD logo est une marque déposée par la
 676 @uref{http://www.freebsd.org/,Fondation FreeBSD}.
 677
 678 @end macro
 679
 680 @macro logoLegalMacOSX
 681 L'image @q{X} n'est pas déposée.  Elle a été créée par
 682 @uref{http://en.wikipedia.org/wiki/User:Nihonjoe, Nihonjoe} et
 683 @uref{http://en.wikipedia.org/wiki/User:CyberSkull, CyberSkull}, et
 684 distribuée sous la licence GNU Free Documentation License version 1.2 ou
 685 ultérieure.
 686 Nous avons trouvé cette image sur
 687 @uref{http://commons.wikimedia.org/wiki/File:Mac_OS_X_Userbox_X.png,
 688 cette page de Wikimedia Commons}.
 689
 690 @end macro
 691
 692 @macro logoLegalWindows
 693 Le @qq{rectangle aux quatre couleurs} n'est pas une marque déposée.
 694 Il a été créé par @uref{http://en.wikipedia.org/wiki/User:Rohitbd, Rohitbd} et
 695 distribué sous la licence GNU Free Documentation License version 1.2.  Nous
 696 avons trouvé cette image sur
 697 @uref{http://commons.wikimedia.org/wiki/Category:Microsoft_Windows_logos,
 698 cette page de Wikimedia Commons}.
 699
 700 @end macro
 701
 702 @end ifset