X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;ds=sidebyside;f=Documentation%2Ffr%2Fuser%2Fmacros.itexi;h=8c60d92155d9e8a43184304e31341fbfbcc33c0e;hb=37ca1f80bf5401accd17056938f4f7b2c147ddb2;hp=916ff7d649fc86bb4cad4a39b3f8d9ac57f01164;hpb=df433e40f2f4ae0c6afcc69b107e74a7a0881b39;p=lilypond.git diff --git a/Documentation/fr/user/macros.itexi b/Documentation/fr/user/macros.itexi index 916ff7d649..8c60d92155 100644 --- a/Documentation/fr/user/macros.itexi +++ b/Documentation/fr/user/macros.itexi @@ -1,258 +1,383 @@ @c -*- coding: utf-8; mode: texinfo; -*- +@ignore + Translation of GIT committish: 1440fffdf8579046cc2033b9c697a190b34b91e5 -@ifnottex - @macro texisharp {word} - # - @end macro - @macro texiflat {word} - b - @end macro -@end ifnottex - -@c FIXME, use \fetaaccidentalsXMC? -@c \\kern0.15em\\fetachar\\fetaflat -@iftex - @macro texiflat {word} - @tex - FIXME: fetaflat - @end tex - @end macro -@c FIXME, use \fetaaccidentalsXC? -@c \\raise0.5ex\\fetachar\\fetasharp - @macro texisharp {word} - @tex - FIXME: fetasharp - @end tex - @end macro -@end iftex + When revising a translation, copy the HEAD committish of the + version that you are working on. See TRANSLATION for details. +@end ignore + +@include version.itexi +@c ***** Displaying text ***** -@macro arrow{} +@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. :( @iftex -@tex $\\Rightarrow$ @end tex@c -@end iftex -@ifhtml -@html -→ -@end html -@end ifhtml -@ifinfo ---> -@end ifinfo +@macro q{TEXT} +@quoteleft{}\TEXT\@quoteright{} @end macro +@macro qq{TEXT} +@guillemetleft{}@tie{}\TEXT\@tie{}@guillemetright{} +@end macro +@end iftex -@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 -@c annoying parentheses stripped by add-html-footer.py -@macro internalsref{NAME} -@vindex \NAME\ -@ref{\NAME\,,,lilypond-internals} +@ifinfo +@macro q{TEXT} +`\TEXT\' @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 qq{TEXT} +« \TEXT\ » @end macro +@end ifinfo -@c annoying parentheses stripped by add-html-footer.py -@macro rglos{NAME} -@vindex \NAME\ -@ref{\NAME\,,,music-glossary} -@end macro -@c to get decent quotes in `foo' +@ifhtml @macro q{TEXT} @html ‘\TEXT\’ @end html @end macro -@c to get decent French quotes in ``foo'' @macro qq{TEXT} @html -« \TEXT\ » +« \TEXT\ » @end html @end macro - @end ifhtml @ifdocbook -@c ***** DOCBOOK-XML ***** - -@macro internalsref{NAME} -@vindex \NAME\ -@ref{\NAME\,,,lilypond-internals} -@end macro - -@macro inputfileref{DIR,NAME} -@uref{source/\DIR\/collated-files.html#\NAME\,@file{\DIR\/\NAME\}} -@end macro - -@macro rglos{NAME} -@vindex \NAME\ -@ref{\NAME\,,,music-glossary} -@end macro - -@c to get decent quotes in `foo' @macro q{TEXT} @xml ‘\TEXT\’ @end xml @end macro -@c to get decent quotes in ``foo'' @macro qq{TEXT} @xml -«\TEXT\» +« \TEXT\ » @end xml @end macro - @end ifdocbook +@macro warning{TEXT} +@quotation +@quotation +@cartouche +@b{Note :} \TEXT\ +@end cartouche +@end quotation +@end quotation +@end macro + +@ifnotinfo +@macro notation{TEXT} +@var{\TEXT\} +@end macro +@end ifnotinfo @ifinfo -@c **** INFO **** +@macro notation{TEXT} +\TEXT\ +@end macro +@end ifinfo -@macro internalsref{NAME} -@vindex \NAME\ -@inforef{\NAME\,,lilypond-internals} +@macro smallspace +@sp 1 @end macro -@macro inputfileref{DIR,NAME} -@file{\DIR\/\NAME\} + +@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 rglos{NAME}@c -@vindex \NAME\ -@inforef{\NAME\,,,music-glossary} +@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 -@macro usermanref{NAME} -@inforef{\NAME\} @end macro -@c to get decent quotes in `foo' -@macro q{TEXT} -`\TEXT\' +@macro snippets +@noindent +@subsubheading Selected Snippets + @end macro -@c to get decent quotes in ``foo'' -@macro qq{TEXT} -« \TEXT\ » +@c obsolete, remove when translation is fully updated +@macro commonprop +@noindent +@subsubheading Commonly tweaked properties + @end macro -@end ifinfo +@macro seealso +@noindent +@subsubheading See also +@end macro -@c **** TEX **** -@iftex +@macro knownissues +@noindent +@subsubheading Known issues and warnings -@macro internalsref{NAME} -@vindex \NAME\ -@code{\NAME\} @end macro -@macro inputfileref{DIR,NAME} -@file{\DIR\/@/\NAME\} +@c obsolete, remove when translation is fully updated +@macro context{TEXT} +@vindex \TEXT\ +@code{\TEXT\}@c should use rinternals @end macro -@macro rglos {NAME} -@vindex \NAME\ -@code{\NAME\} +@c obsolete, remove when translation is fully updated +@macro refcommand{TEXT} +@vindex \TEXT\ +@code{\TEXT\} @end macro -@macro seeinternals{NAME} -internals document, @internalsref{\NAME\} +@macro lydoctitle {TEXT} +@emph{\TEXT\} + @end macro -@macro usermanref{NAME} -user manual, @internalsref{\NAME\} +@macro funindex {TEXT} +@findex \TEXT\ +@kindex \TEXT\ @end macro -@c to get decent quotes in `foo' -@macro q{TEXT} -`\TEXT\' + + +@c **** Links and references **** + +@c Definitions for references: +@c @rinternals +@c @rglos +@c @rprogram +@c @ruser +@c @rlearning +@c @rlsr + +@ifhtml +@c ***** HTML ***** + +@ifset bigpage + +@macro rinternals{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-internals-big-page,Référence des propriétés internes} @end macro -@c to get decent quotes in ``foo'' -@macro qq{TEXT} -<< \TEXT\ >> +@macro rglos{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,music-glossary-big-page,Glossaire} @end macro -@end iftex +@macro rprogram{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-program-big-page,Manuel d'utilisation du programme} +@end macro +@macro ruser{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-big-page,Manuel de notation} +@end macro -@ifnottex -@c **** not TEX **** +@macro rlearning{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-learning-big-page,Manuel d'initiation} +@end macro -@macro seeinternals{NAME} -@internalsref{\NAME\} +@macro rlsr{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-snippets-big-page,Exemples de code} @end macro -@ifnotinfo -@macro usermanref{NAME} -@ref{\NAME\} +@end ifset + + +@ifclear bigpage + +@macro rinternals{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-internals,Référence des propriétés internes} @end macro -@end ifnotinfo -@end ifnottex +@macro rglos{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,music-glossary,Glossaire} +@end macro +@macro rprogram{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-program,Manuel d'utilisation du programme} +@end macro -@c **** ALL **** +@macro ruser{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond,Manuel de notation} +@end macro -@macro refbugs -@noindent -@subsubheading Bugs +@macro rlearning{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-learning,Manuel d'initiation} +@end macro +@macro rlsr{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-snippets,Exemples de code} @end macro -@macro moreinfo -@subheading More information +@end ifclear + +@end ifhtml + +@ifdocbook +@c ***** DOCBOOK-XML ***** + +@macro rinternals{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-internals,Référence des propriétés internes} @end macro -@macro seealso -@noindent -@subsubheading See also +@macro rglos{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,music-glossary,Glossaire} +@end macro +@macro rprogram{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-program,Manuel d'utilisation du programme} @end macro -@macro refcommands -@noindent -@subsubheading Predefined commands +@macro ruser{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond,Manuel de notation} +@end macro +@macro rlearning{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-learning,Manuel d'initiation} @end macro -@macro context{NAME} +@macro rlsr{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-snippets,Exemples de code} +@end macro + +@end ifdocbook + + +@ifinfo +@c **** INFO **** + +@macro rinternals{NAME} @vindex \NAME\ -@code{\NAME\}@c should use internalsref +@inforef{\NAME\,,lilypond-internals,Référence des propriétés internes} @end macro -@macro refcommand{WHAT} -@vindex \WHAT\ -@code{\WHAT\} +@macro rglos{NAME} +@vindex \NAME\ +@inforef{\NAME\,,music-glossary,Glossaire} @end macro -@macro commonprop -@noindent -@subsubheading Commonly tweaked properties +@macro rprogram{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-program,Manuel d'utilisation du programme} +@end macro + +@macro ruser{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond,Manuel de notation} +@end macro + +@macro rlearning{TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,lilypond-learning,Manuel d'initiation} +@end macro + +@macro rlsr{TEXT} +@ref{\TEXT\,,,lilypond-snippets,Exemples de code} +@end macro + +@end ifinfo + + +@c **** TEX **** +@iftex +@macro rinternals{TEXT} +@vindex \TEXT\ +@code{\TEXT\} @end macro -@macro funindex {WORD} -@findex \WORD\ -@kindex \WORD\ +@macro rglos {TEXT} +@vindex \TEXT\ +@ref{\TEXT\,,,music-glossary,Glossaire} @end macro -@c EOF +@macro rprogram{TEXT} +@ref{\TEXT\,,,lilypond-program.fr,Manuel d'utilisation du programme} +@end macro + +@macro ruser{TEXT} +@ref{\TEXT\,,,lilypond.fr,Manuel de notation} +@end macro + +@macro rlearning{TEXT} +@ref{\TEXT\,,,lilypond-learning.fr,Manuel d'initiation} +@end macro + +@macro rlsr{TEXT} +@ref{\TEXT\,,,lilypond-snippets,Exemples de code} +@end macro + +@end iftex + + +@c Commands specific to translated docs + +@c ugh, cannot set/define global variable 'translationof' in some way? +@iftex +@macro translationof{TEXT} +@end macro +@end iftex + +@ifinfo +@macro +@macro translationof{TEXT} +@set translationof \TEXT\ +@end macro +@end ifinfo + +@c TODO when @translationof is used in translated docs +@c see if it's feasible to say @value{translationof} +@macro englishref +Cette section n'est pas encore encore traduite, veuillez +vous reporter à la documentation correspondante en anglais. +@end macro