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. See TRANSLATION for details.
10 @include version.itexi
11 @include common-macros.itexi
14 ****************************
15 MACRO DEFINITIONS GUIDELINES
16 ****************************
18 This file should contain macro defintions which are common to all
19 languages, i.e. all macro definitions which do not contain text that
20 should be translated (namely text visible in the output).
22 Macro definitions which contain text that should be translated in
23 translations should be in macros.itexi.
26 @c ***** Displaying text *****
28 @c To get decent quotes in `foo' and ``foo''.
31 @quoteleft{}\TEXT\@quoteright{}
35 @quotedblleft{}\TEXT\@quotedblright{}
46 @c keep the space for proper nesting of </p>
72 For more information about how this manual fits with the other
73 documentation, or to read this manual in other formats, see
76 If you are missing any manuals, the complete documentation can be
77 found at @w{@uref{http://@/www@/.lilypond@/.org/}}.
82 @macro lilyTitlePage{TITLE}
83 @c This produces the unified index
88 @c ***** Copyright stuff *****
94 Permission is granted to copy, distribute and/or modify this document
95 under the terms of the GNU Free Documentation License, Version 1.1
96 or any later version published by the Free Software Foundation;
97 with no Invariant Sections.
98 A copy of the license is included in the section entitled ``GNU
99 Free Documentation License''.
106 This document has been placed in the public domain.
112 @c ***** Title page *****
115 @top LilyPond --- \TITLE\
126 @subtitle The music typesetter
128 @author The LilyPond development team
140 @vskip 0pt plus 1filll
144 For LilyPond version @version{}
150 @c ***** Headings in a doc subsection *****
152 @c The next macro is a dummy currently since texinfo doesn't
153 @c provide a real ragged-right environment yet.
155 @c Don't insert an empty line after @predefined! Right now
156 @c it doesn't matter, but a future implementation will probably
157 @c add some code which needs this restriction.
161 @subsubheading Predefined commands
164 @c Due to a bug in texi2html (texi2html.pl CVS versions <= 1.245)
165 @c the next macro must not be empty.
174 @subsubheading Selected Snippets
178 @c Don't insert an empty line after @seealso! Otherwise we get
179 @c unwanted extra vertical space in the PDF output.
183 @subsubheading See also
190 @subsubheading Known issues and warnings
195 @c ***** Links and references *****
197 @c Definitions for references:
211 @c All these also have a @...named version which allows to specify the
212 @c displayed text for the reference as second argument.
214 @c ***** HTML + bigpage is a special case (other manual names); all other
215 @c formats are treated similarly.
228 @ref{\TEXT\,,,music-glossary-big-page,Music Glossary}
231 @macro rglosnamed{TEXT,DISPLAY}
233 @ref{\TEXT\,,\DISPLAY\,music-glossary-big-page,Music Glossary}
236 @macro rlearning{TEXT}
238 @ref{\TEXT\,,,learning-big-page,Learning Manual}
241 @macro rlearningnamed{TEXT,DISPLAY}
243 @ref{\TEXT\,,\DISPLAY\,learning-big-page,Learning Manual}
248 @ref{\TEXT\,,,notation-big-page,Notation Reference}
251 @macro rusernamed{TEXT,DISPLAY}
253 @ref{\TEXT\,,\DISPLAY\,notation-big-page,Notation Reference}
258 @ref{\TEXT\,,,extending-big-page,Extending}
261 @macro rextendnamed{TEXT,DISPLAY}
263 @ref{\TEXT\,,\DISPLAY\,extending-big-page,Extending}
266 @macro rchanges{TEXT}
268 @ref{\TEXT\,,,changes-big-page,Changes}
271 @macro rchangesnamed{TEXT,DISPLAY}
273 @ref{\TEXT\,,\DISPLAY\,changes-big-page,Changes}
276 @macro rcontrib{TEXT}
278 @ref{\TEXT\,,,contributor-big-page,Contributor's Guide}
281 @macro rcontribnamed{TEXT,DISPLAY}
283 @ref{\TEXT\,,\DISPLAY\,contributor-big-page,Contributor's Guide}
288 @ref{\TEXT\,,,web-big-page,General Information}
291 @macro rwebnamed{TEXT,DISPLAY}
293 @ref{\TEXT\,,\DISPLAY\,web-big-page,General Information}
298 @ref{\TEXT\,,,essay-big-page,Essay}
301 @macro ressaynamed{TEXT,DISPLAY}
303 @ref{\TEXT\,,\DISPLAY\,essay-big-page,Essay}
306 @macro rprogram{TEXT}
308 @ref{\TEXT\,,,usage-big-page,Application Usage}
311 @macro rprogramnamed{TEXT,DISPLAY}
313 @ref{\TEXT\,,\DISPLAY\,usage-big-page,Application Usage}
317 @ref{\TEXT\,,,snippets-big-page,Snippets}
320 @macro rlsrnamed{TEXT,DISPLAY}
321 @ref{\TEXT\,,\DISPLAY\,snippets-big-page,Snippets}
324 @macro rinternals{TEXT}
326 @ref{\TEXT\,,,internals-big-page,Internals Reference}
329 @macro rinternalsnamed{TEXT,DISPLAY}
331 @ref{\TEXT\,,\DISPLAY\,internals-big-page,Internals Reference}
345 @ref{\TEXT\,,,music-glossary,Music Glossary}
348 @macro rglosnamed{TEXT,DISPLAY}
350 @ref{\TEXT\,,\DISPLAY\,music-glossary,Music Glossary}
353 @macro rlearning{TEXT}
355 @ref{\TEXT\,,,learning,Learning Manual}
358 @macro rlearningnamed{TEXT,DISPLAY}
360 @ref{\TEXT\,,,learning,Learning Manual}
365 @ref{\TEXT\,,,notation,Notation Reference}
368 @macro rusernamed{TEXT,DISPLAY}
370 @ref{\TEXT\,,\DISPLAY\,notation,Notation Reference}
373 @macro rchanges{TEXT}
375 @ref{\TEXT\,,,changes,Changes}
378 @macro rchangesnamed{TEXT,DISPLAY}
380 @ref{\TEXT\,,\DISPLAY\,changes,Changes}
385 @ref{\TEXT\,,,extending,Extending}
388 @macro rextendnamed{TEXT,DISPLAY}
390 @ref{\TEXT\,,\DISPLAY\,extending,Extending}
393 @macro rcontrib{TEXT}
395 @ref{\TEXT\,,,contributor,Contributor's Guide}
398 @macro rcontribnamed{TEXT,DISPLAY}
400 @ref{\TEXT\,,\DISPLAY\,contributor,Contributor's Guide}
405 @ref{\TEXT\,,,web,General Information}
408 @macro rwebnamed{TEXT,DISPLAY}
410 @ref{\TEXT\,,\DISPLAY\,web,General Information}
415 @ref{\TEXT\,,,essay,Essay}
418 @macro ressaynamed{TEXT,DISPLAY}
420 @ref{\TEXT\,,\DISPLAY\,essay,Essay}
423 @macro rprogram{TEXT}
425 @ref{\TEXT\,,,usage,Application Usage}
428 @macro rprogramnamed{TEXT,DISPLAY}
430 @ref{\TEXT\,,\DISPLAY\,usage,Application Usage}
434 @ref{\TEXT\,,,snippets,Snippets}
437 @macro rlsrnamed{TEXT,DISPLAY}
438 @ref{\TEXT\,,\DISPLAY\,snippets,Snippets}
441 @macro rinternals{TEXT}
443 @ref{\TEXT\,,,internals,Internals Reference}
446 @macro rinternalsnamed{TEXT,DISPLAY}
448 @ref{\TEXT\,,\DISPLAY\,internals,Internals Reference}
457 @ref{\TEXT\,,,music-glossary,Music Glossary}
460 @macro rglosnamed{TEXT,DISPLAY}
462 @ref{\TEXT\,,\DISPLAY\,music-glossary,Music Glossary}
465 @macro rlearning{TEXT}
467 @ref{\TEXT\,,,lilypond-learning,Learning Manual}
470 @macro rlearningnamed{TEXT,DISPLAY}
472 @ref{\TEXT\,,,lilypond-learning,Learning Manual}
477 @ref{\TEXT\,,,lilypond-notation,Notation Reference}
480 @macro rusernamed{TEXT,DISPLAY}
482 @ref{\TEXT\,,\DISPLAY\,lilypond-notation,Notation Reference}
485 @macro rchanges{TEXT}
487 @ref{\TEXT\,,,lilypond-changes,Changes}
490 @macro rchangesnamed{TEXT,DISPLAY}
492 @ref{\TEXT\,,\DISPLAY\,lilypond-changes,Changes}
497 @ref{\TEXT\,,,lilypond-extending,Extending}
500 @macro rextendnamed{TEXT,DISPLAY}
502 @ref{\TEXT\,,\DISPLAY\,lilypond-extending,Extending}
505 @macro rcontrib{TEXT}
507 @ref{\TEXT\,,,lilypond-contributor,Contributor's Guide}
510 @macro rcontribnamed{TEXT,DISPLAY}
512 @ref{\TEXT\,,\DISPLAY\,lilypond-contributor,Contributor's Guide}
517 @ref{\TEXT\,,,lilypond-web,General Information}
520 @macro rwebnamed{TEXT,DISPLAY}
522 @ref{\TEXT\,,\DISPLAY\,lilypond-web, General Information}
527 @ref{\TEXT\,,,lilypond-essay,Essay}
530 @macro ressaynamed{TEXT,DISPLAY}
532 @ref{\TEXT\,,\DISPLAY\,lilypond-essay,Essay}
535 @macro rprogram{TEXT}
537 @ref{\TEXT\,,,lilypond-usage,Application Usage}
540 @macro rprogramnamed{TEXT,DISPLAY}
542 @ref{\TEXT\,,\DISPLAY\,lilypond-usage,Application Usage}
546 @ref{\TEXT\,,,lilypond-snippets,Snippets}
549 @macro rlsrnamed{TEXT,DISPLAY}
550 @ref{\TEXT\,,\DISPLAY\,lilypond-snippets,Snippets}
553 @macro rinternals{TEXT}
555 @ref{\TEXT\,,,lilypond-internals,Internals Reference}
558 @macro rinternalsnamed{TEXT,DISPLAY}
560 @ref{\TEXT\,,\DISPLAY\,lilypond-internals,Internals Reference}
574 @c All commands below should work in the middle of the line;
575 @c we thus must not use @vindex directly since it works only if placed
576 @c on a line of its own. To overcome this problem, we define a
577 @c replacement macro using the internal definition of @vindex which
578 @c delimits arguments in the standard way (i.e., with braces).
581 \gdef\lilyvindex#1{\doind{vr}{\code{#1}}\ignorespaces}
586 @ref{\TEXT\,,,music-glossary,Music Glossary}
589 @macro rglosnamed{TEXT,DISPLAY}
591 @ref{\TEXT\,,\DISPLAY\,music-glossary,Music Glossary}
594 @macro rlearning{TEXT}
596 @ref{\TEXT\,,,learning,Learning Manual}
599 @macro rlearningnamed{TEXT,DISPLAY}
601 @ref{\TEXT\,,\DISPLAY\,learning,Learning Manual}
606 @ref{\TEXT\,,,notation,Notation Reference}
609 @macro rusernamed{TEXT,DISPLAY}
611 @ref{\TEXT\,,\DISPLAY\,notation,Notation Reference}
614 @macro rchanges{TEXT}
616 @ref{\TEXT\,,,changes,Changes}
619 @macro rchangesnamed{TEXT,DISPLAY}
621 @ref{\TEXT\,,\DISPLAY\,changes,Changes}
626 @ref{\TEXT\,,,extending,Extending}
629 @macro rextendnamed{TEXT,DISPLAY}
631 @ref{\TEXT\,,\DISPLAY\,extending,Extending}
634 @macro rcontrib{TEXT}
636 @ref{\TEXT\,,,contributor,Contributor's Guide}
639 @macro rcontribnamed{TEXT,DISPLAY}
641 @ref{\TEXT\,,\DISPLAY\,contributor,Contributor's Guide}
646 @ref{\TEXT\,,,web,General Information}
649 @macro rwebnamed{TEXT,DISPLAY}
651 @ref{\TEXT\,,\DISPLAY\,web,General Information}
656 @ref{\TEXT\,,,essay,Essay}
659 @macro ressaynamed{TEXT,DISPLAY}
661 @ref{\TEXT\,,\DISPLAY\,essay,Essay}
664 @macro rprogram{TEXT}
666 @ref{\TEXT\,,,usage,Application Usage}
669 @macro rprogramnamed{TEXT,DISPLAY}
671 @ref{\TEXT\,,\DISPLAY\,usage,Application Usage}
676 @ref{\TEXT\,,,snippets,Snippets}
679 @macro rlsrnamed{TEXT,DISPLAY}
681 @ref{\TEXT\,,\DISPLAY\,snippets,Snippets}
684 @macro rinternals{TEXT}
686 @ref{\TEXT\,,,internals,Internals Reference}
689 @macro rinternalsnamed{TEXT,DISPLAY}
691 @ref{\TEXT\,,\DISPLAY\,internals,Internals Reference}
696 @c ***** Macros specific to the web site *****
700 @macro exampleImage{IMAGE-FILE}
702 <div class="float-center">
703 <a class="clickable" href="ly-examples/\IMAGE-FILE\.png">
704 <img src="ly-examples/\IMAGE-FILE\-small.png" alt="\IMAGE-FILE\">
706 <p style="text-align: center">
712 @image{ly-examples/\IMAGE-FILE\-small,,,\IMAGE-FILE\,png}
715 @image{lilypond/ly-examples/\IMAGE-FILE\,,,\IMAGE-FILE\,png}
723 <span style="text-decoration:blink">Help wanted:</span>
732 @macro logoLegalLinux
733 Tux the Linux Penguin was created by
734 @uref{mailto:lewing@@isc.tamu.edu, lewing@@isc.tamu.edu} with
735 @uref{http://www.isc.tamu.edu/~lewing/gimp/, the Gnu Image
736 Manipulation Program}.
740 @macro logoLegalFreeBSD
741 The FreeBSD logo is a registered trademark of
742 @uref{http://www.freebsd.org/, The FreeBSD Foundation}.
746 @macro logoLegalMacOSX
747 The @qq{X image} is not a registered trademark. It was created by
748 @uref{http://en.wikipedia.org/wiki/User:Nihonjoe, Nihonjoe} and
749 @uref{http://en.wikipedia.org/wiki/User:CyberSkull, CyberSkull}, and
750 placed under the GNU Free Documentation License version 1.2 or later.
751 We found the image on
752 @uref{http://commons.wikimedia.org/wiki/File:Mac_OS_X_Userbox_X.png,
753 this Wikimedia Commons page}.
757 @macro logoLegalWindows
758 The @qq{four colored rectangles image} is not a registered
759 trademark. It was created by
760 @uref{http://en.wikipedia.org/wiki/User:Rohitbd, Rohitbd} and
761 placed under the GNU Free Documentation License version 1.2. We
763 @uref{http://commons.wikimedia.org/wiki/Category:Microsoft_Windows_logos,
764 this Wikimedia Commons page}.