%% Generated by lilypond-book
%% Options: [exampleindent=10.16\mm,indent=0\mm,line-width=160\mm,paper-height=845.047\pt,paper-width=597.508\pt,papersize='(cons (* 597.508 pt) (* 845.047 pt))]
\include "lilypond-book-preamble.ly"


% ****************************************************************
% Start cut-&-pastable-section
% ****************************************************************

#(ly:set-option 'eps-box-padding 3.000000)



\paper {
  #(set-paper-size '(cons (* 597.508 pt) (* 845.047 pt)))
  indent = 0\mm
  line-width = 160\mm
  % offset the left padding, also add 1mm as lilypond creates cropped
  % images with a little space on the right
  line-width = #(- line-width (* mm  3.000000) (* mm 1))
}

\layout {
  
}




% ****************************************************************
% ly snippet:
% ****************************************************************
\sourcefilename "snippets/separating-key-cancellations-from-key-signature-changes.ly"
\sourcefileline 0
%% DO NOT EDIT this file manually; it was automatically
%% generated from `Documentation/snippets/new/`.
%%
%% Make any changes in `Documentation/snippets/new/`,
%% then run `scripts/auxiliar/makelsr.pl --new`.
%%
%% This file is in the public domain.
%%
%% Note: this file needs at least LilyPond version 2.25.35.

\version "2.25.35"

\header {
%% Translation of GIT committish: a8a85e19654e46d725563e6deba44083ef137a2c
  texidocja = "
デフォルトでは、調号が変更される際のナチュラルによる取り消し表示は、@c
新たな調号のすぐ隣に配置されます。この挙動は、@code{BreakAlignment} Grob の
@code{break-align-orders} プロパティをオーバライドすることで変更できます。

@code{break-align-orders} は長さ 3 のベクトルで、それぞれが@c
改行可能なアイテムを要素とした quote リストを取ります。この例では
2 つ目のリストのみを変更しており、@code{key-cancellation} を @code{staff-bar}
の前に移動しています。2 番目の要素はシステムの途中における配置に影響し、@c
行頭あるいは行末には影響しません。
"
  doctitleja = "調号の取り消し表示を新たな調号から離す"

%% Translation of GIT committish: c95d569e9013276fd0595366c79eebdf772bea77
  texidocfr = "
Les altérations supprimées lors d'un changement de tonalité sont par
défaut accolées à la nouvelle armure. Ce comportement peut s'adapter
grâce à la propriété @code{break-align-orders} de l'objet
@code{BreakAlignment}.

Si l'on se réfère à la référence des propriétés internes à propos de
l'objet @rinternals{break-alignment-interface}, l'ordre du deuxième
élément est :

@example
ambitus
breathing-sign
clef
cue-clef
cue-end-clef
custos
key-cancellation
key-signature
left-edge
signum-repetitionis
staff-bar
staff-ellipsis
time-signature
@end example

La consultation de cette liste nous apprend qu'il faut déplacer
@code{key-cancellation} pour le mettre avant @code{staff-bar}. Ceci se
réalise à l'aide de la fonction @code{\\breakAlignInsert}.
"

  doctitlefr = "Séparation entre altérations annulées et nouvelle armure"

%% Translation of GIT committish: b29e4a7ec4796951eb92b596fd04b9f7f719ab02
  texidoces = "
De forma predeterminada, las alteraciones accidentales que se usan
para las cancelaciones en las armaduras se colocan adyacentes a
las que se usan para los cambios de tonalidad.  Este
comportamiento se puede cambiar sobreescribiendo la propiedad
@code{break-align-orders} del objeto gráfico
@code{BreakAlignment}.

Si busca la definición de @code{break-alignment-interface} en la
@uref{https://lilypond.org/doc/v2.24/Documentation/internals/break_002dalignment_002dinterface,Referencia
de funcionamiento interno} de LilyPond, obtendrá la siguiente
lista de los símbolos de break-align disponibles:

@example
ambitus
breathing-sign
clef
cue-clef
cue-end-clef
custos
key-cancellation
key-signature
left-edge
signum-repetitionis
staff-bar
staff-ellipsis
time-signature
@end example

A partir de esta lista, vemos que lo que queremos hacer es
trasladar la @code{key-cancellation} de forma que esté antes del
@code{staff-bar}. Esto se hace con la función
@code{\\breakAlignInsert}.

"
  doctitlees = "Separar las cancelaciones de tonalidad de los cambios de armadura"

%% Translation of GIT committish: 8ffecf6be17c6ec2ff87cf31873121a8cce29b09
  texidocca = "
De forma predeterminada, les alteracions accidentals que s'usen
per a les cancel·lacions a les armadures es col·loquen adjacents
a les que s'usen per als canvis de tonalitat.  Aquest comportament
es pot canviar sobreescrivint la propietat @code{'break-align-orders}
de l'objecte gràfic @code{BreakAlignment}.

El valor de @code{'break-align-orders} és un vector de longitud 3, amb
llistes entre cometes els elements de les quals són objectes que
es poden dividir en un salt.  Aquest exemple sols modifica la
segona llista, movent @code{key-cancellation} abans de @code{staff-bar};
modificant la segona llista, el comportament d'alineació dels
salts canvia en la meitat d'un sistema, no al principi ni al final.

"
  doctitleca = "Separar les cancel·lacions de tonalitat dels canvis d'armadura"

  categories = "Pitches, Scheme, Tweaks and overrides"

  texidoc = "
By default, the accidentals used for key cancellations are placed
adjacent to those for key signature changes. This behavior can be
changed by overriding the @code{break-align-orders} property of the
@code{BreakAlignment} grob.

If you look up the definition of the @code{break-alignment-interface} in
LilyPond's
@uref{https://lilypond.org/doc/v2.24/Documentation/internals/break_002dalignment_002dinterface,
Internals Reference}, you get the following list of available break-align
symbols:

@example
ambitus
breathing-sign
clef
cue-clef
cue-end-clef
custos
key-cancellation
key-signature
left-edge
signum-repetitionis
staff-bar
staff-ellipsis
time-signature
@end example

From this list, we find that we want to move @code{key-cancellation} so
that it comes before @code{staff-bar}. This is accomplished with the
@code{\\breakAlignInsert} function.
"

  doctitle = "Separating key cancellations from key signature changes"
} % begin verbatim


music = { \key es \major d'1 \bar "||"
          \key a \major d'1 }

{ <>^\markup "default"
  \music }

{ <>^\markup "cancellation first"
  \breakAlignInsert key-cancellation before staff-bar
  \music }



% ****************************************************************
% end ly snippet
% ****************************************************************