1 @c -*- coding: us-ascii; 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 @c ***** Copyright stuff *****
88 Permission is granted to copy, distribute and/or modify this document
89 under the terms of the GNU Free Documentation License, Version 1.1
90 or any later version published by the Free Software Foundation;
91 with no Invariant Sections.
92 A copy of the license is included in the section entitled ``GNU
93 Free Documentation License''.
100 This document has been placed in the public domain.
104 @c ***** Title page *****
105 @macro lilyTitlePage{TITLE}
106 @c This produces the unified index
113 @top LilyPond --- \TITLE\
124 @subtitle The music typesetter
126 @author The LilyPond development team
138 @vskip 0pt plus 1filll
142 For LilyPond version @version{}
148 @c ***** Headings in a doc subsection *****
150 @c The next macro is a dummy currently since texinfo doesn't
151 @c provide a real ragged-right environment yet.
153 @c Don't insert an empty line after @predefined! Right now
154 @c it doesn't matter, but a future implementation will probably
155 @c add some code which needs this restriction.
159 @subsubheading Predefined commands
162 @c Due to a bug in texi2html (texi2html.pl CVS versions <= 1.245)
163 @c the next macro must not be empty.
172 @subsubheading Selected Snippets
176 @c Don't insert an empty line after @seealso! Otherwise we get
177 @c unwanted extra vertical space in the PDF output.
181 @subsubheading See also
188 @subsubheading Known issues and warnings
193 @c ***** Links and references *****
195 @c Definitions for references:
209 @c All these also have a @...named version which allows to specify the
210 @c displayed text for the reference as second argument.
212 @c ***** HTML + bigpage is a special case (other manual names); all other
213 @c formats are treated similarly.
226 @ref{\TEXT\,,,music-glossary-big-page,Music Glossary}
229 @macro rglosnamed{TEXT,DISPLAY}
231 @ref{\TEXT\,,\DISPLAY\,music-glossary-big-page,Music Glossary}
234 @macro rlearning{TEXT}
236 @ref{\TEXT\,,,learning-big-page,Learning Manual}
239 @macro rlearningnamed{TEXT,DISPLAY}
241 @ref{\TEXT\,,\DISPLAY\,learning-big-page,Learning Manual}
246 @ref{\TEXT\,,,notation-big-page,Notation Reference}
249 @macro rusernamed{TEXT,DISPLAY}
251 @ref{\TEXT\,,\DISPLAY\,notation-big-page,Notation Reference}
256 @ref{\TEXT\,,,extending-big-page,Extending}
259 @macro rextendnamed{TEXT,DISPLAY}
261 @ref{\TEXT\,,\DISPLAY\,extending-big-page,Extending}
264 @macro rchanges{TEXT}
266 @ref{\TEXT\,,,changes-big-page,Changes}
269 @macro rchangesnamed{TEXT,DISPLAY}
271 @ref{\TEXT\,,\DISPLAY\,changes-big-page,Changes}
274 @macro rcontrib{TEXT}
276 @ref{\TEXT\,,,contributor-big-page,Contributor's Guide}
279 @macro rcontribnamed{TEXT,DISPLAY}
281 @ref{\TEXT\,,\DISPLAY\,contributor-big-page,Contributor's Guide}
286 @ref{\TEXT\,,,web-big-page,General Information}
289 @macro rwebnamed{TEXT,DISPLAY}
291 @ref{\TEXT\,,\DISPLAY\,web-big-page,General Information}
296 @ref{\TEXT\,,,essay-big-page,Essay}
299 @macro ressaynamed{TEXT,DISPLAY}
301 @ref{\TEXT\,,\DISPLAY\,essay-big-page,Essay}
304 @macro rprogram{TEXT}
306 @ref{\TEXT\,,,usage-big-page,Application Usage}
309 @macro rprogramnamed{TEXT,DISPLAY}
311 @ref{\TEXT\,,\DISPLAY\,usage-big-page,Application Usage}
315 @ref{\TEXT\,,,snippets-big-page,Snippets}
318 @macro rlsrnamed{TEXT,DISPLAY}
319 @ref{\TEXT\,,\DISPLAY\,snippets-big-page,Snippets}
322 @macro rinternals{TEXT}
324 @ref{\TEXT\,,,internals-big-page,Internals Reference}
327 @macro rinternalsnamed{TEXT,DISPLAY}
329 @ref{\TEXT\,,\DISPLAY\,internals-big-page,Internals Reference}
343 @ref{\TEXT\,,,music-glossary,Music Glossary}
346 @macro rglosnamed{TEXT,DISPLAY}
348 @ref{\TEXT\,,\DISPLAY\,music-glossary,Music Glossary}
351 @macro rlearning{TEXT}
353 @ref{\TEXT\,,,learning,Learning Manual}
356 @macro rlearningnamed{TEXT,DISPLAY}
358 @ref{\TEXT\,,,learning,Learning Manual}
363 @ref{\TEXT\,,,notation,Notation Reference}
366 @macro rusernamed{TEXT,DISPLAY}
368 @ref{\TEXT\,,\DISPLAY\,notation,Notation Reference}
371 @macro rchanges{TEXT}
373 @ref{\TEXT\,,,changes,Changes}
376 @macro rchangesnamed{TEXT,DISPLAY}
378 @ref{\TEXT\,,\DISPLAY\,changes,Changes}
383 @ref{\TEXT\,,,extending,Extending}
386 @macro rextendnamed{TEXT,DISPLAY}
388 @ref{\TEXT\,,\DISPLAY\,extending,Extending}
391 @macro rcontrib{TEXT}
393 @ref{\TEXT\,,,contributor,Contributor's Guide}
396 @macro rcontribnamed{TEXT,DISPLAY}
398 @ref{\TEXT\,,\DISPLAY\,contributor,Contributor's Guide}
403 @ref{\TEXT\,,,web,General Information}
406 @macro rwebnamed{TEXT,DISPLAY}
408 @ref{\TEXT\,,\DISPLAY\,web,General Information}
413 @ref{\TEXT\,,,essay,Essay}
416 @macro ressaynamed{TEXT,DISPLAY}
418 @ref{\TEXT\,,\DISPLAY\,essay,Essay}
421 @macro rprogram{TEXT}
423 @ref{\TEXT\,,,usage,Application Usage}
426 @macro rprogramnamed{TEXT,DISPLAY}
428 @ref{\TEXT\,,\DISPLAY\,usage,Application Usage}
432 @ref{\TEXT\,,,snippets,Snippets}
435 @macro rlsrnamed{TEXT,DISPLAY}
436 @ref{\TEXT\,,\DISPLAY\,snippets,Snippets}
439 @macro rinternals{TEXT}
441 @ref{\TEXT\,,,internals,Internals Reference}
444 @macro rinternalsnamed{TEXT,DISPLAY}
446 @ref{\TEXT\,,\DISPLAY\,internals,Internals Reference}
455 @ref{\TEXT\,,,music-glossary,Music Glossary}
458 @macro rglosnamed{TEXT,DISPLAY}
460 @ref{\TEXT\,,\DISPLAY\,music-glossary,Music Glossary}
463 @macro rlearning{TEXT}
465 @ref{\TEXT\,,,lilypond-learning,Learning Manual}
468 @macro rlearningnamed{TEXT,DISPLAY}
470 @ref{\TEXT\,,,lilypond-learning,Learning Manual}
475 @ref{\TEXT\,,,lilypond-notation,Notation Reference}
478 @macro rusernamed{TEXT,DISPLAY}
480 @ref{\TEXT\,,\DISPLAY\,lilypond-notation,Notation Reference}
483 @macro rchanges{TEXT}
485 @ref{\TEXT\,,,lilypond-changes,Changes}
488 @macro rchangesnamed{TEXT,DISPLAY}
490 @ref{\TEXT\,,\DISPLAY\,lilypond-changes,Changes}
495 @ref{\TEXT\,,,lilypond-extending,Extending}
498 @macro rextendnamed{TEXT,DISPLAY}
500 @ref{\TEXT\,,\DISPLAY\,lilypond-extending,Extending}
503 @macro rcontrib{TEXT}
505 @ref{\TEXT\,,,lilypond-contributor,Contributor's Guide}
508 @macro rcontribnamed{TEXT,DISPLAY}
510 @ref{\TEXT\,,\DISPLAY\,lilypond-contributor,Contributor's Guide}
515 @ref{\TEXT\,,,lilypond-web,General Information}
518 @macro rwebnamed{TEXT,DISPLAY}
520 @ref{\TEXT\,,\DISPLAY\,lilypond-web, General Information}
525 @ref{\TEXT\,,,lilypond-essay,Essay}
528 @macro ressaynamed{TEXT,DISPLAY}
530 @ref{\TEXT\,,\DISPLAY\,lilypond-essay,Essay}
533 @macro rprogram{TEXT}
535 @ref{\TEXT\,,,lilypond-usage,Application Usage}
538 @macro rprogramnamed{TEXT,DISPLAY}
540 @ref{\TEXT\,,\DISPLAY\,lilypond-usage,Application Usage}
544 @ref{\TEXT\,,,lilypond-snippets,Snippets}
547 @macro rlsrnamed{TEXT,DISPLAY}
548 @ref{\TEXT\,,\DISPLAY\,lilypond-snippets,Snippets}
551 @macro rinternals{TEXT}
553 @ref{\TEXT\,,,lilypond-internals,Internals Reference}
556 @macro rinternalsnamed{TEXT,DISPLAY}
558 @ref{\TEXT\,,\DISPLAY\,lilypond-internals,Internals Reference}
572 @c All commands below should work in the middle of the line;
573 @c we thus must not use @vindex directly since it works only if placed
574 @c on a line of its own. To overcome this problem, we define a
575 @c replacement macro using the internal definition of @vindex which
576 @c delimits arguments in the standard way (i.e., with braces).
579 \gdef\lilyvindex#1{\doind{vr}{\code{#1}}\ignorespaces}
584 @ref{\TEXT\,,,music-glossary,Music Glossary}
587 @macro rglosnamed{TEXT,DISPLAY}
589 @ref{\TEXT\,,\DISPLAY\,music-glossary,Music Glossary}
592 @macro rlearning{TEXT}
594 @ref{\TEXT\,,,learning,Learning Manual}
597 @macro rlearningnamed{TEXT,DISPLAY}
599 @ref{\TEXT\,,\DISPLAY\,learning,Learning Manual}
604 @ref{\TEXT\,,,notation,Notation Reference}
607 @macro rusernamed{TEXT,DISPLAY}
609 @ref{\TEXT\,,\DISPLAY\,notation,Notation Reference}
612 @macro rchanges{TEXT}
614 @ref{\TEXT\,,,changes,Changes}
617 @macro rchangesnamed{TEXT,DISPLAY}
619 @ref{\TEXT\,,\DISPLAY\,changes,Changes}
624 @ref{\TEXT\,,,extending,Extending}
627 @macro rextendnamed{TEXT,DISPLAY}
629 @ref{\TEXT\,,\DISPLAY\,extending,Extending}
632 @macro rcontrib{TEXT}
634 @ref{\TEXT\,,,contributor,Contributor's Guide}
637 @macro rcontribnamed{TEXT,DISPLAY}
639 @ref{\TEXT\,,\DISPLAY\,contributor,Contributor's Guide}
644 @ref{\TEXT\,,,web,General Information}
647 @macro rwebnamed{TEXT,DISPLAY}
649 @ref{\TEXT\,,\DISPLAY\,web,General Information}
654 @ref{\TEXT\,,,essay,Essay}
657 @macro ressaynamed{TEXT,DISPLAY}
659 @ref{\TEXT\,,\DISPLAY\,essay,Essay}
662 @macro rprogram{TEXT}
664 @ref{\TEXT\,,,usage,Application Usage}
667 @macro rprogramnamed{TEXT,DISPLAY}
669 @ref{\TEXT\,,\DISPLAY\,usage,Application Usage}
674 @ref{\TEXT\,,,snippets,Snippets}
677 @macro rlsrnamed{TEXT,DISPLAY}
679 @ref{\TEXT\,,\DISPLAY\,snippets,Snippets}
682 @macro rinternals{TEXT}
684 @ref{\TEXT\,,,internals,Internals Reference}
687 @macro rinternalsnamed{TEXT,DISPLAY}
689 @ref{\TEXT\,,\DISPLAY\,internals,Internals Reference}
694 @c ***** Macros specific to the web site *****
698 @macro exampleImage{IMAGE-FILE}
700 <div class="float-center">
701 <a class="clickable" href="examples/\IMAGE-FILE\.png">
702 <img src="examples/\IMAGE-FILE\-small.png" alt="\IMAGE-FILE\">
704 <p style="text-align: center">
710 @image{examples/\IMAGE-FILE\-small,,,\IMAGE-FILE\,png}
713 @image{lilypond/examples/\IMAGE-FILE\,,,\IMAGE-FILE\,png}
721 <span style="text-decoration:blink">Help wanted:</span>
729 @macro logoLegalLinux
730 Tux the Linux Penguin was created by
731 @uref{mailto:lewing@@isc.tamu.edu, lewing@@isc.tamu.edu} with
732 @uref{http://www.isc.tamu.edu/~lewing/gimp/, the Gnu Image
733 Manipulation Program}.
737 @macro logoLegalFreeBSD
738 The FreeBSD logo is a registered trademark of
739 @uref{http://www.freebsd.org/, The FreeBSD Foundation}.
743 @macro logoLegalMacOSX
744 The @qq{X image} is not a registered trademark. It was created by
745 @uref{http://en.wikipedia.org/wiki/User:Nihonjoe, Nihonjoe} and
746 @uref{http://en.wikipedia.org/wiki/User:CyberSkull, CyberSkull}, and
747 placed under the GNU Free Documentation License version 1.2 or later.
748 We found the image on
749 @uref{http://commons.wikimedia.org/wiki/File:Mac_OS_X_Userbox_X.png,
750 this Wikimedia Commons page}.
754 @macro logoLegalWindows
755 The @qq{four colored rectangles image} is not a registered
756 trademark. It was created by
757 @uref{http://en.wikipedia.org/wiki/User:Rohitbd, Rohitbd} and
758 placed under the GNU Free Documentation License version 1.2. We
760 @uref{http://commons.wikimedia.org/wiki/Category:Microsoft_Windows_logos,
761 this Wikimedia Commons page}.