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>
74 <div class="advanced">
76 @strong{Advanced note:} \TEXT\
77 @c keep the space for proper nesting of </p>
90 @b{Advanced note:} \TEXT\
99 For more information about how this manual fits with the other
100 documentation, or to read this manual in other formats, see
103 If you are missing any manuals, the complete documentation can be
104 found at @w{@uref{http://@/www@/.lilypond@/.org/}}.
109 @macro lilyTitlePage{TITLE}
110 @c This produces the unified index
115 @c ***** Copyright stuff *****
121 Permission is granted to copy, distribute and/or modify this document
122 under the terms of the GNU Free Documentation License, Version 1.1
123 or any later version published by the Free Software Foundation;
124 with no Invariant Sections.
125 A copy of the license is included in the section entitled ``GNU
126 Free Documentation License''.
133 This document has been placed in the public domain.
139 @c ***** Title page *****
142 @top LilyPond --- \TITLE\
153 @subtitle The music typesetter
155 @author The LilyPond development team
167 @vskip 0pt plus 1filll
171 For LilyPond version @version{}
177 @c ***** Headings in a doc subsection *****
179 @c The next macro is a dummy currently since texinfo doesn't
180 @c provide a real ragged-right environment yet.
182 @c Don't insert an empty line after @predefined! Right now
183 @c it doesn't matter, but a future implementation will probably
184 @c add some code which needs this restriction.
188 @subsubheading Predefined commands
191 @c Due to a bug in texi2html (texi2html.pl CVS versions <= 1.245)
192 @c the next macro must not be empty.
201 @subsubheading Selected Snippets
205 @c Don't insert an empty line after @seealso! Otherwise we get
206 @c unwanted extra vertical space in the PDF output.
210 @subsubheading See also
217 @subsubheading Known issues and warnings
222 @c ***** Links and references *****
224 @c Definitions for references:
238 @c All these also have a @...named version which allows to specify the
239 @c displayed text for the reference as second argument.
241 @c ***** HTML + bigpage is a special case (other manual names); all other
242 @c formats are treated similarly.
255 @ref{\TEXT\,,,music-glossary-big-page,Music Glossary}
258 @macro rglosnamed{TEXT,DISPLAY}
260 @ref{\TEXT\,,\DISPLAY\,music-glossary-big-page,Music Glossary}
263 @macro rlearning{TEXT}
265 @ref{\TEXT\,,,learning-big-page,Learning Manual}
268 @macro rlearningnamed{TEXT,DISPLAY}
270 @ref{\TEXT\,,\DISPLAY\,learning-big-page,Learning Manual}
275 @ref{\TEXT\,,,notation-big-page,Notation Reference}
278 @macro rusernamed{TEXT,DISPLAY}
280 @ref{\TEXT\,,\DISPLAY\,notation-big-page,Notation Reference}
285 @ref{\TEXT\,,,extending-big-page,Extending}
288 @macro rextendnamed{TEXT,DISPLAY}
290 @ref{\TEXT\,,\DISPLAY\,extending-big-page,Extending}
293 @macro rchanges{TEXT}
295 @ref{\TEXT\,,,changes-big-page,Changes}
298 @macro rchangesnamed{TEXT,DISPLAY}
300 @ref{\TEXT\,,\DISPLAY\,changes-big-page,Changes}
303 @macro rcontrib{TEXT}
305 @ref{\TEXT\,,,contributor-big-page,Contributor's Guide}
308 @macro rcontribnamed{TEXT,DISPLAY}
310 @ref{\TEXT\,,\DISPLAY\,contributor-big-page,Contributor's Guide}
315 @ref{\TEXT\,,,web-big-page,General Information}
318 @macro rwebnamed{TEXT,DISPLAY}
320 @ref{\TEXT\,,\DISPLAY\,web-big-page,General Information}
325 @ref{\TEXT\,,,essay-big-page,Essay}
328 @macro ressaynamed{TEXT,DISPLAY}
330 @ref{\TEXT\,,\DISPLAY\,essay-big-page,Essay}
333 @macro rprogram{TEXT}
335 @ref{\TEXT\,,,usage-big-page,Application Usage}
338 @macro rprogramnamed{TEXT,DISPLAY}
340 @ref{\TEXT\,,\DISPLAY\,usage-big-page,Application Usage}
344 @ref{\TEXT\,,,snippets-big-page,Snippets}
347 @macro rlsrnamed{TEXT,DISPLAY}
348 @ref{\TEXT\,,\DISPLAY\,snippets-big-page,Snippets}
351 @macro rinternals{TEXT}
353 @ref{\TEXT\,,,internals-big-page,Internals Reference}
356 @macro rinternalsnamed{TEXT,DISPLAY}
358 @ref{\TEXT\,,\DISPLAY\,internals-big-page,Internals Reference}
372 @ref{\TEXT\,,,music-glossary,Music Glossary}
375 @macro rglosnamed{TEXT,DISPLAY}
377 @ref{\TEXT\,,\DISPLAY\,music-glossary,Music Glossary}
380 @macro rlearning{TEXT}
382 @ref{\TEXT\,,,learning,Learning Manual}
385 @macro rlearningnamed{TEXT,DISPLAY}
387 @ref{\TEXT\,,,learning,Learning Manual}
392 @ref{\TEXT\,,,notation,Notation Reference}
395 @macro rusernamed{TEXT,DISPLAY}
397 @ref{\TEXT\,,\DISPLAY\,notation,Notation Reference}
400 @macro rchanges{TEXT}
402 @ref{\TEXT\,,,changes,Changes}
405 @macro rchangesnamed{TEXT,DISPLAY}
407 @ref{\TEXT\,,\DISPLAY\,changes,Changes}
412 @ref{\TEXT\,,,extending,Extending}
415 @macro rextendnamed{TEXT,DISPLAY}
417 @ref{\TEXT\,,\DISPLAY\,extending,Extending}
420 @macro rcontrib{TEXT}
422 @ref{\TEXT\,,,contributor,Contributor's Guide}
425 @macro rcontribnamed{TEXT,DISPLAY}
427 @ref{\TEXT\,,\DISPLAY\,contributor,Contributor's Guide}
432 @ref{\TEXT\,,,web,General Information}
435 @macro rwebnamed{TEXT,DISPLAY}
437 @ref{\TEXT\,,\DISPLAY\,web,General Information}
442 @ref{\TEXT\,,,essay,Essay}
445 @macro ressaynamed{TEXT,DISPLAY}
447 @ref{\TEXT\,,\DISPLAY\,essay,Essay}
450 @macro rprogram{TEXT}
452 @ref{\TEXT\,,,usage,Application Usage}
455 @macro rprogramnamed{TEXT,DISPLAY}
457 @ref{\TEXT\,,\DISPLAY\,usage,Application Usage}
461 @ref{\TEXT\,,,snippets,Snippets}
464 @macro rlsrnamed{TEXT,DISPLAY}
465 @ref{\TEXT\,,\DISPLAY\,snippets,Snippets}
468 @macro rinternals{TEXT}
470 @ref{\TEXT\,,,internals,Internals Reference}
473 @macro rinternalsnamed{TEXT,DISPLAY}
475 @ref{\TEXT\,,\DISPLAY\,internals,Internals Reference}
484 @ref{\TEXT\,,,music-glossary,Music Glossary}
487 @macro rglosnamed{TEXT,DISPLAY}
489 @ref{\TEXT\,,\DISPLAY\,music-glossary,Music Glossary}
492 @macro rlearning{TEXT}
494 @ref{\TEXT\,,,lilypond-learning,Learning Manual}
497 @macro rlearningnamed{TEXT,DISPLAY}
499 @ref{\TEXT\,,,lilypond-learning,Learning Manual}
504 @ref{\TEXT\,,,lilypond-notation,Notation Reference}
507 @macro rusernamed{TEXT,DISPLAY}
509 @ref{\TEXT\,,\DISPLAY\,lilypond-notation,Notation Reference}
512 @macro rchanges{TEXT}
514 @ref{\TEXT\,,,lilypond-changes,Changes}
517 @macro rchangesnamed{TEXT,DISPLAY}
519 @ref{\TEXT\,,\DISPLAY\,lilypond-changes,Changes}
524 @ref{\TEXT\,,,lilypond-extending,Extending}
527 @macro rextendnamed{TEXT,DISPLAY}
529 @ref{\TEXT\,,\DISPLAY\,lilypond-extending,Extending}
532 @macro rcontrib{TEXT}
534 @ref{\TEXT\,,,lilypond-contributor,Contributor's Guide}
537 @macro rcontribnamed{TEXT,DISPLAY}
539 @ref{\TEXT\,,\DISPLAY\,lilypond-contributor,Contributor's Guide}
544 @ref{\TEXT\,,,lilypond-web,General Information}
547 @macro rwebnamed{TEXT,DISPLAY}
549 @ref{\TEXT\,,\DISPLAY\,lilypond-web, General Information}
554 @ref{\TEXT\,,,lilypond-essay,Essay}
557 @macro ressaynamed{TEXT,DISPLAY}
559 @ref{\TEXT\,,\DISPLAY\,lilypond-essay,Essay}
562 @macro rprogram{TEXT}
564 @ref{\TEXT\,,,lilypond-usage,Application Usage}
567 @macro rprogramnamed{TEXT,DISPLAY}
569 @ref{\TEXT\,,\DISPLAY\,lilypond-usage,Application Usage}
573 @ref{\TEXT\,,,lilypond-snippets,Snippets}
576 @macro rlsrnamed{TEXT,DISPLAY}
577 @ref{\TEXT\,,\DISPLAY\,lilypond-snippets,Snippets}
580 @macro rinternals{TEXT}
582 @ref{\TEXT\,,,lilypond-internals,Internals Reference}
585 @macro rinternalsnamed{TEXT,DISPLAY}
587 @ref{\TEXT\,,\DISPLAY\,lilypond-internals,Internals Reference}
601 @c All commands below should work in the middle of the line;
602 @c we thus must not use @vindex directly since it works only if placed
603 @c on a line of its own. To overcome this problem, we define a
604 @c replacement macro using the internal definition of @vindex which
605 @c delimits arguments in the standard way (i.e., with braces).
608 \gdef\lilyvindex#1{\doind{vr}{\code{#1}}\ignorespaces}
613 @ref{\TEXT\,,,music-glossary,Music Glossary}
616 @macro rglosnamed{TEXT,DISPLAY}
618 @ref{\TEXT\,,\DISPLAY\,music-glossary,Music Glossary}
621 @macro rlearning{TEXT}
623 @ref{\TEXT\,,,learning,Learning Manual}
626 @macro rlearningnamed{TEXT,DISPLAY}
628 @ref{\TEXT\,,\DISPLAY\,learning,Learning Manual}
633 @ref{\TEXT\,,,notation,Notation Reference}
636 @macro rusernamed{TEXT,DISPLAY}
638 @ref{\TEXT\,,\DISPLAY\,notation,Notation Reference}
641 @macro rchanges{TEXT}
643 @ref{\TEXT\,,,changes,Changes}
646 @macro rchangesnamed{TEXT,DISPLAY}
648 @ref{\TEXT\,,\DISPLAY\,changes,Changes}
653 @ref{\TEXT\,,,extending,Extending}
656 @macro rextendnamed{TEXT,DISPLAY}
658 @ref{\TEXT\,,\DISPLAY\,extending,Extending}
661 @macro rcontrib{TEXT}
663 @ref{\TEXT\,,,contributor,Contributor's Guide}
666 @macro rcontribnamed{TEXT,DISPLAY}
668 @ref{\TEXT\,,\DISPLAY\,contributor,Contributor's Guide}
673 @ref{\TEXT\,,,web,General Information}
676 @macro rwebnamed{TEXT,DISPLAY}
678 @ref{\TEXT\,,\DISPLAY\,web,General Information}
683 @ref{\TEXT\,,,essay,Essay}
686 @macro ressaynamed{TEXT,DISPLAY}
688 @ref{\TEXT\,,\DISPLAY\,essay,Essay}
691 @macro rprogram{TEXT}
693 @ref{\TEXT\,,,usage,Application Usage}
696 @macro rprogramnamed{TEXT,DISPLAY}
698 @ref{\TEXT\,,\DISPLAY\,usage,Application Usage}
703 @ref{\TEXT\,,,snippets,Snippets}
706 @macro rlsrnamed{TEXT,DISPLAY}
708 @ref{\TEXT\,,\DISPLAY\,snippets,Snippets}
711 @macro rinternals{TEXT}
713 @ref{\TEXT\,,,internals,Internals Reference}
716 @macro rinternalsnamed{TEXT,DISPLAY}
718 @ref{\TEXT\,,\DISPLAY\,internals,Internals Reference}
723 @c ***** Macros specific to the web site *****
727 @macro exampleImage{IMAGE-FILE}
729 <div class="float-center">
730 <a class="clickable" href="ly-examples/\IMAGE-FILE\.png">
731 <img src="ly-examples/\IMAGE-FILE\-small.png" alt="\IMAGE-FILE\">
733 <p style="text-align: center">
739 @image{ly-examples/\IMAGE-FILE\-small,,,\IMAGE-FILE\,png}
742 @image{lilypond/ly-examples/\IMAGE-FILE\,,,\IMAGE-FILE\,png}
750 <span style="text-decoration:blink">Help wanted:</span>
759 @macro logoLegalLinux
760 Tux the Linux Penguin was created by
761 @uref{mailto:lewing@@isc.tamu.edu, lewing@@isc.tamu.edu} with
762 @uref{http://www.isc.tamu.edu/~lewing/gimp/, the Gnu Image
763 Manipulation Program}.
767 @macro logoLegalFreeBSD
768 The FreeBSD logo is a registered trademark of
769 @uref{http://www.freebsd.org/, The FreeBSD Foundation}.
773 @macro logoLegalMacOSX
774 The @qq{X image} is not a registered trademark. It was created by
775 @uref{http://en.wikipedia.org/wiki/User:Nihonjoe, Nihonjoe} and
776 @uref{http://en.wikipedia.org/wiki/User:CyberSkull, CyberSkull}, and
777 placed under the GNU Free Documentation License version 1.2 or later.
778 We found the image on
779 @uref{http://commons.wikimedia.org/wiki/File:Mac_OS_X_Userbox_X.png,
780 this Wikimedia Commons page}.
784 @macro logoLegalWindows
785 The @qq{four colored rectangles image} is not a registered
786 trademark. It was created by
787 @uref{http://en.wikipedia.org/wiki/User:Rohitbd, Rohitbd} and
788 placed under the GNU Free Documentation License version 1.2. We
790 @uref{http://commons.wikimedia.org/wiki/Category:Microsoft_Windows_logos,
791 this Wikimedia Commons page}.