X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fde%2Fuser%2Fmacros.itexi;h=fb3329078a50e8ca21d77b4ac3e0c9b6485d6864;hb=2a07e2ea1924abec1b70e2150e698e5792ae1687;hp=6aa222e3139d91969e190e7a8ba135c1aabda32b;hpb=5274f7944a00e046d6c980925c9188df6b82d865;p=lilypond.git diff --git a/Documentation/de/user/macros.itexi b/Documentation/de/user/macros.itexi index 6aa222e313..fb3329078a 100644 --- a/Documentation/de/user/macros.itexi +++ b/Documentation/de/user/macros.itexi @@ -1,118 +1,189 @@ @c -*- coding: utf-8; mode: texinfo; -*- +@ignore + Translation of GIT committish: db57f02c46305a587071dfb73a51bd8250df2482 -@c **** all formats **** + When revising a translation, copy the HEAD committish of the + version that you are working on. See TRANSLATION for details. +@end ignore -@macro refbugs -@noindent -@subsubheading Bugs +@macro version +@value{version} @end macro -@macro moreinfo -@subheading More information +@c ***** Displaying text ***** + +@c we need this since @q{\} doesn't work with makeinfo 4.8 -- +@c say @q{@value{backslash}} instead +@set backslash \ + +@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 seealso -@noindent -@subsubheading See also +@macro qq{TEXT} +@quotedblbase{}\TEXT\@quotedblleft{} +@end macro +@macro warning{TEXT} +@quotation +@quotation +@cartouche +@b{Achtung:} \TEXT\ +@end cartouche +@end quotation +@end quotation +@end macro + +@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 lilypond/ subdirectory. lilypond-book already +@c generates proper @image commands for images of music; these macros +@c definitions do the same for other images. + +@ifnotinfo +@macro sourceimage{FILENAME,WIDTH,HEIGHT,ALTTEXT} +@image{\FILENAME\,\WIDTH\,\HEIGHT\,\ALTTEXT\} +@end macro +@end ifnotinfo -@macro refcommands +@ifinfo +@macro sourceimage{FILENAME,WIDTH,HEIGHT,ALTTEXT} +@image{lilypond/\FILENAME\,\WIDTH\,\HEIGHT\,\ALTTEXT\} +@end macro +@end ifinfo + + + +@c **** Headings in a doc subsection **** + +@macro predefined @noindent @subsubheading Predefined commands @end macro -@macro context{NAME} -@vindex \NAME\ -@code{\NAME\}@c should use internalsref -@end macro +@macro snippets +@noindent +@subsubheading Selected Snippets -@macro refcommand{WHAT} -@vindex \WHAT\ -@code{\WHAT\} @end macro +@c obsolete, remove when translation is fully updated @macro commonprop @noindent @subsubheading Commonly tweaked properties @end macro -@macro funindex {WORD} -@findex \WORD\ -@kindex \WORD\ +@macro seealso +@noindent +@subsubheading See also + +@end macro + +@macro knownissues +@noindent +@subsubheading Known issues and warnings + +@end macro + +@c obsolete, remove when translation is fully updated +@macro context{TEXT} +@vindex \TEXT\ +@code{\TEXT\}@c should use internalsref +@end macro + + +@macro funindex {TEXT} +@findex \TEXT\ +@kindex \TEXT\ @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 -@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 Definitions for references: +@c @internalsref +@c @rglos +@c @rprogram +@c @ruser +@c @rlearning @ifhtml @c ***** HTML ***** -@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 - @ifset bigpage -@macro internalsref{NAME} -@vindex \NAME\ -@ref{\NAME\,,,lilypond-internals-big-page} +@macro internalsref{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-internals-big-page} @end macro -@macro rglos{NAME} -@vindex \NAME\ -@ref{\NAME\,,,music-glossary-big-page} +@macro rglos{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,music-glossary-big-page} +@end macro + +@macro rprogram{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-program-big-page} +@end macro + +@macro ruser{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-big-page} +@end macro + +@macro rlearning{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-learning-big-page} @end macro @end ifset @@ -120,72 +191,62 @@ @ifclear bigpage -@c annoying parentheses stripped by add-html-footer.py -@macro internalsref{NAME} -@vindex \NAME\ -@ref{\NAME\,,,lilypond-internals} +@macro internalsref{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-internals} @end macro -@c annoying parentheses stripped by add-html-footer.py -@macro rglos{NAME} -@vindex \NAME\ -@ref{\NAME\,,,music-glossary} +@macro rglos{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,music-glossary} @end macro -@end ifclear - - -@c usage: @inputfileref{input@/regression,FILE@/-NAME.ly} -@macro inputfileref{DIR,NAME} -@uref{source/\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}}@c +@macro rprogram{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-program} @end macro -@c to get decent German quotes in `foo' -@macro q{TEXT} -@html -‚\TEXT\‘ -@end html +@macro ruser{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond} @end macro -@c to get decent German quotes in ``foo'' -@macro qq{TEXT} -@html -„\TEXT\“ -@end html +@macro rlearning{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-learning} @end macro +@end ifclear + @end ifhtml @ifdocbook @c ***** DOCBOOK-XML ***** -@macro internalsref{NAME} -@vindex \NAME\ -@ref{\NAME\,,,lilypond-internals} +@macro internalsref{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-internals} @end macro -@macro inputfileref{DIR,NAME} -@uref{source/\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}} +@macro rglos{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,music-glossary} @end macro -@macro rglos{NAME} -@vindex \NAME\ -@ref{\NAME\,,,music-glossary} +@macro rprogram{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-program} @end macro -@c to get decent German quotes in `foo' -@macro q{TEXT} -@html -‚\TEXT\‘ -@end html +@macro ruser{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond} @end macro -@c to get decent German quotes in ``foo'' -@macro qq{TEXT} -@html -„\TEXT\“ -@end html +@macro rlearning{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-learning} @end macro @end ifdocbook @@ -199,27 +260,24 @@ @inforef{\NAME\,,lilypond-internals} @end macro -@macro inputfileref{DIR,NAME} -@file{\DIR\/\NAME\} -@end macro - -@macro rglos{NAME}@c +@macro rglos{NAME} @vindex \NAME\ -@inforef{\NAME\,,,music-glossary} +@inforef{\NAME\,,music-glossary} @end macro -@macro usermanref{NAME} -@inforef{\NAME\} +@macro rprogram{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-program} @end macro -@c to get decent quotes in `foo' -@macro q{TEXT} -‚\TEXT\‘ +@macro ruser{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond} @end macro -@c to get decent quotes in ``foo'' -@macro qq{TEXT} -„\TEXT\“ +@macro rlearning{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-learning} @end macro @end ifinfo @@ -228,105 +286,29 @@ @c **** TEX **** @iftex -@macro internalsref{NAME} -@vindex \NAME\ -@code{\NAME\} -@end macro - -@macro inputfileref{DIR,NAME} -@file{\DIR\/@/\NAME\} +@macro internalsref{TEXT} +@vindex \TEXT\ +@code{\TEXT\} @end macro -@macro rglos {NAME} -@vindex \NAME\ -@code{\NAME\} -@end macro - -@macro seeinternals{NAME} -internals document, @internalsref{\NAME\} -@end macro - -@macro usermanref{NAME} -user manual, @internalsref{\NAME\} -@end macro - -@tex -% from german.sty -\def\allowhyphens{% - \penalty\@M - \hskip\z@skip} - -\gdef\set@low@box#1{% - \setbox\tw@\hbox{,}% - \setbox\z@\hbox{#1}% - \setbox\z@\hbox{% - \dimen@\ht\z@ - \advance\dimen@ -\ht\tw@ - \lower\dimen@\box\z@}% - \ht\z@\ht\tw@ - \dp\z@\dp\tw@} - -\gdef\save@sf@q#1{% - {\ifhmode - \edef\@SF{\spacefactor\the\spacefactor}% - \else - \let\@SF\empty - \fi - \leavevmode #1 - \@SF}} - -\gdef\glq{% - \save@sf@q{% - \set@low@box{'\/}% - \box\z@ - \kern-.04em - \allowhyphens}} -\gdef\grq{% - \save@sf@q{% - \kern-.0125em - `% - \kern.07em}} -\gdef\glqq{% - \save@sf@q{% - \set@low@box{''\/}% - \box\z@ - \kern-.04em - \allowhyphens}} -\gdef\grqq{% - \save@sf@q{% - \kern-.07em - ``% - \kern.07em}} -@end tex - -@c to get decent quotes in `foo' -@macro q{TEXT} -@glq\TEXT\@grq +@macro rglos {TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,music-glossary} @end macro -@c to get decent quotes in ``foo'' -@macro qq{TEXT} -@glqq\TEXT\@grqq +@macro rprogram{TEXT} +Programmbenutzung, @ref{\TEXT\,,,lilypond-program.de} @end macro -@end iftex - - -@ifnottex -@c **** not TEX **** - -@macro seeinternals{NAME} -@internalsref{\NAME\} +@macro ruser{TEXT} +Benutzerhandbuch, @ref{\TEXT\,,,lilypond.de} @end macro -@ifnotinfo -@macro usermanref{NAME} -@ref{\NAME\} +@macro rlearning{TEXT} +Handbuch zum Lernen, @ref{\TEXT\,,,lilypond-learning.de} @end macro -@end ifnotinfo -@end ifnottex +@end iftex @c EOF -