Documentation/ja/user/macros.itexi

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @ignore
   3     Translation of GIT committish: 499a511d4166feaada31114e097f86b5e0c56421
   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 @c Translators: Yoshiki Sawada
  13
  14 @c Don't replace quotes with directed quotes.
  15
  16 @set txicodequoteundirected
  17 @set txicodequotebacktick
  18
  19
  20
  21 @c   ***** Displaying text *****
  22
  23 @c We need this since @q{\} doesn't work with makeinfo 4.11 --
  24 @c say @q{@bs{}} instead.
  25
  26 @macro bs
  27 \\
  28 @end macro
  29
  30 @macro hash
  31 \#
  32 @end macro
  33
  34 @c To get decent quotes in `foo' and ``foo''.
  35 @c FIXME: Use thin spaces for @qq.
  36
  37 @ifnotinfo
  38
  39 @macro q{TEXT}
  40 @quoteleft{}\TEXT\@quoteright{}
  41 @end macro
  42
  43 @macro qq{TEXT}
  44 @quotedblleft{}\TEXT\@quotedblright{}
  45 @end macro
  46
  47 @end ifnotinfo
  48
  49 @ifinfo
  50
  51 @macro q{TEXT}
  52 `\TEXT\'
  53 @end macro
  54
  55 @macro qq{TEXT}
  56 « \TEXT\ »
  57 @end macro
  58
  59 @end ifinfo
  60
  61
  62 @ifhtml
  63
  64 @macro warning{TEXT}
  65 @cartouche
  66 @b{Note:} \TEXT\
  67 @end cartouche
  68 @end macro
  69
  70 @end ifhtml
  71
  72 @ifnothtml
  73
  74 @macro warning{TEXT}
  75 @quotation
  76 @quotation
  77 @cartouche
  78 @b{Note:} \TEXT\
  79 @end cartouche
  80 @end quotation
  81 @end quotation
  82 @end macro
  83
  84 @end ifnothtml
  85
  86
  87 @ifnotinfo
  88
  89 @macro notation{TEXT}
  90 @var{\TEXT\}
  91 @end macro
  92
  93 @end ifnotinfo
  94
  95 @ifinfo
  96
  97 @macro notation{TEXT}
  98 \TEXT\
  99 @end macro
 100
 101 @end ifinfo
 102
 103
 104 @macro smallspace
 105 @sp 1
 106 @end macro
 107
 108
 109
 110 @c   ***** Displaying images not generated by lilypond-book *****
 111
 112 @c Current installation setup of Info docs requires that all images are
 113 @c expected to be found in the `lilypond/' subdirectory.  `lilypond-book'
 114 @c already generates proper @image commands for images of music; these
 115 @c macro definitions do the same for other images.
 116
 117 @ifnotinfo
 118
 119 @macro sourceimage{FILENAME,WIDTH,HEIGHT,ALTTEXT}
 120 @image{\FILENAME\,\WIDTH\,\HEIGHT\,\ALTTEXT\}
 121 @end macro
 122
 123 @end ifnotinfo
 124
 125 @ifinfo
 126
 127 @macro sourceimage{FILENAME,WIDTH,HEIGHT,ALTTEXT}
 128 @image{lilypond/\FILENAME\,\WIDTH\,\HEIGHT\,\ALTTEXT\}
 129 @end macro
 130
 131 @end ifinfo
 132
 133
 134
 135 @c   ***** Headings in a doc subsection *****
 136
 137 @c Don't insert an empty line after @predefined!  Right now
 138 @c it doesn't matter, but a future implementation will probably
 139 @c add some code which needs this restriction.
 140
 141 @macro predefined
 142 @noindent
 143 @subsubheading Predefined commands
 144 @end macro
 145
 146 @c The next macro is a dummy currently since texinfo doesn't
 147 @c provide a real ragged-right environment yet.
 148 @c
 149 @c Due to a bug in texi2html (texi2html.pl CVS versions <= 1.245)
 150 @c the macro must not be empty.
 151
 152 @macro endpredefined
 153 @c
 154 @end macro
 155
 156
 157 @macro snippets
 158 @noindent
 159 @subsubheading Selected Snippets
 160 @end macro
 161
 162
 163 @c Don't insert an empty line after @seealso!  Otherwise we get
 164 @c unwanted extra vertical space in the PDF output.
 165
 166 @macro seealso
 167 @noindent
 168 @subsubheading See also
 169 @indent
 170 @end macro
 171
 172
 173 @macro knownissues
 174 @noindent
 175 @subsubheading Known issues and warnings
 176 @end macro
 177
 178
 179 @macro lydoctitle {TEXT}
 180 @emph{\TEXT\}
 181 @end macro
 182
 183
 184 @c Don't remove the `@c' within the macro definition!  See section 19.3,
 185 @c `Macro Details and Caveats', in the texinfo info file for explanation.
 186
 187 @macro funindex {TEXT}
 188 @findex \TEXT\
 189 @kindex \TEXT\
 190 @c
 191 @end macro
 192
 193
 194
 195 @c   ***** Links and references *****
 196
 197 @c  Definitions for references:
 198 @c
 199 @c     @rglos
 200 @c     @rlearning
 201 @c     @ruser
 202 @c     @rprogram
 203 @c     @rlsr
 204 @c     @rinternals
 205 @c
 206 @c  All these also have a @...named version which allows to specify the
 207 @c  displayed text for the reference as second argument.
 208 @c
 209 @c ***** HTML + bigpage is a special case (other manual names); all other
 210 @c formats are treated similarly.
 211
 212
 213 @c *** not TeX ***
 214
 215 @ifnottex
 216
 217 @c ** bigpage **
 218
 219 @ifset bigpage
 220
 221 @macro rglos{TEXT}
 222 @vindex \TEXT\
 223 @ref{\TEXT\,,,music-glossary-big-page,Music Glossary}
 224 @end macro
 225
 226 @macro rglosnamed{TEXT,DISPLAY}
 227 @vindex \TEXT\
 228 @ref{\TEXT\,,\DISPLAY\,music-glossary-big-page,Music Glossary}
 229 @end macro
 230
 231 @macro rlearning{TEXT}
 232 @vindex \TEXT\
 233 @ref{\TEXT\,,,lilypond-learning-big-page,Learning Manual}
 234 @end macro
 235
 236 @macro rlearningnamed{TEXT,DISPLAY}
 237 @vindex \TEXT\
 238 @ref{\TEXT\,,\DISPLAY\,lilypond-learning-big-page,Learning Manual}
 239 @end macro
 240
 241 @macro ruser{TEXT}
 242 @vindex \TEXT\
 243 @ref{\TEXT\,,,lilypond-big-page,Notation Reference}
 244 @end macro
 245
 246 @macro rusernamed{TEXT,DISPLAY}
 247 @vindex \TEXT\
 248 @ref{\TEXT\,,\DISPLAY\,lilypond-big-page,Notation Reference}
 249 @end macro
 250
 251 @macro rprogram{TEXT}
 252 @vindex \TEXT\
 253 @ref{\TEXT\,,,lilypond-program-big-page,Application Usage}
 254 @end macro
 255
 256 @macro rprogramnamed{TEXT,DISPLAY}
 257 @vindex \TEXT\
 258 @ref{\TEXT\,,\DISPLAY\,lilypond-program-big-page,Application Usage}
 259 @end macro
 260
 261 @macro rlsr{TEXT}
 262 @ref{\TEXT\,,,lilypond-snippets-big-page,Snippets}
 263 @end macro
 264
 265 @macro rlsrnamed{TEXT,DISPLAY}
 266 @ref{\TEXT\,,\DISPLAY\,lilypond-snippets-big-page,Snippets}
 267 @end macro
 268
 269 @macro rinternals{TEXT}
 270 @vindex \TEXT\
 271 @ref{\TEXT\,,,lilypond-internals-big-page,Internals Reference}
 272 @end macro
 273
 274 @macro rinternalsnamed{TEXT,DISPLAY}
 275 @vindex \TEXT\
 276 @ref{\TEXT\,,\DISPLAY\,lilypond-internals-big-page,Internals Reference}
 277 @end macro
 278
 279 @end ifset
 280
 281
 282 @c ** not bigpage **
 283
 284 @ifclear bigpage
 285
 286 @macro rglos{TEXT}
 287 @vindex \TEXT\
 288 @ref{\TEXT\,,,music-glossary,Music Glossary}
 289 @end macro
 290
 291 @macro rglosnamed{TEXT,DISPLAY}
 292 @vindex \TEXT\
 293 @ref{\TEXT\,,\DISPLAY\,music-glossary,Music Glossary}
 294 @end macro
 295
 296 @macro rlearning{TEXT}
 297 @vindex \TEXT\
 298 @ref{\TEXT\,,,lilypond-learning,Learning Manual}
 299 @end macro
 300
 301 @macro rlearningnamed{TEXT,DISPLAY}
 302 @vindex \TEXT\
 303 @ref{\TEXT\,,,lilypond-learning,Learning Manual}
 304 @end macro
 305
 306 @macro ruser{TEXT}
 307 @vindex \TEXT\
 308 @ref{\TEXT\,,,lilypond,Notation Reference}
 309 @end macro
 310
 311 @macro rusernamed{TEXT,DISPLAY}
 312 @vindex \TEXT\
 313 @ref{\TEXT\,,\DISPLAY\,lilypond,Notation Reference}
 314 @end macro
 315
 316 @macro rprogram{TEXT}
 317 @vindex \TEXT\
 318 @ref{\TEXT\,,,lilypond-program,Application Usage}
 319 @end macro
 320
 321 @macro rprogramnamed{TEXT,DISPLAY}
 322 @vindex \TEXT\
 323 @ref{\TEXT\,,\DISPLAY\,lilypond-program,Application Usage}
 324 @end macro
 325
 326 @macro rlsr{TEXT}
 327 @ref{\TEXT\,,,lilypond-snippets,Snippets}
 328 @end macro
 329
 330 @macro rlsrnamed{TEXT,DISPLAY}
 331 @ref{\TEXT\,,\DISPLAY\,lilypond-snippets,Snippets}
 332 @end macro
 333
 334 @macro rinternals{TEXT}
 335 @vindex \TEXT\
 336 @ref{\TEXT\,,,lilypond-internals,Internals Reference}
 337 @end macro
 338
 339 @macro rinternalsnamed{TEXT,DISPLAY}
 340 @vindex \TEXT\
 341 @ref{\TEXT\,,\DISPLAY\,lilypond-internals,Internals Reference}
 342 @end macro
 343
 344 @end ifclear
 345
 346 @end ifnottex
 347
 348
 349 @c *** TeX ***
 350
 351 @iftex
 352
 353 @macro rglos{TEXT}
 354 @vindex \TEXT\
 355 @ref{\TEXT\,,,music-glossary,Music Glossary}
 356 @end macro
 357
 358 @macro rglosnamed{TEXT,DISPLAY}
 359 @vindex \TEXT\
 360 @ref{\TEXT\,,\DISPLAY\,music-glossary,Music Glossary}
 361 @end macro
 362
 363 @macro rlearning{TEXT}
 364 @ref{\TEXT\,,,lilypond-learning,Learning Manual}
 365 @end macro
 366
 367 @macro rlearningnamed{TEXT,DISPLAY}
 368 @ref{\TEXT\,,\DISPLAY\,lilypond-learning,Learning Manual}
 369 @end macro
 370
 371 @macro ruser{TEXT}
 372 @ref{\TEXT\,,,lilypond,Notation Reference}
 373 @end macro
 374
 375 @macro rusernamed{TEXT,DISPLAY}
 376 @ref{\TEXT\,,\DISPLAY\,lilypond,Notation Reference}
 377 @end macro
 378
 379 @macro rprogram{TEXT}
 380 @ref{\TEXT\,,,lilypond-program,Application Usage}
 381 @end macro
 382
 383 @macro rprogramnamed{TEXT,DISPLAY}
 384 @ref{\TEXT\,,\DISPLAY\,lilypond-program,Application Usage}
 385 @end macro
 386
 387 @macro rlsr{TEXT}
 388 @ref{\TEXT\,,,lilypond-snippets,Snippets}
 389 @end macro
 390
 391 @macro rlsrnamed{TEXT,DISPLAY}
 392 @ref{\TEXT\,,\DISPLAY\,lilypond-snippets,Snippets}
 393 @end macro
 394
 395 @macro rinternals{TEXT}
 396 @vindex \TEXT\
 397 @ref{\TEXT\,,,lilypond-internals,Internals Reference}
 398 @end macro
 399
 400 @macro rinternalsnamed{TEXT,DISPLAY}
 401 @vindex \TEXT\
 402 @ref{\TEXT\,,\DISPLAY\,lilypond-internals,Internals Reference}
 403 @end macro
 404
 405 @end iftex
 406
 407
 408
 409
 410
 411 @c   ***** Macros specific to translated docs *****
 412
 413 @c ugh, cannot set/define global variable 'translationof' in some way?
 414
 415 @iftex
 416
 417 @macro translationof{TEXT}
 418 @end macro
 419
 420 @end iftex
 421
 422 @ifinfo
 423
 424 @macro translationof{TEXT}
 425 @set translationof \TEXT\
 426 @end macro
 427
 428 @end ifinfo
 429
 430
 431 @c TODO: If @translationof is used in translated docs
 432 @c see whether it is feasible to say @value{translationof}.
 433
 434 @macro englishref
 435 Cette section n'est pas encore encore traduite, veuillez
 436 vous reporter à la documentation correspondante en anglais.
 437 @end macro
 438
 439
 440 @ifhtml
 441
 442 @ifset bigpage
 443 @macro untranslated
 444 @end macro
 445 @end ifset
 446
 447 @ifclear bigpage
 448 @macro untranslated
 449 UNTRANSLATED NODE: IGNORE ME
 450 @end macro
 451 @end ifclear
 452
 453 @end ifhtml
 454
 455 @ifnothtml
 456
 457 @macro untranslated
 458 @end macro
 459
 460 @end ifnothtml