Documentation/fr/user/macros.itexi

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @ignore
   3     Translation of GIT committish: a88c1b861df238ad1c000e6a86926e6f19f2fedd
   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 @include version.itexi
  10
  11 @c   ***** Displaying text *****
  12
  13 @c we need this since @q{\} doesn't work with makeinfo 4.11 --
  14 @c say @q{@bs} instead
  15 @macro bs
  16 \\
  17 @end macro
  18
  19 @c to get decent quotes in `foo' and ``foo''
  20 @c  these need to be split up so that "@qq{foo}." looks nice.  :(
  21 @iftex
  22 @macro q{TEXT}
  23 @quoteleft{}\TEXT\@quoteright{}
  24 @end macro
  25
  26 @macro qq{TEXT}
  27 @guillemetleft{}@tie{}\TEXT\@tie{}@guillemetright{}
  28 @end macro
  29 @end iftex
  30
  31
  32 @ifinfo
  33 @macro q{TEXT}
  34 `\TEXT\'
  35 @end macro
  36
  37 @macro qq{TEXT}
  38 « \TEXT\ »
  39 @end macro
  40 @end ifinfo
  41
  42
  43 @ifhtml
  44 @macro q{TEXT}
  45 @html
  46 &lsquo;\TEXT\&rsquo;
  47 @end html
  48 @end macro
  49
  50 @macro qq{TEXT}
  51 @html
  52 &laquo;<font size="-4">&nbsp;</font>\TEXT\<font size="-4">&nbsp;</font>&raquo;
  53 @end html
  54 @end macro
  55 @end ifhtml
  56
  57
  58 @ifdocbook
  59 @macro q{TEXT}
  60 @xml
  61 &lsquo;\TEXT\&rsquo;
  62 @end xml
  63 @end macro
  64
  65 @macro qq{TEXT}
  66 @xml
  67 &laquo;<font size="-4">&nbsp;</font>\TEXT\<font size="-4">&nbsp;</font>&raquo;
  68 @end xml
  69 @end macro
  70 @end ifdocbook
  71
  72 @ifhtml
  73 @macro warning{TEXT}
  74 @cartouche
  75 @b{Note :} \TEXT\
  76 @end cartouche
  77 @end macro
  78 @end ifhtml
  79
  80 @ifnothtml
  81 @macro warning{TEXT}
  82 @quotation
  83 @quotation
  84 @cartouche
  85 @b{Note :} \TEXT\
  86 @end cartouche
  87 @end quotation
  88 @end quotation
  89 @end macro
  90 @end ifnothtml
  91
  92 @ifnotinfo
  93 @macro notation{TEXT}
  94 @var{\TEXT\}
  95 @end macro
  96 @end ifnotinfo
  97
  98 @ifinfo
  99 @macro notation{TEXT}
 100 \TEXT\
 101 @end macro
 102 @end ifinfo
 103
 104 @macro smallspace
 105 @sp 1
 106 @end macro
 107
 108
 109 @c   **** Displaying images not generated by lilypond-book
 110
 111 @c current installation setup of Info docs requires that all images are
 112 @c expected to be found in lilypond/ subdirectory.  lilypond-book already
 113 @c generates proper @image commands for images of music; these macros
 114 @c definitions do the same for other images.
 115
 116 @ifnotinfo
 117 @macro sourceimage{FILENAME,WIDTH,HEIGHT,ALTTEXT}
 118 @image{\FILENAME\,\WIDTH\,\HEIGHT\,\ALTTEXT\}
 119 @end macro
 120 @end ifnotinfo
 121
 122 @ifinfo
 123 @macro sourceimage{FILENAME,WIDTH,HEIGHT,ALTTEXT}
 124 @image{lilypond/\FILENAME\,\WIDTH\,\HEIGHT\,\ALTTEXT\}
 125 @end macro
 126 @end ifinfo
 127
 128
 129
 130 @c   **** Headings in a doc subsection ****
 131
 132 @macro predefined
 133 @noindent
 134 @subsubheading Predefined commands
 135
 136 @end macro
 137
 138 @macro snippets
 139 @noindent
 140 @subsubheading Selected Snippets
 141
 142 @end macro
 143
 144 @c obsolete, remove when translation is fully updated
 145 @macro commonprop
 146 @noindent
 147 @subsubheading Commonly tweaked properties
 148
 149 @end macro
 150
 151 @macro seealso
 152 @noindent
 153 @subsubheading See also
 154
 155 @end macro
 156
 157 @macro knownissues
 158 @noindent
 159 @subsubheading Known issues and warnings
 160
 161 @end macro
 162
 163 @macro lydoctitle {TEXT}
 164 @emph{\TEXT\}
 165
 166 @end macro
 167
 168 @macro funindex {TEXT}
 169 @findex \TEXT\
 170 @kindex \TEXT\
 171 @end macro
 172
 173
 174
 175 @c   **** Links and references ****
 176
 177 @c  Definitions for references:
 178 @c     @rglos
 179 @c     @rlearning
 180 @c     @ruser
 181 @c     @rprogram
 182 @c     @rlsr
 183 @c     @rinternals
 184 @c  all these also have a @...named version, which allows to specify the
 185 @c  displayed text for the reference as second argument
 186
 187
 188 @c ***** HTML + bigpage is a special case (other manual names), all other
 189 @c formats are treated similarly
 190
 191 @ifnottex
 192
 193 @ifset bigpage
 194
 195 @macro rglos{TEXT}
 196 @vindex \TEXT\
 197 @ref{\TEXT\,,,music-glossary-big-page,Glossaire}
 198 @end macro
 199
 200 @macro rglosnamed{TEXT,DISPLAY}
 201 @vindex \TEXT\
 202 @ref{\TEXT\,,\DISPLAY\,music-glossary-big-page,Glossaire}
 203 @end macro
 204
 205 @macro rlearning{TEXT}
 206 @vindex \TEXT\
 207 @ref{\TEXT\,,,lilypond-learning-big-page,Manuel d'initiation}
 208 @end macro
 209
 210 @macro rlearningnamed{TEXT,DISPLAY}
 211 @vindex \TEXT\
 212 @ref{\TEXT\,,\DISPLAY\,lilypond-learning-big-page,Manuel d'initiation}
 213 @end macro
 214
 215 @macro ruser{TEXT}
 216 @vindex \TEXT\
 217 @ref{\TEXT\,,,lilypond-big-page,Manuel de notation}
 218 @end macro
 219
 220 @macro rusernamed{TEXT,DISPLAY}
 221 @vindex \TEXT\
 222 @ref{\TEXT\,,\DISPLAY\,lilypond-big-page,Manuel de notation}
 223 @end macro
 224
 225 @macro rprogram{TEXT}
 226 @vindex \TEXT\
 227 @ref{\TEXT\,,,lilypond-program-big-page,Manuel d'utilisation du programme}
 228 @end macro
 229
 230 @macro rprogramnamed{TEXT,DISPLAY}
 231 @vindex \TEXT\
 232 @ref{\TEXT\,,\DISPLAY\,lilypond-program-big-page,Manuel d'utilisation du programme}
 233 @end macro
 234
 235 @macro rlsr{TEXT}
 236 @vindex \TEXT\
 237 @ref{\TEXT\,,,lilypond-snippets-big-page,Exemples de code}
 238 @end macro
 239
 240 @macro rlsrnamed{TEXT,DISPLAY}
 241 @ref{\TEXT\,,\DISPLAY\,lilypond-snippets-big-page,Exemples de code}
 242 @end macro
 243
 244 @macro rinternals{TEXT}
 245 @vindex \TEXT\
 246 @ref{\TEXT\,,,lilypond-internals-big-page,Référence des propriétés internes}
 247 @end macro
 248
 249 @macro rinternalsnamed{TEXT,DISPLAY}
 250 @vindex \TEXT\
 251 @ref{\TEXT\,,,lilypond-internals-big-page,Référence des propriétés internes}
 252 @end macro
 253
 254 @end ifset
 255
 256
 257 @ifclear bigpage
 258
 259 @macro rglos{TEXT}
 260 @vindex \TEXT\
 261 @ref{\TEXT\,,,music-glossary,Glossaire}
 262 @end macro
 263
 264 @macro rglosnamed{TEXT,DISPLAY}
 265 @vindex \TEXT\
 266 @ref{\TEXT\,,\DISPLAY\,music-glossary,Glossaire}
 267 @end macro
 268
 269 @macro rlearning{TEXT}
 270 @vindex \TEXT\
 271 @ref{\TEXT\,,,lilypond-learning,Manuel d'initiation}
 272 @end macro
 273
 274 @macro rlearningnamed{TEXT,DISPLAY}
 275 @vindex \TEXT\
 276 @ref{\TEXT\,,\DISPLAY\,lilypond-learning,Manuel d'initiation}
 277 @end macro
 278
 279 @macro ruser{TEXT}
 280 @vindex \TEXT\
 281 @ref{\TEXT\,,,lilypond,Manuel de notation}
 282 @end macro
 283
 284 @macro rusernamed{TEXT,DISPLAY}
 285 @vindex \TEXT\
 286 @ref{\TEXT\,,\DISPLAY\,lilypond,Manuel de notation}
 287 @end macro
 288
 289 @macro rprogram{TEXT}
 290 @vindex \TEXT\
 291 @ref{\TEXT\,,,lilypond-program,Manuel d'utilisation du programme}
 292 @end macro
 293
 294 @macro rprogramnamed{TEXT,DISPLAY}
 295 @vindex \TEXT\
 296 @ref{\TEXT\,,\DISPLAY\,lilypond-program,Manuel d'utilisation du programme}
 297 @end macro
 298
 299 @macro rlsr{TEXT}
 300 @vindex \TEXT\
 301 @ref{\TEXT\,,,lilypond-snippets,Exemples de code}
 302 @end macro
 303
 304 @macro rlsrnamed{TEXT,DISPLAY}
 305 @ref{\TEXT\,,\DISPLAY\,lilypond-snippets,Exemples de code}
 306 @end macro
 307
 308 @macro rinternals{TEXT}
 309 @vindex \TEXT\
 310 @ref{\TEXT\,,,lilypond-internals,Référence des propriétés internes}
 311 @end macro
 312
 313 @macro rinternalsnamed{TEXT,DISPLAY}
 314 @vindex \TEXT\
 315 @ref{\TEXT\,,,lilypond-internals,Référence des propriétés internes}
 316 @end macro
 317
 318 @end ifclear
 319
 320 @end ifnottex
 321
 322
 323 @c **** TEX ****
 324 @iftex
 325
 326 @macro rglos{TEXT}
 327 @vindex \TEXT\
 328 @ref{\TEXT\,,,music-glossary,Glossaire}
 329 @end macro
 330
 331 @macro rglosnamed{TEXT,DISPLAY}
 332 @vindex \TEXT\
 333 @ref{\TEXT\,,\DISPLAY\,music-glossary,Glossaire}
 334 @end macro
 335
 336 @macro rlearning{TEXT}
 337 @vindex \TEXT\
 338 @ref{\TEXT\,,,lilypond-learning.fr,Manuel d'initiation}
 339 @end macro
 340
 341 @macro rlearningnamed{TEXT,DISPLAY}
 342 @vindex \TEXT\
 343 @ref{\TEXT\,,\DISPLAY\,lilypond-learning.fr,Manuel d'initiation}
 344 @end macro
 345
 346 @macro ruser{TEXT}
 347 @vindex \TEXT\
 348 @ref{\TEXT\,,,lilypond.fr,Manuel de notation}
 349 @end macro
 350
 351 @macro rusernamed{TEXT,DISPLAY}
 352 @vindex \TEXT\
 353 @ref{\TEXT\,,\DISPLAY\,lilypond.fr,Manuel de notation}
 354 @end macro
 355
 356 @macro rprogram{TEXT}
 357 @vindex \TEXT\
 358 @ref{\TEXT\,,,lilypond-program.fr,Manuel d'utilisation du programme}
 359 @end macro
 360
 361 @macro rprogramnamed{TEXT,DISPLAY}
 362 @vindex \TEXT\
 363 @ref{\TEXT\,,\DISPLAY\,lilypond-program.fr,Manuel d'utilisation du programme}
 364 @end macro
 365
 366 @macro rlsr{TEXT}
 367 @ref{\TEXT\,,,lilypond-snippets,Exemples de code}
 368 @end macro
 369
 370 @macro rlsrnamed{TEXT,DISPLAY}
 371 @ref{\TEXT\,,\DISPLAY\,lilypond-snippets,Exemples de code}
 372 @end macro
 373
 374 @macro rinternals{TEXT}
 375 @vindex \TEXT\
 376 @ref{\TEXT\,,,lilypond-internals,Référence des propriétés internes}
 377 @end macro
 378
 379 @macro rinternalsnamed{TEXT,DISPLAY}
 380 @vindex \TEXT\
 381 @ref{\TEXT\,,,lilypond-internals,Référence des propriétés internes}
 382 @end macro
 383
 384 @end iftex
 385
 386
 387 @c **** Macros specific to translated docs ****
 388
 389 @c ugh, cannot set/define global variable 'translationof' in some way?
 390 @iftex
 391 @macro translationof{TEXT}
 392 @end macro
 393 @end iftex
 394
 395 @ifinfo
 396 @macro
 397 @macro translationof{TEXT}
 398 @set translationof \TEXT\
 399 @end macro
 400 @end ifinfo
 401
 402 @c TODO when @translationof is used in translated docs
 403 @c see if it's feasible to say @value{translationof}
 404 @macro englishref
 405 Cette section n'est pas encore encore traduite, veuillez
 406 vous reporter à la documentation correspondante en anglais.
 407 @end macro
 408
 409 @ifhtml
 410 @macro untranslated
 411 UNTRANSLATED NODE: IGNORE ME
 412 @end macro
 413 @end ifhtml
 414
 415 @ifnothtml
 416 @macro untranslated
 417 @end macro
 418 @end ifnothtml