Documentation/fr/macros.itexi

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @ignore
   3     Translation of GIT committish: 9d789d3cb5f3b0f227d28d16b81f79dd1dfd2927
   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 @rlearning{À propos de la documentation}.
  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
 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,Essay}
 310 @end macro
 311
 312 @macro ressaynamed{TEXT,DISPLAY}
 313 @vindex \TEXT\
 314 @ref{\TEXT\,,\DISPLAY\,essay-big-page,Essay}
 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,Exemples de code}
 330 @end macro
 331
 332 @macro rlsrnamed{TEXT,DISPLAY}
 333 @ref{\TEXT\,,\DISPLAY\,snippets-big-page,Exemples de code}
 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,Essay}
 426 @end macro
 427
 428 @macro ressaynamed{TEXT,DISPLAY}
 429 @vindex \TEXT\
 430 @ref{\TEXT\,,\DISPLAY\,essay,Essay}
 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,Exemples de code}
 446 @end macro
 447
 448 @macro rlsrnamed{TEXT,DISPLAY}
 449 @ref{\TEXT\,,\DISPLAY\,snippets,Exemples de code}
 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,Essay}
 554 @end macro
 555
 556 @macro ressaynamed{TEXT,DISPLAY}
 557 @vindex \TEXT\
 558 @ref{\TEXT\,,\DISPLAY\,lilypond-essay,Essay}
 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,Exemples de code}
 574 @end macro
 575
 576 @macro rlsrnamed{TEXT,DISPLAY}
 577 @lilyvindex{\TEXT\}
 578 @ref{\TEXT\,,\DISPLAY\,snippets,Exemples de code}
 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="examples/\IMAGE-FILE\.png">
 640     <img src="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 @c LEGALESE
 656
 657 @macro logoLegalLinux
 658 Tux le pingouin Linux a été créé par
 659 @uref{mailto:lewing@@isc.tamu.edu, lewing@@isc.tamu.edu} avec
 660 @uref{http://www.isc.tamu.edu/~lewing/gimp/,GIMP}.
 661
 662 @end macro
 663
 664 @macro logoLegalFreeBSD
 665 Le logo FreeBSD logo est une marque déposée par la
 666 @uref{http://www.freebsd.org/,Fondation FreeBSD}.
 667
 668 @end macro
 669
 670 @macro logoLegalMacOSX
 671 L'image @q{X} n'est pas déposée.  Elle a été créée par
 672 @uref{http://en.wikipedia.org/wiki/User:Nihonjoe, Nihonjoe} et
 673 @uref{http://en.wikipedia.org/wiki/User:CyberSkull, CyberSkull}, et
 674 distribuée sous la licence GNU Free Documentation License version 1.2 ou
 675 ultérieure.
 676 Nous avons trouvé cette image sur
 677 @uref{http://commons.wikimedia.org/wiki/File:Mac_OS_X_Userbox_X.png,
 678 cette page de Wikimedia Commons}.
 679
 680 @end macro
 681
 682 @macro logoLegalWindows
 683 Le @qq{rectangle aux quatre couleurs} n'est pas une marque déposée.
 684 Il a été créé par @uref{http://en.wikipedia.org/wiki/User:Rohitbd, Rohitbd} et
 685 distribué sous la licence GNU Free Documentation License version 1.2.  Nous
 686 avons trouvé cette image sur
 687 @uref{http://commons.wikimedia.org/wiki/Category:Microsoft_Windows_logos,
 688 cette page de Wikimedia Commons}.
 689
 690 @end macro
 691
 692 @end ifset