Documentation/de/user/macros.itexi

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