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