Documentation/fr/macros.itexi

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