X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fde%2Fuser%2Fmacros.itexi;h=261ae0561ba3f794b4816173ef46e345884d4c48;hb=a58143ffd322981ea22351c44a0d5929f18892e5;hp=fb8e8360a3f45435c2cff09ee40ecad199884363;hpb=157d98c1870868bf59c1691577444e3c3d533bc4;p=lilypond.git diff --git a/Documentation/de/user/macros.itexi b/Documentation/de/user/macros.itexi index fb8e8360a3..261ae0561b 100644 --- a/Documentation/de/user/macros.itexi +++ b/Documentation/de/user/macros.itexi @@ -1,289 +1,472 @@ @c -*- coding: utf-8; mode: texinfo; -*- @ignore - Translation of GIT committish: 8a19cc25524338cdd99863ccd954bbcb8f8b2afa + Translation of GIT committish: 2881ea603b63e4e335dc1104b0c22c71f373b20d When revising a translation, copy the HEAD committish of the version that you are working on. See TRANSLATION for details. @end ignore -@c **** all formats **** -@macro refbugs -@noindent -@subsubheading Bugs +@include version.itexi + + +@c Don't replace quotes with directed quotes. + +@set txicodequoteundirected +@set txicodequotebacktick + + +@c ***** Displaying text ***** + +@c We need this since @q{\} doesn't work with makeinfo 4.11 -- +@c say @q{@bs{}} instead. + +@macro bs +\\ @end macro -@macro moreinfo -@subheading More information +@c To get decent quotes in ,foo' and ,,foo''. +@c These need to be split up so that "@qq{foo}." looks nice. :( + +@macro q{TEXT} +@quotesinglbase{}\TEXT\@quoteleft{} +@end macro + +@macro qq{TEXT} +@quotedblbase{}\TEXT\@quotedblleft{} @end macro -@macro seealso -@noindent -@subsubheading See also +@ifhtml + +@macro warning{TEXT} +@cartouche +@b{Achtung:} \TEXT\ +@end cartouche @end macro -@macro refcommands +@end ifhtml + +@ifnothtml + +@macro warning{TEXT} +@quotation +@quotation +@cartouche +@b{Achtung:} \TEXT\ +@end cartouche +@end quotation +@end quotation +@end macro + +@end ifnothtml + + +@ifnotinfo + +@macro notation{TEXT} +@var{\TEXT\} +@end macro + +@end ifnotinfo + +@ifinfo + +@macro notation{TEXT} +\TEXT\ +@end macro + +@end ifinfo + + +@macro smallspace +@sp 1 +@end macro + + + +@c ***** Displaying images not generated by lilypond-book ***** + +@c Current installation setup of Info docs requires that all images are +@c expected to be found in the `lilypond/' subdirectory. `lilypond-book' +@c already generates proper @image commands for images of music; these +@c macro definitions do the same for other images. + +@ifnotinfo + +@macro sourceimage{FILENAME,WIDTH,HEIGHT,ALTTEXT} +@image{\FILENAME\,\WIDTH\,\HEIGHT\,\ALTTEXT\} +@end macro + +@end ifnotinfo + +@ifinfo + +@macro sourceimage{FILENAME,WIDTH,HEIGHT,ALTTEXT} +@image{lilypond/\FILENAME\,\WIDTH\,\HEIGHT\,\ALTTEXT\} +@end macro + +@end ifinfo + + + +@c ***** Headings in a doc subsection ***** + +@c Don't insert an empty line after @predefined! Right now +@c it doesn't matter, but a future implementation will probably +@c add some code which needs this restriction. + +@macro predefined @noindent @subsubheading Predefined commands - @end macro -@macro context{NAME} -@vindex \NAME\ -@code{\NAME\}@c should use internalsref +@c The next macro is a dummy currently since texinfo doesn't +@c provide a real ragged-right environment yet. +@c +@c Due to a bug in texi2html (texi2html.pl CVS versions <= 1.245) +@c the macro must not be empty. + +@macro endpredefined +@c @end macro -@macro refcommand{WHAT} -@vindex \WHAT\ -@code{\WHAT\} + +@macro snippets +@noindent +@subsubheading Selected Snippets @end macro + +@c obsolete, remove when translation is fully updated @macro commonprop @noindent @subsubheading Commonly tweaked properties +@end macro + + +@c Don't insert an empty line after @seealso! Otherwise we get +@c unwanted extra vertical space in the PDF output. + +@macro seealso +@noindent +@subsubheading See also +@indent +@end macro + +@macro knownissues +@noindent +@subsubheading Known issues and warnings @end macro -@macro funindex {WORD} -@findex \WORD\ -@kindex \WORD\ + +@macro lydoctitle {TEXT} +@emph{\TEXT\} +@end macro + + +@c Don't remove the `@c' within the macro definition! See section 19.3, +@c `Macro Details and Caveats', in the texinfo info file for explanation. + +@macro funindex {TEXT} +@findex \TEXT\ +@kindex \TEXT\ +@c @end macro -@c *** Macros with variable output *** +@c ***** Links and references ***** +@c obsolete @c usage: @lsr{ancient,custodes.ly} -@macro lsr{DIR,NAME} +@macro lsr{DIR,TEXT} @ifhtml - @uref{source/input/lsr/\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}} +@uref{source/input/lsr/\DIR\/collated-files.html#\TEXT\,@file{\DIR\/\TEXT\}} @end ifhtml @ifnothtml - @file{\DIR\/\NAME\} +@file{\DIR\/\TEXT\} @end ifnothtml @end macro +@c don't update until this macro is correctly set up in English docs @macro lsrdir{DIR} @ifhtml - @uref{source/input/lsr/\DIR\/collated-files.html,@file{\DIR\}} +@uref{source/input/lsr/\DIR\/collated-files.html,@file{\DIR\}/} @end ifhtml @ifnothtml - @file{\DIR\} +@file{\DIR\} @end ifnothtml @end macro +@c Definitions for references: +@c +@c @rglos +@c @rlearning +@c @ruser +@c @rprogram +@c @rlsr +@c @rinternals +@c +@c All these also have a @...named version which allows to specify the +@c displayed text for the reference as second argument. +@c +@c ***** HTML + bigpage is a special case (other manual names); all other +@c formats are treated similarly. -@macro arrow{} -@iftex -@tex $\\Rightarrow$ @end tex@c -@end iftex -@ifhtml -@html -→ -@end html -@end ifhtml -@ifinfo ---> -@end ifinfo -@end macro - - -@c we need this since @q{\} doesn't work with makeinfo 4.8 -- -@c say @q{@value{backslash}} instead -@set backslash \ - +@c *** not TeX *** -@ifhtml -@c ***** HTML ***** +@ifnottex -@c makeinfo-4.7 encodes html names, which means that nodes that -@c contain nonalphanum characters will be broken links on the website. -@c @uref{../lilypond-internals/\NAME\.html,\NAME\}@c -@c @inforef{} adds ``See'' to the sentence, which is annoying, but -@c better than a broken link. -@c @inforef{\NAME\,,lilypond-internals}@c -@c using @ref without punctuation is OK without for formats other than info +@c ** bigpage ** @ifset bigpage -@macro internalsref{NAME} -@vindex \NAME\ -@ref{\NAME\,,,lilypond-internals-big-page} +@macro rglos{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,music-glossary-big-page,Glossar} @end macro -@macro rglos{NAME} -@vindex \NAME\ -@ref{\NAME\,,,music-glossary-big-page} +@macro rglosnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,music-glossary-big-page,Glossar} @end macro -@end ifset +@macro rlearning{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-learning-big-page,Handbuch zum Lernen} +@end macro +@macro rlearningnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,lilypond-learning-big-page,Handbuch zum Lernen} +@end macro -@ifclear bigpage +@macro ruser{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-big-page,Notationsreferenz} +@end macro -@c annoying parentheses stripped by add-html-footer.py -@macro internalsref{NAME} -@vindex \NAME\ -@ref{\NAME\,,,lilypond-internals} +@macro rusernamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,lilypond-big-page,Notationsreferenz} @end macro -@c annoying parentheses stripped by add-html-footer.py -@macro rglos{NAME} -@vindex \NAME\ -@ref{\NAME\,,,music-glossary} +@macro rprogram{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-program-big-page,Anwendungsbenutzung} @end macro -@end ifclear +@macro rprogramnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,lilypond-program-big-page,Anwendungsbenutzung} +@end macro +@macro rlsr{TEXT} +@ref{\TEXT\,,,lilypond-snippets-big-page,Schnipsel} +@end macro -@c usage: @inputfileref{input@/regression,FILE@/-NAME.ly} -@macro inputfileref{DIR,NAME} -@uref{source/\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}@c +@macro rlsrnamed{TEXT,DISPLAY} +@ref{\TEXT\,,\DISPLAY\,lilypond-snippets-big-page,Schnipsel} @end macro -@c to get decent German quotes in `foo' -@macro q{TEXT} -@html -‚\TEXT\‘ -@end html +@macro rinternals{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-internals-big-page,Referenz der Interna} @end macro -@c to get decent German quotes in ``foo'' -@macro qq{TEXT} -@html -„\TEXT\“ -@end html +@macro rinternalsnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,lilypond-internals-big-page,Referenz der Interna} @end macro -@end ifhtml +@end ifset + +@c ** not bigpage ** -@ifdocbook -@c ***** DOCBOOK-XML ***** +@ifclear bigpage -@macro internalsref{NAME} -@vindex \NAME\ -@ref{\NAME\,,,lilypond-internals} +@macro rglos{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,music-glossary,Glossar} @end macro -@macro inputfileref{DIR,NAME} -@uref{source/\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}} +@macro rglosnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,music-glossary,Glossar} @end macro -@macro rglos{NAME} -@vindex \NAME\ -@ref{\NAME\,,,music-glossary} +@macro rlearning{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-learning,Handbuch zum Lernen} @end macro -@c to get decent German quotes in `foo' -@macro q{TEXT} -@html -‚\TEXT\‘ -@end html +@macro rlearningnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,lilypond-learning,Handbuch zum Lernen} @end macro -@c to get decent German quotes in ``foo'' -@macro qq{TEXT} -@html -„\TEXT\“ -@end html +@macro ruser{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond,Notationsreferenz} @end macro -@end ifdocbook +@macro rusernamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,lilypond,Notationsreferenz} +@end macro +@macro rprogram{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-program,Anwendungsbenutzung} +@end macro -@ifinfo -@c **** INFO **** +@macro rprogramnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,lilypond-program,Anwendungsbenutzung} +@end macro -@macro internalsref{NAME} -@vindex \NAME\ -@inforef{\NAME\,,lilypond-internals} +@macro rlsr{TEXT} +@ref{\TEXT\,,,lilypond-snippets,Schnipsel} @end macro -@macro inputfileref{DIR,NAME} -@file{\DIR\/\NAME\} +@macro rlsrnamed{TEXT,DISPLAY} +@ref{\TEXT\,,\DISPLAY\,lilypond-snippets,Schnipsel} @end macro -@macro rglos{NAME}@c -@vindex \NAME\ -@inforef{\NAME\,,,music-glossary} +@macro rinternals{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-internals,Referenz der Interna} @end macro -@macro usermanref{NAME} -@inforef{\NAME\} +@macro rinternalsnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,lilypond-internals,Referenz der Interna} @end macro -@c to get decent quotes in `foo' -@macro q{TEXT} -‚\TEXT\‘ +@end ifclear + +@end ifnottex + + +@c *** TeX *** + +@iftex + +@macro rglos{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,music-glossary,Glossar} @end macro -@c to get decent quotes in ``foo'' -@macro qq{TEXT} -„\TEXT\“ +@macro rglosnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,music-glossary,Glossar} @end macro -@end ifinfo +@macro rlearning{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-learning.de,Handbuch zum Lernen} +@end macro +@macro rlearningnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,lilypond-learning.de,Handbuch zum Lernen} +@end macro -@c **** TEX **** -@iftex +@macro ruser{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond.de,Notationsreferenz} +@end macro -@macro internalsref{NAME} -@vindex \NAME\ -@code{\NAME\} +@macro rusernamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,lilypond.de,Notationsreferenz} @end macro -@macro inputfileref{DIR,NAME} -@file{\DIR\/@/\NAME\} +@macro rprogram{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-program.de,Anwendungsbenutzung} @end macro -@macro rglos {NAME} -@vindex \NAME\ -@code{\NAME\} +@macro rprogramnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,lilypond-program.de,Anwendungsbenutzung} @end macro -@macro seeinternals{NAME} -internals document, @internalsref{\NAME\} +@macro rlsr{TEXT} +@ref{\TEXT\,,,lilypond-snippets,Schnipsel} @end macro -@macro usermanref{NAME} -user manual, @internalsref{\NAME\} +@macro rlsrnamed{TEXT,DISPLAY} +@ref{\TEXT\,,\DISPLAY\,lilypond-snippets,Schnipsel} @end macro -@c to get decent German quotes in `foo' -@macro q{TEXT} -@quotesinglbase{}\TEXT\` +@macro rinternals{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-internals,Referenz der Interna} @end macro -@c to get decent German quotes in ``foo'' -@macro qq{TEXT} -@quotedblbase{}\TEXT\`` +@macro rinternalsnamed{TEXT,DISPLAY} +@vindex \TEXT\ +@ref{\TEXT\,,\DISPLAY\,lilypond-internals,Referenz der Interna} @end macro @end iftex -@ifnottex -@c **** not TEX **** -@macro seeinternals{NAME} -@internalsref{\NAME\} +@c ***** Macros specific to translated docs ***** + +@c ugh, cannot set/define global variable 'translationof' in some way? + +@iftex + +@macro translationof{TEXT} @end macro -@ifnotinfo -@macro usermanref{NAME} -@ref{\NAME\} +@end iftex + +@ifinfo + +@macro +@macro translationof{TEXT} +@set translationof \TEXT\ @end macro -@end ifnotinfo -@end ifnottex +@end ifinfo + + +@c TODO: If @translationof is used in translated docs +@c see whether it is feasible to say @value{translationof}. + +@macro englishref +Dieser Abschnitt wurde noch nicht übersetzt. Bitte lesen Sie den +Abschnitt im englischen Benutzerhandbuch. +@end macro + + +@ifhtml + +@ifset bigpage +@macro untranslated +@end macro +@end ifset +@ifclear bigpage +@macro untranslated +UNTRANSLATED NODE: IGNORE ME +@end macro +@end ifclear -@c EOF +@end ifhtml +@ifnothtml +@macro untranslated +@end macro +@end ifnothtml