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>
70 @c do not translate the following macro -- it is used in
71 @c an untranslated manual.
77 <div class="advanced">
79 @strong{Advanced note:} \TEXT\
80 @c keep the space for proper nesting of </p>
93 @b{Advanced note:} \TEXT\
102 For more information about how this manual fits with the other
103 documentation, or to read this manual in other formats, see
106 If you are missing any manuals, the complete documentation can be
107 found at @w{@uref{http://@/www@/.lilypond@/.org/}}.
112 @macro lilyTitlePage{TITLE}
113 @c This produces the unified index
118 @c ***** Copyright stuff *****
124 Permission is granted to copy, distribute and/or modify this document
125 under the terms of the GNU Free Documentation License, Version 1.1
126 or any later version published by the Free Software Foundation;
127 with no Invariant Sections.
128 A copy of the license is included in the section entitled ``GNU
129 Free Documentation License''.
136 This document has been placed in the public domain.
142 @c ***** Title page *****
145 @top LilyPond --- \TITLE\
156 @subtitle The music typesetter
158 @author The LilyPond development team
170 @vskip 0pt plus 1filll
174 For LilyPond version @version{}
180 @c ***** Headings in a doc subsection *****
182 @c The next macro is a dummy currently since texinfo doesn't
183 @c provide a real ragged-right environment yet.
185 @c Don't insert an empty line after @predefined! Right now
186 @c it doesn't matter, but a future implementation will probably
187 @c add some code which needs this restriction.
191 @subsubheading Predefined commands
194 @c Due to a bug in texi2html (texi2html.pl CVS versions <= 1.245)
195 @c the next macro must not be empty.
204 @subsubheading Selected Snippets
208 @c Don't insert an empty line after @seealso! Otherwise we get
209 @c unwanted extra vertical space in the PDF output.
213 @subsubheading See also
220 @subsubheading Known issues and warnings
225 @c ***** Links and references *****
227 @c Definitions for references:
241 @c All these also have a @...named version which allows to specify the
242 @c displayed text for the reference as second argument.
244 @c ***** HTML + bigpage is a special case (other manual names); all other
245 @c formats are treated similarly.
258 @ref{\TEXT\,,,music-glossary-big-page,Music Glossary}
261 @macro rglosnamed{TEXT,DISPLAY}
263 @ref{\TEXT\,,\DISPLAY\,music-glossary-big-page,Music Glossary}
266 @macro rlearning{TEXT}
268 @ref{\TEXT\,,,learning-big-page,Learning Manual}
271 @macro rlearningnamed{TEXT,DISPLAY}
273 @ref{\TEXT\,,\DISPLAY\,learning-big-page,Learning Manual}
278 @ref{\TEXT\,,,notation-big-page,Notation Reference}
281 @macro rusernamed{TEXT,DISPLAY}
283 @ref{\TEXT\,,\DISPLAY\,notation-big-page,Notation Reference}
288 @ref{\TEXT\,,,extending-big-page,Extending}
291 @macro rextendnamed{TEXT,DISPLAY}
293 @ref{\TEXT\,,\DISPLAY\,extending-big-page,Extending}
296 @macro rchanges{TEXT}
298 @ref{\TEXT\,,,changes-big-page,Changes}
301 @macro rchangesnamed{TEXT,DISPLAY}
303 @ref{\TEXT\,,\DISPLAY\,changes-big-page,Changes}
306 @macro rcontrib{TEXT}
308 @ref{\TEXT\,,,contributor-big-page,Contributor's Guide}
311 @macro rcontribnamed{TEXT,DISPLAY}
313 @ref{\TEXT\,,\DISPLAY\,contributor-big-page,Contributor's Guide}
318 @ref{\TEXT\,,,web-big-page,General Information}
321 @macro rwebnamed{TEXT,DISPLAY}
323 @ref{\TEXT\,,\DISPLAY\,web-big-page,General Information}
328 @ref{\TEXT\,,,essay-big-page,Essay}
331 @macro ressaynamed{TEXT,DISPLAY}
333 @ref{\TEXT\,,\DISPLAY\,essay-big-page,Essay}
336 @macro rprogram{TEXT}
338 @ref{\TEXT\,,,usage-big-page,Application Usage}
341 @macro rprogramnamed{TEXT,DISPLAY}
343 @ref{\TEXT\,,\DISPLAY\,usage-big-page,Application Usage}
347 @ref{\TEXT\,,,snippets-big-page,Snippets}
350 @macro rlsrnamed{TEXT,DISPLAY}
351 @ref{\TEXT\,,\DISPLAY\,snippets-big-page,Snippets}
354 @macro rinternals{TEXT}
356 @ref{\TEXT\,,,internals-big-page,Internals Reference}
359 @macro rinternalsnamed{TEXT,DISPLAY}
361 @ref{\TEXT\,,\DISPLAY\,internals-big-page,Internals Reference}
375 @ref{\TEXT\,,,music-glossary,Music Glossary}
378 @macro rglosnamed{TEXT,DISPLAY}
380 @ref{\TEXT\,,\DISPLAY\,music-glossary,Music Glossary}
383 @macro rlearning{TEXT}
385 @ref{\TEXT\,,,learning,Learning Manual}
388 @macro rlearningnamed{TEXT,DISPLAY}
390 @ref{\TEXT\,,,learning,Learning Manual}
395 @ref{\TEXT\,,,notation,Notation Reference}
398 @macro rusernamed{TEXT,DISPLAY}
400 @ref{\TEXT\,,\DISPLAY\,notation,Notation Reference}
403 @macro rchanges{TEXT}
405 @ref{\TEXT\,,,changes,Changes}
408 @macro rchangesnamed{TEXT,DISPLAY}
410 @ref{\TEXT\,,\DISPLAY\,changes,Changes}
415 @ref{\TEXT\,,,extending,Extending}
418 @macro rextendnamed{TEXT,DISPLAY}
420 @ref{\TEXT\,,\DISPLAY\,extending,Extending}
423 @macro rcontrib{TEXT}
425 @ref{\TEXT\,,,contributor,Contributor's Guide}
428 @macro rcontribnamed{TEXT,DISPLAY}
430 @ref{\TEXT\,,\DISPLAY\,contributor,Contributor's Guide}
435 @ref{\TEXT\,,,web,General Information}
438 @macro rwebnamed{TEXT,DISPLAY}
440 @ref{\TEXT\,,\DISPLAY\,web,General Information}
445 @ref{\TEXT\,,,essay,Essay}
448 @macro ressaynamed{TEXT,DISPLAY}
450 @ref{\TEXT\,,\DISPLAY\,essay,Essay}
453 @macro rprogram{TEXT}
455 @ref{\TEXT\,,,usage,Application Usage}
458 @macro rprogramnamed{TEXT,DISPLAY}
460 @ref{\TEXT\,,\DISPLAY\,usage,Application Usage}
464 @ref{\TEXT\,,,snippets,Snippets}
467 @macro rlsrnamed{TEXT,DISPLAY}
468 @ref{\TEXT\,,\DISPLAY\,snippets,Snippets}
471 @macro rinternals{TEXT}
473 @ref{\TEXT\,,,internals,Internals Reference}
476 @macro rinternalsnamed{TEXT,DISPLAY}
478 @ref{\TEXT\,,\DISPLAY\,internals,Internals Reference}
487 @ref{\TEXT\,,,music-glossary,Music Glossary}
490 @macro rglosnamed{TEXT,DISPLAY}
492 @ref{\TEXT\,,\DISPLAY\,music-glossary,Music Glossary}
495 @macro rlearning{TEXT}
497 @ref{\TEXT\,,,lilypond-learning,Learning Manual}
500 @macro rlearningnamed{TEXT,DISPLAY}
502 @ref{\TEXT\,,,lilypond-learning,Learning Manual}
507 @ref{\TEXT\,,,lilypond-notation,Notation Reference}
510 @macro rusernamed{TEXT,DISPLAY}
512 @ref{\TEXT\,,\DISPLAY\,lilypond-notation,Notation Reference}
515 @macro rchanges{TEXT}
517 @ref{\TEXT\,,,lilypond-changes,Changes}
520 @macro rchangesnamed{TEXT,DISPLAY}
522 @ref{\TEXT\,,\DISPLAY\,lilypond-changes,Changes}
527 @ref{\TEXT\,,,lilypond-extending,Extending}
530 @macro rextendnamed{TEXT,DISPLAY}
532 @ref{\TEXT\,,\DISPLAY\,lilypond-extending,Extending}
535 @macro rcontrib{TEXT}
537 @ref{\TEXT\,,,lilypond-contributor,Contributor's Guide}
540 @macro rcontribnamed{TEXT,DISPLAY}
542 @ref{\TEXT\,,\DISPLAY\,lilypond-contributor,Contributor's Guide}
547 @ref{\TEXT\,,,lilypond-web,General Information}
550 @macro rwebnamed{TEXT,DISPLAY}
552 @ref{\TEXT\,,\DISPLAY\,lilypond-web, General Information}
557 @ref{\TEXT\,,,lilypond-essay,Essay}
560 @macro ressaynamed{TEXT,DISPLAY}
562 @ref{\TEXT\,,\DISPLAY\,lilypond-essay,Essay}
565 @macro rprogram{TEXT}
567 @ref{\TEXT\,,,lilypond-usage,Application Usage}
570 @macro rprogramnamed{TEXT,DISPLAY}
572 @ref{\TEXT\,,\DISPLAY\,lilypond-usage,Application Usage}
576 @ref{\TEXT\,,,lilypond-snippets,Snippets}
579 @macro rlsrnamed{TEXT,DISPLAY}
580 @ref{\TEXT\,,\DISPLAY\,lilypond-snippets,Snippets}
583 @macro rinternals{TEXT}
585 @ref{\TEXT\,,,lilypond-internals,Internals Reference}
588 @macro rinternalsnamed{TEXT,DISPLAY}
590 @ref{\TEXT\,,\DISPLAY\,lilypond-internals,Internals Reference}
604 @c All commands below should work in the middle of the line;
605 @c we thus must not use @vindex directly since it works only if placed
606 @c on a line of its own. To overcome this problem, we define a
607 @c replacement macro using the internal definition of @vindex which
608 @c delimits arguments in the standard way (i.e., with braces).
611 \gdef\lilyvindex#1{\doind{vr}{\code{#1}}\ignorespaces}
616 @ref{\TEXT\,,,music-glossary,Music Glossary}
619 @macro rglosnamed{TEXT,DISPLAY}
621 @ref{\TEXT\,,\DISPLAY\,music-glossary,Music Glossary}
624 @macro rlearning{TEXT}
626 @ref{\TEXT\,,,learning,Learning Manual}
629 @macro rlearningnamed{TEXT,DISPLAY}
631 @ref{\TEXT\,,\DISPLAY\,learning,Learning Manual}
636 @ref{\TEXT\,,,notation,Notation Reference}
639 @macro rusernamed{TEXT,DISPLAY}
641 @ref{\TEXT\,,\DISPLAY\,notation,Notation Reference}
644 @macro rchanges{TEXT}
646 @ref{\TEXT\,,,changes,Changes}
649 @macro rchangesnamed{TEXT,DISPLAY}
651 @ref{\TEXT\,,\DISPLAY\,changes,Changes}
656 @ref{\TEXT\,,,extending,Extending}
659 @macro rextendnamed{TEXT,DISPLAY}
661 @ref{\TEXT\,,\DISPLAY\,extending,Extending}
664 @macro rcontrib{TEXT}
666 @ref{\TEXT\,,,contributor,Contributor's Guide}
669 @macro rcontribnamed{TEXT,DISPLAY}
671 @ref{\TEXT\,,\DISPLAY\,contributor,Contributor's Guide}
676 @ref{\TEXT\,,,web,General Information}
679 @macro rwebnamed{TEXT,DISPLAY}
681 @ref{\TEXT\,,\DISPLAY\,web,General Information}
686 @ref{\TEXT\,,,essay,Essay}
689 @macro ressaynamed{TEXT,DISPLAY}
691 @ref{\TEXT\,,\DISPLAY\,essay,Essay}
694 @macro rprogram{TEXT}
696 @ref{\TEXT\,,,usage,Application Usage}
699 @macro rprogramnamed{TEXT,DISPLAY}
701 @ref{\TEXT\,,\DISPLAY\,usage,Application Usage}
706 @ref{\TEXT\,,,snippets,Snippets}
709 @macro rlsrnamed{TEXT,DISPLAY}
711 @ref{\TEXT\,,\DISPLAY\,snippets,Snippets}
714 @macro rinternals{TEXT}
716 @ref{\TEXT\,,,internals,Internals Reference}
719 @macro rinternalsnamed{TEXT,DISPLAY}
721 @ref{\TEXT\,,\DISPLAY\,internals,Internals Reference}
726 @c ***** Macros specific to the web site *****
730 @macro exampleImage{IMAGE-FILE}
732 <div class="float-center">
733 <a class="clickable" href="ly-examples/\IMAGE-FILE\.png">
734 <img src="ly-examples/\IMAGE-FILE\-small.png" alt="\IMAGE-FILE\">
736 <p style="text-align: center">
742 @image{ly-examples/\IMAGE-FILE\,6in,,\IMAGE-FILE\,png}
745 @image{lilypond/ly-examples/\IMAGE-FILE\,,,\IMAGE-FILE\,png}
753 <span style="text-decoration:blink">Help wanted:</span>
762 @macro logoLegalLinux
763 Tux the Linux Penguin was created by
764 @uref{mailto:lewing@@isc.tamu.edu, lewing@@isc.tamu.edu} with
765 @uref{http://www.isc.tamu.edu/~lewing/gimp/, the Gnu Image
766 Manipulation Program}.
770 @macro logoLegalFreeBSD
771 The FreeBSD logo is a registered trademark of
772 @uref{http://www.freebsd.org/, The FreeBSD Foundation}.
776 @macro logoLegalMacOSX
777 The @qq{X image} is not a registered trademark. It was created by
778 @uref{http://en.wikipedia.org/wiki/User:Nihonjoe, Nihonjoe} and
779 @uref{http://en.wikipedia.org/wiki/User:CyberSkull, CyberSkull}, and
780 placed under the GNU Free Documentation License version 1.2 or later.
781 We found the image on
782 @uref{http://commons.wikimedia.org/wiki/File:Mac_OS_X_Userbox_X.png,
783 this Wikimedia Commons page}.
787 @macro logoLegalWindows
788 The @qq{four colored rectangles image} is not a registered
789 trademark. It was created by
790 @uref{http://en.wikipedia.org/wiki/User:Rohitbd, Rohitbd} and
791 placed under the GNU Free Documentation License version 1.2. We
793 @uref{http://commons.wikimedia.org/wiki/Category:Microsoft_Windows_logos,
794 this Wikimedia Commons page}.