Documentation/fr/user/macros.itexi

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @ignore
   3     Translation of GIT committish: 8135382760aa0adfac5aed987a272c394e59dbdb
   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
  12
  13 @c Don't replace quotes with directed quotes.
  14
  15 @set txicodequoteundirected
  16 @set txicodequotebacktick
  17
  18
  19
  20 @c   ***** Displaying text *****
  21
  22 @c We need this since @q{\} doesn't work with makeinfo 4.11 --
  23 @c say @q{@bs{}} instead.
  24
  25 @macro bs
  26 \\
  27 @end macro
  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 @cartouche
  61 @b{Note :} \TEXT\
  62 @end cartouche
  63 @end macro
  64
  65 @end ifhtml
  66
  67 @ifnothtml
  68
  69 @macro warning{TEXT}
  70 @quotation
  71 @quotation
  72 @cartouche
  73 @b{Note :} \TEXT\
  74 @end cartouche
  75 @end quotation
  76 @end quotation
  77 @end macro
  78
  79 @end ifnothtml
  80
  81
  82 @ifnotinfo
  83
  84 @macro notation{TEXT}
  85 @var{\TEXT\}
  86 @end macro
  87
  88 @end ifnotinfo
  89
  90 @ifinfo
  91
  92 @macro notation{TEXT}
  93 \TEXT\
  94 @end macro
  95
  96 @end ifinfo
  97
  98
  99 @macro smallspace
 100 @sp 1
 101 @end macro
 102
 103
 104
 105 @c   ***** Displaying images not generated by lilypond-book *****
 106
 107 @c Current installation setup of Info docs requires that all images are
 108 @c expected to be found in the `lilypond/' subdirectory.  `lilypond-book'
 109 @c already generates proper @image commands for images of music; these
 110 @c macro definitions do the same for other images.
 111
 112 @ifnotinfo
 113
 114 @macro sourceimage{FILENAME,WIDTH,HEIGHT,ALTTEXT}
 115 @image{\FILENAME\,\WIDTH\,\HEIGHT\,\ALTTEXT\}
 116 @end macro
 117
 118 @end ifnotinfo
 119
 120 @ifinfo
 121
 122 @macro sourceimage{FILENAME,WIDTH,HEIGHT,ALTTEXT}
 123 @image{lilypond/\FILENAME\,\WIDTH\,\HEIGHT\,\ALTTEXT\}
 124 @end macro
 125
 126 @end ifinfo
 127
 128
 129
 130 @c   ***** Headings in a doc subsection *****
 131
 132 @c Don't insert an empty line after @predefined!  Right now
 133 @c it doesn't matter, but a future implementation will probably
 134 @c add some code which needs this restriction.
 135
 136 @macro predefined
 137 @noindent
 138 @subsubheading Predefined commands
 139 @end macro
 140
 141 @c The next macro is a dummy currently since texinfo doesn't
 142 @c provide a real ragged-right environment yet.
 143 @c
 144 @c Due to a bug in texi2html (texi2html.pl CVS versions <= 1.245)
 145 @c the macro must not be empty.
 146
 147 @macro endpredefined
 148 @c
 149 @end macro
 150
 151
 152 @macro snippets
 153 @noindent
 154 @subsubheading Selected Snippets
 155 @end macro
 156
 157
 158 @c obsolete, remove when translation is fully updated
 159 @macro commonprop
 160 @noindent
 161 @subsubheading Commonly tweaked properties
 162 @end macro
 163
 164
 165 @c Don't insert an empty line after @seealso!  Otherwise we get
 166 @c unwanted extra vertical space in the PDF output.
 167
 168 @macro seealso
 169 @noindent
 170 @subsubheading See also
 171 @indent
 172 @end macro
 173
 174
 175 @macro knownissues
 176 @noindent
 177 @subsubheading Known issues and warnings
 178 @end macro
 179
 180
 181 @macro lydoctitle {TEXT}
 182 @emph{\TEXT\}
 183 @end macro
 184
 185
 186 @c Don't remove the `@c' within the macro definition!  See section 19.3,
 187 @c `Macro Details and Caveats', in the texinfo info file for explanation.
 188
 189 @macro funindex {TEXT}
 190 @findex \TEXT\
 191 @kindex \TEXT\
 192 @c
 193 @end macro
 194
 195
 196
 197 @c   ***** Links and references *****
 198
 199 @c  Definitions for references:
 200 @c
 201 @c     @rglos
 202 @c     @rlearning
 203 @c     @ruser
 204 @c     @rprogram
 205 @c     @rlsr
 206 @c     @rinternals
 207 @c
 208 @c  All these also have a @...named version which allows to specify the
 209 @c  displayed text for the reference as second argument.
 210 @c
 211 @c ***** HTML + bigpage is a special case (other manual names); all other
 212 @c formats are treated similarly.
 213
 214
 215 @c *** not TeX ***
 216
 217 @ifnottex
 218
 219 @c ** bigpage **
 220
 221 @ifset bigpage
 222
 223 @macro rglos{TEXT}
 224 @vindex \TEXT\
 225 @ref{\TEXT\,,,music-glossary-big-page,Glossaire}
 226 @end macro
 227
 228 @macro rglosnamed{TEXT,DISPLAY}
 229 @vindex \TEXT\
 230 @ref{\TEXT\,,\DISPLAY\,music-glossary-big-page,Glossaire}
 231 @end macro
 232
 233 @macro rlearning{TEXT}
 234 @vindex \TEXT\
 235 @ref{\TEXT\,,,lilypond-learning-big-page,Manuel d'initiation}
 236 @end macro
 237
 238 @macro rlearningnamed{TEXT,DISPLAY}
 239 @vindex \TEXT\
 240 @ref{\TEXT\,,\DISPLAY\,lilypond-learning-big-page,Manuel d'initiation}
 241 @end macro
 242
 243 @macro ruser{TEXT}
 244 @vindex \TEXT\
 245 @ref{\TEXT\,,,lilypond-big-page,Manuel de notation}
 246 @end macro
 247
 248 @macro rusernamed{TEXT,DISPLAY}
 249 @vindex \TEXT\
 250 @ref{\TEXT\,,\DISPLAY\,lilypond-big-page,Manuel de notation}
 251 @end macro
 252
 253 @macro rprogram{TEXT}
 254 @vindex \TEXT\
 255 @ref{\TEXT\,,,lilypond-program-big-page,Manuel d'utilisation du programme}
 256 @end macro
 257
 258 @macro rprogramnamed{TEXT,DISPLAY}
 259 @vindex \TEXT\
 260 @ref{\TEXT\,,\DISPLAY\,lilypond-program-big-page,Manuel d'utilisation du programme}
 261 @end macro
 262
 263 @macro rlsr{TEXT}
 264 @vindex \TEXT\
 265 @ref{\TEXT\,,,lilypond-snippets-big-page,Exemples de code}
 266 @end macro
 267
 268 @macro rlsrnamed{TEXT,DISPLAY}
 269 @ref{\TEXT\,,\DISPLAY\,lilypond-snippets-big-page,Exemples de code}
 270 @end macro
 271
 272 @macro rinternals{TEXT}
 273 @vindex \TEXT\
 274 @ref{\TEXT\,,,lilypond-internals-big-page,Référence des propriétés internes}
 275 @end macro
 276
 277 @macro rinternalsnamed{TEXT,DISPLAY}
 278 @vindex \TEXT\
 279 @ref{\TEXT\,,,lilypond-internals-big-page,Référence des propriétés internes}
 280 @end macro
 281
 282 @end ifset
 283
 284
 285 @c ** not bigpage **
 286
 287 @ifclear bigpage
 288
 289 @macro rglos{TEXT}
 290 @vindex \TEXT\
 291 @ref{\TEXT\,,,music-glossary,Glossaire}
 292 @end macro
 293
 294 @macro rglosnamed{TEXT,DISPLAY}
 295 @vindex \TEXT\
 296 @ref{\TEXT\,,\DISPLAY\,music-glossary,Glossaire}
 297 @end macro
 298
 299 @macro rlearning{TEXT}
 300 @vindex \TEXT\
 301 @ref{\TEXT\,,,lilypond-learning,Manuel d'initiation}
 302 @end macro
 303
 304 @macro rlearningnamed{TEXT,DISPLAY}
 305 @vindex \TEXT\
 306 @ref{\TEXT\,,\DISPLAY\,lilypond-learning,Manuel d'initiation}
 307 @end macro
 308
 309 @macro ruser{TEXT}
 310 @vindex \TEXT\
 311 @ref{\TEXT\,,,lilypond,Manuel de notation}
 312 @end macro
 313
 314 @macro rusernamed{TEXT,DISPLAY}
 315 @vindex \TEXT\
 316 @ref{\TEXT\,,\DISPLAY\,lilypond,Manuel de notation}
 317 @end macro
 318
 319 @macro rprogram{TEXT}
 320 @vindex \TEXT\
 321 @ref{\TEXT\,,,lilypond-program,Manuel d'utilisation du programme}
 322 @end macro
 323
 324 @macro rprogramnamed{TEXT,DISPLAY}
 325 @vindex \TEXT\
 326 @ref{\TEXT\,,\DISPLAY\,lilypond-program,Manuel d'utilisation du programme}
 327 @end macro
 328
 329 @macro rlsr{TEXT}
 330 @vindex \TEXT\
 331 @ref{\TEXT\,,,lilypond-snippets,Exemples de code}
 332 @end macro
 333
 334 @macro rlsrnamed{TEXT,DISPLAY}
 335 @ref{\TEXT\,,\DISPLAY\,lilypond-snippets,Exemples de code}
 336 @end macro
 337
 338 @macro rinternals{TEXT}
 339 @vindex \TEXT\
 340 @ref{\TEXT\,,,lilypond-internals,Référence des propriétés internes}
 341 @end macro
 342
 343 @macro rinternalsnamed{TEXT,DISPLAY}
 344 @vindex \TEXT\
 345 @ref{\TEXT\,,,lilypond-internals,Référence des propriétés internes}
 346 @end macro
 347
 348 @end ifclear
 349
 350 @end ifnottex
 351
 352
 353 @c *** TeX ***
 354
 355 @iftex
 356
 357 @macro rglos{TEXT}
 358 @vindex \TEXT\
 359 @ref{\TEXT\,,,music-glossary,Glossaire}
 360 @end macro
 361
 362 @macro rglosnamed{TEXT,DISPLAY}
 363 @vindex \TEXT\
 364 @ref{\TEXT\,,\DISPLAY\,music-glossary,Glossaire}
 365 @end macro
 366
 367 @macro rlearning{TEXT}
 368 @vindex \TEXT\
 369 @ref{\TEXT\,,,lilypond-learning.fr,Manuel d'initiation}
 370 @end macro
 371
 372 @macro rlearningnamed{TEXT,DISPLAY}
 373 @vindex \TEXT\
 374 @ref{\TEXT\,,\DISPLAY\,lilypond-learning.fr,Manuel d'initiation}
 375 @end macro
 376
 377 @macro ruser{TEXT}
 378 @vindex \TEXT\
 379 @ref{\TEXT\,,,lilypond.fr,Manuel de notation}
 380 @end macro
 381
 382 @macro rusernamed{TEXT,DISPLAY}
 383 @vindex \TEXT\
 384 @ref{\TEXT\,,\DISPLAY\,lilypond.fr,Manuel de notation}
 385 @end macro
 386
 387 @macro rprogram{TEXT}
 388 @vindex \TEXT\
 389 @ref{\TEXT\,,,lilypond-program.fr,Manuel d'utilisation du programme}
 390 @end macro
 391
 392 @macro rprogramnamed{TEXT,DISPLAY}
 393 @vindex \TEXT\
 394 @ref{\TEXT\,,\DISPLAY\,lilypond-program.fr,Manuel d'utilisation du programme}
 395 @end macro
 396
 397 @macro rlsr{TEXT}
 398 @ref{\TEXT\,,,lilypond-snippets,Exemples de code}
 399 @end macro
 400
 401 @macro rlsrnamed{TEXT,DISPLAY}
 402 @ref{\TEXT\,,\DISPLAY\,lilypond-snippets,Exemples de code}
 403 @end macro
 404
 405 @macro rinternals{TEXT}
 406 @vindex \TEXT\
 407 @ref{\TEXT\,,,lilypond-internals,Référence des propriétés internes}
 408 @end macro
 409
 410 @macro rinternalsnamed{TEXT,DISPLAY}
 411 @vindex \TEXT\
 412 @ref{\TEXT\,,,lilypond-internals,Référence des propriétés internes}
 413 @end macro
 414
 415 @end iftex
 416
 417
 418
 419 @c   ***** Macros specific to translated docs *****
 420
 421 @c ugh, cannot set/define global variable 'translationof' in some way?
 422
 423 @iftex
 424
 425 @macro translationof{TEXT}
 426 @end macro
 427
 428 @end iftex
 429
 430 @ifinfo
 431
 432 @macro translationof{TEXT}
 433 @set translationof \TEXT\
 434 @end macro
 435
 436 @end ifinfo
 437
 438
 439 @c TODO: If @translationof is used in translated docs
 440 @c see whether it is feasible to say @value{translationof}.
 441
 442 @macro englishref
 443 Cette section n'est pas encore encore traduite, veuillez
 444 vous reporter à la documentation correspondante en anglais.
 445 @end macro
 446
 447
 448 @ifhtml
 449
 450 @macro untranslated
 451 UNTRANSLATED NODE: IGNORE ME
 452 @end macro
 453
 454 @end ifhtml
 455
 456 @ifnothtml
 457
 458 @macro untranslated
 459 @end macro
 460
 461 @end ifnothtml