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