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 @include common-macros.itexi
  12
  13
  14 @c   ***** Displaying text *****
  15
  16 @c To get decent quotes in `foo' and ``foo''.
  17 @c FIXME: Use thin spaces for @qq.
  18
  19 @ifnotinfo
  20
  21 @macro q{TEXT}
  22 @quoteleft{}\TEXT\@quoteright{}
  23 @end macro
  24
  25 @macro qq{TEXT}
  26 @guillemetleft{}@tie{}\TEXT\@tie{}@guillemetright{}
  27 @end macro
  28
  29 @end ifnotinfo
  30
  31 @ifinfo
  32
  33 @macro q{TEXT}
  34 `\TEXT\'
  35 @end macro
  36
  37 @macro qq{TEXT}
  38 « \TEXT\ »
  39 @end macro
  40
  41 @end ifinfo
  42
  43
  44 @ifhtml
  45
  46 @macro warning{TEXT}
  47 @cartouche
  48 @b{Note :} \TEXT\
  49 @end cartouche
  50 @end macro
  51
  52 @end ifhtml
  53
  54 @ifnothtml
  55
  56 @macro warning{TEXT}
  57 @quotation
  58 @quotation
  59 @cartouche
  60 @b{Note :} \TEXT\
  61 @end cartouche
  62 @end quotation
  63 @end quotation
  64 @end macro
  65
  66 @end ifnothtml
  67
  68
  69
  70 @c   ***** Headings in a doc subsection *****
  71
  72 @c Don't insert an empty line after @predefined!  Right now
  73 @c it doesn't matter, but a future implementation will probably
  74 @c add some code which needs this restriction.
  75
  76 @macro predefined
  77 @noindent
  78 @subsubheading Predefined commands
  79 @end macro
  80
  81 @c The next macro is a dummy currently since texinfo doesn't
  82 @c provide a real ragged-right environment yet.
  83 @c
  84 @c Due to a bug in texi2html (texi2html.pl CVS versions <= 1.245)
  85 @c the macro must not be empty.
  86
  87 @macro endpredefined
  88 @c
  89 @end macro
  90
  91
  92 @macro snippets
  93 @noindent
  94 @subsubheading Selected Snippets
  95 @end macro
  96
  97
  98 @c obsolete, remove when translation is fully updated
  99 @macro commonprop
 100 @noindent
 101 @subsubheading Commonly tweaked properties
 102 @end macro
 103
 104
 105 @c Don't insert an empty line after @seealso!  Otherwise we get
 106 @c unwanted extra vertical space in the PDF output.
 107
 108 @macro seealso
 109 @noindent
 110 @subsubheading See also
 111 @indent
 112 @end macro
 113
 114
 115 @macro knownissues
 116 @noindent
 117 @subsubheading Known issues and warnings
 118 @end macro
 119
 120
 121
 122
 123 @c   ***** Links and references *****
 124
 125 @c  Definitions for references:
 126 @c
 127 @c     @rglos
 128 @c     @rlearning
 129 @c     @ruser
 130 @c     @rprogram
 131 @c     @rlsr
 132 @c     @rinternals
 133 @c
 134 @c  All these also have a @...named version which allows to specify the
 135 @c  displayed text for the reference as second argument.
 136 @c
 137 @c ***** HTML + bigpage is a special case (other manual names); all other
 138 @c formats are treated similarly.
 139
 140
 141 @c *** not TeX ***
 142
 143 @ifnottex
 144
 145 @c ** bigpage **
 146
 147 @ifset bigpage
 148
 149 @macro rglos{TEXT}
 150 @vindex \TEXT\
 151 @ref{\TEXT\,,,music-glossary-big-page,Glossaire}
 152 @end macro
 153
 154 @macro rglosnamed{TEXT,DISPLAY}
 155 @vindex \TEXT\
 156 @ref{\TEXT\,,\DISPLAY\,music-glossary-big-page,Glossaire}
 157 @end macro
 158
 159 @macro rlearning{TEXT}
 160 @vindex \TEXT\
 161 @ref{\TEXT\,,,lilypond-learning-big-page,Manuel d'initiation}
 162 @end macro
 163
 164 @macro rlearningnamed{TEXT,DISPLAY}
 165 @vindex \TEXT\
 166 @ref{\TEXT\,,\DISPLAY\,lilypond-learning-big-page,Manuel d'initiation}
 167 @end macro
 168
 169 @macro ruser{TEXT}
 170 @vindex \TEXT\
 171 @ref{\TEXT\,,,lilypond-big-page,Manuel de notation}
 172 @end macro
 173
 174 @macro rusernamed{TEXT,DISPLAY}
 175 @vindex \TEXT\
 176 @ref{\TEXT\,,\DISPLAY\,lilypond-big-page,Manuel de notation}
 177 @end macro
 178
 179 @macro rprogram{TEXT}
 180 @vindex \TEXT\
 181 @ref{\TEXT\,,,lilypond-program-big-page,Manuel d'utilisation du programme}
 182 @end macro
 183
 184 @macro rprogramnamed{TEXT,DISPLAY}
 185 @vindex \TEXT\
 186 @ref{\TEXT\,,\DISPLAY\,lilypond-program-big-page,Manuel d'utilisation du programme}
 187 @end macro
 188
 189 @macro rlsr{TEXT}
 190 @vindex \TEXT\
 191 @ref{\TEXT\,,,lilypond-snippets-big-page,Exemples de code}
 192 @end macro
 193
 194 @macro rlsrnamed{TEXT,DISPLAY}
 195 @ref{\TEXT\,,\DISPLAY\,lilypond-snippets-big-page,Exemples de code}
 196 @end macro
 197
 198 @macro rinternals{TEXT}
 199 @vindex \TEXT\
 200 @ref{\TEXT\,,,lilypond-internals-big-page,Référence des propriétés internes}
 201 @end macro
 202
 203 @macro rinternalsnamed{TEXT,DISPLAY}
 204 @vindex \TEXT\
 205 @ref{\TEXT\,,,lilypond-internals-big-page,Référence des propriétés internes}
 206 @end macro
 207
 208 @end ifset
 209
 210
 211 @c ** not bigpage **
 212
 213 @ifclear bigpage
 214
 215 @macro rglos{TEXT}
 216 @vindex \TEXT\
 217 @ref{\TEXT\,,,music-glossary,Glossaire}
 218 @end macro
 219
 220 @macro rglosnamed{TEXT,DISPLAY}
 221 @vindex \TEXT\
 222 @ref{\TEXT\,,\DISPLAY\,music-glossary,Glossaire}
 223 @end macro
 224
 225 @macro rlearning{TEXT}
 226 @vindex \TEXT\
 227 @ref{\TEXT\,,,lilypond-learning,Manuel d'initiation}
 228 @end macro
 229
 230 @macro rlearningnamed{TEXT,DISPLAY}
 231 @vindex \TEXT\
 232 @ref{\TEXT\,,\DISPLAY\,lilypond-learning,Manuel d'initiation}
 233 @end macro
 234
 235 @macro ruser{TEXT}
 236 @vindex \TEXT\
 237 @ref{\TEXT\,,,lilypond,Manuel de notation}
 238 @end macro
 239
 240 @macro rusernamed{TEXT,DISPLAY}
 241 @vindex \TEXT\
 242 @ref{\TEXT\,,\DISPLAY\,lilypond,Manuel de notation}
 243 @end macro
 244
 245 @macro rprogram{TEXT}
 246 @vindex \TEXT\
 247 @ref{\TEXT\,,,lilypond-program,Manuel d'utilisation du programme}
 248 @end macro
 249
 250 @macro rprogramnamed{TEXT,DISPLAY}
 251 @vindex \TEXT\
 252 @ref{\TEXT\,,\DISPLAY\,lilypond-program,Manuel d'utilisation du programme}
 253 @end macro
 254
 255 @macro rlsr{TEXT}
 256 @vindex \TEXT\
 257 @ref{\TEXT\,,,lilypond-snippets,Exemples de code}
 258 @end macro
 259
 260 @macro rlsrnamed{TEXT,DISPLAY}
 261 @ref{\TEXT\,,\DISPLAY\,lilypond-snippets,Exemples de code}
 262 @end macro
 263
 264 @macro rinternals{TEXT}
 265 @vindex \TEXT\
 266 @ref{\TEXT\,,,lilypond-internals,Référence des propriétés internes}
 267 @end macro
 268
 269 @macro rinternalsnamed{TEXT,DISPLAY}
 270 @vindex \TEXT\
 271 @ref{\TEXT\,,,lilypond-internals,Référence des propriétés internes}
 272 @end macro
 273
 274 @end ifclear
 275
 276 @end ifnottex
 277
 278
 279 @c *** TeX ***
 280
 281 @iftex
 282
 283 @c All commands below should work in the middle of the line;
 284 @c we thus must not use @vindex directly since it works only if placed
 285 @c on a line of its own.  To overcome this problem, we define a
 286 @c replacement macro using the internal definition of @vindex which
 287 @c delimits arguments in the standard way (i.e., with braces).
 288
 289 @tex
 290 \gdef\lilyvindex#1{\doind{vr}{\code #1}\ignorespaces}
 291 @end tex
 292
 293 @macro rglos{TEXT}
 294 @lilyvindex{\TEXT\}
 295 @ref{\TEXT\,,,music-glossary,Glossaire}
 296 @end macro
 297
 298 @macro rglosnamed{TEXT,DISPLAY}
 299 @lilyvindex{\TEXT\}
 300 @ref{\TEXT\,,\DISPLAY\,music-glossary,Glossaire}
 301 @end macro
 302
 303 @macro rlearning{TEXT}
 304 @lilyvindex{\TEXT\}
 305 @ref{\TEXT\,,,lilypond-learning.fr,Manuel d'initiation}
 306 @end macro
 307
 308 @macro rlearningnamed{TEXT,DISPLAY}
 309 @lilyvindex{\TEXT\}
 310 @ref{\TEXT\,,\DISPLAY\,lilypond-learning.fr,Manuel d'initiation}
 311 @end macro
 312
 313 @macro ruser{TEXT}
 314 @lilyvindex{\TEXT\}
 315 @ref{\TEXT\,,,lilypond.fr,Manuel de notation}
 316 @end macro
 317
 318 @macro rusernamed{TEXT,DISPLAY}
 319 @lilyvindex{\TEXT\}
 320 @ref{\TEXT\,,\DISPLAY\,lilypond.fr,Manuel de notation}
 321 @end macro
 322
 323 @macro rprogram{TEXT}
 324 @lilyvindex{\TEXT\}
 325 @ref{\TEXT\,,,lilypond-program.fr,Manuel d'utilisation du programme}
 326 @end macro
 327
 328 @macro rprogramnamed{TEXT,DISPLAY}
 329 @lilyvindex{\TEXT\}
 330 @ref{\TEXT\,,\DISPLAY\,lilypond-program.fr,Manuel d'utilisation du programme}
 331 @end macro
 332
 333 @macro rlsr{TEXT}
 334 @lilyvindex{\TEXT\}
 335 @ref{\TEXT\,,,lilypond-snippets,Exemples de code}
 336 @end macro
 337
 338 @macro rlsrnamed{TEXT,DISPLAY}
 339 @lilyvindex{\TEXT\}
 340 @ref{\TEXT\,,\DISPLAY\,lilypond-snippets,Exemples de code}
 341 @end macro
 342
 343 @macro rinternals{TEXT}
 344 @lilyvindex{\TEXT\}
 345 @ref{\TEXT\,,,lilypond-internals,Référence des propriétés internes}
 346 @end macro
 347
 348 @macro rinternalsnamed{TEXT,DISPLAY}
 349 @lilyvindex{\TEXT\}
 350 @ref{\TEXT\,,,lilypond-internals,Référence des propriétés internes}
 351 @end macro
 352
 353 @end iftex
 354
 355
 356 @c   ***** Macros specific to translated docs *****
 357
 358 @macro englishref
 359 Cette section n'est pas encore encore traduite, veuillez
 360 vous reporter à la documentation correspondante en anglais.
 361 @end macro