X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fcommon-macros.itexi;h=6d47ad9cf3a21f04a7435ee6d4d828db2ddf871f;hb=bd8e8f0193000854fef9d3de3cc0a9f667ea8fb1;hp=b9113835d8ab3d22a3079d51b990473ab65acb06;hpb=91621d62e71a60270a5dec159a2d1f51c9a33f1c;p=lilypond.git diff --git a/Documentation/common-macros.itexi b/Documentation/common-macros.itexi index b9113835d8..6d47ad9cf3 100644 --- a/Documentation/common-macros.itexi +++ b/Documentation/common-macros.itexi @@ -1,11 +1,16 @@ @c -*- coding: utf-8; mode: texinfo; -*- +@c *********************************************** +@c SEE MACRO DEFINITION GUIDELINES IN macros.itexi +@c *********************************************** + @c Don't replace quotes with directed quotes. @set txicodequoteundirected @set txicodequotebacktick +@include cyrillic.itexi @c ***** Displaying text ***** @@ -46,19 +51,18 @@ @c already generates proper @image commands for images of music; these @c macro definitions do the same for other images. -@c can't scale images in tex @ifnotinfo -@macro sourceimage{FILENAME} -@image{pictures/\FILENAME\} +@macro sourceimage{FILENAME,WIDTH,HEIGHT,ALTTEXT} +@image{pictures/\FILENAME\,\WIDTH\,\HEIGHT\,\ALTTEXT\} @end macro @end ifnotinfo @ifinfo -@macro sourceimage{FILENAME} -@image{lilypond/pictures/\FILENAME\} +@macro sourceimage{FILENAME,WIDTH,HEIGHT,ALTTEXT} +@image{lilypond/pictures/\FILENAME\,\WIDTH\,\HEIGHT\,\ALTTEXT\} @end macro @end ifinfo @@ -66,6 +70,11 @@ @c ***** Headers ***** +@c For use as the Level 5 header +@macro subsubsubheading {TEXT} +@subsubheading @i{\TEXT\} +@end macro + @ifclear snippets-sections @macro lydoctitle {TEXT} @need 600 @@ -131,14 +140,13 @@ UNTRANSLATED NODE: IGNORE ME @ifset web -@macro help{TEXT} -@html -
- - Help wanted: - \TEXT\ -
-@end html +@c make link to bugfixes for news.itexi +@c use underscores for version: @bugfixes{2_13_13,} +@c use specifier arg when listing multiple versions +@c (see September 20, 2007 post for an example) +@macro bugfixes{version,specifier} +@uref{http://code.google.com/p/lilypond/issues/list?can=1&q=fixed_\version\&colspec=ID+Type+Status+Priority+Milestone+Owner+Summary,Bugfixes +\specifier\} @end macro @macro divId {ID} @@ -161,6 +169,42 @@ UNTRANSLATED NODE: IGNORE ME @end html @end macro +@ifclear web_version + @ifclear bigpage + @macro docLink{name,target,webLink} + @uref{../\target\, \name\} + @end macro + @end ifclear + @ifset bigpage + @macro docLink{name,target,webLink} + @uref{\target\, \name\} + @end macro + @end ifset +@end ifclear +@ifset web_version + @macro docLink{name,target,webLink} + \webLink\ + @end macro +@end ifset + +@macro miscLink{MISC-FILE,MISC-TEXT} +@uref{http://lilypond.org/website/misc/\MISC-FILE\,\MISC-TEXT\} +@end macro + +@macro spanClass {CLASS} +@html + +@end html +@end macro + +@macro spanEnd +@c keep the space for proper nesting of

+ +@html +
+@end html +@end macro + @c not strictly necessary, but it makes things easier for updating news @macro newsItem @@ -178,44 +222,49 @@ UNTRANSLATED NODE: IGNORE ME @end macro - -@macro imageClickable{IMAGE-FILE, MORE-TEXT, CLICK-FILE, POSITION} +@macro imageClickable{IMAGE-FILE, EXT, MORE-TEXT, CLICK-FILE, CLICK-EXT, POSITION} @html
- - \IMAGE-FILE\ + + \IMAGE-FILE\

\MORE-TEXT\

@end html -@ifnothtml -FIXME: broken image -@c @image{\IMAGE-FILE\} -@end ifnothtml +@iftex +@image{pictures/\IMAGE-FILE\,,,\IMAGE-FILE\} +@end iftex +@ifinfo +@image{lilypond/pictures/\IMAGE-FILE\,,,\IMAGE-FILE\} +@end ifinfo @end macro -@macro imageFloat{IMAGE-FILE, POSITION} +@macro imageFloat{IMAGE-FILE, EXT, POSITION} @html -\IMAGE-FILE\ +\IMAGE-FILE\ @end html -@ifnothtml -FIXME: broken image -@c @image{\IMAGE-FILE\} -@end ifnothtml +@iftex +@image{pictures/\IMAGE-FILE\,,,\IMAGE-FILE\,\EXT\} +@end iftex +@ifinfo +@image{lilypond/pictures/\IMAGE-FILE\,,,\EXT\} +@end ifinfo @end macro -@macro imageId{ID, IMAGE-FILE, ALT} +@macro imageId{ID, IMAGE-FILE, EXT, ALT} @html
- \ALT\ + \ALT\
@end html -@ifnothtml -FIXME: broken image -@c @image{\IMAGE-FILE\} -@end ifnothtml +@iftex +@image{pictures/\IMAGE-FILE\,,,\ALT\} +@end iftex +@ifinfo +@image{lilypond/pictures/\IMAGE-FILE\,,,\ALT\} +@end ifinfo @end macro @end ifset