]> git.donarmstrong.com Git - lilypond.git/commitdiff
Move sections in French and German docs
authorJohn Mandereau <john.mandereau@gmail.com>
Wed, 13 Aug 2008 14:25:02 +0000 (16:25 +0200)
committerJohn Mandereau <john.mandereau@gmail.com>
Wed, 13 Aug 2008 14:25:02 +0000 (16:25 +0200)
12 files changed:
Documentation/de/user/ancient.itely
Documentation/de/user/pitches.itely
Documentation/de/user/spacing.itely
Documentation/de/user/tweaks.itely
Documentation/de/user/working.itely
Documentation/fr/user/ancient.itely
Documentation/fr/user/changing-defaults.itely
Documentation/fr/user/editorial.itely
Documentation/fr/user/pitches.itely
Documentation/fr/user/spacing.itely
Documentation/fr/user/tweaks.itely
Documentation/fr/user/working.itely

index 6f1446db67dcdefaa687889f0121e60251b302b2..77cfa539570e6d3d0b0d7ce35d41dd96619b2a7d 100644 (file)
@@ -163,7 +163,7 @@ des @rinternals{KeySignature}-Objektes gesetzt wird.
 
 @seealso
 
-In diesem Handbuch: @ref{Pitches}, @ref{Cautionary accidentals} und
+In diesem Handbuch: @ref{Pitches}, @ref{Accidentals} und
 @ref{Automatic accidentals} geben eine allgemeine Einführung in die Benutzung
 von Versetzungszeichen. Der Abschnitt @ref{Key signature} zeigt die allgemeine
 Benutzung von Vorzeichen.
index 17ce46f1a314c06a83fc7af8686469abc576c1ee..f7404f332e7b0d1b801c71de886b4a27e47f3d51 100644 (file)
@@ -29,15 +29,14 @@ This section discusses how to specify the pitch of notes.
 Into text.
 
 @menu
-* Normal pitches::              
+* Absolute octave entry::       
+* Relative octave entry::       
 * Accidentals::                 
-* Cautionary accidentals::      
-* Micro tones::                 
 * Note names in other languages::  
 @end menu
 
-@node Normal pitches
-@unnumberedsubsubsec Normal pitches
+@node Absolute octave entry
+@unnumberedsubsubsec Absolute octave entry
 
 @cindex Tonhöhenbezeichnungen
 
@@ -82,7 +81,94 @@ Eine alternative Methode gibt am Anfang die Oktave vor,
 innerhalb derer die Noten gesetzt werden, dabei werden 
 unter Umständen weniger Oktavangaben (@code{'} oder @code{,})
 benötigt. Siehe auch 
-@ref{Relative octaves}.
+@ref{Relative octave entry}.
+
+
+@node Relative octave entry
+@unnumberedsubsubsec Relative octave entry
+
+@cindex Relativ
+@cindex Relative Oktavbestimmung
+@funindex \relative
+
+Oktaven werden angegeben, indem man @code{'} oder @code{,}
+an die Notenbezeichnung hängt. Wenn Sie schon existierende 
+Musik kopieren, passiert es schnell, eine Note aus Versehen 
+in die falsche Oktave zu setzen, und der Fehler ist schwer zu 
+finden. Der relative Oktaven-Modus verhindert solche Fehler,
+indem mögliche Fehler stark vergrößert werden: ein einziger 
+Oktavierungsfehler wirkt sich auf den gesamten Rest des Stückes aus.
+
+Die Syntax des Befehls lautet:
+
+@example
+\relative @var{Referenzoktave} @var{musikalischer Ausdruck}
+@end example
+
+@noindent
+oder:
+
+@example
+\relative @var{musikalischer Ausdruck}
+@end example
+
+@noindent
+Das eingestrichene C (@code{c'}) wird als Referenzoktave angenommen, 
+wenn sie nicht extra angegeben wird.
+
+Die Oktave von Noten, die im musikalischen Ausdruck notiert sind, 
+wird wie folgt erschlossen: Wenn keine Oktavversetzungszeichen 
+benutzt werden, wird als Intervall zwischen der Noten und der 
+vorhergehenden immer eine Quarte oder kleiner angenommen. Dieser 
+Abstand wird ohne Rücksicht auf Alterationen bestimmt. Eine 
+übermäßige Quarte ist also ein kleineres Intervall als eine 
+verminderte Quinte, auch wenn beide sechs Halbtöne groß sind.
+
+Die Oktavversetzungszeichen @code{'} und @code{,} können 
+hinzugefügt werden, um die Tonhöhe um eine Oktave zu erhöhen 
+oder zu erniedrigen. Wenn der relative Modus beginnt, kann 
+ein Referenzton angegeben werden, der als die vorhergehende Note 
+für die erste Tonhöhe des musikalischen Ausdrucks verwendet 
+wird. Wenn dieser Referenzton nicht angeben wird, wird das 
+eingestrichene C verwendet.
+
+So funktioniert der relative Modus:
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+\relative c'' {
+  b c d c b c bes a
+}
+@end lilypond
+
+Oktavversetzungen müssen für alle Intervalle angezeigt werden, 
+die größer als eine Quarte sind.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c'' {
+  c g c f, c' a, e''
+}
+@end lilypond
+
+Wenn der vorherige Ausdruck ein Akkord ist, wird die erste Note 
+des Akkordes benutzt, um die erste Note des nächsten Akkordes zu 
+bestimmen.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c' {
+  c <c e g>
+  <c' e g>
+  <c, e' g>
+}
+@end lilypond
+
+Die Tonhöhe nach @code{\relative} muss eine Notenbezeichnung enthalten.
+
+Die relative Veränderung wirkt sich nicht auf 
+Transposition (@code{\transpose}),
+Akkordnotation (@code{\chordmode}) oder @code{\relative}-Abschnitte 
+aus.  Um den relativen Modus innerhalb von transponierter Musik zu 
+verwenden, muss ein zusätzliches @code{\relative} innerhalb der 
+Klammern des @code{\transpose}-Befehls gesetzt werden.
 
 
 @node Accidentals
@@ -158,7 +244,34 @@ Programmreferenz: @rinternals{LedgerLineSpanner},
 @rinternals{NoteHead}.
 
 
-@node Cautionary accidentals
+@unnumberedsubsubsec Micro tones
+
+@cindex Vierteltöne
+@cindex Vorzeichen, Vierteltöne
+@cindex Versetzungszeichen, Vierteltöne
+@cindex Mikrotöne
+
+Versetzungszeichen für Vierteltöne werden durch Anhängen der Endungen 
+@code{-eh} (Erniedrigung) und @code{-ih} (Erhöhung) an den 
+Tonhöhenbuchstaben erstellt. Das Beispiel zeigt eine in Vierteltönen 
+aufsteigende Serie vom kleinen C.
+
+@lilypond[verbatim,ragged-right,quote,relative=2,fragment]
+\set Staff.extraNatural = ##f
+ceseh ceh cih cisih
+@end lilypond
+
+Mikrotöne werden auch in die MIDI-Dateien geschrieben.
+
+
+
+@knownissues
+
+Es gibt keine allgemein anerkannten Standards für die 
+Notation von Dreiviertelton-Erniedrigungszeichen. LilyPonds
+Symbol entspricht also keinem Standard.
+
+
 @unnumberedsubsubsec Cautionary accidentals
 
 @cindex Versetzungszeichen, Erinnerung
@@ -190,35 +303,6 @@ beeinflusst werden. Mehr Information dazu siehe
  @ref{Automatic accidentals}.
 
 
-@node Micro tones
-@unnumberedsubsubsec Micro tones
-
-@cindex Vierteltöne
-@cindex Vorzeichen, Vierteltöne
-@cindex Versetzungszeichen, Vierteltöne
-@cindex Mikrotöne
-
-Versetzungszeichen für Vierteltöne werden durch Anhängen der Endungen 
-@code{-eh} (Erniedrigung) und @code{-ih} (Erhöhung) an den 
-Tonhöhenbuchstaben erstellt. Das Beispiel zeigt eine in Vierteltönen 
-aufsteigende Serie vom kleinen C.
-
-@lilypond[verbatim,ragged-right,quote,relative=2,fragment]
-\set Staff.extraNatural = ##f
-ceseh ceh cih cisih
-@end lilypond
-
-Mikrotöne werden auch in die MIDI-Dateien geschrieben.
-
-
-
-@knownissues
-
-Es gibt keine allgemein anerkannten Standards für die 
-Notation von Dreiviertelton-Erniedrigungszeichen. LilyPonds
-Symbol entspricht also keinem Standard.
-
-
 @node Note names in other languages
 @unnumberedsubsubsec Note names in other languages
 
@@ -286,99 +370,12 @@ espanol.ly     do  re  mi  fa  sol la  sib si
 @subsection Changing multiple pitches
 
 @menu
-* Relative octaves::            
-* Octave check::                
+* Octave checks::               
 * Transpose::                   
 @end menu
 
-@node Relative octaves
-@unnumberedsubsubsec Relative octaves
-
-@cindex Relativ
-@cindex Relative Oktavbestimmung
-@funindex \relative
-
-Oktaven werden angegeben, indem man @code{'} oder @code{,}
-an die Notenbezeichnung hängt. Wenn Sie schon existierende 
-Musik kopieren, passiert es schnell, eine Note aus Versehen 
-in die falsche Oktave zu setzen, und der Fehler ist schwer zu 
-finden. Der relative Oktaven-Modus verhindert solche Fehler,
-indem mögliche Fehler stark vergrößert werden: ein einziger 
-Oktavierungsfehler wirkt sich auf den gesamten Rest des Stückes aus.
-
-Die Syntax des Befehls lautet:
-
-@example
-\relative @var{Referenzoktave} @var{musikalischer Ausdruck}
-@end example
-
-@noindent
-oder:
-
-@example
-\relative @var{musikalischer Ausdruck}
-@end example
-
-@noindent
-Das eingestrichene C (@code{c'}) wird als Referenzoktave angenommen, 
-wenn sie nicht extra angegeben wird.
-
-Die Oktave von Noten, die im musikalischen Ausdruck notiert sind, 
-wird wie folgt erschlossen: Wenn keine Oktavversetzungszeichen 
-benutzt werden, wird als Intervall zwischen der Noten und der 
-vorhergehenden immer eine Quarte oder kleiner angenommen. Dieser 
-Abstand wird ohne Rücksicht auf Alterationen bestimmt. Eine 
-übermäßige Quarte ist also ein kleineres Intervall als eine 
-verminderte Quinte, auch wenn beide sechs Halbtöne groß sind.
-
-Die Oktavversetzungszeichen @code{'} und @code{,} können 
-hinzugefügt werden, um die Tonhöhe um eine Oktave zu erhöhen 
-oder zu erniedrigen. Wenn der relative Modus beginnt, kann 
-ein Referenzton angegeben werden, der als die vorhergehende Note 
-für die erste Tonhöhe des musikalischen Ausdrucks verwendet 
-wird. Wenn dieser Referenzton nicht angeben wird, wird das 
-eingestrichene C verwendet.
-
-So funktioniert der relative Modus:
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-\relative c'' {
-  b c d c b c bes a
-}
-@end lilypond
-
-Oktavversetzungen müssen für alle Intervalle angezeigt werden, 
-die größer als eine Quarte sind.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c'' {
-  c g c f, c' a, e''
-}
-@end lilypond
-
-Wenn der vorherige Ausdruck ein Akkord ist, wird die erste Note 
-des Akkordes benutzt, um die erste Note des nächsten Akkordes zu 
-bestimmen.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c' {
-  c <c e g>
-  <c' e g>
-  <c, e' g>
-}
-@end lilypond
-
-Die Tonhöhe nach @code{\relative} muss eine Notenbezeichnung enthalten.
-
-Die relative Veränderung wirkt sich nicht auf 
-Transposition (@code{\transpose}),
-Akkordnotation (@code{\chordmode}) oder @code{\relative}-Abschnitte 
-aus.  Um den relativen Modus innerhalb von transponierter Musik zu 
-verwenden, muss ein zusätzliches @code{\relative} innerhalb der 
-Klammern des @code{\transpose}-Befehls gesetzt werden.
-
-@node Octave check
-@unnumberedsubsubsec Octave check
+@node Octave checks
+@unnumberedsubsubsec Octave checks
 
 @cindex Oktavenüberprüfung
 
@@ -739,30 +736,39 @@ Programmreferenz: @rinternals{KeyCancellation},
 @node Ottava brackets
 @unnumberedsubsubsec Ottava brackets
 
+@ifhtml
 UNTRANSLATED NODE: IGNORE ME
-
+@end ifhtml
 
 @node Instrument transpositions
 @unnumberedsubsubsec Instrument transpositions
 
+@ifhtml
 UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
 
 
 @node Automatic accidentals
 @unnumberedsubsubsec Automatic accidentals
 
+@ifhtml
 UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
 
 @node Ambitus
 @unnumberedsubsubsec Ambitus
 
+@ifhtml
 UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
 
 
 @node Note heads
 @subsection Note heads
 
+@ifhtml
 UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
 
 @menu
 * Special note heads::          
@@ -774,19 +780,27 @@ UNTRANSLATED NODE: IGNORE ME
 @node Special note heads
 @unnumberedsubsubsec Special note heads
 
+@ifhtml
 UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
 
 @node Easy notation note heads
 @unnumberedsubsubsec Easy notation note heads
 
+@ifhtml
 UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
 
 @node Shape note heads
 @unnumberedsubsubsec Shape note heads
 
+@ifhtml
 UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
 
 @node Improvisation
 @unnumberedsubsubsec Improvisation
 
+@ifhtml
 UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
index d5ffc2ac68bbf39a61491ef73afa69534a9dab8f..80d801229490cf3635ebb084d65aa461528e5776 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 6bcad9cdc487270910758b1ee39cf3c8aee1015e
+    Translation of GIT committish: 3121682025660b6c85fbf3f22bb9cd8396699ad1
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
@@ -293,10 +293,87 @@ UNTRANSLATED NODE: IGNORE ME
 @node Changing spacing
 @subsection Changing spacing
 
-@ifhtml
-UNTRANSLATED NODE: IGNORE ME
-@end ifhtml
-
-
+Manchmal bleiben nur noch ein oder zwei Systeme auf der 
+letzten Seite übrig. Das ist immer ärgerlich, besonders 
+wenn es scheint, dass auf den vorigen Seiten genug Platz 
+ist, um die Systeme noch unterzubringen.
+
+Wenn man versucht, das Layout zu verändern, kommt einem 
+der Befehl @code{annotate-spacing} zu Hilfe. Mit diesem 
+Befehl erhält man die Werte von verschiedenen Abstandsbefehlen 
+ausgedruckt, mehr Information im Kapitel @ref{Displaying spacing}.
+Anhand dieser Angaben kann dann entschieden werden, welche 
+Werte verändert werden müssen.
+
+Neben Rändern gibt es nämlich weitere Optionen, Platz zu sparen:
+
+@itemize
+@item
+LilyPond kann die Systeme so dicht wie möglich platzieren (damit 
+so viele Systeme wie möglich auf eine Seite passen), aber sie 
+dann so anordnen, dass kein weißer Rand unten auf der Seite entsteht.
+
+@example
+\paper @{
+  between-system-padding = #0.1
+  between-system-space = #0.1
+  ragged-last-bottom = ##f
+  ragged-bottom = ##f
+@}
+@end example
+
+@item
+Die Anzahl der Systeme kann reduziert werden (wenn LilyPond 
+die Musik auf 11 Systeme verteilt, kann man die Benutzung von 
+nur 10 Systemen erzwingen).
+
+@example
+\paper @{
+  system-count = #10
+@}
+@end example
+
+@item
+Vermeidung von Objekten, die den vertikalen Abstand von Systemen 
+vergrößern, hilft oft. Die Verwendung von Klammern bei Wiederholungen 
+etwa braucht mehr Platz. Wenn die Noten innerhalb der Klammern  auf 
+zwei Systeme verteilt sind, brauchen sie mehr Platz, als wenn sie 
+nur auf einer Zeile gedruckt werden.
+
+Ein anderes Beispiel ist es, Dynamik-Zeichen, die besonders 
+weit @qq{hervorstehen}, zu verschieben.
+
+@lilypond[verbatim,quote,fragment]
+\relative c' {
+  e4 c g\f c
+  \override DynamicLineSpanner #'padding = #-1.8
+  \override DynamicText #'extra-offset = #'( -2.1 . 0)
+  e4 c g\f c
+}
+@end lilypond
+
+@item
+Die horizontalen Abstände können mit der 
+ @code{SpacingSpanner}-Eigenschaft verändert werden.  Siehe
+@ref{Changing horizontal spacing} für Einzelheiten.
+
+@lilypond[verbatim,quote]
+\score {
+  \relative c'' {
+    g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
+    g4 e e2 | f4 d d2 | c4 e g g | c,1 |
+    d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
+    g4 e e2 | f4 d d2 | c4 e g g | c,1 |
+  }
+  \layout {
+    \context {
+      \Score
+      \override SpacingSpanner
+                #'base-shortest-duration = #(ly:make-moment 1 4)
+    }
+  }
+}
+@end lilypond
+
+@end itemize
 
-@c -- SKELETON FILE --
index 2eb716d3c9a289f8d04d2e6cb753fa80552384c1..01604d3c583f1f17cae3c337df5cd7d0aa2b675e 100644 (file)
@@ -18,18 +18,172 @@ Notenfragment kann geändert werden.
 
 
 @menu
-* Moving objects::              
-* Fixing overlapping notation::  
+* Tweaking basics::             
+* The Internals Reference manual::  
+* Appearance of objects::       
+* Placement of objects::        
+* Collisions of objects::       
 * Common tweaks::               
-* Default files::               
-* Fitting music onto fewer pages::  
-* Advanced tweaks with Scheme::  
-* Avoiding tweaks with slower processing::  
+* Further tweaking::            
 @end menu
 
 
+@node Tweaking basics
+@section Tweaking basics
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@menu
+* Introduction to tweaks::      
+* Objects and interfaces::      
+* Naming conventions of objects and properties::  
+* Tweaking methods::            
+@end menu
+
+@node Introduction to tweaks
+@subsection Introduction to tweaks
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Objects and interfaces
+@subsection Objects and interfaces
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Naming conventions of objects and properties
+@subsection Naming conventions of objects and properties
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Tweaking methods
+@subsection Tweaking methods
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node The Internals Reference manual
+@section The Internals Reference manual
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@menu
+* Properties of layout objects::  
+* Properties found in interfaces::  
+* Types of properties::         
+@end menu
+
+@node Properties of layout objects
+@subsection Properties of layout objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Properties found in interfaces
+@subsection Properties found in interfaces
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Types of properties
+@subsection Types of properties
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Appearance of objects
+@section Appearance of objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@menu
+* Visibility and color of objects::  
+* Size of objects::             
+* Length and thickness of objects::  
+@end menu
+
+@node Visibility and color of objects
+@subsection Visibility and color of objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Size of objects
+@subsection Size of objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Length and thickness of objects
+@subsection Length and thickness of objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Placement of objects
+@section Placement of objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@menu
+* Automatic behavior::          
+* Within-staff objects::        
+* Outside staff objects::       
+@end menu
+
+@node Automatic behavior
+@subsection Automatic behavior
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Within-staff objects
+@subsection Within-staff objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Outside staff objects
+@subsection Outside staff objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+
+@node Collisions of objects
+@section Collisions of objects
+
+@menu
+* Moving objects::              
+* Fixing overlapping notation::  
+* Real music example::          
+@end menu
+
 @node Moving objects
-@section Moving objects
+@subsection Moving objects
 
 Es wird vielleicht eine Überraschung sein, aber LilyPond ist nicht 
 perfekt. Einige Notationselemente können sich überschneiden. Das 
@@ -171,7 +325,7 @@ c4^"piu mosso" d e f
 
 
 @node Fixing overlapping notation
-@section Fixing overlapping notation
+@subsection Fixing overlapping notation
 
 Im Kapitel @ref{Moving objects} wurde gezeigt, wie man Texte 
 (@code{TextScript}-Objekte) verschiebt. Mit der gleichen 
@@ -214,8 +368,18 @@ aber die gebräuchlichsten finden sich hier:
 @end multitable
 
 
+@node Real music example
+@subsection Real music example
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+
+@c DEPRECATED SECTION
 @node Common tweaks
 @section Common tweaks
+
 Bestimmte Korrekturen sind so häufig, dass für sie schon fertige 
 angepasste Befehle bereitgestellt sind, so etwa 
  @code{\slurUp} um einen Bindebogen oberhalb anzuzeigen oder 
@@ -352,8 +516,33 @@ verhalten sich anders, etwa die Dicke von Balken ist an die
 Notenzeilenabstände gekoppelt. Mehr Information findet sich 
 im relevanten Teil der Programmreferenz.
 
-@node Default files
-@section Default files
+@node Further tweaking
+@section Further tweaking
+
+@menu
+* Other uses for tweaks::       
+* Using variables for tweaks::  
+* Other sources of information::  
+* Avoiding tweaks with slower processing::  
+* Advanced tweaks with Scheme::  
+@end menu
+
+@node Other uses for tweaks
+@subsection Other uses for tweaks
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Using variables for tweaks
+@subsection Using variables for tweaks
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Other sources of information
+@subsection Other sources of information
 
 Die Programmreferenz enthält sehr viel Information über LilyPond, aber 
 noch mehr Information findet sich in den internen 
@@ -386,96 +575,23 @@ Dateien wie @file{ly/property-init.ly} und
 @file{ly/declarations-init.ly} definieren alle häufig vorkommenden Veränderungen.
 
 
-@node Fitting music onto fewer pages
-@section Fitting music onto fewer pages
-
-Manchmal bleiben nur noch ein oder zwei Systeme auf der 
-letzten Seite übrig. Das ist immer ärgerlich, besonders 
-wenn es scheint, dass auf den vorigen Seiten genug Platz 
-ist, um die Systeme noch unterzubringen.
-
-Wenn man versucht, das Layout zu verändern, kommt einem 
-der Befehl @code{annotate-spacing} zu Hilfe. Mit diesem 
-Befehl erhält man die Werte von verschiedenen Abstandsbefehlen 
-ausgedruckt, mehr Information im Kapitel @ruser{Displaying spacing}. 
-Anhand dieser Angaben kann dann entschieden werden, welche 
-Werte verändert werden müssen.
-
-Neben Rändern gibt es nämlich weitere Optionen, Platz zu sparen:
-
-@itemize
-@item
-LilyPond kann die Systeme so dicht wie möglich platzieren (damit 
-so viele Systeme wie möglich auf eine Seite passen), aber sie 
-dann so anordnen, dass kein weißer Rand unten auf der Seite entsteht.
-
-@example
-\paper @{
-  between-system-padding = #0.1
-  between-system-space = #0.1
-  ragged-last-bottom = ##f
-  ragged-bottom = ##f
-@}
-@end example
+@node Avoiding tweaks with slower processing
+@subsection Avoiding tweaks with slower processing
 
-@item
-Die Anzahl der Systeme kann reduziert werden (wenn LilyPond 
-die Musik auf 11 Systeme verteilt, kann man die Benutzung vo
-nur 10 Systemen erzwingen).
+LilyPond kann einige zusätzliche Tests durchführen, während 
+die Noten gesetzt werden. Dadurch braucht das Programm länger, 
+um den Notensatz zu produzieren, aber üblicherweise werde
+weniger nachträgliche Anpassungen nötig sein.
 
 @example
-\paper @{
-  system-count = #10
-@}
+%%  Um sicher zu gehen, dass Texte und Liedtext 
+%%  innerhalb der Papierränder bleiben
+\override Score.PaperColumn #'keep-inside-line = ##t 
 @end example
 
-@item
-Vermeidung von Objekten, die den vertikalen Abstand von Systemen 
-vergrößern, hilft oft. Die Verwendung von Klammern bei Wiederholungen 
-etwa braucht mehr Platz. Wenn die Noten innerhalb der Klammern  auf 
-zwei Systeme verteilt sind, brauchen sie mehr Platz, als wenn sie 
-nur auf einer Zeile gedruckt werden.
-
-Ein anderes Beispiel ist es, Dynamik-Zeichen, die besonders 
-weit @qq{hervorstehen}, zu verschieben.
-
-@lilypond[verbatim,quote,fragment]
-\relative c' {
-  e4 c g\f c
-  \override DynamicLineSpanner #'padding = #-1.8
-  \override DynamicText #'extra-offset = #'( -2.1 . 0)
-  e4 c g\f c
-}
-@end lilypond
-
-@item
-Die horizontalen Abstände können mit der 
- @code{SpacingSpanner}-Eigenschaft verändert werden.  Siehe
-@ruser{Changing horizontal spacing} für Einzelheiten.
-
-@lilypond[verbatim,quote]
-\score {
-  \relative c'' {
-    g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
-    g4 e e2 | f4 d d2 | c4 e g g | c,1 |
-    d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
-    g4 e e2 | f4 d d2 | c4 e g g | c,1 |
-  }
-  \layout {
-    \context {
-      \Score
-      \override SpacingSpanner
-                #'base-shortest-duration = #(ly:make-moment 1 4)
-    }
-  }
-}
-@end lilypond
-
-@end itemize
-
 
 @node Advanced tweaks with Scheme
-@section Advanced tweaks with Scheme
+@subsection Advanced tweaks with Scheme
 
 Es wurde schon gezeigt, wie die LilyPond-Ausgabe sehr stark verändert 
 werden kann, indem man Befehle wie 
@@ -535,20 +651,3 @@ pattern = #(define-music-function (parser location x y) (ly:music? ly:music?)
 }
 @end lilypond
 
-
-@node Avoiding tweaks with slower processing
-@section Avoiding tweaks with slower processing
-
-LilyPond kann einige zusätzliche Tests durchführen, während 
-die Noten gesetzt werden. Dadurch braucht das Programm länger, 
-um den Notensatz zu produzieren, aber üblicherweise werden 
-weniger nachträgliche Anpassungen nötig sein.
-
-@example
-%%  Um sicher zu gehen, dass Texte und Liedtext 
-%%  innerhalb der Papierränder bleiben
-\override Score.PaperColumn #'keep-inside-line = ##t 
-@end example
-
-
-
index 402500ad7f834030b2b09ad17d1c94477390e6e3..4d4c8de092244d6b307f01eefffeeba4906bbc0f 100644 (file)
@@ -83,7 +83,7 @@ vor einem Jahr verwendet hat. Auch @code{convert-ly} benötigt die
 Versionsnummer.
 
 @item @strong{Benutzen Sie Überprüfungen}: @ruser{Bar check}, 
-@ruser{Octave check} und
+@ruser{Octave checks} und
 @ruser{Barnumber check}.  Wenn Sie hier und da diese Überprüfungen 
 einfügen, finden Sie einen möglichen Fehler weit schneller. Wie oft 
 aber 
index 76dec30fc73453d0c771a307ddaa982dfba2169e..6a1c73f25575097a2bbcf810cde38ce12b9a4338 100644 (file)
@@ -236,7 +236,7 @@ par la propriété @code{glyph-name-alist} de l'objet
 
 @seealso
 
-Dans ce manuel : @ref{Pitches}, @ref{Cautionary accidentals}, et
+Dans ce manuel : @ref{Pitches}, @ref{Accidentals}, et
 @ref{Automatic accidentals}, pour les principes généraux d'utilisation
 des altérations ; @ref{Key signature} pour les armures.
 
index 79364ec95831ed4ad6c8967805cf541df2f8c27e..5606cb51d4d2b9d4a84b17b177b8f848f1caf5ea 100644 (file)
@@ -80,368 +80,12 @@ des listes, des chaînes de caractères ou des symboles, en Scheme.}
 @section Automatic notation
 
 Cette section s'intéresse au réglage de l'impression automatique des
-altérations accidentelles et ligatures.
+ligatures.
 
 @menu
-* Automatic accidentals::       
 * Setting automatic beam behavior::  
 @end menu
 
-@node Automatic accidentals
-@subsection Automatic accidentals
-@cindex Altérations accidentelles automatiques
-
-Une fonction a été créée pour regrouper les règles suivant lesquelles
-s'impriment les altérations.  Elle s'invoque de la manière suivante :
-
-@funindex set-accidental-style
-@example
-#(set-accidental-style 'REGLE)
-@end example
-
-@c TODO: check the context stuff below
-@c -does it *really* work?
-@c -the default contexts as specified in
-@c  scm/music-function.scm seem to be different -vv
-
-Cette fonction prend pour argument le nom de la règle d'altérations,
-auquel peut s'ajouter, comme argument facultatif, le contexte
-devant être affecté :
-
-@example
-#(set-accidental-style 'REGLE #('CONTEXTE#))
-@end example
-
-Si aucun contexte n'est spécifié, le contexte @code{Staff} sera affecté ; 
-cependant on peut souhaiter l'appliquer au contexte @code{Voice} en lieu 
-et place.
-
-Les régles d'altérations suivantes sont possibles :
-
-@table @code
-@item default
-C'est la règle d'impression par défaut, qui se rapporte à l'usage 
-en vigueur au XVIIIème siècle : les altérations accidentelles sont valables toute
-une mesure, et uniquement à leur propre octave.
-
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              %#(set-accidental-style 'default) 
-       \musicA }
-       \context Staff = "down"{
-              %#(set-accidental-style 'default)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'default" }}}
-}
-@end lilypond
-
-@item voice
-En principe, LilyPond se souvient de toutes les altérations présentes sur la
-portée (contexte Staff).  Avec cette règle, cependant, les altérations sont indépendantes
-pour chacune des voix. 
-
-
-@example
- \new Staff <<
-        #(set-accidental-style 'voice)
-       @{ @dots{} @}
-       >>
-@end example
-
-De ce fait, les altérations d'une voix sont ignorées dans les autres voix,
-ce qui peut donner lieu à un résultat malencontreux.  Dans l'exemple suivant,
-il est difficile de dire si le deuxième @samp{la} est dièse ou naturel.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'voice) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'voice)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'voice" }}}
-}
-@end lilypond
-
-La règle @code{voice} n'est à envisager que dans le cas de voix devant être lues par
-des musiciens différents.  S'il s'agit d'un @q{conducteur}, ou d'une portée destinée
-à un seul musicien, il vaut mieux utiliser @code{modern} ou @code{modern-cautionary}.
-
-
-@item modern
-@funindex modern style accidentals
-Cette règle est la plus courante au XXème siècle.  Les altérations accidentelles
-sont imprimées comme avec le style @code{default}, mais lorsqu'une note non-altérée
-apparaît à une octave différente, ou bien dans la mesure suivante, des bécarres de précaution
-sont ajoutés.  Dans l'exemple suivant, notez ainsi les deux bécarres dans la
-deuxième mesure de la main droite.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'modern) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'modern)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'modern" }}}
-}
-@end lilypond
-
-@item @code{modern-cautionary}
-@funindex modern-cautionary
-Cette règle est équivalente à @code{modern}, mais les bécarres de précaution sont
-imprimés de façon particulière : soit plus petits, soit (par défaut) entre parenthèses.
-Il est possible de le définir au moyen de la propriété @code{cautionary-style}
-pour l'objet @rinternals{AccidentalSuggestion}.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'modern-cautionary) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'modern-cautionary)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-cautionary" }}}
-}
-@end lilypond
-
-@funindex modern-voice
-@item modern-voice
-Cette règle sert aux altérations dans de la musique polyphonique destinée
-autant à des musiciens différents qu'à quelqu'un qui lirait l'ensemble des voix.
-Les altérations sont imprimées voix par voix, mais les autres voix, dans le même 
-contexte @rinternals{Staff}, en @emph{tiennent compte} cette fois.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'modern-voice) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'modern-voice)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-voice" }}}
-}
-@end lilypond
-
-@funindex modern-voice-cautionary
-@item modern-voice-cautionary
-Cette régle est similaire à la précédente, mais les altérations de précautions
-(celles que n'aurait pas ajoutées @code{voice}), sont imprimées de façon
-particulière.  On retrouve donc toutes les altérations qu'imprimerait
-@code{default}, mais certaines sont considérées comme étant @qq{de précaution}.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'modern-voice-cautionary) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'modern-voice-cautionary)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-voice-cautionary" }}}
-}
-@end lilypond
-
-@item piano
-@funindex piano accidentals
-Cette règle est adaptée aux contextes GrandStaff -- ce qui n'empêche pas de devoir la spécifier 
-pour chaque portée individuelle au sein du contexte GrandStaff.
-
-@example
-\new GrandStaff @{ <<
-  \new Staff = "up" @{ <<
-    #(set-accidental-style 'piano)
-    @{ @dots{} @}
-  >> @}
-  \new Staff = "down"@{ <<
-    #(set-accidental-style 'piano)
-  @{ @dots{} @}
-  >> @}
->> @}
-@end example
-
-Cette règle est communément employée pour les partitions de piano au XXème siècle.
-Très similaire à @code{modern} de par son comportement, elle s'en distingue en ce que
-les altérations tiennent compte des autre portées du contexte @rinternals{GrandStaff} ou
-@rinternals{PianoStaff}.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'piano) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'piano)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'piano" }}}
-}
-@end lilypond
-
-@item piano-cautionary
-@funindex #(set-accidental-style 'piano-cautionary)
-Identique à @code{#(set-accidental-style 'piano)}, mais les altérations de précaution
-sont imprimées différemment.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'piano-cautionary) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'piano-cautionary)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'piano-cautionary" }}}
-}
-@end lilypond
-
-@item no-reset
-@funindex no-reset accidental style
-C'est la même règle que @code{default}, mais l'effet des altérations accidentelles
-ne cesse jamais, même dans les mesures suivantes.
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'no-reset) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'no-reset)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'no-reset" }}}
-}
-@end lilypond
-
-@item forget
-Tout le contraire de @code{no-reset}: l'effet des altérations cesse aussitôt,
-et de ce fait, toutes les altérations, quelque soit leur place dans la mesure, sont
-imprimées, en fonction de l'éventuelle armure.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'forget) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'forget)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'forget" }}}
-}
-@end lilypond
-@end table
-
-
-@seealso
-
-Référence du programme : @rinternals{Accidental_engraver},
-@rinternals{Accidental}, @rinternals{AccidentalSuggestion} et @rinternals{AccidentalPlacement}.
-
-
-@knownissues
-
-Les notes simultanées sont considérées comme des évènements séquentiels.
-Ce qui implique que, dans un accord, les altérations accidentelles seront 
-imprimées comme si les notes de l'accords apparaissaient une par une, en fonction
-de l'ordre dans lequels elles ont été saisies -- ce qui peut poser problème lorsqu'au
-sein d'un accord certaines altérations dépendent les unes des autres.
-Ce problème est à résoudre manuellement, en insérant des @code{!} et des @code{?} après les notes
-concernées.
-
-
 @node Setting automatic beam behavior
 @subsection Setting automatic beam behavior
 
@@ -1554,7 +1198,7 @@ propriétés internes).
 Pour aller encore plus loin, plutôt que de simplement parler de l'objet
 @code{Fingering}, ce qui ne nous avance pas à grand chose, on peut aller explorer
 son âme même, dans les fichiers source de LilyPond (voir
-@rlearning{Default files}), en l'occurence le fichier
+@rlearning{Other sources of information}), en l'occurence le fichier
 @file{scm/@/define@/-grobs@/.scm} :
 
 @example
index e502b8ba62683879b7f1b56fc4c5e784f985eaa4..4236c4547d7dbc271422ff04d0c0ec757cbc9743 100644 (file)
@@ -31,7 +31,6 @@
 * Hidden notes::                
 * Coloring objects::            
 * Parentheses::                 
-* Ambitus::                     
 * Stems::                       
 @end menu
 
@@ -291,100 +290,6 @@ comprendre qu'une seule note.
 @end example
 
 
-@node Ambitus
-@unnumberedsubsubsec Ambitus
-@cindex ambitus
-
-L'@emph{ambitus} est l'amplitude des hauteurs d'une voix donnée dans une
-partition.  Ce terme peut aussi désigner la tessiture qu'un instrument
-est capable d'atteindre.  Souvent, cet ambitus est imprimé au début des
-partitions vocales, afin que les exécutants puissent voir au premier
-coup d'oeil s'ils sont en mesure de tenir la partie en question.
-
-Pour exprimer l'ambitus d'une pièce, on indique avant la clé deux notes
-représentant la hauteur la plus basse et la plus haute.  Pour imprimer
-cet ambitus, il faut ajouter le graveur @rinternals{Ambitus_engraver}
-au contexte @rinternals{Voice}.  Ainsi,
-
-@example
-\layout @{
-  \context @{
-    \Voice
-    \consists Ambitus_engraver
-  @}
-@}
-@end example
-
-@noindent
-donne pour résultat
-
-@lilypond[quote,ragged-right]
-\layout {
-  \context {
-    \Staff
-    \consists Ambitus_engraver
-  }
-}
-
-\relative \new Staff {
-  as'' c e2 cis,2
-}
-@end lilypond
-
-Si plusieurs voix se trouvent sur une même portée, on peut attribuer le
-graveur @rinternals{Ambitus_engraver} au contexte @rinternals{Staff}
-plutôt qu'au contexte @rinternals{Voice} ; l'ambitus affiché sera
-alors celui de toutes les voix cumulées, non d'une seule des voix
-actives.
-
-@lilypond[verbatim,ragged-right,quote]
-\new Staff \with {
-  \consists "Ambitus_engraver"
-}
-<<
-  \new Voice \with {
-    \remove "Ambitus_engraver"
-  } \relative c'' {
-    \override Ambitus #'X-offset = #-1.0
-    \voiceOne
-    c4 a d e f2
-  }
-  \new Voice \with {
-    \remove "Ambitus_engraver"
-  } \relative c' {
-    \voiceTwo
-    es4 f g as b2
-  }
->>
-@end lilypond
-
-@noindent
-Cet exemple met en œuvre une fonctionnalité avancée :
-
-@example
-\override Ambitus #'X-offset = #-1.0
-@end example
-
-@noindent
-Ce réglage déplace l'ambitus vers la gauche.  Le même résultat aurait pu
-être obtenu avec @code{extra-offset}, mais alors le système de mise en
-forme n'aurait pas attribué d'espace supplémentaire pour l'objet
-déplacé.
-
-@seealso
-
-Référence du programme : @rinternals{Ambitus},
-@rinternals{AmbitusLine}, @rinternals{AmbitusNoteHead},
-@rinternals{AmbitusAccidental}.
-
-Exemples : @rlsr{Pitches}, @rlsr{Vocal music}.
-
-@knownissues
-
-LilyPond ne gère pas les collisions entre plusieurs ambitus présents sur
-une même portée.
-
-
 @node Stems
 @unnumberedsubsubsec Stems
 
index da5dc12ebb1d72860cd6fe1d66071c17f7c8af8d..fdf73a4530bf6743458fab2f7402d7bbec76ab3b 100644 (file)
@@ -24,28 +24,33 @@ et les options de gravure.
 * Writing pitches::             
 * Changing multiple pitches::   
 * Displaying pitches::          
-* Note heads::
+* Note heads::                  
 @end menu
 
 
 @node Writing pitches
 @subsection Writing pitches
 
-Cette section
+Cette section explique la manière d'indiquer les hauteurs de note.  Il
+y a deux modes d'indiquer l'octave des notes : le mode absolu, et le
+mode relatif.  Le dernier est le plus pratique lors de la saisie d'un
+fichier source au clavier de l'ordinateur.
 
 @menu
-* Normal pitches::              
+* Absolute octave entry::       
+* Relative octave entry::       
 * Accidentals::                 
-* Cautionary accidentals::      
-* Micro tones::                 
 * Note names in other languages::  
 @end menu
 
-@node Normal pitches
-@unnumberedsubsubsec Normal pitches
+@node Absolute octave entry
+@unnumberedsubsubsec Absolute octave entry
 
 @cindex noms de note
 @cindex hauteurs
+@cindex absolues, hauteurs
+@cindex absolues, octaves
+@cindex octaves absolues
 
 La hauteur s'écrit --- à moins de préciser une autre langue --- avec la
 notation anglaise, en utilisant les lettres @code{a} à @code{g}.
@@ -81,7 +86,91 @@ c, c,, e, g d,, d, d c
 
 Il existe une autre méthode pour préciser à quelle octave se situe la
 note à graver ; cette méthode demande moins d'indications d'octave
-(@code{'} ou @code{,}) --- voir @ref{Relative octaves}.
+(@code{'} ou @code{,}) --- voir @ref{Relative octave entry}.
+
+
+@node Relative octave entry
+@unnumberedsubsubsec Relative octave entry
+
+@cindex relatif
+@cindex indication d'octave relative
+@funindex \relative
+
+On spécifie les octaves en ajoutant @code{'} et @code{,} aux noms de
+hauteurs.  En recopiant de la musique, on a vite fait de mettre une note
+à la mauvaise octave, et ce genre d'erreur est difficile à retrouver.
+Le mode d'écriture \relative prévient ces erreurs dans la mesure où
+elles deviennent beaucoup plus évidentes : une seule erreur décale le
+reste de la pièce à une mauvaise octave.
+
+
+@example
+\relative @var{startpitch} @var{musicexpr}
+@end example
+
+@noindent
+ou
+
+@example
+\relative @var{musicexpr}
+@end example
+
+@noindent
+@code{c'} est utilisé par défaut si aucune hauteur de départ n'est
+définie.
+
+L'octave des notes mentionnées dans @var{musicexpr} va être calculée de
+la manière suivante : si aucun signe de changement d'octave n'est
+utilisé, l'intervalle de base entre la note actuelle et la précédente
+sera toujours au plus d'une quarte.  Cet intervalle est déterminé sans
+tenir compte des altérations ; ainsi un @code{fisis} après un
+@code{ceses} sera placé au-dessus du @code{ceses}.  En d'autres termes,
+une quarte doublement augmentée demeure considérée comme un intervavlle
+plus petit qu'une quinte diminuée, bien que la quarte doublement
+augmentée soit de sept demi-tons et la quinte diminuée de seulement six
+demi-tons.
+
+Les signes de changement d'octave @code{'} et @code{,} peuvent être
+ajoutés pour hausser ou baisser la note d'une octave supplémentaire.
+Lorsque l'on entre en mode @code{\relative}, une hauteur absolue de
+départ peut être spécifiée, et agira dès lors comme si elle précédait la
+première note de @var{musicexpr}.  Si aucune hauteur de départ n'est
+spécifiée, le do central sert de point de départ.
+
+Voici le mode \relative en action.
+@lilypond[quote,fragment,ragged-right,verbatim]
+\relative c'' {
+  b c d c b c bes a
+}
+@end lilypond
+
+On utilise les signes de changement d'octave pour les intervalles
+dépassant la quarte.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c'' {
+  c g c f, c' a, e''
+}
+@end lilypond
+
+Si l'expression précédente est un accord, c'est la première note de
+l'accord qui détermine l'emplacement de la première note du prochain
+accord.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c' {
+  c <c e g>
+  <c' e g>
+  <c, e' g>
+}
+@end lilypond
+
+La hauteur après @code{\relative} contient un nom de note.
+
+La conversion en mode \relative n'affectera pas les sections @code{\transpose},
+@code{\chordmode} ou @code{\relative} situées dans son argument.  Pour
+utiliser \relative dans de la musique transposée, un code
+@code{\relative} additionnel doit être placé dans @code{\transpose}.
 
 
 @node Accidentals
@@ -141,7 +230,29 @@ Référence du programme : @rinternals{LedgerLineSpanner},
 @rinternals{NoteHead}.
 
 
-@node Cautionary accidentals
+@unnumberedsubsubsec Micro tones
+
+@cindex quarts de ton
+@cindex demi-bémols, demi-dièses
+
+Les demi-bémols et demi-dièses s'écrivent en ajoutant respectivement
+@code{-eh} et @code{-ih}. Voici une série de dos altérés en hauteurs
+croissantes :
+
+@lilypond[verbatim,ragged-right,quote,relative=2,fragment]
+\set Staff.extraNatural = ##f
+ceseh ceh cih cisih
+@end lilypond
+
+Les micro-intervalles sont aussi exportés dans le fichier MIDI.
+
+@knownissues
+
+Il n'y a pas de standard universellement accepté pour noter le bémol et
+demi (qui abaisse la hauteur trois quarts de ton), le symbole de
+LilyPond n'est donc conforme à aucun standard.
+
+
 @unnumberedsubsubsec Cautionary accidentals
 
 @cindex altération, de précaution
@@ -170,30 +281,6 @@ L'impression automatique des altérations peut être affinée de plusieurs
 manières.  Pour plus d'information, voir @ref{Automatic accidentals}.
 
 
-@node Micro tones
-@unnumberedsubsubsec Micro tones
-
-@cindex quarts de ton
-@cindex demi-bémols, demi-dièses
-
-Les demi-bémols et demi-dièses s'écrivent en ajoutant respectivement
-@code{-eh} et @code{-ih}. Voici une série de dos altérés en hauteurs
-croissantes :
-
-@lilypond[verbatim,ragged-right,quote,relative=2,fragment]
-\set Staff.extraNatural = ##f
-ceseh ceh cih cisih
-@end lilypond
-
-Les micro-intervalles sont aussi exportés dans le fichier MIDI.
-
-@knownissues
-
-Il n'y a pas de standard universellement accepté pour noter le bémol et
-demi (qui abaisse la hauteur trois quarts de ton), le symbole de
-LilyPond n'est donc conforme à aucun standard.
-
-
 @node Note names in other languages
 @unnumberedsubsubsec Note names in other languages
 
@@ -261,97 +348,12 @@ espanol.ly     do  re  mi  fa  sol la  sib si
 @subsection Changing multiple pitches
 
 @menu
-* Relative octaves::            
-* Octave check::                
+* Octave checks::                
 * Transpose::                   
 @end menu
 
-@node Relative octaves
-@unnumberedsubsubsec Relative octaves
-
-@cindex relatif
-@cindex indication d'octave relative
-@funindex \relative
-
-On spécifie les octaves en ajoutant @code{'} et @code{,} aux noms de
-hauteurs.  En recopiant de la musique, on a vite fait de mettre une note
-à la mauvaise octave, et ce genre d'erreur est difficile à retrouver.
-Le mode d'écriture \relative prévient ces erreurs dans la mesure où
-elles deviennent beaucoup plus évidentes : une seule erreur décale le
-reste de la pièce à une mauvaise octave.
-
-
-@example
-\relative @var{startpitch} @var{musicexpr}
-@end example
-
-@noindent
-ou
-
-@example
-\relative @var{musicexpr}
-@end example
-
-@noindent
-@code{c'} est utilisé par défaut si aucune hauteur de départ n'est
-définie.
-
-L'octave des notes mentionnées dans @var{musicexpr} va être calculée de
-la manière suivante : si aucun signe de changement d'octave n'est
-utilisé, l'intervalle de base entre la note actuelle et la précédente
-sera toujours au plus d'une quarte.  Cet intervalle est déterminé sans
-tenir compte des altérations ; ainsi un @code{fisis} après un
-@code{ceses} sera placé au-dessus du @code{ceses}.  En d'autres termes,
-une quarte doublement augmentée demeure considérée comme un intervavlle
-plus petit qu'une quinte diminuée, bien que la quarte doublement
-augmentée soit de sept demi-tons et la quinte diminuée de seulement six
-demi-tons.
-
-Les signes de changement d'octave @code{'} et @code{,} peuvent être
-ajoutés pour hausser ou baisser la note d'une octave supplémentaire.
-Lorsque l'on entre en mode @code{\relative}, une hauteur absolue de
-départ peut être spécifiée, et agira dès lors comme si elle précédait la
-première note de @var{musicexpr}.  Si aucune hauteur de départ n'est
-spécifiée, le do central sert de point de départ.
-
-Voici le mode \relative en action.
-@lilypond[quote,fragment,ragged-right,verbatim]
-\relative c'' {
-  b c d c b c bes a
-}
-@end lilypond
-
-On utilise les signes de changement d'octave pour les intervalles
-dépassant la quarte.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c'' {
-  c g c f, c' a, e''
-}
-@end lilypond
-
-Si l'expression précédente est un accord, c'est la première note de
-l'accord qui détermine l'emplacement de la première note du prochain
-accord.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c' {
-  c <c e g>
-  <c' e g>
-  <c, e' g>
-}
-@end lilypond
-
-La hauteur après @code{\relative} contient un nom de note.
-
-La conversion en mode \relative n'affectera pas les sections @code{\transpose},
-@code{\chordmode} ou @code{\relative} situées dans son argument.  Pour
-utiliser \relative dans de la musique transposée, un code
-@code{\relative} additionnel doit être placé dans @code{\transpose}.
-
-
-@node Octave check
-@unnumberedsubsubsec Octave check
+@node Octave checks
+@unnumberedsubsubsec Octave checks
 
 @cindex vérification d'octave
 
@@ -503,6 +505,8 @@ musique apparaissant dans un @code{\transpose}.
 * Key signature::               
 * Ottava brackets::             
 * Instrument transpositions::   
+* Automatic accidentals::       
+* Ambitus::                     
 @end menu
 
 @node Clef
@@ -769,6 +773,455 @@ c'4^"en sol"
 ...
 @end example
 
+@node Automatic accidentals
+@unnumberedsubsubsec Automatic accidentals
+@cindex Altérations accidentelles automatiques
+
+Une fonction a été créée pour regrouper les règles suivant lesquelles
+s'impriment les altérations.  Elle s'invoque de la manière suivante :
+
+@funindex set-accidental-style
+@example
+#(set-accidental-style 'REGLE)
+@end example
+
+@c TODO: check the context stuff below
+@c -does it *really* work?
+@c -the default contexts as specified in
+@c  scm/music-function.scm seem to be different -vv
+
+Cette fonction prend pour argument le nom de la règle d'altérations,
+auquel peut s'ajouter, comme argument facultatif, le contexte
+devant être affecté :
+
+@example
+#(set-accidental-style 'REGLE #('CONTEXTE#))
+@end example
+
+Si aucun contexte n'est spécifié, le contexte @code{Staff} sera affecté ; 
+cependant on peut souhaiter l'appliquer au contexte @code{Voice} en lieu 
+et place.
+
+Les régles d'altérations suivantes sont possibles :
+
+@table @code
+@item default
+C'est la règle d'impression par défaut, qui se rapporte à l'usage 
+en vigueur au XVIIIème siècle : les altérations accidentelles sont valables toute
+une mesure, et uniquement à leur propre octave.
+
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+       \change Staff = up cis' \change Staff = down <fis, a>  
+       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+       <f a d>2 |  } }}
+
+\score { 
+       \new PianoStaff {
+       << \context Staff = "up" {
+              %#(set-accidental-style 'default) 
+       \musicA }
+       \context Staff = "down"{
+              %#(set-accidental-style 'default)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'default" }}}
+}
+@end lilypond
+
+@item voice
+En principe, LilyPond se souvient de toutes les altérations présentes sur la
+portée (contexte Staff).  Avec cette règle, cependant, les altérations sont indépendantes
+pour chacune des voix. 
+
+
+@example
+ \new Staff <<
+        #(set-accidental-style 'voice)
+       @{ @dots{} @}
+       >>
+@end example
+
+De ce fait, les altérations d'une voix sont ignorées dans les autres voix,
+ce qui peut donner lieu à un résultat malencontreux.  Dans l'exemple suivant,
+il est difficile de dire si le deuxième @samp{la} est dièse ou naturel.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+       \change Staff = up cis' \change Staff = down <fis, a>  
+       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+       <f a d>2 |  } }}
+
+\score { 
+       \new PianoStaff {
+       << \context Staff = "up" {
+              #(set-accidental-style 'voice) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'voice)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'voice" }}}
+}
+@end lilypond
+
+La règle @code{voice} n'est à envisager que dans le cas de voix devant être lues par
+des musiciens différents.  S'il s'agit d'un @q{conducteur}, ou d'une portée destinée
+à un seul musicien, il vaut mieux utiliser @code{modern} ou @code{modern-cautionary}.
+
+
+@item modern
+@funindex modern style accidentals
+Cette règle est la plus courante au XXème siècle.  Les altérations accidentelles
+sont imprimées comme avec le style @code{default}, mais lorsqu'une note non-altérée
+apparaît à une octave différente, ou bien dans la mesure suivante, des bécarres de précaution
+sont ajoutés.  Dans l'exemple suivant, notez ainsi les deux bécarres dans la
+deuxième mesure de la main droite.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+       \change Staff = up cis' \change Staff = down <fis, a>  
+       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+       <f a d>2 |  } }}
+
+\score { 
+       \new PianoStaff {
+       << \context Staff = "up" {
+              #(set-accidental-style 'modern) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'modern)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'modern" }}}
+}
+@end lilypond
+
+@item @code{modern-cautionary}
+@funindex modern-cautionary
+Cette règle est équivalente à @code{modern}, mais les bécarres de précaution sont
+imprimés de façon particulière : soit plus petits, soit (par défaut) entre parenthèses.
+Il est possible de le définir au moyen de la propriété @code{cautionary-style}
+pour l'objet @rinternals{AccidentalSuggestion}.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+       \change Staff = up cis' \change Staff = down <fis, a>  
+       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+       <f a d>2 |  } }}
+
+\score { 
+       \new PianoStaff {
+       << \context Staff = "up" {
+              #(set-accidental-style 'modern-cautionary) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'modern-cautionary)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-cautionary" }}}
+}
+@end lilypond
+
+@funindex modern-voice
+@item modern-voice
+Cette règle sert aux altérations dans de la musique polyphonique destinée
+autant à des musiciens différents qu'à quelqu'un qui lirait l'ensemble des voix.
+Les altérations sont imprimées voix par voix, mais les autres voix, dans le même 
+contexte @rinternals{Staff}, en @emph{tiennent compte} cette fois.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+       \change Staff = up cis' \change Staff = down <fis, a>  
+       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+       <f a d>2 |  } }}
+
+\score { 
+       \new PianoStaff {
+       << \context Staff = "up" {
+              #(set-accidental-style 'modern-voice) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'modern-voice)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-voice" }}}
+}
+@end lilypond
+
+@funindex modern-voice-cautionary
+@item modern-voice-cautionary
+Cette régle est similaire à la précédente, mais les altérations de précautions
+(celles que n'aurait pas ajoutées @code{voice}), sont imprimées de façon
+particulière.  On retrouve donc toutes les altérations qu'imprimerait
+@code{default}, mais certaines sont considérées comme étant @qq{de précaution}.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+       \change Staff = up cis' \change Staff = down <fis, a>  
+       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+       <f a d>2 |  } }}
+
+\score { 
+       \new PianoStaff {
+       << \context Staff = "up" {
+              #(set-accidental-style 'modern-voice-cautionary) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'modern-voice-cautionary)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-voice-cautionary" }}}
+}
+@end lilypond
+
+@item piano
+@funindex piano accidentals
+Cette règle est adaptée aux contextes GrandStaff -- ce qui n'empêche pas de devoir la spécifier 
+pour chaque portée individuelle au sein du contexte GrandStaff.
+
+@example
+\new GrandStaff @{ <<
+  \new Staff = "up" @{ <<
+    #(set-accidental-style 'piano)
+    @{ @dots{} @}
+  >> @}
+  \new Staff = "down"@{ <<
+    #(set-accidental-style 'piano)
+  @{ @dots{} @}
+  >> @}
+>> @}
+@end example
+
+Cette règle est communément employée pour les partitions de piano au XXème siècle.
+Très similaire à @code{modern} de par son comportement, elle s'en distingue en ce que
+les altérations tiennent compte des autre portées du contexte @rinternals{GrandStaff} ou
+@rinternals{PianoStaff}.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+       \change Staff = up cis' \change Staff = down <fis, a>  
+       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+       <f a d>2 |  } }}
+
+\score { 
+       \new PianoStaff {
+       << \context Staff = "up" {
+              #(set-accidental-style 'piano) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'piano)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'piano" }}}
+}
+@end lilypond
+
+@item piano-cautionary
+@funindex #(set-accidental-style 'piano-cautionary)
+Identique à @code{#(set-accidental-style 'piano)}, mais les altérations de précaution
+sont imprimées différemment.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+       \change Staff = up cis' \change Staff = down <fis, a>  
+       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+       <f a d>2 |  } }}
+
+\score { 
+       \new PianoStaff {
+       << \context Staff = "up" {
+              #(set-accidental-style 'piano-cautionary) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'piano-cautionary)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'piano-cautionary" }}}
+}
+@end lilypond
+
+@item no-reset
+@funindex no-reset accidental style
+C'est la même règle que @code{default}, mais l'effet des altérations accidentelles
+ne cesse jamais, même dans les mesures suivantes.
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+       \change Staff = up cis' \change Staff = down <fis, a>  
+       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+       <f a d>2 |  } }}
+
+\score { 
+       \new PianoStaff {
+       << \context Staff = "up" {
+              #(set-accidental-style 'no-reset) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'no-reset)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'no-reset" }}}
+}
+@end lilypond
+
+@item forget
+Tout le contraire de @code{no-reset}: l'effet des altérations cesse aussitôt,
+et de ce fait, toutes les altérations, quelque soit leur place dans la mesure, sont
+imprimées, en fonction de l'éventuelle armure.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+       \change Staff = up cis' \change Staff = down <fis, a>  
+       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+       <f a d>2 |  } }}
+
+\score { 
+       \new PianoStaff {
+       << \context Staff = "up" {
+              #(set-accidental-style 'forget) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'forget)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'forget" }}}
+}
+@end lilypond
+@end table
+
+
+@seealso
+
+Référence du programme : @rinternals{Accidental_engraver},
+@rinternals{Accidental}, @rinternals{AccidentalSuggestion} et @rinternals{AccidentalPlacement}.
+
+
+@knownissues
+
+Les notes simultanées sont considérées comme des évènements séquentiels.
+Ce qui implique que, dans un accord, les altérations accidentelles seront 
+imprimées comme si les notes de l'accords apparaissaient une par une, en fonction
+de l'ordre dans lequels elles ont été saisies -- ce qui peut poser problème lorsqu'au
+sein d'un accord certaines altérations dépendent les unes des autres.
+Ce problème est à résoudre manuellement, en insérant des @code{!} et des @code{?} après les notes
+concernées.
+
+
+@node Ambitus
+@unnumberedsubsubsec Ambitus
+@cindex ambitus
+
+L'@emph{ambitus} est l'amplitude des hauteurs d'une voix donnée dans une
+partition.  Ce terme peut aussi désigner la tessiture qu'un instrument
+est capable d'atteindre.  Souvent, cet ambitus est imprimé au début des
+partitions vocales, afin que les exécutants puissent voir au premier
+coup d'oeil s'ils sont en mesure de tenir la partie en question.
+
+Pour exprimer l'ambitus d'une pièce, on indique avant la clé deux notes
+représentant la hauteur la plus basse et la plus haute.  Pour imprimer
+cet ambitus, il faut ajouter le graveur @rinternals{Ambitus_engraver}
+au contexte @rinternals{Voice}.  Ainsi,
+
+@example
+\layout @{
+  \context @{
+    \Voice
+    \consists Ambitus_engraver
+  @}
+@}
+@end example
+
+@noindent
+donne pour résultat
+
+@lilypond[quote,ragged-right]
+\layout {
+  \context {
+    \Staff
+    \consists Ambitus_engraver
+  }
+}
+
+\relative \new Staff {
+  as'' c e2 cis,2
+}
+@end lilypond
+
+Si plusieurs voix se trouvent sur une même portée, on peut attribuer le
+graveur @rinternals{Ambitus_engraver} au contexte @rinternals{Staff}
+plutôt qu'au contexte @rinternals{Voice} ; l'ambitus affiché sera
+alors celui de toutes les voix cumulées, non d'une seule des voix
+actives.
+
+@lilypond[verbatim,ragged-right,quote]
+\new Staff \with {
+  \consists "Ambitus_engraver"
+}
+<<
+  \new Voice \with {
+    \remove "Ambitus_engraver"
+  } \relative c'' {
+    \override Ambitus #'X-offset = #-1.0
+    \voiceOne
+    c4 a d e f2
+  }
+  \new Voice \with {
+    \remove "Ambitus_engraver"
+  } \relative c' {
+    \voiceTwo
+    es4 f g as b2
+  }
+>>
+@end lilypond
+
+@noindent
+Cet exemple met en œuvre une fonctionnalité avancée :
+
+@example
+\override Ambitus #'X-offset = #-1.0
+@end example
+
+@noindent
+Ce réglage déplace l'ambitus vers la gauche.  Le même résultat aurait pu
+être obtenu avec @code{extra-offset}, mais alors le système de mise en
+forme n'aurait pas attribué d'espace supplémentaire pour l'objet
+déplacé.
+
+@seealso
+
+Référence du programme : @rinternals{Ambitus},
+@rinternals{AmbitusLine}, @rinternals{AmbitusNoteHead},
+@rinternals{AmbitusAccidental}.
+
+Exemples : @rlsr{Pitches}, @rlsr{Vocal music}.
+
+@knownissues
+
+LilyPond ne gère pas les collisions entre plusieurs ambitus présents sur
+une même portée.
+
+
 @node Note heads
 @subsection Note heads
 
index 406512147f83d4f413f62a320b6106b5efd6b0a1..ef876267474a19122bbe3f502fee68cb2e7b76ce 100644 (file)
@@ -1,20 +1,17 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 6bcad9cdc487270910758b1ee39cf3c8aee1015e
+    Translation of GIT committish: 964d024dd4f022ba7cd66adc13c0169035d4c4e5
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
+@c \version "2.11.51"
 
 @node Spacing issues
 @chapter Spacing issues
 
-@ifhtml
-UNTRANSLATED NODE: IGNORE ME
-@end ifhtml
-
 
 @menu
 * Paper and pages::
@@ -272,11 +269,6 @@ UNTRANSLATED NODE: IGNORE ME
 @node Fitting music onto fewer pages
 @section Fitting music onto fewer pages
 
-@ifhtml
-UNTRANSLATED NODE: IGNORE ME
-@end ifhtml
-
-
 @menu
 * Displaying spacing::
 * Changing spacing::
@@ -293,10 +285,90 @@ UNTRANSLATED NODE: IGNORE ME
 @node Changing spacing
 @subsection Changing spacing
 
-@ifhtml
-UNTRANSLATED NODE: IGNORE ME
-@end ifhtml
-
-
+Parfois, une partition peut se terminer avec seulement 
+un ou deux systèmes sur la dernière page. Ceci peut être ennuyeux
+surtout si vous constatez, en regardant les pages précédentes, qu'il
+reste encore beaucoup de place sur celles-ci.
+
+Si vous vous intéressez aux problèmes de mise en page,
+@code{annotate-spacing} peut alors être un outil d'une valeur
+inestimable.  Cette commande imprime les valeurs 
+de nombreuses commandes d'espacement concernant la mise en page.  
+Consultez @ref{Displaying spacing} pour de plus amples informations.  À l'aide 
+des informations données par @code{annotate-spacing}, on peut 
+voir quelles marges il est souhaitable de modifier afin de résoudre le
+problème.
+
+
+En plus d'agir sur les marges, il existe d'autres possibilités
+qui permettent de gagner de la place.
+
+@itemize
+@item
+Demander à LilyPond de placer les systèmes aussi 
+près que possible les uns des autres (pour en disposer autant
+que possible sur une page), tout en répartissant les systèmes afin
+de ne pas laisser de blanc en bas de la dernière page.
+
+@example
+\paper @{
+  between-system-padding = #0.1
+  between-system-space = #0.1
+  ragged-last-bottom = ##f
+  ragged-bottom = ##f
+@}
+@end example
+
+@item
+Obliger LilyPond à mettre un certain nombre de systèmes
+par page.  Par exemple, si LilyPond veut placer onze systèmes dans une page,
+vous pouvez l'obliger à n'en mettre que dix.
+
+@example
+\paper @{
+  system-count = #10
+@}
+@end example
+
+@item
+Supprimer (ou réduire) les objets qui augmentent la hauteur du
+système.  C'est le cas en particulier de certaines reprises (avec des 
+alternatives) qui placent des crochets au dessus des portées. Si ces crochets 
+de reprise se poursuivent sur deux systèmes, ils prendront plus de
+place que s'ils sont regroupés sur un même système.
+
+Un autre exemple : déplacer les nuances qui @qq{débordent} d'un système.
+
+@lilypond[verbatim,quote,fragment]
+\relative c' {
+  e4 c g\f c
+  \override DynamicLineSpanner #'padding = #-1.8
+  \override DynamicText #'extra-offset = #'( -2.1 . 0)
+  e4 c g\f c
+}
+@end lilypond
+
+@item
+Modifier l'espacement vertical avec @code{SpacingSpanner}.  Reportez-vous à
+@ref{Changing horizontal spacing} pour plus de détails.
+
+@lilypond[verbatim,quote]
+\score {
+  \relative c'' {
+    g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
+    g4 e e2 | f4 d d2 | c4 e g g | c,1 |
+    d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
+    g4 e e2 | f4 d d2 | c4 e g g | c,1 |
+  }
+  \layout {
+    \context {
+      \Score
+      \override SpacingSpanner
+                #'base-shortest-duration = #(ly:make-moment 1 4)
+    }
+  }
+}
+@end lilypond
+
+@end itemize
 
-@c -- SKELETON FILE --
index 4bd2d67920904d133664f43ed2a5ef1c017ccbc9..8cae3c4720556cf09358d0cb08cb1fc328127897 100644 (file)
@@ -20,18 +20,172 @@ LilyPond offre de nombreuses possibilités de réglages, permettant de modifier
 quasiment chaque élément de votre partition.
 
 @menu
-* Moving objects::              
-* Fixing overlapping notation::  
+* Tweaking basics::             
+* The Internals Reference manual::  
+* Appearance of objects::       
+* Placement of objects::        
+* Collisions of objects::       
 * Common tweaks::               
-* Default files::               
-* Fitting music onto fewer pages::  
-* Advanced tweaks with Scheme::  
-* Avoiding tweaks with slower processing::  
+* Further tweaking::            
+@end menu
+
+@node Tweaking basics
+@section Tweaking basics
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@menu
+* Introduction to tweaks::      
+* Objects and interfaces::      
+* Naming conventions of objects and properties::  
+* Tweaking methods::            
+@end menu
+
+@node Introduction to tweaks
+@subsection Introduction to tweaks
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Objects and interfaces
+@subsection Objects and interfaces
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Naming conventions of objects and properties
+@subsection Naming conventions of objects and properties
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Tweaking methods
+@subsection Tweaking methods
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node The Internals Reference manual
+@section The Internals Reference manual
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@menu
+* Properties of layout objects::  
+* Properties found in interfaces::  
+* Types of properties::         
 @end menu
 
+@node Properties of layout objects
+@subsection Properties of layout objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Properties found in interfaces
+@subsection Properties found in interfaces
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Types of properties
+@subsection Types of properties
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Appearance of objects
+@section Appearance of objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@menu
+* Visibility and color of objects::  
+* Size of objects::             
+* Length and thickness of objects::  
+@end menu
+
+@node Visibility and color of objects
+@subsection Visibility and color of objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Size of objects
+@subsection Size of objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Length and thickness of objects
+@subsection Length and thickness of objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Placement of objects
+@section Placement of objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@menu
+* Automatic behavior::          
+* Within-staff objects::        
+* Outside staff objects::       
+@end menu
+
+@node Automatic behavior
+@subsection Automatic behavior
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Within-staff objects
+@subsection Within-staff objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Outside staff objects
+@subsection Outside staff objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+
+@node Collisions of objects
+@section Collisions of objects
+
+
+@menu
+* Moving objects::              
+* Fixing overlapping notation::  
+* Real music example::          
+@end menu
 
 @node Moving objects
-@section Moving objects
+@subsection Moving objects
 
 Aussi surprenant que cela puisse paraître, LilyPond n'est pas parfait.
 Certains éléments sur la partition peuvent se chevaucher, ce qui est 
@@ -177,7 +331,7 @@ Dans ce même manuel : @ruser{The \override command}, @ref{Common tweaks}.
 
 
 @node Fixing overlapping notation
-@section Fixing overlapping notation
+@subsection Fixing overlapping notation
 
 Dans la section @ref{Moving objects}, nous avons vu comment
 déplacer un objet @code{TextScript}.  Ce même procédé peut être
@@ -220,6 +374,15 @@ les plus communs :
 @end multitable
 
 
+@node Real music example
+@subsection Real music example
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+
+@c DEPRECATED SECTION
 @node Common tweaks
 @section Common tweaks
 
@@ -355,8 +518,33 @@ l'unité staff-space.  Pour de plus amples informations,
 consultez les sections correspondantes de la Référence du programme.
 
 
-@node Default files
-@section Default files
+@node Further tweaking
+@section Further tweaking
+
+@menu
+* Other uses for tweaks::       
+* Using variables for tweaks::  
+* Other sources of information::  
+* Avoiding tweaks with slower processing::  
+* Advanced tweaks with Scheme::  
+@end menu
+
+@node Other uses for tweaks
+@subsection Other uses for tweaks
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Using variables for tweaks
+@subsection Using variables for tweaks
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Other sources of information
+@subsection Other sources of information
 
 La Référence du programme contient
 beaucoup d'informations sur LilyPond. Cependant vous pouvez en découvrir 
@@ -392,99 +580,22 @@ intéressants.  En effet les fichiers du type
 @file{ly/property-init.ly} ou encore @file{ly/declarations-init.ly}
 déterminent toutes les définitions avancées communes.
 
-@node Fitting music onto fewer pages
-@section Fitting music onto fewer pages
-
-Parfois, une partition peut se terminer avec seulement 
-un ou deux systèmes sur la dernière page. Ceci peut être ennuyeux
-surtout si vous constatez, en regardant les pages précédentes, qu'il
-reste encore beaucoup de place sur celles-ci.
-
-Si vous vous intéressez aux problèmes de mise en page,
-@code{annotate-spacing} peut alors être un outil d'une valeur
-inestimable.  Cette commande imprime les valeurs 
-de nombreuses commandes d'espacement concernant la mise en page.  
-Consultez @ruser{Displaying spacing} pour de plus amples informations.  À l'aide 
-des informations données par @code{annotate-spacing}, on peut 
-voir quelles marges il est souhaitable de modifier afin de résoudre le
-problème.
-
-
-En plus d'agir sur les marges, il existe d'autres possibilités
-qui permettent de gagner de la place.
-
-@itemize
-@item
-Demander à LilyPond de placer les systèmes aussi 
-près que possible les uns des autres (pour en disposer autant
-que possible sur une page), tout en répartissant les systèmes afin
-de ne pas laisser de blanc en bas de la dernière page.
-
-@example
-\paper @{
-  between-system-padding = #0.1
-  between-system-space = #0.1
-  ragged-last-bottom = ##f
-  ragged-bottom = ##f
-@}
-@end example
+@node Avoiding tweaks with slower processing
+@subsection Avoiding tweaks with slower processing
 
-@item
-Obliger LilyPond à mettre un certain nombre de systèmes
-par page.  Par exemple, si LilyPond veut placer onze systèmes dans une page,
-vous pouvez l'obliger à n'en mettre que dix.
+LilyPond peut effectuer des vérifications supplémentaires lors du 
+traitement des fichiers, cependant le rendu nécessitera alors plus de
+temps.  En contrepartie, il y aura moins d'ajustements manuels à réaliser.
 
+  
 @example
-\paper @{
-  system-count = #10
-@}
+%%  Ceci sert à s'assurer que les indications textuelles resteront à l'intérieur des marges de la page.
+\override Score.PaperColumn #'keep-inside-line = ##t 
 @end example
 
-@item
-Supprimer (ou réduire) les objets qui augmentent la hauteur du
-système.  C'est le cas en particulier de certaines reprises (avec des 
-alternatives) qui placent des crochets au dessus des portées. Si ces crochets 
-de reprise se poursuivent sur deux systèmes, ils prendront plus de
-place que s'ils sont regroupés sur un même système.
-
-Un autre exemple : déplacer les nuances qui @qq{débordent} d'un système.
-
-@lilypond[verbatim,quote,fragment]
-\relative c' {
-  e4 c g\f c
-  \override DynamicLineSpanner #'padding = #-1.8
-  \override DynamicText #'extra-offset = #'( -2.1 . 0)
-  e4 c g\f c
-}
-@end lilypond
-
-@item
-Modifier l'espacement vertical avec @code{SpacingSpanner}.  Reportez-vous à
-@ruser{Changing horizontal spacing} pour plus de détails.
-
-@lilypond[verbatim,quote]
-\score {
-  \relative c'' {
-    g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
-    g4 e e2 | f4 d d2 | c4 e g g | c,1 |
-    d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
-    g4 e e2 | f4 d d2 | c4 e g g | c,1 |
-  }
-  \layout {
-    \context {
-      \Score
-      \override SpacingSpanner
-                #'base-shortest-duration = #(ly:make-moment 1 4)
-    }
-  }
-}
-@end lilypond
-
-@end itemize
-
 
 @node Advanced tweaks with Scheme
-@section Advanced tweaks with Scheme
+@subsection Advanced tweaks with Scheme
 
 Nous avons déjà vu comment le résultat obtenu avec LilyPond peut être
 largement personnalisé à l'aide de commandes comme 
@@ -541,16 +652,3 @@ pattern = #(define-music-function (parser location x y) (ly:music? ly:music?)
 }
 @end lilypond
 
-
-@node Avoiding tweaks with slower processing
-@section Avoiding tweaks with slower processing
-
-LilyPond peut effectuer des vérifications supplémentaires lors du 
-traitement des fichiers, cependant le rendu nécessitera alors plus de
-temps.  En contrepartie, il y aura moins d'ajustements manuels à réaliser.
-
-  
-@example
-%%  Ceci sert à s'assurer que les indications textuelles resteront à l'intérieur des marges de la page.
-\override Score.PaperColumn #'keep-inside-line = ##t 
-@end example
index bd8b7d46375b8cab6aeec7de47b34112bb97dd58..7196704fa82ede7bca80478dd32da029c0f5b6e9 100644 (file)
@@ -81,7 +81,7 @@ années auparavant.  L'utilitaire @command{convert-ly} demande que vous
 spécifiiez la version de LilyPond vous utilisiez alors.
 
 @item @strong{Ajoutez des contrôles}: @ruser{Bar check}, @ruser{Octave
-check} et @ruser{Barnumber check}.  Si vous avez ajouté des contrôles de
+checks} et @ruser{Barnumber check}.  Si vous avez ajouté des contrôles de
 loin en loin, et que vous faites une erreur, vous pourrez la retrouver
 plus rapidement.  @qq{De loin en loin}, qu'est-ce à dire ?  Cela
 dépend de la complexité de la musique.  Pour de la musique très