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