Documentation/fr/user/macros.itexi

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @ignore
   3     Translation of GIT committish: 6ffead15d2e3dffd294c8e030938facef896d861
   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 @c **** all formats ****
  10
  11 @macro refbugs
  12 @noindent
  13 @subsubheading Bugs
  14
  15 @end macro
  16
  17 @macro moreinfo
  18 @subheading More information
  19
  20 @end macro
  21
  22 @macro seealso
  23 @noindent
  24 @subsubheading See also
  25
  26 @end macro
  27
  28 @macro refcommands
  29 @noindent
  30 @subsubheading Predefined commands
  31
  32 @end macro
  33
  34 @macro context{NAME}
  35 @vindex \NAME\
  36 @code{\NAME\}@c should use internalsref
  37 @end macro
  38
  39 @macro refcommand{WHAT}
  40 @vindex \WHAT\
  41 @code{\WHAT\}
  42 @end macro
  43
  44 @macro commonprop
  45 @noindent
  46 @subsubheading Commonly tweaked properties
  47
  48 @end macro
  49
  50 @macro funindex {WORD}
  51 @findex \WORD\
  52 @kindex \WORD\
  53 @end macro
  54
  55
  56
  57 @c  *** Macros with variable output ***
  58
  59 @c usage: @lsr{ancient,custodes.ly}
  60 @macro lsr{DIR,NAME}
  61 @ifhtml
  62   @uref{source/input/lsr/\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}
  63 @end ifhtml
  64 @ifnothtml
  65   @file{\DIR\/\NAME\}
  66 @end ifnothtml
  67 @end macro
  68
  69 @macro lsrdir{DIR}
  70 @ifhtml
  71   @uref{source/input/lsr/\DIR\/collated-files.html,@file{\DIR\}/}
  72 @end ifhtml
  73 @ifnothtml
  74   @file{\DIR\}
  75 @end ifnothtml
  76 @end macro
  77
  78
  79
  80
  81 @macro arrow{}
  82 @iftex
  83 @tex $\\Rightarrow$ @end tex@c
  84 @end iftex
  85 @ifhtml
  86 @html
  87 &rarr;
  88 @end html
  89 @end ifhtml
  90 @ifinfo
  91 -->
  92 @end ifinfo
  93 @end macro
  94
  95
  96 @c we need this since @q{\} doesn't work with makeinfo 4.8 --
  97 @c say @q{@value{backslash}} instead
  98 @set backslash \
  99
 100
 101 @ifhtml
 102 @c ***** HTML *****
 103
 104 @c makeinfo-4.7 encodes html names, which means that nodes that
 105 @c contain nonalphanum characters will be broken links on the website.
 106 @c @uref{../lilypond-internals/\NAME\.html,\NAME\}@c
 107 @c @inforef{} adds ``See'' to the sentence, which is annoying, but
 108 @c better than a broken link.
 109 @c @inforef{\NAME\,,lilypond-internals}@c
 110 @c using @ref without punctuation is OK without for formats other than info
 111
 112 @ifset bigpage
 113
 114 @macro internalsref{NAME}
 115 @vindex \NAME\
 116 @ref{\NAME\,,,lilypond-internals-big-page}
 117 @end macro
 118
 119 @macro rglos{NAME}
 120 @vindex \NAME\
 121 @ref{\NAME\,,,music-glossary-big-page}
 122 @end macro
 123
 124 @macro rprogram{NAME}
 125 @vindex \NAME\
 126 @ref{\NAME\,,,lilypond-program-big-page}
 127 @end macro
 128
 129 @macro ruser{NAME}
 130 @vindex \NAME\
 131 @ref{\NAME\,,,lilypond-big-page}
 132 @end macro
 133
 134 @macro rlearing{NAME}
 135 @vindex \NAME\
 136 @ref{\NAME\,,,lilypond-learning-big-page}
 137 @end macro
 138
 139
 140 @end ifset
 141
 142
 143 @ifclear bigpage
 144
 145 @macro internalsref{NAME}
 146 @vindex \NAME\
 147 @ref{\NAME\,,,lilypond-internals}
 148 @end macro
 149
 150 @macro rglos{NAME}
 151 @vindex \NAME\
 152 @ref{\NAME\,,,music-glossary}
 153 @end macro
 154
 155 @macro rprogram{NAME}
 156 @vindex \NAME\
 157 @ref{\NAME\,,,lilypond-program}
 158 @end macro
 159
 160 @macro ruser{NAME}
 161 @vindex \NAME\
 162 @ref{\NAME\,,,lilypond}
 163 @end macro
 164
 165 @macro rlearning{NAME}
 166 @vindex \NAME\
 167 @ref{\NAME\,,,lilypond-learning}
 168 @end macro
 169
 170 @end ifclear
 171
 172
 173 @c to get decent quotes in `foo'
 174 @macro q{TEXT}
 175 @html
 176 &lsquo;\TEXT\&rsquo;
 177 @end html
 178 @end macro
 179
 180 @c to get decent French quotes in ``foo''
 181 @macro qq{TEXT}
 182 @html
 183 &laquo;&thinsp;\TEXT\&thinsp;&raquo;
 184 @end html
 185 @end macro
 186
 187 @end ifhtml
 188
 189
 190 @ifdocbook
 191 @c ***** DOCBOOK-XML *****
 192
 193 @macro internalsref{NAME}
 194 @vindex \NAME\
 195 @ref{\NAME\,,,lilypond-internals}
 196 @end macro
 197
 198 @macro rglos{NAME}
 199 @vindex \NAME\
 200 @ref{\NAME\,,,music-glossary}
 201 @end macro
 202
 203 @macro rprogram{NAME}
 204 @vindex \NAME\
 205 @ref{\NAME\,,,lilypond-program}
 206 @end macro
 207
 208 @macro ruser{NAME}
 209 @vindex \NAME\
 210 @ref{\NAME\,,,lilypond}
 211 @end macro
 212
 213 @macro rlearning{NAME}
 214 @vindex \NAME\
 215 @ref{\NAME\,,,lilypond-learning}
 216 @end macro
 217
 218 @c to get decent quotes in `foo'
 219 @macro q{TEXT}
 220 @html
 221 &lsquo;\TEXT\&rsquo;
 222 @end html
 223 @end macro
 224
 225 @c to get decent French quotes in ``foo''
 226 @macro qq{TEXT}
 227 @html
 228 &laquo;&thinsp;\TEXT\&thinsp;&raquo;
 229 @end html
 230 @end macro
 231
 232 @end ifdocbook
 233
 234
 235 @ifinfo
 236 @c **** INFO ****
 237
 238 @macro internalsref{NAME}
 239 @vindex \NAME\
 240 @inforef{\NAME\,,lilypond-internals}
 241 @end macro
 242
 243 @macro rglos{NAME}
 244 @vindex \NAME\
 245 @inforef{\NAME\,,,music-glossary}
 246 @end macro
 247
 248 @macro usermanref{NAME}
 249 @inforef{\NAME\}
 250 @end macro
 251
 252 @macro rprogram{NAME}
 253 @vindex \NAME\
 254 @ref{\NAME\,,,lilypond-program}
 255 @end macro
 256
 257 @macro ruser{NAME}
 258 @vindex \NAME\
 259 @ref{\NAME\,,,lilypond}
 260 @end macro
 261
 262 @macro rlearning{NAME}
 263 @vindex \NAME\
 264 @ref{\NAME\,,,lilypond-learning}
 265 @end macro
 266
 267 @c to get decent quotes in `foo'
 268 @macro q{TEXT}
 269 `\TEXT\'
 270 @end macro
 271
 272 @c to get decent French quotes in ``foo''
 273 @macro qq{TEXT}
 274 « \TEXT\ »
 275 @end macro
 276
 277 @end ifinfo
 278
 279
 280 @c **** TEX ****
 281 @iftex
 282
 283 @macro internalsref{NAME}
 284 @vindex \NAME\
 285 @code{\NAME\}
 286 @end macro
 287
 288 @macro rglos {NAME}
 289 @vindex \NAME\
 290 @code{\NAME\}
 291 @end macro
 292
 293 @macro seeinternals{NAME}
 294 @emph{Référence du programme}, @internalsref{\NAME\}
 295 @end macro
 296
 297 @macro usermanref{NAME}
 298 @emph{Manuel de l'utilisateur, \NAME\}
 299 @end macro
 300
 301 @macro rprogram{NAME}
 302 @emph{Manuel d'utilisation du programme, \NAME\}
 303 @end macro
 304
 305 @macro rlearning{NAME}
 306 @emph{Manuel d'apprentissage du programme, \NAME\}
 307 @end macro
 308
 309 @alias ruser=usermanref
 310
 311 @c to get decent French quotes in `foo'
 312 @macro q{TEXT}
 313 `\TEXT\'
 314 @end macro
 315
 316 @c to get decent French quotes in ``foo''
 317 @macro qq{TEXT}
 318 @guillemetleft{}@tie{}\TEXT\@tie{}@guillemetright{}
 319 @end macro
 320
 321 @end iftex
 322
 323
 324 @ifnottex
 325 @c **** not TEX ****
 326
 327 @macro seeinternals{NAME}
 328 @internalsref{\NAME\}
 329 @end macro
 330
 331 @ifnotinfo
 332 @macro usermanref{NAME}
 333 @ref{\NAME\}
 334 @end macro
 335 @end ifnotinfo
 336
 337 @end ifnottex
 338
 339
 340 @c EOF