Documentation/fr/texidocs/generating-whole-scores-also-book-parts-in-scheme-without-using-the-parser.texidoc

   1 %% Translation of GIT committish: cc3b9e1430f4cc9c54da7252e504f3d274a7ea17
   2   texidocfr = "
   3 Une partition LilyPond, de manière interne, n'est rien d'autre qu'une
   4 expression Scheme générée par l'analyseur syntaxique de lilypond.  Il
   5 est donc possible, à l'aide de Scheme, de générer automatiquement une
   6 partition sans fichier source.  Une expression musicale en Scheme sera
   7 transformée en partition par un appel à
   8 @code{(scorify-music music parser)}.  Ceci aura pour effet de générer
   9 un objet @code{score} auquel sera appliqué un bloc @code{layout}
  10 comportant la fonction
  11
  12 @example
  13 (let* ((layout (ly:output-def-clone $defaultlayout)))
  14    ; modification de la mise en forme, puis assignation :
  15    (ly:score-add-output-def! score layout)
  16   )
  17 @end example
  18
  19 Il suffit alors de transmettre ce @code{score} à lilypond pour qu'il le
  20 grave.  Les trois fonctions -- @code{(add-score parser score)},
  21 @code{(add-text parser text)} et @code{(add-music parser music)} --
  22 définies dans le code ci-dessous permettent de transmettre à lilypond,
  23 aux fins de les graver, une partition complète, un @emph{markup} ou
  24 simplement de la musique.
  25
  26 Cet exemple permet aussi de graver les pièces contenues dans un bloc
  27 @code{\\book@{@dots{}@}} ainsi que des partitions de niveau supérieur.
  28 Chaque partition destinée à être gravée est alors ajoutée à la liste des
  29 partitions de niveau supérieur ; le @code{toplevel-book-handler} --
  30 fonction Scheme appelée pour traiter un @emph{book} dès que le bloc
  31 @code{\\book@{@dots{}@}} est clôturé -- s'adapte pour prendre en charge
  32 tous les @code{score} jusque là collectés dans l'ouvrage.
  33
  34 "
  35   doctitlefr = "Génération en Scheme de partitions complètes (y compris des parties d'ouvrage) sans utiliser l'analyseur"