1 @c -*- coding: utf-8; mode: texinfo; -*-
3 Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. For details, see the Contributors'
7 Guide, node Updating translation committishes..
11 @include version.itexi
12 @include common-macros.itexi
15 ****************************
16 MACRO DEFINITIONS GUIDELINES
17 ****************************
19 This file should contain macro definitions which are common to all
20 languages, i.e. all macro definitions which do not contain text that
21 should be translated (namely text visible in the output).
23 Macro definitions which contain text that should be translated in
24 translations should be in macros.itexi.
27 @c ***** Displaying text *****
29 @c To get decent quotes in `foo' and ``foo''.
32 @quoteleft{}\TEXT\@quoteright{}
36 @quotedblleft{}\TEXT\@quotedblright{}
47 @c keep the space for proper nesting of </p>
73 For more information about how this manual fits with the other
74 documentation, or to read this manual in other formats, see
77 If you are missing any manuals, the complete documentation can be
78 found at @w{@uref{http://@/www@/.lilypond@/.org/}}.
83 @macro lilyTitlePage{TITLE}
84 @c This produces the unified index
89 @c ***** Copyright stuff *****
95 Permission is granted to copy, distribute and/or modify this document
96 under the terms of the GNU Free Documentation License, Version 1.1
97 or any later version published by the Free Software Foundation;
98 with no Invariant Sections.
99 A copy of the license is included in the section entitled ``GNU
100 Free Documentation License''.
107 This document has been placed in the public domain.
113 @c ***** Title page *****
116 @top LilyPond --- \TITLE\
127 @subtitle The music typesetter
129 @author The LilyPond development team
141 @vskip 0pt plus 1filll
145 For LilyPond version @version{}
151 @c ***** Headings in a doc subsection *****
153 @c The next macro is a dummy currently since texinfo doesn't
154 @c provide a real ragged-right environment yet.
156 @c Don't insert an empty line after @predefined! Right now
157 @c it doesn't matter, but a future implementation will probably
158 @c add some code which needs this restriction.
162 @subsubheading Predefined commands
165 @c Due to a bug in texi2html (texi2html.pl CVS versions <= 1.245)
166 @c the next macro must not be empty.
175 @subsubheading Selected Snippets
179 @c Don't insert an empty line after @seealso! Otherwise we get
180 @c unwanted extra vertical space in the PDF output.
184 @subsubheading See also
191 @subsubheading Known issues and warnings
196 @c ***** Links and references *****
198 @c Definitions for references:
212 @c All these also have a @...named version which allows to specify the
213 @c displayed text for the reference as second argument.
215 @c ***** HTML + bigpage is a special case (other manual names); all other
216 @c formats are treated similarly.
229 @ref{\TEXT\,,,music-glossary-big-page,Music Glossary}
232 @macro rglosnamed{TEXT,DISPLAY}
234 @ref{\TEXT\,,\DISPLAY\,music-glossary-big-page,Music Glossary}
237 @macro rlearning{TEXT}
239 @ref{\TEXT\,,,learning-big-page,Learning Manual}
242 @macro rlearningnamed{TEXT,DISPLAY}
244 @ref{\TEXT\,,\DISPLAY\,learning-big-page,Learning Manual}
249 @ref{\TEXT\,,,notation-big-page,Notation Reference}
252 @macro rusernamed{TEXT,DISPLAY}
254 @ref{\TEXT\,,\DISPLAY\,notation-big-page,Notation Reference}
259 @ref{\TEXT\,,,extending-big-page,Extending}
262 @macro rextendnamed{TEXT,DISPLAY}
264 @ref{\TEXT\,,\DISPLAY\,extending-big-page,Extending}
267 @macro rchanges{TEXT}
269 @ref{\TEXT\,,,changes-big-page,Changes}
272 @macro rchangesnamed{TEXT,DISPLAY}
274 @ref{\TEXT\,,\DISPLAY\,changes-big-page,Changes}
277 @macro rcontrib{TEXT}
279 @ref{\TEXT\,,,contributor-big-page,Contributor's Guide}
282 @macro rcontribnamed{TEXT,DISPLAY}
284 @ref{\TEXT\,,\DISPLAY\,contributor-big-page,Contributor's Guide}
289 @ref{\TEXT\,,,web-big-page,General Information}
292 @macro rwebnamed{TEXT,DISPLAY}
294 @ref{\TEXT\,,\DISPLAY\,web-big-page,General Information}
299 @ref{\TEXT\,,,essay-big-page,Essay}
302 @macro ressaynamed{TEXT,DISPLAY}
304 @ref{\TEXT\,,\DISPLAY\,essay-big-page,Essay}
307 @macro rprogram{TEXT}
309 @ref{\TEXT\,,,usage-big-page,Application Usage}
312 @macro rprogramnamed{TEXT,DISPLAY}
314 @ref{\TEXT\,,\DISPLAY\,usage-big-page,Application Usage}
318 @ref{\TEXT\,,,snippets-big-page,Snippets}
321 @macro rlsrnamed{TEXT,DISPLAY}
322 @ref{\TEXT\,,\DISPLAY\,snippets-big-page,Snippets}
325 @macro rinternals{TEXT}
327 @ref{\TEXT\,,,internals-big-page,Internals Reference}
330 @macro rinternalsnamed{TEXT,DISPLAY}
332 @ref{\TEXT\,,\DISPLAY\,internals-big-page,Internals Reference}
346 @ref{\TEXT\,,,music-glossary,Music Glossary}
349 @macro rglosnamed{TEXT,DISPLAY}
351 @ref{\TEXT\,,\DISPLAY\,music-glossary,Music Glossary}
354 @macro rlearning{TEXT}
356 @ref{\TEXT\,,,learning,Learning Manual}
359 @macro rlearningnamed{TEXT,DISPLAY}
361 @ref{\TEXT\,,,learning,Learning Manual}
366 @ref{\TEXT\,,,notation,Notation Reference}
369 @macro rusernamed{TEXT,DISPLAY}
371 @ref{\TEXT\,,\DISPLAY\,notation,Notation Reference}
374 @macro rchanges{TEXT}
376 @ref{\TEXT\,,,changes,Changes}
379 @macro rchangesnamed{TEXT,DISPLAY}
381 @ref{\TEXT\,,\DISPLAY\,changes,Changes}
386 @ref{\TEXT\,,,extending,Extending}
389 @macro rextendnamed{TEXT,DISPLAY}
391 @ref{\TEXT\,,\DISPLAY\,extending,Extending}
394 @macro rcontrib{TEXT}
396 @ref{\TEXT\,,,contributor,Contributor's Guide}
399 @macro rcontribnamed{TEXT,DISPLAY}
401 @ref{\TEXT\,,\DISPLAY\,contributor,Contributor's Guide}
406 @ref{\TEXT\,,,web,General Information}
409 @macro rwebnamed{TEXT,DISPLAY}
411 @ref{\TEXT\,,\DISPLAY\,web,General Information}
416 @ref{\TEXT\,,,essay,Essay}
419 @macro ressaynamed{TEXT,DISPLAY}
421 @ref{\TEXT\,,\DISPLAY\,essay,Essay}
424 @macro rprogram{TEXT}
426 @ref{\TEXT\,,,usage,Application Usage}
429 @macro rprogramnamed{TEXT,DISPLAY}
431 @ref{\TEXT\,,\DISPLAY\,usage,Application Usage}
435 @ref{\TEXT\,,,snippets,Snippets}
438 @macro rlsrnamed{TEXT,DISPLAY}
439 @ref{\TEXT\,,\DISPLAY\,snippets,Snippets}
442 @macro rinternals{TEXT}
444 @ref{\TEXT\,,,internals,Internals Reference}
447 @macro rinternalsnamed{TEXT,DISPLAY}
449 @ref{\TEXT\,,\DISPLAY\,internals,Internals Reference}
458 @ref{\TEXT\,,,music-glossary,Music Glossary}
461 @macro rglosnamed{TEXT,DISPLAY}
463 @ref{\TEXT\,,\DISPLAY\,music-glossary,Music Glossary}
466 @macro rlearning{TEXT}
468 @ref{\TEXT\,,,lilypond-learning,Learning Manual}
471 @macro rlearningnamed{TEXT,DISPLAY}
473 @ref{\TEXT\,,,lilypond-learning,Learning Manual}
478 @ref{\TEXT\,,,lilypond-notation,Notation Reference}
481 @macro rusernamed{TEXT,DISPLAY}
483 @ref{\TEXT\,,\DISPLAY\,lilypond-notation,Notation Reference}
486 @macro rchanges{TEXT}
488 @ref{\TEXT\,,,lilypond-changes,Changes}
491 @macro rchangesnamed{TEXT,DISPLAY}
493 @ref{\TEXT\,,\DISPLAY\,lilypond-changes,Changes}
498 @ref{\TEXT\,,,lilypond-extending,Extending}
501 @macro rextendnamed{TEXT,DISPLAY}
503 @ref{\TEXT\,,\DISPLAY\,lilypond-extending,Extending}
506 @macro rcontrib{TEXT}
508 @ref{\TEXT\,,,lilypond-contributor,Contributor's Guide}
511 @macro rcontribnamed{TEXT,DISPLAY}
513 @ref{\TEXT\,,\DISPLAY\,lilypond-contributor,Contributor's Guide}
518 @ref{\TEXT\,,,lilypond-web,General Information}
521 @macro rwebnamed{TEXT,DISPLAY}
523 @ref{\TEXT\,,\DISPLAY\,lilypond-web, General Information}
528 @ref{\TEXT\,,,lilypond-essay,Essay}
531 @macro ressaynamed{TEXT,DISPLAY}
533 @ref{\TEXT\,,\DISPLAY\,lilypond-essay,Essay}
536 @macro rprogram{TEXT}
538 @ref{\TEXT\,,,lilypond-usage,Application Usage}
541 @macro rprogramnamed{TEXT,DISPLAY}
543 @ref{\TEXT\,,\DISPLAY\,lilypond-usage,Application Usage}
547 @ref{\TEXT\,,,lilypond-snippets,Snippets}
550 @macro rlsrnamed{TEXT,DISPLAY}
551 @ref{\TEXT\,,\DISPLAY\,lilypond-snippets,Snippets}
554 @macro rinternals{TEXT}
556 @ref{\TEXT\,,,lilypond-internals,Internals Reference}
559 @macro rinternalsnamed{TEXT,DISPLAY}
561 @ref{\TEXT\,,\DISPLAY\,lilypond-internals,Internals Reference}
575 @c All commands below should work in the middle of the line;
576 @c we thus must not use @vindex directly since it works only if placed
577 @c on a line of its own. To overcome this problem, we define a
578 @c replacement macro using the internal definition of @vindex which
579 @c delimits arguments in the standard way (i.e., with braces).
582 \gdef\lilyvindex#1{\doind{vr}{\code{#1}}\ignorespaces}
587 @ref{\TEXT\,,,music-glossary,Music Glossary}
590 @macro rglosnamed{TEXT,DISPLAY}
592 @ref{\TEXT\,,\DISPLAY\,music-glossary,Music Glossary}
595 @macro rlearning{TEXT}
597 @ref{\TEXT\,,,learning,Learning Manual}
600 @macro rlearningnamed{TEXT,DISPLAY}
602 @ref{\TEXT\,,\DISPLAY\,learning,Learning Manual}
607 @ref{\TEXT\,,,notation,Notation Reference}
610 @macro rusernamed{TEXT,DISPLAY}
612 @ref{\TEXT\,,\DISPLAY\,notation,Notation Reference}
615 @macro rchanges{TEXT}
617 @ref{\TEXT\,,,changes,Changes}
620 @macro rchangesnamed{TEXT,DISPLAY}
622 @ref{\TEXT\,,\DISPLAY\,changes,Changes}
627 @ref{\TEXT\,,,extending,Extending}
630 @macro rextendnamed{TEXT,DISPLAY}
632 @ref{\TEXT\,,\DISPLAY\,extending,Extending}
635 @macro rcontrib{TEXT}
637 @ref{\TEXT\,,,contributor,Contributor's Guide}
640 @macro rcontribnamed{TEXT,DISPLAY}
642 @ref{\TEXT\,,\DISPLAY\,contributor,Contributor's Guide}
647 @ref{\TEXT\,,,web,General Information}
650 @macro rwebnamed{TEXT,DISPLAY}
652 @ref{\TEXT\,,\DISPLAY\,web,General Information}
657 @ref{\TEXT\,,,essay,Essay}
660 @macro ressaynamed{TEXT,DISPLAY}
662 @ref{\TEXT\,,\DISPLAY\,essay,Essay}
665 @macro rprogram{TEXT}
667 @ref{\TEXT\,,,usage,Application Usage}
670 @macro rprogramnamed{TEXT,DISPLAY}
672 @ref{\TEXT\,,\DISPLAY\,usage,Application Usage}
677 @ref{\TEXT\,,,snippets,Snippets}
680 @macro rlsrnamed{TEXT,DISPLAY}
682 @ref{\TEXT\,,\DISPLAY\,snippets,Snippets}
685 @macro rinternals{TEXT}
687 @ref{\TEXT\,,,internals,Internals Reference}
690 @macro rinternalsnamed{TEXT,DISPLAY}
692 @ref{\TEXT\,,\DISPLAY\,internals,Internals Reference}
697 @c ***** Macros specific to the web site *****
701 @macro exampleImage{IMAGE-FILE}
703 <div class="float-center">
704 <a class="clickable" href="ly-examples/\IMAGE-FILE\.png">
705 <img src="ly-examples/\IMAGE-FILE\-small.png" alt="\IMAGE-FILE\">
707 <p style="text-align: center">
713 @image{ly-examples/\IMAGE-FILE\-small,,,\IMAGE-FILE\,png}
716 @image{lilypond/ly-examples/\IMAGE-FILE\,,,\IMAGE-FILE\,png}
724 <span style="text-decoration:blink">Help wanted:</span>
733 @macro logoLegalLinux
734 Tux the Linux Penguin was created by
735 @uref{mailto:lewing@@isc.tamu.edu, lewing@@isc.tamu.edu} with
736 @uref{http://www.isc.tamu.edu/~lewing/gimp/, the Gnu Image
737 Manipulation Program}.
741 @macro logoLegalFreeBSD
742 The FreeBSD logo is a registered trademark of
743 @uref{http://www.freebsd.org/, The FreeBSD Foundation}.
747 @macro logoLegalMacOSX
748 The @qq{X image} is not a registered trademark. It was created by
749 @uref{http://en.wikipedia.org/wiki/User:Nihonjoe, Nihonjoe} and
750 @uref{http://en.wikipedia.org/wiki/User:CyberSkull, CyberSkull}, and
751 placed under the GNU Free Documentation License version 1.2 or later.
752 We found the image on
753 @uref{http://commons.wikimedia.org/wiki/File:Mac_OS_X_Userbox_X.png,
754 this Wikimedia Commons page}.
758 @macro logoLegalWindows
759 The @qq{four colored rectangles image} is not a registered
760 trademark. It was created by
761 @uref{http://en.wikipedia.org/wiki/User:Rohitbd, Rohitbd} and
762 placed under the GNU Free Documentation License version 1.2. We
764 @uref{http://commons.wikimedia.org/wiki/Category:Microsoft_Windows_logos,
765 this Wikimedia Commons page}.