version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Ancient notation
@section Ancient notation
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Bagpipes
@section Bagpipes
@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: d9b4bfc69674eb4ed7b8c6eaa0b646f00eae6c8d
+ Translation of GIT committish: 02cb8b672238eeb53bffa2240c87f23dd8ca9e60
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@menu
* Interpretation contexts::
* The \override command::
+* Discussion of specific tweaks::
@end menu
@node Interpretation contexts
@section Interpretation contexts
UNTRANSLATED NODE: IGNORE ME
+@node Discussion of specific tweaks
+@section Discussion of specific tweaks
+
+UNTRANSLATED NODE: IGNORE ME
+
+@menu
+* Line styles::
+* Controlling visibility of objects::
+@end menu
+@node Line styles
+@subsection Line styles
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Controlling visibility of objects
+@subsection Controlling visibility of objects
+
+UNTRANSLATED NODE: IGNORE ME
+
-- SKELETON FILE --
When you actually translate this file, please remove these lines as
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c TODO: add tablature.
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Chords Blah
@section Chords Blah
@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond-program.tely
@ignore
- Translation of GIT committish: d9b4bfc69674eb4ed7b8c6eaa0b646f00eae6c8d
+ Translation of GIT committish: 02cb8b672238eeb53bffa2240c87f23dd8ca9e60
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@quotation
Wir wollen dieses Programm allen Freunden widmen, die wir
durch die Musik kennengelernt haben.
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Editorial annotations
@section Editorial annotations
@menu
-* Note heads::
* Inside the staff::
* Outside the staff::
@end menu
-@node Note heads
-@subsection Note heads
-
-@menu
-* Easy notation note heads::
-* Shape note heads::
-* Improvisation::
-* Special noteheads::
-@end menu
-
-@node Easy Notation note heads
-@unnumberedsubsubsec Easy Notation note heads
-
-UNTRANSLATED NODE: IGNORE ME
-
-
-@node Shape note heads
-@unnumberedsubsubsec Shape note heads
-
-UNTRANSLATED NODE: IGNORE ME
-
-
-@node Improvisation
-@unnumberedsubsubsec Improvisation
-
-UNTRANSLATED NODE: IGNORE ME
-
-
-@node Special noteheads
-@unnumberedsubsubsec Special noteheads
-
-UNTRANSLATED NODE: IGNORE ME
-
-
@node Inside the staff
@subsection Inside the staff
* Hidden notes::
* Coloring objects::
* Parentheses::
-* Ambitus::
* Stems::
@end menu
UNTRANSLATED NODE: IGNORE ME
-@node Ambitus
-@unnumberedsubsubsec Ambitus
-
-UNTRANSLATED NODE: IGNORE ME
-
-
@node Stems
@unnumberedsubsubsec Stems
@menu
* Balloon help::
* Grid lines::
-* Blank music sheet::
+* Analysis brackets::
@end menu
@node Balloon help
-@subsection Balloon help
+@unnumberedsubsubsec Balloon help
UNTRANSLATED NODE: IGNORE ME
@node Grid lines
-@subsection Grid lines
+@unnumberedsubsubsec Grid lines
UNTRANSLATED NODE: IGNORE ME
-@node Blank music sheet
-@subsection Blank music sheet
+@node Analysis brackets
+@unnumberedsubsubsec Analysis brackets
UNTRANSLATED NODE: IGNORE ME
-
-
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Expressive marks
@section Expressive marks
* Glissando::
* Arpeggio::
* Trills::
-* Analysis brackets::
@end menu
@node Glissando
Programmreferenz: @internalsref{TrillSpanner}.
-@node Analysis brackets
-@unnumberedsubsubsec Analysis brackets
-
-UNTRANSLATED NODE: IGNORE ME
-
-
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Fundamental concepts
@chapter Fundamental concepts
-UNTRANSLATED NODE: IGNORE ME
+Dieses Kapitel behandelt das allgemeine Konzept von LilyPond
+und wie man @code{\score}-Blöcke erstellt.
@menu
* How LilyPond files work::
* Voices contain music::
* Contexts and engravers::
* Extending the templates::
-@end menu
+@end menu
+
@node How LilyPond files work
@section How LilyPond files work
-UNTRANSLATED NODE: IGNORE ME
-
-@menu
+Das LilyPond Eingabeformat hat eine ziemlich freie Form, so dass
+für erfahrene Benutzer viel Freiheit besteht, die Struktur ihrer
+Quelldateien anzulegen. Für Neulinge kann diese Flexibilität aber
+erst einmal verwirrend sein. In diesem Kapitel soll darum ein Teil
+dieser Strukturen dargestellt werden, vieles aber zur Vereinfachung
+auch weggelassen werden. Für eine komplette Beschreibung des Eingabeformats
+siehe @ruser{File structure}.
+
+Die meisten Beispiele in diesem Handbuch sind kleine Schnipsel, wie
+etwa dieser:
+
+@example
+c4 a b c
+@end example
+
+Wie hoffentlich bekannt ist, lässt sich solch ein Schnipsel nicht
+in dieser Form übersetzen. Diese Beispiele sind also nur Kurzformen
+von wirklichen Beispielen. Sie müssen wenigstens zusätzlich in
+geschweifte Klammern gesetzt werden.
+
+@example
+@{
+ c4 a b c
+@}
+@end example
+
+Die meisten Beispiele benutzen auch den @code{\relative c'}-Befehl.
+Der ist nicht nötig, um die Dateien zu übersetzen, aber in den meisten
+Fällen sieht der Notensatz seltsam aus, wenn man den Befehl
+weglässt.
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+\relative c'' {
+ c4 a b c
+}
+@end lilypond
+
+Jetzt kommt noch eine Ebene dazu: LilyPond-Code in der obigen Form
+ist in Wirklichkeit auch wieder eine Abkürzung. Auch wenn man so
+Dateien schreiben kann und sie auch korrekt gesetzt werden, heißt
+der wirkliche Code, der hier gemeint ist, eigentlich:
+
+@example
+\score @{
+ \relative c'' @{
+ c4 a b c
+ @}
+@}
+@end example
+
+Eine Partitur (@code{\score}) muss immer mit einem musikalischen Ausdruck
+beginnen. Das ist letztendlich alle Musik, angefangen bei einer
+einzelnen
+Note bis hin zu einer riesigen Partitur mit vielen Notensystemen
+(bezeichnet durch @code{GrandStaff}):
+
+@example
+@{
+ \new GrandStaff <<
+ hier die gesamte Partitur
+ >>
+@}
+@end example
+
+@noindent
+Da sich alles innerhalb der geschweiften Klammern @code{@{ ... @}}
+befindet, wird es wie ein einziger musikalischer Ausdruck behandelt.
+
+
+Ein @code{\score} auch andere Dinge enthalten, wie etwa
+
+@example
+\score @{
+ @{ c'4 a b c' @}
+ \layout @{ @}
+ \midi @{ @}
+ \header @{ @}
+@}
+@end example
+
+@noindent
+Viele setzen einige dieser Befehle außerhalb des
+@code{\score}-Blocks, zum Beispiel wird der @code{\header}
+sehr oft oberhalb der @code{\score}-Umgebung gesetzt. Das
+funktioniert genauso gut.
+
+@cindex Variablen
+@cindex Bezeichner
+
+Eine gute Möglichkeit zur Vereinfachung sind selbst definierte Variablen.
+Alle Vorlagen verwenden diese Möglichkeit.
+
+@example
+melodie = \relative c' @{
+ c4 a b c
+@}
+
+\score @{
+ @{ \melodie @}
+@}
+@end example
+
+Wenn LilyPond diese Datei analysiert, nimmt es den Inhalt
+von @code{melodie} (alles, was nach dem Gleichheitszeichen
+kommt) und fügt ihn immer dann ein, wenn ein @code{\melodie}
+vorkommt. Die Namen sind frei wählbar, die Variable kann genauso
+gut @code{melodie}, @code{GLOBAL},
+@code{rechteHandklavier}, oder @code{foofoobarbaz} heißen. Für mehr
+Information siehe
+@ruser{Saving typing with identifiers and functions}.
+
+Eine komplette Definition des Eingabeformats findet sich
+im Kapitel @ruser{File structure}.
+
+@menu
* Introduction to the LilyPond file structure::
* Score is a (single) compound musical expression::
* Nesting music expressions::
* On the un-nestedness of brackets and ties::
-@end menu
+@end menu
+
@node Introduction to the LilyPond file structure
@subsection Introduction to the LilyPond file structure
@node Score is a (single) compound musical expression
@subsection Score is a (single) compound musical expression
-UNTRANSLATED NODE: IGNORE ME
+Im vorigen Kapitel, @ruser{How LilyPond files work},
+wurde die allgemeine Struktur einer LilyPond-Quelldatei
+beschrieben. Aber anscheinend haben wir die wichtigste
+Frage ausgelassen, nämlich wie man herausfindet, was nach
+dem @code{\score} geschrieben werden soll.
+
+In Wirklichkeit ist das aber gar kein Geheimnis. Diese
+Zeile ist die Antwort:
+
+
+@quotation
+@emph{Eine Partitur fängt immer mit @code{\score} an, gefolgt
+von einem einzelnen musikalischen Ausdruck.}
+@end quotation
+
+@noindent
+Vielleicht wollen Sie noch einmal
+@ruser{Music expressions explained} überfliegen. In diesem
+Kapitel wurde gezeigt, wie sich große musikalische Ausdrücke
+aus kleinen Teilen zusammensetzen. Noten können zu Akkorden
+verbunden werden usw. Jetzt gehen wir aber in die andere Richtung
+und betrachten, wie sich ein großer musikalischer Ausdruck
+zerlegen lässt.
+
+@example
+\score @{
+ @{ % diese Klammer startet den großen mus. Ausdruck
+ \new GrandStaff <<
+ hier eine ganze Wagner-Oper einfügen
+ >>
+ @} % diese Klammer beendet den Ausdruck
+ \layout @{ @}
+@}
+@end example
+
+Eine Wagner-Oper ist mindestens doppelt so lang wie dieses Handbuch,
+beschränken wir uns also auf einen Sänger und Klavier. Wir brauchen
+keine Orchesterpartitur (@code{GrandStaff}) dafür, darum lassen wir
+den Befehl weg. Wir brauchen aber einen Sänger und ein Klavier.
+
+@example
+\score @{
+ @{
+ <<
+ \new Staff = "Sänger" <<
+ >>
+ \new PianoStaff = Klavier <<
+ >>
+ >>
+ @}
+ \layout @{ @}
+@}
+@end example
+
+Zur Erinnerung: mit @code{<<} und @code{>>} werden Noten gleichzeitig
+gesetzt; wir wollen ja auch Klavier- und Sängerstimme gleichzeitig
+haben.
+
+@example
+\score @{
+ @{
+ <<
+ \new Staff = "Sänger" <<
+ \new Voice = "vocal" @{ @}
+ >>
+ \new Lyrics \lyricsto vocal \new Lyrics @{ @}
+ \new PianoStaff = "piano" <<
+ \new Staff = "upper" @{ @}
+ \new Staff = "lower" @{ @}
+ >>
+ >>
+ @}
+ \layout @{ @}
+@}
+@end example
+
+Jetzt haben wir viel mehr Details. Wir haben ein System (engl. staff)
+für einen Sänger, in dem sich wieder eine Stimme (engl. voice)
+befindet. @code{Voice} bedeutet für LilyPond eine Stimme (sowohl
+gesungen als auch gespielt) und evtl. zusätzlich einen Text. Zusätzlich
+werden zwei Notensysteme für das Klavier mit dem Befehl @code{\new
+PianoStaff} gesetzt. @code{PianoStaff} bezeichnet die Piano-Umgebung (etwa
+durchgehende Taktstriche und die geschweifte Klammer am Anfang), in der
+dann wiederum zwei eigene Systeme ("upper" für die rechte Hand und
+"lower"
+für die linke) erstellt werden.
+
+Jetzt könnte man in diese Umgebung Noten einfügen. Innerhalb der
+geschweiften
+Klammern neben @code{\new Voice = vocal} könnte man
+
+
+@example
+\relative c'' @{
+ a4 b c d
+@}
+@end example
+
+@noindent schreiben. Aber wenn man seine Datei so direkt schreibt, wird
+der @code{\score}-Abschnitt sehr lang und es wird ziemlich schwer zu
+verstehen, wie alles zusammenhängt. Darum bietet es sich an, Bezeichner
+(oder Variablen) zu verwenden.
+
+
+@example
+melodie = @{ @}
+text = @{ @}
+upper = @{ @}
+lower = @{ @}
+\score @{
+ @{
+ <<
+ \new Staff = "Sänger" <<
+ \new Voice = "vocal" @{ \melodie @}
+ >>
+ \new Lyrics \lyricsto vocal \new Lyrics @{ \text @}
+ \new PianoStaff = "piano" <<
+ \new Staff = "upper" @{ \upper @}
+ \new Staff = "lower" @{ \lower @}
+ >>
+ >>
+ @}
+ \layout @{ @}
+@}
+@end example
+
+@noindent
+Nochmal: der Bezeichner kann aller möglicher Text sein. Die
+Einschränkungen sind in
+@ruser{File structure} genau aufgelistet.
+
+Beim Schreiben (oder Lesen) einer @code{\score}-Umgebung
+sollte man langsam und sorgfältig vorgehen. Am besten fängt
+man mit dem größten Gebilde an und definiert dann die darin
+enthaltenen kleineren der Reihe nach. Es hilft auch, sehr
+genau mit den Einzügen zu sein, so dass jede Zeile, die
+der gleichen Ebene angehört, wirklich horizontal an der
+gleichen Stelle beginnt.
+
@node Nesting music expressions
@subsection Nesting music expressions
* Engravers explained::
* Modifying context properties::
* Adding and removing engravers::
-@end menu
+@end menu
+
@node Contexts explained
@subsection Contexts explained
UNTRANSLATED NODE: IGNORE ME
-@subsubsection Changing a single context
-@
-@subsubsection Changing all contexts of the same type
@node Extending the templates
@section Extending the templates
* Soprano and cello::
* Four-part SATB vocal score::
* Building a score from scratch::
-@end menu
+@end menu
+
@node Soprano and cello
@subsection Soprano and cello
UNTRANSLATED NODE: IGNORE ME
-
--- SKELETON FILE --
-When you actually translate this file, please remove these lines as
-well as all `UNTRANSLATED NODE: IGNORE ME' lines.
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Guitar
@section Guitar
@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: d9b4bfc69674eb4ed7b8c6eaa0b646f00eae6c8d
+ Translation of GIT committish: 02cb8b672238eeb53bffa2240c87f23dd8ca9e60
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
UNTRANSLATED NODE: IGNORE ME
@menu
-* Controlling direction::
+* Controlling direction and placement::
* Distances and measurements MAYBE MOVE::
+* When to add a -::
@end menu
-@node Controlling direction
-@subsection Controlling direction
+@node Controlling direction and placement
+@subsection Controlling direction and placement
UNTRANSLATED NODE: IGNORE ME
UNTRANSLATED NODE: IGNORE ME
+@node When to add a -
+@subsection When to add a -
+
+UNTRANSLATED NODE: IGNORE ME
+
@node Other stuffs TODO move?
@section Other stuffs TODO move?
@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond-program.tely
@ignore
- Translation of GIT committish: d9b4bfc69674eb4ed7b8c6eaa0b646f00eae6c8d
+ Translation of GIT committish: 02cb8b672238eeb53bffa2240c87f23dd8ca9e60
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Introduction
@chapter Introduction
@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond-program.tely
@ignore
- Translation of GIT committish: d9b4bfc69674eb4ed7b8c6eaa0b646f00eae6c8d
+ Translation of GIT committish: 02cb8b672238eeb53bffa2240c87f23dd8ca9e60
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@documentencoding UTF-8
@documentlanguage de
+@include macros.itexi
+
@iftex
@afourpaper
@c don't replace quotes with directed quotes
@vskip 20pt
-@lilypond[ragged-right]
-\score {
- \context Lyrics {
- \override Score.RehearsalMark #'self-alignment-X = #LEFT
- \override Score.RehearsalMark #'font-size = #-2
- \mark #(ly:export (string-append
- "(For LilyPond version " (lilypond-version) ")"))
- s2
- }
- \layout {
- indent = 0.0\pt
- }
-}
-@end lilypond
-
+Für LilyPond Version @version{}
@end titlepage
@copying
@top GNU LilyPond -- Handbuch zum Lernen
@c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
-Das ist des Handbuch zum Erlernen von GNU LilyPond Version 2.11.x
-@ifhtml
-(Siehe Ende der Seite für die genaue Versionsnummer).
-@end ifhtml
+Das ist des Handbuch zum Erlernen von GNU LilyPond Version @version{}.
@cindex Internetseite
@cindex URL
* Preface:: Vorwort.
* Introduction:: Was, warum und wie.
* Tutorial:: Eine Übung zur Einführung.
-* Putting it all together:: Genauere Erklärungen zu LilyPonds
-Eigenschaften.
-* Fundamental concepts:: Grundlegende Konzepte, die benötigt
-werden, um den Rest dieses Handbuchs zu lesen.
-* Tweaking output:: Einleitung in die Beeinflussung des
-Notenbilds.
-* Working on LilyPond projects:: Benutzung des Programms im
-wirklichen Leben.
+* Fundamental concepts:: Grundlegende Konzepte, die benötigt werden, um den Rest dieses Handbuchs zu lesen.
+* Tweaking output:: Einleitung in die Beeinflussung des Notenbilds.
+* Working on LilyPond projects:: Benutzung des Programms im wirklichen Leben.
Anhänge
@contents
-@include macros.itexi
-
@include preface.itely
@include introduction.itely
@include tutorial.itely
-@include putting.itely
@include fundamental.itely
@include tweaks.itely
@include working.itely
@documentencoding UTF-8
@documentlanguage de
+@include macros.itexi
+
@iftex
@afourpaper
@c don't replace quotes with directed quotes
@vskip 20pt
-@lilypond[ragged-right]
-\score {
- \context Lyrics {
- \override Score.RehearsalMark #'self-alignment-X = #LEFT
- \override Score.RehearsalMark #'font-size = #-2
- \mark #(ly:export (string-append
- "(For LilyPond version " (lilypond-version) ")"))
- s2
- }
- \layout {
- indent = 0.0\pt
- }
-}
-@end lilypond
-
+Für LilyPond Version @version{}
@end titlepage
@copying
@top GNU LilyPond -- Programmbenutzung
@c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
-Das ist das Handbuch zur Programmbenutzung für GNU LilyPond Version 2.11.x.
-@ifhtml
-(Siehe Ende der Seite für die genaue Versionsnummer).
-@end ifhtml
+Das ist das Handbuch zur Programmbenutzung für GNU LilyPond Version @version{}.
@cindex Internetseite
@cindex URL
@contents
-@include macros.itexi
-
@include install.itely
@include setup.itely
@include running.itely
@documentencoding UTF-8
@documentlanguage de
+@include macros.itexi
+
@iftex
@afourpaper
@c don't replace quotes with directed quotes
@vskip 20pt
-@lilypond[ragged-right]
-\score {
- \context Lyrics {
- \override Score.RehearsalMark #'self-alignment-X = #LEFT
- \override Score.RehearsalMark #'font-size = #-2
- \mark #(ly:export (string-append
- "(For LilyPond version " (lilypond-version) ")"))
- s2
- }
- \layout {
- indent = 0.0\pt
- }
-}
-@end lilypond
-
+Für LilyPond Version @version{}
@end titlepage
@copying
@top GNU LilyPond -- Das Notationsprogramm
@c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
-Das ist das Benutzerhandbuch für GNU LilyPond Version 2.11.x
-@ifhtml
-(Siehe Ende der Seite für die genaue Versionsnummer).
-@end ifhtml
+Das ist das Benutzerhandbuch für GNU LilyPond Version @version{}.
@cindex Internetseite
@cindex URL
@menu
* Musical notation:: Allgemeine Notation von Musik.
-* Specialist notation:: Notation, die nur für spezielle Zwecke
- eingesetzt wird.
-* Input syntax:: Allgemeine Information über die
- Quelledateien von LilyPond.
+* Specialist notation:: Notation, die nur für spezielle Zwecke eingesetzt wird.
+* Input syntax:: Allgemeine Information über die Quelledateien von LilyPond.
* Non-musical notation:: Alles, was nicht Musiknotation ist.
* Spacing issues:: Anzeige der Ausgabe auf dem Papier.
* Changing defaults:: Das Notenbild verfeinern.
@contents
-@include macros.itexi
-
@include notation.itely
@include specialist.itely
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Literature list
@appendix Literature list
@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: d9b4bfc69674eb4ed7b8c6eaa0b646f00eae6c8d
+ Translation of GIT committish: 02cb8b672238eeb53bffa2240c87f23dd8ca9e60
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@menu
* Repeats and MIDI::
-@end menu
+@end menu
+
@node Repeats and MIDI
@subsubsection Repeats and MIDI
-UNTRANSLATED NODE: IGNORE ME
+@cindex Erweiterung von Wiederholungen
+@funindex \unfoldRepeats
+
+Mit ein bisschen Anpassung können alle Wiederholungstypen
+auch in der MIDI-Datei wiedergegeben werden. Das wird erreicht
+durch die @code{\unfoldRepeats}-Funktion. Hiermit werden alle
+Wiederholungen, welcher Art auch immer, in notengetreue Wiederholungen
+umgewandelt, die Noten werden also wiederholt ausgegeben.
+
+@lilypond[quote,verbatim,fragment,line-width=8.0\cm]
+\unfoldRepeats {
+ \repeat tremolo 8 {c'32 e' }
+ \repeat percent 2 { c''8 d'' }
+ \repeat volta 2 {c'4 d' e' f'}
+ \alternative {
+ { g' a' a' g' }
+ {f' e' d' c' }
+ }
+}
+\bar "|."
+@end lilypond
+
+Wenn man eine Partitur schreibt, die diesen @code{\unfoldRepeats}-Befehl
+für die MIDI-Ausgabe benutzt, muss man zwei @code{\score}-Umgebungen
+schreiben: eine für die MIDI-Ausgabe, wo die Wiederholungen ausgeschrieben
+werden, und eine für die gedruckte Notation, in der Klammern, Tremolo und
+Prozent-Wiederholungen benutzt werden. Zum Beispiel:
+
+@example
+\score @{
+ @var{..music..}
+ \layout @{ .. @}
+@}
+\score @{
+ \unfoldRepeats @var{..music..}
+ \midi @{ .. @}
+@}
+@end example
+
@node other midi
@section other midi
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Notation manual tables
@appendix Notation manual tables
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Musical notation
@chapter Musical notation
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Percussion
@section Percussion
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Piano music
@section Piano music
Dynamische Zeichen werden nicht automatisch mittig notiert, aber
dafür gibt es Lösungen, vgl. die
-@q{piano centered dynamics}-Vorlage in @ref{Piano templates}.
+@q{piano centered dynamics}-Vorlage in @rlearning{Piano templates}.
@cindex Hälse über zwei Systeme
@cindex System querende Hälse
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Pitches
@section Pitches
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Preface
@unnumbered Preface
@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: d9b4bfc69674eb4ed7b8c6eaa0b646f00eae6c8d
+ Translation of GIT committish: 02cb8b672238eeb53bffa2240c87f23dd8ca9e60
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
+++ /dev/null
-@c -*- coding: utf-8; mode: texinfo; -*-
-@c This file is part of lilypond.tely
-@ignore
- Translation of GIT committish: 3db3697bb5109201192c9cecdd2e4b7a5520421a
-
- When revising a translation, copy the HEAD committish of the
- version that you are working on. See TRANSLATION for details.
-@end ignore
-
-@node Putting it all together
-@chapter Putting it all together
-
-Dieses Kapitel behandelt das allgemeine Konzept von LilyPond
-und wie man @code{\score}-Blöcke erstellt.
-
-
-@menu
-* Extending the templates::
-* How LilyPond files work::
-* Score is a single musical expression::
-* An orchestral part::
-@end menu
-
-
-@node Extending the templates
-@section Extending the templates
-
-Wenn Sie das Übungskapitel gelesen haben, wissen Sie, wie man Noten
-schreibt. Aber wie erhalten Sie genau die Notensysteme, die Sie sich
-vorstellen? Die Vorlagen sind gut, aber was, wenn Sie etwas anderen
-wollen?
-
-Beginnen Sie mit der Vorlage, die am ehesten dem nahe kommt, was Sie als
-Ergebnis haben wollen. Sagen wir, Sie wollen ein Stück für Sopran und
-Cello notieren. In diesem Fall beginnen Sie mit
- @qq{Noten und Text} (für die Sopranstimme).
-
-@example
-\version "2.11.38"
-melodie = \relative c' @{
- \clef treble
- \key c \major
- \time 4/4
-
- a4 b c d
-@}
-
-text = \lyricmode @{
- Aaa Bee Cee Dee
-@}
-
-\score@{
- <<
- \new Voice = "one" @{
- \autoBeamOff
- \melodie
- @}
- \new Lyrics \lyricsto "one" \text
- >>
- \layout @{ @}
- \midi @{ @}
-@}
-@end example
-
-Jetzt wollen wir die Cellostimme hinzufügen. Schauen wir uns das
-@qq{Nur Noten}-Beispiel an:
-
-@example
-\version "2.11.38"
-melodie = \relative c' @{
- \clef treble
- \key c \major
- \time 4/4
-
- a4 b c d
-@}
-
-\score @{
-\new Staff \melodie
-\layout @{ @}
-\midi @{ @}
-@}
-@end example
-
-Wir brauchen nicht zwei @code{\version}-Befehle. Wir brauchen den
-@code{melodie}-Abschnitt. Wir brauchen keine zwei
-@code{\score}-Abschnitte,
-denn damit würden wir ja zwei voneinander getrennte Notensysteme
-erhalten. Wir wollen sie aber zusammen, als Duo. Innerhalb eines
-@code{\score}-Abschnittes brauchen wir auch nicht zweimal
-@code{\layout} und @code{\midi}.
-
-Kopieren wir aber nur den @code{melodie}-Abschnitt, hätte wir zwei
-@code{melodie}-Abschnitte. Also nennen wir diesen Bezeichner anders.
-Die Noten für den Sopran nennen wir @code{sopranNoten}, die Noten
-für das Cello @code{celloNoten}. Gleichzeitig können wir auch noch
-den Abschnitt @code{text} in @code{sopranText} umbenennen. Es ist
-wichtig, beide Befehle umzubenennen, einmal die Definition (also den
-@code{melodie = \relative c' @{ }-Teil), zweitens die Anwendung des
-Namens in der Partitur (also in dem @code{\score}-Abschnitt).
-
-Während wir hier diese Änderungen vornehmen, können wir auch gleich
-das Cello-System anpassen -- Celli brauchen im Normalfall den
-Bass-Schlüssel.
-Wir setzen hier auch ein paar andere Noten für das Cello.
-
-
-@example
-\version "2.11.38"
-sopranNoten = \relative c' @{
- \clef treble
- \key c \major
- \time 4/4
-
- a4 b c d
-@}
-
-sopranText = \lyricmode @{
- Aaa Bee Cee Dee
-@}
-
-celloNoten = \relative c @{
- \clef bass
- \key c \major
- \time 4/4
-
- d4 g fis8 e d4
-@}
-
-\score@{
- <<
- \new Voice = "one" @{
- \autoBeamOff
- \sopranoNoten
- @}
- \new Lyrics \lyricsto "one" \sopranText
- >>
- \layout @{ @}
- \midi @{ @}
-@}
-@end example
-
-Das sieht schon ganz gut aus, aber das Cello-System erscheint noch
-nicht in der Partitur. Wir haben den Bezeichner ja auch nicht im
-@code{\score}-Abschnitt benutzt. Wenn wir wollen, dass die Noten
-auch gedruckt werden, müssen wir noch
-
-@example
-\new Staff \celloNoten
-@end example
-
-@noindent
-unter dem Sopran-System einfügen. Wir müssen auch die Zeichen
- @code{<<} und unter der Musik dann die Zeichen @code{>>} einfügen,
- denn dadurch wird LilyPond
-mitgeteilt, dass mehrere Ausdrücke (hier unsere zwei Systeme
-(@code{Staff})
-gleichzeitig gesetzt werden sollen. Der @code{\score}-Abschnitt
-sieht jetzt so aus:
-
-@example
-\score@{
- <<
- <<
- \new Voice = "one" @{
- \autoBeamOff
- \sopranNoten
- @}
- \new Lyrics \lyricsto "one" \sopranText
- >>
- \new Staff \celloNoten
- >>
- \layout @{ @}
- \midi @{ @}
-@}
-@end example
-
-@noindent
-Das sieht noch etwas durcheinander aus, die Einzüge sind in
-Unordnung geraden. Aber das ist einfach wieder hergestellt. Hier die
-vollständige Vorlage für Sopran und Cello:
-
-@lilypond[quote,verbatim,ragged-right]
-\version "2.11.38"
-sopranoMusic = \relative c' {
- \clef treble
- \key c \major
- \time 4/4
-
- a4 b c d
-}
-
-sopranoLyrics = \lyricmode {
- Aaa Bee Cee Dee
-}
-
-celloMusic = \relative c {
- \clef bass
- \key c \major
- \time 4/4
-
- d4 g fis8 e d4
-}
-
-\score{
- <<
- <<
- \new Voice = "one" {
- \autoBeamOff
- \sopranoMusic
- }
- \new Lyrics \lyricsto "one" \sopranoLyrics
- >>
- \new Staff \celloMusic
- >>
- \layout { }
- \midi { }
-}
-@end lilypond
-
-
-
-@node How LilyPond files work
-@section How LilyPond files work
-
-Das LilyPond Eingabeformat hat eine ziemlich freie Form, so dass
-für erfahrene Benutzer viel Freiheit besteht, die Struktur ihrer
-Quelldateien anzulegen. Für Neulinge kann diese Flexibilität aber
-erst einmal verwirrend sein. In diesem Kapitel soll darum ein Teil
-dieser Strukturen dargestellt werden, vieles aber zur Vereinfachung
-auch weggelassen werden. Für eine komplette Beschreibung des Eingabeformats
-siehe @ruser{File structure}.
-
-Die meisten Beispiele in diesem Handbuch sind kleine Schnipsel, wie
-etwa dieser:
-
-@example
-c4 a b c
-@end example
-
-Wie hoffentlich bekannt ist, lässt sich solch ein Schnipsel nicht
-in dieser Form übersetzen. Diese Beispiele sind also nur Kurzformen
-von wirklichen Beispielen. Sie müssen wenigstens zusätzlich in
-geschweifte Klammern gesetzt werden.
-
-@example
-@{
- c4 a b c
-@}
-@end example
-
-Die meisten Beispiele benutzen auch den @code{\relative c'}-Befehl.
-Der ist nicht nötig, um die Dateien zu übersetzen, aber in den meisten
-Fällen sieht der Notensatz seltsam aus, wenn man den Befehl
-weglässt.
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-\relative c'' {
- c4 a b c
-}
-@end lilypond
-
-Jetzt kommt noch eine Ebene dazu: LilyPond-Code in der obigen Form
-ist in Wirklichkeit auch wieder eine Abkürzung. Auch wenn man so
-Dateien schreiben kann und sie auch korrekt gesetzt werden, heißt
-der wirkliche Code, der hier gemeint ist, eigentlich:
-
-@example
-\score @{
- \relative c'' @{
- c4 a b c
- @}
-@}
-@end example
-
-Eine Partitur (@code{\score}) muss immer mit einem musikalischen Ausdruck
-beginnen. Das ist letztendlich alle Musik, angefangen bei einer
-einzelnen
-Note bis hin zu einer riesigen Partitur mit vielen Notensystemen
-(bezeichnet durch @code{GrandStaff}):
-
-@example
-@{
- \new GrandStaff <<
- hier die gesamte Partitur
- >>
-@}
-@end example
-
-@noindent
-Da sich alles innerhalb der geschweiften Klammern @code{@{ ... @}}
-befindet, wird es wie ein einziger musikalischer Ausdruck behandelt.
-
-
-Ein @code{\score} auch andere Dinge enthalten, wie etwa
-
-@example
-\score @{
- @{ c'4 a b c' @}
- \layout @{ @}
- \midi @{ @}
- \header @{ @}
-@}
-@end example
-
-@noindent
-Viele setzen einige dieser Befehle außerhalb des
-@code{\score}-Blocks, zum Beispiel wird der @code{\header}
-sehr oft oberhalb der @code{\score}-Umgebung gesetzt. Das
-funktioniert genauso gut.
-
-@cindex Variablen
-@cindex Bezeichner
-
-Eine gute Möglichkeit zur Vereinfachung sind selbst definierte Variablen.
-Alle Vorlagen verwenden diese Möglichkeit.
-
-@example
-melodie = \relative c' @{
- c4 a b c
-@}
-
-\score @{
- @{ \melodie @}
-@}
-@end example
-
-Wenn LilyPond diese Datei analysiert, nimmt es den Inhalt
-von @code{melodie} (alles, was nach dem Gleichheitszeichen
-kommt) und fügt ihn immer dann ein, wenn ein @code{\melodie}
-vorkommt. Die Namen sind frei wählbar, die Variable kann genauso
-gut @code{melodie}, @code{GLOBAL},
-@code{rechteHandklavier}, oder @code{foofoobarbaz} heißen. Für mehr
-Information siehe
-@ruser{Saving typing with identifiers and functions}.
-
-Eine komplette Definition des Eingabeformats findet sich
-im Kapitel @ruser{File structure}.
-
-
-@node Score is a single musical expression
-@section Score is a single musical expression
-
-Im vorigen Kapitel, @ruser{How LilyPond files work},
-wurde die allgemeine Struktur einer LilyPond-Quelldatei
-beschrieben. Aber anscheinend haben wir die wichtigste
-Frage ausgelassen, nämlich wie man herausfindet, was nach
-dem @code{\score} geschrieben werden soll.
-
-In Wirklichkeit ist das aber gar kein Geheimnis. Diese
-Zeile ist die Antwort:
-
-
-@quotation
-@emph{Eine Partitur fängt immer mit @code{\score} an, gefolgt
-von einem einzelnen musikalischen Ausdruck.}
-@end quotation
-
-@noindent
-Vielleicht wollen Sie noch einmal
-@ruser{Music expressions explained} überfliegen. In diesem
-Kapitel wurde gezeigt, wie sich große musikalische Ausdrücke
-aus kleinen Teilen zusammensetzen. Noten können zu Akkorden
-verbunden werden usw. Jetzt gehen wir aber in die andere Richtung
-und betrachten, wie sich ein großer musikalischer Ausdruck
-zerlegen lässt.
-
-@example
-\score @{
- @{ % diese Klammer startet den großen mus. Ausdruck
- \new GrandStaff <<
- hier eine ganze Wagner-Oper einfügen
- >>
- @} % diese Klammer beendet den Ausdruck
- \layout @{ @}
-@}
-@end example
-
-Eine Wagner-Oper ist mindestens doppelt so lang wie dieses Handbuch,
-beschränken wir uns also auf einen Sänger und Klavier. Wir brauchen
-keine Orchesterpartitur (@code{GrandStaff}) dafür, darum lassen wir
-den Befehl weg. Wir brauchen aber einen Sänger und ein Klavier.
-
-@example
-\score @{
- @{
- <<
- \new Staff = "Sänger" <<
- >>
- \new PianoStaff = Klavier <<
- >>
- >>
- @}
- \layout @{ @}
-@}
-@end example
-
-Zur Erinnerung: mit @code{<<} und @code{>>} werden Noten gleichzeitig
-gesetzt; wir wollen ja auch Klavier- und Sängerstimme gleichzeitig
-haben.
-
-@example
-\score @{
- @{
- <<
- \new Staff = "Sänger" <<
- \new Voice = "vocal" @{ @}
- >>
- \new Lyrics \lyricsto vocal \new Lyrics @{ @}
- \new PianoStaff = "piano" <<
- \new Staff = "upper" @{ @}
- \new Staff = "lower" @{ @}
- >>
- >>
- @}
- \layout @{ @}
-@}
-@end example
-
-Jetzt haben wir viel mehr Details. Wir haben ein System (engl. staff)
-für einen Sänger, in dem sich wieder eine Stimme (engl. voice)
-befindet. @code{Voice} bedeutet für LilyPond eine Stimme (sowohl
-gesungen als auch gespielt) und evtl. zusätzlich einen Text. Zusätzlich
-werden zwei Notensysteme für das Klavier mit dem Befehl @code{\new
-PianoStaff} gesetzt. @code{PianoStaff} bezeichnet die Piano-Umgebung (etwa
-durchgehende Taktstriche und die geschweifte Klammer am Anfang), in der
-dann wiederum zwei eigene Systeme ("upper" für die rechte Hand und
-"lower"
-für die linke) erstellt werden.
-
-Jetzt könnte man in diese Umgebung Noten einfügen. Innerhalb der
-geschweiften
-Klammern neben @code{\new Voice = vocal} könnte man
-
-
-@example
-\relative c'' @{
- a4 b c d
-@}
-@end example
-
-@noindent schreiben. Aber wenn man seine Datei so direkt schreibt, wird
-der @code{\score}-Abschnitt sehr lang und es wird ziemlich schwer zu
-verstehen, wie alles zusammenhängt. Darum bietet es sich an, Bezeichner
-(oder Variablen) zu verwenden.
-
-
-@example
-melodie = @{ @}
-text = @{ @}
-upper = @{ @}
-lower = @{ @}
-\score @{
- @{
- <<
- \new Staff = "Sänger" <<
- \new Voice = "vocal" @{ \melodie @}
- >>
- \new Lyrics \lyricsto vocal \new Lyrics @{ \text @}
- \new PianoStaff = "piano" <<
- \new Staff = "upper" @{ \upper @}
- \new Staff = "lower" @{ \lower @}
- >>
- >>
- @}
- \layout @{ @}
-@}
-@end example
-
-@noindent
-Nochmal: der Bezeichner kann aller möglicher Text sein. Die
-Einschränkungen sind in
-@ruser{File structure} genau aufgelistet.
-
-Beim Schreiben (oder Lesen) einer @code{\score}-Umgebung
-sollte man langsam und sorgfältig vorgehen. Am besten fängt
-man mit dem größten Gebilde an und definiert dann die darin
-enthaltenen kleineren der Reihe nach. Es hilft auch, sehr
-genau mit den Einzügen zu sein, so dass jede Zeile, die
-der gleichen Ebene angehört, wirklich horizontal an der
-gleichen Stelle beginnt.
-
-
-
-
-
-
-
-@node An orchestral part
-@section An orchestral part
-
-Orchesternoten werden alle zweimal gesetzt. Erstens als Stimmen für
-die Musiker, und dann als große Partitur für den Dirigenten. Mit
-Variablen
-kann hier doppelte Arbeit erspart werden. Die Musik muss nur einmal
-eingegeben werden und wird in einer Variable abgelegt. Der Inhalt
-dieser
-Variable wird dann benutzt, um sowohl die Stimme als auch die Partitur
-zu erstellen.
-
-Es bietet sich an, die Noten in eigenen Dateien zu speichern. Sagen wir
-beispielsweise, dass in der Datei @file{Horn-Noten.ly} die folgenden
-Noten eines Duetts für Horn und Fagott gespeichert sind:
-
-@example
-HornNoten = \relative c @{
- \time 2/4
- r4 f8 a cis4 f e d
-@}
-@end example
-
-@noindent
-Daraus wird dann eine eigene Stimme gemacht, indem folgende Datei
-erstellt
-wird:
-
-@example
-\include "Horn-Noten.ly"
-\header @{
- instrument = "Horn in F"
-@}
-
-@{
- \transpose f c' \HornNoten
-@}
-@end example
-
-Die Zeile
-
-@example
-\include "Horn-Noten.ly"
-@end example
-
-@noindent
-setzt den Inhalt der Datei @file{Horn-Noten.ly} an die Stelle des
-Befehls in die aktuelle Datei. Damit besteht also eine Definition
-für @code{HornNoten}, so dass die Variable verwendet werden kann.
-Der Befehl @code{\transpose f@tie{}c'} zeigt an, dass das Argument,
-also @code{\HornNoten}, um eine Quinte nach oben transponiert wird.
-Klingendes @q{f} wird also als @code{c'} notiert. Das entspricht
-der Notation eines Waldhorn in F. Die Transposition zeigt die folgende
-Ausgabe:
-
-@lilypond[quote,ragged-right]
-\transpose f c' \relative c {
- \time 2/4
- r4 f8 a cis4 f e d
-}
-@end lilypond
-
-In Musik für mehrere Instrumente kommt es oft vor, dass eine Stimme
-für mehrere Takte nicht spielt. Das wird mit einer besonderen Pause
-angezeigt, dem Pausenzeichen für mehrere Takte (engl. multi-measure
-rest). Sie wird mit dem @emph{großen} Buchstaben @samp{R} eingegeben,
-gefolgt von einer Dauer (@code{1}@tie{}für eine Ganze, @code{2}@tie{}
-für eine Halbe usw.). Indem man die Dauer multipliziert, können längere
-Pausen erstellt werden. Z. B. dauert diese Pause drei Takte eines
-2/4-Taktes:
-
-@example
-R2*3
-@end example
-
-Wenn die Stimme gedruckt wird, müssen diese Pausen zusammengezogen
-werden.
-Das wird durch eine Variable erreicht:
-
-@example
-\set Score.skipBars = ##t
-@end example
-
-@noindent
-Dieser Befehl setzt die Eigenschaft des @code{skipBars} (@qq{überspringe
-Takte}) auf wahr (@code{##t}). Wenn diese Option und die Pause
-zu der Musik des Beispiels gesetzt wird, erhält man folgendes Ergebnis:
-
-@lilypond[quote,ragged-right]
-\transpose f c' \relative c {
- \time 2/4
- \set Score.skipBars = ##t
- R2*3
- r4 f8 a cis4 f e d
-}
-@end lilypond
-
-Die Partitur wird erstellt, indem alle Noten zusammengesetzt werden.
-Angenommen, die andere Stimme trägt den Namen @code{FagottNoten}
- und ist in der Datei @file{Fagott-Noten.ly} gespeichert. Die
-Partitur sieht dann folgendermaßen aus:
-
-@example
-\include "Fagott-Noten.ly"
-\include "Horn-Noten.ly"
-
-<<
- \new Staff \HornNoten
- \new Staff \FagottNoten
->>
-@end example
-
-@noindent
-Und mit LilyPond übersetzt:
-
-@lilypond[quote,ragged-right]
-\relative c <<
- \new Staff {
- \time 2/4 R2*3
- r4 f8 a cis4 f e d
- }
- \new Staff {
- \clef bass
- r4 d,8 f | gis4 c | b bes |
- a8 e f4 | g d | gis f
- }
->>
-@end lilypond
-
-Tiefer gehende Information darüber, wie Stimmauszüge und Partituren
-erstellt werden, finden sich im Notationshandbuch, siehe
-@ruser{Orchestral music}.
-
-Das Setzen der Variablen, die das Verhalten von LilyPond beeinflussen
-(@q{properties}), wird im Kapitel
-@ruser{Changing context properties on the fly} besprochen.
-
-
-
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Repeats
@section Repeats
ganze Vielzahl von Notationsmöglichkeiten für Wiederholungen.
@menu
-* Writing repeats::
-* Other repeats::
+* Writing long repeats::
+* Short repeats::
@end menu
-@node Writing repeats
-@subsection Writing repeats
+@node Writing long repeats
+@subsection Writing long repeats
@menu
* Repeat types::
* Repeat syntax::
* Manual repeat commands::
-* Repeats and MIDI::
@end menu
@node Repeat types
-@unnumberedsubsubsec Repeat types
+@subsubsection Repeat types
@cindex Wiederholungen
@node Repeat syntax
-@unnumberedsubsubsec Repeat syntax
+@subsubsection Repeat syntax
@cindex Klammer, Wiederholung
@cindex Volta
@node Manual repeat commands
-@unnumberedsubsubsec Manual repeat commands
+@subsubsection Manual repeat commands
@funindex repeatCommands
@internalsref{UnfoldedRepeatedMusic}.
-@node Repeats and MIDI
-@unnumberedsubsubsec Repeats and MIDI
+@node Short repeats
+@subsection Short repeats
-@cindex Erweiterung von Wiederholungen
-@funindex \unfoldRepeats
+@menu
+* Percent repeats::
+* Tremolo repeats::
+* Tremolo subdivisions::
+@end menu
+
+@node Percent repeats
+@subsubsection Percent repeats
-Mit ein bisschen Anpassung können alle Wiederholungstypen
-auch in der MIDI-Datei wiedergegeben werden. Das wird erreicht
-durch die @code{\unfoldRepeats}-Funktion. Hiermit werden alle
-Wiederholungen, welcher Art auch immer, in notengetreue Wiederholungen
-umgewandelt, die Noten werden also wiederholt ausgegeben.
+@cindex Prozent-Wiederholungen
+@cindex Taktweise Wiederholungen
+
+Wenn der Prozent (@code{percent})-Wiederholungsstil gesetzt ist, wird
+eine Notenphrase wiederholt. Sie wird einmal gedruckt und dann durch
+ein spezielles Zeichen ersetzt. Phrasen von ein oder zwei Takten Dauer
+werden durch ein dem Prozentzeichen ähnlichen Zeichen markiert, Phrasen,
+die kürzer als ein Takt sind, durch einen Schrägstrich dargestellt.
+Dieser Wiederholungstyp muss innerhalb eines Stimmen
+(@code{Voice})-Kontextes notiert werden.
-@lilypond[quote,verbatim,fragment,line-width=8.0\cm]
-\unfoldRepeats {
- \repeat tremolo 8 {c'32 e' }
- \repeat percent 2 { c''8 d'' }
- \repeat volta 2 {c'4 d' e' f'}
- \alternative {
- { g' a' a' g' }
- {f' e' d' c' }
- }
+@lilypond[quote,verbatim,ragged-right]
+\new Voice \relative c' {
+ \repeat percent 4 { c4 }
+ \repeat percent 2 { c2 es2 f4 fis4 g4 c4 }
}
-\bar "|."
@end lilypond
-Wenn man eine Partitur schreibt, die diesen @code{\unfoldRepeats}-Befehl
-für die MIDI-Ausgabe benutzt, muss man zwei @code{\score}-Umgebungen
-schreiben: eine für die MIDI-Ausgabe, wo die Wiederholungen ausgeschrieben
-werden, und eine für die gedruckte Notation, in der Klammern, Tremolo und
-Prozent-Wiederholungen benutzt werden. Zum Beispiel:
+Wiederholungen, die länger als einen Takt dauern, können gezählt werden,
+wenn die @code{countPercentRepeats}-Eigenschaft eingeschaltet wird.
-@example
-\score @{
- @var{..music..}
- \layout @{ .. @}
-@}
-\score @{
- \unfoldRepeats @var{..music..}
- \midi @{ .. @}
-@}
-@end example
+@lilypond[relative=2,fragment,quote,verbatim,ragged-right]
+\new Voice {
+\set countPercentRepeats = ##t
+ \repeat "percent" 4 { c1 }
+}
+@end lilypond
+Isolierte Prozentzeichen können auch gedruckt werden. Das geschieht, indem
+einer Ganztaktpause (@code{R}) eine andere Funktion zugewiesen wird.
+
+@lilypond[fragment,verbatim,quote]
+\override MultiMeasureRest #'stencil
+ = #ly:multi-measure-rest::percent
+R1
+@end lilypond
+
+@seealso
+
+Programmreferenz: @internalsref{RepeatSlash},
+@internalsref{PercentRepeat}, @internalsref{DoublePercentRepeat},
+@internalsref{DoublePercentRepeatCounter},
+@internalsref{PercentRepeatCounter},
+@internalsref{PercentRepeatedMusic}.
-@node Other repeats
-@subsection Other repeats
-@menu
-* Tremolo repeats::
-* Tremolo subdivisions::
-* Measure repeats::
-@end menu
@node Tremolo repeats
-@unnumberedsubsubsec Tremolo repeats
+@subsubsection Tremolo repeats
@cindex Tremolobalken
@node Tremolo subdivisions
-@unnumberedsubsubsec Tremolo subdivisions
+@subsubsection Tremolo subdivisions
@cindex Tremolozeichen
@funindex tremoloFlags
Programmreferenz: @internalsref{StemTremolo}.
-
-@node Measure repeats
-@unnumberedsubsubsec Measure repeats
-
-@cindex Prozent-Wiederholungen
-@cindex Taktweise Wiederholungen
-
-Wenn der Prozent (@code{percent})-Wiederholungsstil gesetzt ist, wird
-eine Notenphrase wiederholt. Sie wird einmal gedruckt und dann durch
-ein spezielles Zeichen ersetzt. Phrasen von ein oder zwei Takten Dauer
-werden durch ein dem Prozentzeichen ähnlichen Zeichen markiert, Phrasen,
-die kürzer als ein Takt sind, durch einen Schrägstrich dargestellt.
-Dieser Wiederholungstyp muss innerhalb eines Stimmen
-(@code{Voice})-Kontextes notiert werden.
-
-@lilypond[quote,verbatim,ragged-right]
-\new Voice \relative c' {
- \repeat percent 4 { c4 }
- \repeat percent 2 { c2 es2 f4 fis4 g4 c4 }
-}
-@end lilypond
-
-Wiederholungen, die länger als einen Takt dauern, können gezählt werden,
-wenn die @code{countPercentRepeats}-Eigenschaft eingeschaltet wird.
-
-@lilypond[relative=2,fragment,quote,verbatim,ragged-right]
-\new Voice {
-\set countPercentRepeats = ##t
- \repeat "percent" 4 { c1 }
-}
-@end lilypond
-
-Isolierte Prozentzeichen können auch gedruckt werden. Das geschieht, indem
-einer Ganztaktpause (@code{R}) eine andere Funktion zugewiesen wird.
-
-@lilypond[fragment,verbatim,quote]
-\override MultiMeasureRest #'stencil
- = #ly:multi-measure-rest::percent
-R1
-@end lilypond
-
-@seealso
-
-Programmreferenz: @internalsref{RepeatSlash},
-@internalsref{PercentRepeat}, @internalsref{DoublePercentRepeat},
-@internalsref{DoublePercentRepeatCounter},
-@internalsref{PercentRepeatCounter},
-@internalsref{PercentRepeatedMusic}.
-
-
-
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Rhythms
@section Rhythms
@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond-program.tely
@ignore
- Translation of GIT committish: d9b4bfc69674eb4ed7b8c6eaa0b646f00eae6c8d
+ Translation of GIT committish: 02cb8b672238eeb53bffa2240c87f23dd8ca9e60
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Scheme tutorial
@appendix Scheme tutorial
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Setup
@chapter Setup
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Simultaneous notes
@section Simultaneous notes
@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: d9b4bfc69674eb4ed7b8c6eaa0b646f00eae6c8d
+ Translation of GIT committish: 02cb8b672238eeb53bffa2240c87f23dd8ca9e60
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Specialist notation
@chapter Specialist notation
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Staff notation
@section Staff notation
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Orchestral strings
@section Orchestral strings
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Templates
@appendix Templates
@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: d9b4bfc69674eb4ed7b8c6eaa0b646f00eae6c8d
+ Translation of GIT committish: 02cb8b672238eeb53bffa2240c87f23dd8ca9e60
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@menu
* Writing text::
-* Text markup::
-* Special text concerns::
+* Formatting text::
@end menu
@node Writing text
@subsection Writing text
UNTRANSLATED NODE: IGNORE ME
@menu
-* Overview of text entry::
* Text scripts::
* Text spanners::
* Text marks::
+* Separate text::
@end menu
-@node Overview of text entry
-@subsubsection Overview of text entry
-
-UNTRANSLATED NODE: IGNORE ME
-
@node Text scripts
@subsubsection Text scripts
UNTRANSLATED NODE: IGNORE ME
-@node Text markup
-@subsection Text markup
+@node Separate text
+@subsubsection Separate text
+
+UNTRANSLATED NODE: IGNORE ME
+
+@node Formatting text
+@subsection Formatting text
UNTRANSLATED NODE: IGNORE ME
UNTRANSLATED NODE: IGNORE ME
-@node Special text concerns
-@subsection Special text concerns
-
-UNTRANSLATED NODE: IGNORE ME
-
-@menu
-* New dynamic marks::
-* Text and line spanners::
-@end menu
-@node New dynamic marks
-@subsubsection New dynamic marks
-
-UNTRANSLATED NODE: IGNORE ME
-
-@node Text and line spanners
-@subsubsection Text and line spanners
-
-UNTRANSLATED NODE: IGNORE ME
-
-- SKELETON FILE --
When you actually translate this file, please remove these lines as
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@ignore
Tutorial guidelines:
- unless you have a really good reason, use either
@menu
-* First steps::
-* Single staff notation::
-* Multiple notes at once::
-* Songs::
-* Final touches::
+* First steps::
+* Single staff notation::
+* Multiple notes at once::
+* Songs::
+* Final touches::
@end menu
des Programmes erklärt.
@menu
-* Compiling a file::
-* Simple notation::
-* Working on text files::
-* How to read the manual::
+* Compiling a file::
+* Simple notation::
+* Working on text files::
+* How to read the manual::
@end menu
geben Sie folgenden Text ein:
@example
-{
+@{
c' e' g' e'
-}
+@}
@end example
Um die Datei zu bearbeiten, geben sie an der Konsole
das Vorkommen von mehr als einer Stimme pro System.
@menu
-* Music expressions explained::
-* Multiple staves::
-* Piano staves::
-* Combining notes into chords::
-* Single staff polyphony::
+* Music expressions explained::
+* Multiple staves::
+* Staff groups::
+* Combining notes into chords::
+* Single staff polyphony::
@end menu
@menu
* Setting simple songs::
* Aligning lyrics to a melody::
-* Lyrics to multiple staves::
+* Lyrics to multiple staves::
@end menu
@end lilypond
Hier wurde auch noch die Balkenlänge manuell gesetzt (mit den
-eckigen Klammern {code{[ ]}, damit die Balkenlänge der
+eckigen Klammern @code{[ ]}, damit die Balkenlänge der
üblichen Notationsweise für Gesang entspricht (siehe
@ref{Automatic and manual beams}).
* Version number::
* Adding titles::
* Absolute note names::
-* After the tutorial::
+* After the tutorial::
@end menu
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Tweaking output
@chapter Tweaking output
@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: d9b4bfc69674eb4ed7b8c6eaa0b646f00eae6c8d
+ Translation of GIT committish: 02cb8b672238eeb53bffa2240c87f23dd8ca9e60
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Working on LilyPond projects
@chapter Working on LilyPond projects
@menu
* Suggestions for writing LilyPond files::
-* Saving typing with identifiers and functions::
-* Style sheets::
-* Updating old files::
-* Troubleshooting (taking it all apart)::
-* Minimal examples::
+* When things don't work::
+* Scores and parts::
@end menu
@node Suggestions for writing LilyPond files
@section Suggestions for writing LilyPond files
+
Jetzt sind Sie so weit, größere Stücke mit LilyPond zu schreiben --
nicht
nur die kleinen Beispiele aus der Übung, sondern ganze Stücke.
* General suggestions::
* Typesetting existing music::
* Large projects::
+* Saving typing with variables and functions::
+* Style sheets::
@end menu
@end itemize
-@node Saving typing with identifiers and functions
-@section Saving typing with identifiers and functions
+@node Saving typing with variables and functions
+@subsection Saving typing with variables and functions
@cindex Variable
@cindex Bezeichner
des Befehles beziehen sich dann auf die neue Definition.
@node Style sheets
-@section Style sheets
+@subsection Style sheets
Die Ausgabe, die LilyPond erstellt, kann sehr start modifiziert
werden, siehe @ruser{Tweaking output} für Einzelheiten. Aber wie
@end example
+@node When things don't work
+@section When things don't work
+
+@menu
+* Updating old files::
+* Troubleshooting (taking it all apart)::
+* Minimal examples::
+@end menu
+
@node Updating old files
-@section Updating old files
+@subsection Updating old files
Die Syntax von LilyPond verändert sich ab und zu. Wenn LilyPond
besser wird, muss auch die Syntax (Eingabesprache) entsprechend
@node Troubleshooting (taking it all apart)
-@section Troubleshooting (taking it all apart)
+@subsection Troubleshooting (taking it all apart)
Früher oder später werden Sie in die Lage kommen,
dass LilyPond Ihre Datei nicht kompilieren will. Die
@node Minimal examples
-@section Minimal examples
+@subsection Minimal examples
Ein Minimalbeispiel ist eine Beispieldatei, die so klein wie
möglich ist. Diese Beispiele sind sehr viel einfacher zu
@end itemize
+@node Scores and parts
+@section Scores and parts
+
+Orchesternoten werden alle zweimal gesetzt. Erstens als Stimmen für
+die Musiker, und dann als große Partitur für den Dirigenten. Mit
+Variablen
+kann hier doppelte Arbeit erspart werden. Die Musik muss nur einmal
+eingegeben werden und wird in einer Variable abgelegt. Der Inhalt
+dieser
+Variable wird dann benutzt, um sowohl die Stimme als auch die Partitur
+zu erstellen.
+
+Es bietet sich an, die Noten in eigenen Dateien zu speichern. Sagen wir
+beispielsweise, dass in der Datei @file{Horn-Noten.ly} die folgenden
+Noten eines Duetts für Horn und Fagott gespeichert sind:
+
+@example
+HornNoten = \relative c @{
+ \time 2/4
+ r4 f8 a cis4 f e d
+@}
+@end example
+
+@noindent
+Daraus wird dann eine eigene Stimme gemacht, indem folgende Datei
+erstellt
+wird:
+
+@example
+\include "Horn-Noten.ly"
+\header @{
+ instrument = "Horn in F"
+@}
+
+@{
+ \transpose f c' \HornNoten
+@}
+@end example
+
+Die Zeile
+
+@example
+\include "Horn-Noten.ly"
+@end example
+
+@noindent
+setzt den Inhalt der Datei @file{Horn-Noten.ly} an die Stelle des
+Befehls in die aktuelle Datei. Damit besteht also eine Definition
+für @code{HornNoten}, so dass die Variable verwendet werden kann.
+Der Befehl @code{\transpose f@tie{}c'} zeigt an, dass das Argument,
+also @code{\HornNoten}, um eine Quinte nach oben transponiert wird.
+Klingendes @q{f} wird also als @code{c'} notiert. Das entspricht
+der Notation eines Waldhorn in F. Die Transposition zeigt die folgende
+Ausgabe:
+
+@lilypond[quote,ragged-right]
+\transpose f c' \relative c {
+ \time 2/4
+ r4 f8 a cis4 f e d
+}
+@end lilypond
+
+In Musik für mehrere Instrumente kommt es oft vor, dass eine Stimme
+für mehrere Takte nicht spielt. Das wird mit einer besonderen Pause
+angezeigt, dem Pausenzeichen für mehrere Takte (engl. multi-measure
+rest). Sie wird mit dem @emph{großen} Buchstaben @samp{R} eingegeben,
+gefolgt von einer Dauer (@code{1}@tie{}für eine Ganze, @code{2}@tie{}
+für eine Halbe usw.). Indem man die Dauer multipliziert, können längere
+Pausen erstellt werden. Z. B. dauert diese Pause drei Takte eines
+2/4-Taktes:
+
+@example
+R2*3
+@end example
+
+Wenn die Stimme gedruckt wird, müssen diese Pausen zusammengezogen
+werden.
+Das wird durch eine Variable erreicht:
+
+@example
+\set Score.skipBars = ##t
+@end example
+
+@noindent
+Dieser Befehl setzt die Eigenschaft des @code{skipBars} (@qq{überspringe
+Takte}) auf wahr (@code{##t}). Wenn diese Option und die Pause
+zu der Musik des Beispiels gesetzt wird, erhält man folgendes Ergebnis:
+
+@lilypond[quote,ragged-right]
+\transpose f c' \relative c {
+ \time 2/4
+ \set Score.skipBars = ##t
+ R2*3
+ r4 f8 a cis4 f e d
+}
+@end lilypond
+
+Die Partitur wird erstellt, indem alle Noten zusammengesetzt werden.
+Angenommen, die andere Stimme trägt den Namen @code{FagottNoten}
+ und ist in der Datei @file{Fagott-Noten.ly} gespeichert. Die
+Partitur sieht dann folgendermaßen aus:
+
+@example
+\include "Fagott-Noten.ly"
+\include "Horn-Noten.ly"
+
+<<
+ \new Staff \HornNoten
+ \new Staff \FagottNoten
+>>
+@end example
+
+@noindent
+Und mit LilyPond übersetzt:
+
+@lilypond[quote,ragged-right]
+\relative c <<
+ \new Staff {
+ \time 2/4 R2*3
+ r4 f8 a cis4 f e d
+ }
+ \new Staff {
+ \clef bass
+ r4 d,8 f | gis4 c | b bes |
+ a8 e f4 | g d | gis f
+ }
+>>
+@end lilypond
+
+Tiefer gehende Information darüber, wie Stimmauszüge und Partituren
+erstellt werden, finden sich im Notationshandbuch, siehe
+@ruser{Orchestral music}.
+
+Das Setzen der Variablen, die das Verhalten von LilyPond beeinflussen
+(@q{properties}), wird im Kapitel
+@ruser{Changing context properties on the fly} besprochen.
+
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Ancient notation
@section Ancient notation
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Bagpipes
@section Bagpipes
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Changing defaults
@chapter Changing defaults
@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: 32fe8d89d5c4fe9c73c1daf200cd23c7e8f2d3fc
+ Translation of GIT committish: b9526773cf95ca29e3d3352c524718fc8e91c599
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.38"
+
@c TODO: add tablature.
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Chords Blah
@section Chords Blah
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of lilypond-program.tely
@ignore
- Translation of GIT committish: 66dde21fe63499f32a718f6098abe70e1429059b
+ Translation of GIT committish: c8d082d075de595c18d05e894ae765f89fc0cb46
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.38"
+
@node Converting from other formats
@chapter Converting from other formats
-UNTRANSLATED NODE: IGNORE ME
+También se puede escribir la música a través de su importación desde
+otros formatos. Este capítulo trata de documentar las herramientas
+incluidas en la dirstribución que permiten hacerlo. Existen otras
+herramientas que producen código de entrada de LilyPond, como por
+ejemplo secuenciadores con interfaz gráfico y comvertidores de XML.
+Consulte el @uref{http://@/lilypond@/.org,website} para ver más
+detalles.
+
+Son programas distintos a lilypond propiamente dicho, y se ejecutan
+desde la línea de órdenes; consulte @ref{Command-line usage} para ver
+más información.
+
+
+@knownissues
+Por desgracia no disponemos de los recursos necesarios para poder
+mantener estos programas; le rogramos que los tome @qq{tal cual
+están}. Se agradecerá el envío de parches correctores, pero los
+informes de fallo casi con certeza no se resolverán a medio plazo.
+
+@menu
+* Invoking midi2ly:: Importar archivos MIDI.
+* Invoking musicxml2ly:: Importar archivos MusicXML.
+* Invoking abc2ly:: Importar archivos ABC.
+* Invoking etf2ly:: Importar archivos de Finale.
+* Generating LilyPond files:: Interfaces gráficos, transcriptores y programas de composición algorítmica.
+@end menu
+
+
-@menu
-* Invoking midi2ly::
-* Invoking musicxml2ly::
-* Invoking abc2ly::
-* Invoking etf2ly::
-* Generating LilyPond files::
-@end menu
@node Invoking midi2ly
@section Invoking @command{midi2ly}
-UNTRANSLATED NODE: IGNORE ME
+@cindex MIDI
+
+@command{midi2ly} traduce un archivo MIDI de tipo@tie{}1 a un acrhivo
+de código fuente de LilyPond.
+
+El MIDI (Music Instrument Digital Interface, Interfase Digital para
+Instrumentos Musicales) es un estándar para instrumentos digitales:
+especifica la interconexión física, un protocolo en serie y un formato
+de archivo. El formato de archivo MIDI es un formato estándar de
+facto para exportar música de otros programas, por lo que esta
+posibilidad puede ser de utilidad al importar archivos de un programa
+que tiene un convertidor para un formato directo.
+
+@command{midi2ly} convierte las pistas en contextos de
+@internalsref{Staff}) y los canales en contextos de
+@internalsref{Voice}. Se utiliza el modo relativo para las alturas, y
+las duraciones se escriben solamente cuando es necesario.
+
+Es posible grabar un archivo MIDI usando un teclado digital y
+convertirlo después a @file{.ly}. Sin embargo, los intérpretes
+humanos no son lo suficientemente exactos desde el punto de vista
+rítmico como para hacer que sea trivial la conversión de MIDI a LY.
+Si se invoca con las opciones de cuantización (@code{-s} y @code{-d}),
+@command{midi2ly} intenta compensar los errores de medida, pero no lo
+hace muy bien. Por ello, no se recomienda usar @command{midi2ly} para
+archivos midi generados por seres humanos.
+
+
+Se invoca a partir de la línea de órdenes como sigue:
+@example
+midi2ly [@var{opción}]@dots{} @var{archivo_midi}
+@end example
+
+Observe que al decir @q{línea de órdenes}, queremos decir la línea de
+órdenes del sistema operativo. Consulte @ref{Converting from other
+formats} para ver más información sobre esto.
+
+@command{midi2ly} contempla las siguientes opciones:
+
+@table @code
+@item -a, --absolute-pitches
+Imprimir alturas absoultas.
+
+@item -d, --duration-quant=@var{DURACIÓN}
+Cuantizar las duraciones a @var{DURACIÓN}.
+
+@item -e, --explicit-durations
+Imprimir valores de figura explícitos.
+
+@item -h,--help
+Mostrar un resumen de las instrucciones de utilización.
+
+@item -k, --key=@var{alteración}[:@var{minor}]
+Establecer la tonalidad predeterminada. @var{alteración}@math{ > 0}
+establece el número de sostenidos; @var{alteración}@math{ < 0}
+establece el número de bemoles. Se indica una tonalidad menor
+mediante @code{:1}.
+
+@item -o, --output=@var{archivo}
+Escribir la salida en @var{archivo}.
+
+@item -s, --start-quant=@var{DURACIÓN}
+Cuantizar el inicio de las notas a DURACIÓN.
+
+@item -t, --allow-tuplet=@var{DURACIÓN}*@var{NUMERADOR}/@var{DENOMINADOR}
+Permitir duraciones de grupos especiales @var{DURACIÓN}*@var{NUMERADOR}/@var{DENOMINADOR}.
+
+@item -V, --verbose
+Ser prolijo en comentarios.
+
+@item -v, --version
+Imprimir el número de la versión.
+
+@item -w, --warranty
+Presentar la garantía y el copyright.
+
+@item -x, --text-lyrics
+Tratar todos los textos como letra de la canción.
+@end table
+
+
+@knownissues
+
+Las notas superpuestas en un arpegio no se procesarán correctamente.
+La primera nota se lee y el resto se ignoran. Aplique la misma
+duración a todas las notas y añada marcas de fraseo o indicaciones de
+pedal.
+
@node Invoking musicxml2ly
@section Invoking @code{musicxml2ly}
-UNTRANSLATED NODE: IGNORE ME
+@uref{http://@/www.@/recordarde@/.com/xml@/.html,MusicXML} es un
+dialecto del XML para representar notación musical.
+
+@command{musicxml2ly} extrae las notas de archivos de MusicXML parte a
+parte, y los escribe en un archivo .ly. Se invoca a través de la
+línea de órdenes.
+
+Observe que por @q{línea de órdenes}, nos referimos a la línea de
+órdenes del sistema operativo. Consulte @ref{Converting from other
+formats}, para obtener más información acerca de esto.
+
+@command{musicxml2ly} contempla las siguientes opciones:
+
+@table @code
+@item -h,--help
+mostrar un resumen de la utilización y las opciones.
+@item -o,--output=@var{archivo}
+fijar el nombre del archivo de salida como @var{archivo}. (de forma
+predeterminada: imprimir salida a través de stdout)
+@item -v,--version
+imprimir la información de la versión.
+@end table
+
@node Invoking abc2ly
@section Invoking @code{abc2ly}
-UNTRANSLATED NODE: IGNORE ME
+@cindex ABC
+
+ABC es un formato bastante simple basado en ASCII. Se encuentra
+descrito en el sitio web de ABC:
+
+@quotation
+@uref{http://@/www@/.walshaw@/.plus@/.com/@/abc/@/abc2mtex/@/abc@/.txt}.
+@end quotation
+
+@command{abc2ly} convierte ABC en LilyPond. Se invoca de la siguiente
+manera:
+
+@example
+abc2ly [@var{opción}]@dots{} @var{archivo_abc}
+@end example
+
+@command{abc2ly} contempla las siguientes opciones:
+
+@table @code
+@item -h,--help
+esta ayuda
+@item -o,--output=@var{archivo}
+fijar el nombre del archivo de salida como @var{archivo}.
+@item -v,--version
+imprimir la infomación de la versión.
+@end table
+
+Existe una posibilidad rudimentaria para añadir código de LilyPond el
+archivo fuente de ABC. Si decimos:
+
+@example
+%%LY voices \set autoBeaming = ##f
+@end example
+
+Producirá que el texto que sigue a la palabra clave @q{voices} se
+inserte en la voz en curso del archivo de salida de LilyPond.
+
+De forma similar,
+
+@example
+%%LY slyrics más palabras
+@end example
+
+producirá que el texto que sigue a la palabra clave @q{slyrics} se
+inserte en la línea de letra en curso.
+
+
+@knownissues
+
+El estándar ABC no es muy @q{estándar}. Existen diferentes
+convenciones para las posibilidades avanzadas (por ejemplo,
+polifonía).
+
+
+No se pueden convertir varias melodías de un solo archivo.
+
+ABC sincroniza las letras y las notas al principio de una línea;
+@command{abc2ly} no lo hace.
+
+@command{abc2ly} ignora el barrado de ABC.
+
@node Invoking etf2ly
@section Invoking @command{etf2ly}
-UNTRANSLATED NODE: IGNORE ME
+@cindex ETF
+@cindex enigma
+@cindex Finale
+@cindex Coda Technology
+
+ETF (Enigma Transport Format) es un formato utilizado por Finale, un
+producto de Coda Music Technology. @command{etf2ly} convierte parte
+de un archivo ETF en un archivo de LilyPond listo para usar.
+
+Se invoca a través de la línea de órdenes como sigue:
+
+@example
+etf2ly [@var{opción}]@dots{} @var{archivo_etf}
+@end example
+
+Observe que por @q{línea de órdenes}, nos referimos a la línea de
+órdenes del sistema operativo. Consulte @ref{Converting from other
+formats}, para obtener más información acerca de esto.
+
+@command{etf2ly} contempla las siguientes opciones:
+
+@table @code
+@item -h,--help
+esta ayuda
+@item -o,--output=ARCHIVO
+fijar el nombre del archivo de salida como ARCHIVO
+@item -v,--version
+información de la versión
+@end table
+
+
+@knownissues
+
+La lista de inscripciones de articulación posibles es incompleta. Los
+compases vacíos confunden a @command{etf2ly}. Las secuencias de notas
+de adorno no se dan por finalizadas satisfactoriamente.
+
@node Generating LilyPond files
@section Generating LilyPond files
-UNTRANSLATED NODE: IGNORE ME
+@cindex programas externos, generación de archivos de LilyPond
+
+El propio LilyPond no contempla la utilización de ningún otro formato,
+pero existen algunas herramientas externas que también generan
+archivos de LilyPond.
+
+Entre ellas se encuentran las siguientes:
+@itemize
+@item
+@uref{http://@/denemo@/.sourceforge@/.net/,Denemo}, editor de partituras gráfico.
+@item
+@uref{http://www@/.volny@/.cz/smilauer/rumor/rumor@/.html,Rumor},
+convertidor monofónico de MIDI a LilyPond en tiempo real.
+@item
+@uref{http://nicolas@/.sceaux@/.free@/.fr/lilypond/lyqi@/.html,lyqi},
+un modo principal para Emacs.
+@item
+@uref{http://@/www@/.nongnu@/.org/@/xml2ly/, xml2ly}, que importa
+@uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}
+@item
+@uref{http://@/noteedit@/.berlios@/.de,NoteEdit} que importa
+@uref{http://@/www@/.musicxml@/.com/xml@/.html,MusicXML}
+@item
+@uref{http://@/www@/.rosegardenmusic@/.com,Rosegarden}, que importa
+MIDI
+@item
+@uref{http://@/common-lisp@/.net/project/fomus/,FOMUS},
+una biblioteca de LISP para generar notación musical
+@end itemize
--- SKELETON FILE --
-When you actually translate this file, please remove these lines as
-well as all `UNTRANSLATED NODE: IGNORE ME' lines.
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@quotation
Queremos dedicar este programa a todos los amigos que hemos
hecho a través de la música.
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Editorial annotations
@section Editorial annotations
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Expressive marks
@section Expressive marks
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of lilypond-learning.tely
@ignore
- Translation of GIT committish: b0a1d7fa5e1b8371a0d1f1ed1dfd3fc9bc4881d2
+ Translation of GIT committish: 7cc6b12897031c450e3399d59cdb22ca9df4fd8c
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.38"
+
@node Fundamental concepts
@chapter Fundamental concepts
@node Introduction to the LilyPond file structure
@subsection Introduction to the LilyPond file structure
-Un ejemplo básico de archivo de entrada de lilypond es el siguiente:
+Un ejemplo básico de archivo de entrada de LilyPond es el siguiente:
@example
\version @w{"@version{}"}
@end example
@noindent
-Hay personas que ponen algunos de estos comandos fuera del
-bloque @code{\score} (por ejemplo, @code{\header} se
-sitúa con frecuencia por encima del @code{\score}. Es tan sólo
-otra abreviatura que LilyPond acepta.
+Hay personas que ponen algunas de estas instrucciones fuera del bloque
+@code{\score} (por ejemplo, @code{\header} se sitúa con frecuencia por
+encima del @code{\score}. Es tan sólo otra abreviatura que LilyPond
+acepta.
Dos instrucciones más que no hemos visto aún son @code{\layout @{ @}}
y @code{\midi @{@}}. Si aparecen tal y como se muestran aquí, hacen
@noindent
Advierta que el tamaño de la clave es igual al que se imprime en un
-cambio de clave (ligemamente menor que la clave al principio de una
+cambio de clave (ligeramente menor que la clave al principio de una
línea). Esto es normal para cualquier clave que se imprime en la
mitad de una línea.
adelante. Es un medio de modificar el comportamiento predeterminado
de un solo pentagrama. Aquí, dice que el pentagrama nuevo se debe
colocar por encima del pentagrama llamado @qq{main} en vez de la
-posición predeterminada que seería por debajo.
+posición predeterminada que sería por debajo.
Los fragmentos de ossia se escriben a menudo sin clave y sin
indicación de compás, y generalmente en un tipo más pequeño. Esto
los paréntesis que se cierran deben encontrarse en el orden
exactamente opuesto al de los paréntesis que se abren. Esto
@strong{es} un requisito para los tres tipos de paréntesis que se
-describen mediante la parabla @q{Encierra} en la tabla anterior: se
+describen mediante la palabra @q{Encierra} en la tabla anterior: se
deben anidar correctamente. Sin embargo, el resto de las llaves y
corchetes, que se encuentran descritos por la palabra @q{Marca} en la
misma tabla anterior, @strong{no} tienen por qué anidarse
son paréntesis en el sentido de que encierran algo: simplemente son
marcadores que indican dónde empieza o finaliza algo.
-Asíi pues, por ejemplo, una ligadura de fraseo puede dar comienzo
+Así pues, por ejemplo, una ligadura de fraseo puede dar comienzo
antes de una barra insertada manualmente, y acabar antes de que acabe
la barra (algo que quizá no sea muy musical, pero es posible):
@end lilypond
En general, los distintos tipos de corchete, y los implicados en
-grupos especiiales, ligaduras de unión y notas de adorno, se pueden
+grupos especiales, ligaduras de unión y notas de adorno, se pueden
mezclar con total libertad. Este ejemplo muestra una barra que se
extiende hacia el interior de un grupo de valoración especial (línea
1), una ligadura de expresión que se prolonga hasta el interior de un
voces reciben a veces el nombre de @q{layers} («capas») en otros
programas de edición de partituras.
-De hechho, una capa o contexto de voz es la única que puede contener
+De hecho, una capa o contexto de voz es la única que puede contener
música. Si un contexto de voz no se declara explícitamente, se crea
uno de forma automática, como vimos al comienzo de este capítulo.
Ciertos instrumentos como el oboe solamente pueden tocar una nota cada
<d g>4 <d fis> <d a'> <d g>
@end lilypond
-Esto se puede expresar utilizand sólo símbolos de acorde con ángulos
+Esto se puede expresar utilizando sólo símbolos de acorde con ángulos
simples, @code{< ... >}, y para este propósito tan sólo se necesita
una voz. Pero suponga que el Fa sostenido fuese realmente una corchea
seguida de un Sol corchea, una nota de paso que conduce al La. Ahora
@funindex << \\ >>
@funindex \\
-La forma más fácil de introducir fragmentos con maś de una voz en un
+La forma más fácil de introducir fragmentos con más de una voz en un
solo pentagrama es escribir cada voz como una secuencia (con
@code{@{...@}}), y combinarlas simultáneamente con ángulos dobles,
@code{<<...>>}. Los fragmentos también se deben separar mediante una
que son mayormente monofónicas pero ocasionalmente tienen cortas
secciones de polifonía.
-He aquí cómo dividimos los acordes anteriore en dos voces y añadimos
+He aquí cómo dividimos los acordes anteriores en dos voces y añadimos
la nota de paso y la ligadura:
@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
Este ejemplo tiene sólo dos voces, pero la misma construcción se puede
-usar para codificar tres o más voces mediante la adición de maś
+usar para codificar tres o más voces mediante la adición de más
separadores de barra invertida.
Los contextos de voz llevan los nombres de @code{"1"}, @code{"2"},
(de prolongación y de expresión) solamente pueden conectar notas que
estén dentro de la misma voz, luego las ligaduras no pueden entrar o
salir de una construcción simultánea. A la inversa, las voces
-paraleleas de construcciones simultáneas distintas sobre el mismo
+paralelas de construcciones simultáneas distintas sobre el mismo
pentagrama, son la misma voz. Otras propiedades relativas a las voces
también conllevan construcciones simultáneas. A continuación vemos el
mismo ejemplo, con colores y cabezas distintos para cada voz. Observe
que los cambios en una voz no afectan a otras voces, pero persisten
-más tarde dentro de la misma voz. Observe tambiénn que las notas
+más tarde dentro de la misma voz. Observe también que las notas
ligadas se pueden dividir entre las mismas voces de dos
construcciones, como se indica aquí en la voz de triángulos azules.
La polifonía no cambia la relación de las notas dentro de un bloque
@code{\relative @{ @}}. La altura de cada nota aún se calcula con
relación a la nota que le precede inmediatamente, o a la primera nota
-del acrode precedente. Así, en
+del acorde precedente. Así, en
@example
\relative c' @{ notaA << < notaB notaC > \\ notaD >> notaE @}
posteriores dentro del presente capítulo y el siguiente, para ilustrar
varias técnicas para producir notación, y por tanto le pedimos que
ignore por ahora cualquier cosa en el código subyacente que le parezca
-misteriorso y tan sólo se concentre en la música y las voces (todas
+misterioso y tan sólo se concentre en la música y las voces (todas
las complicaciones se explicarán en secciones posteriores).
@c The following should appear as music without code
}
@end lilypond
-Con frecuencia, la dirección de las plicas se utiiliza para indicar la
+Con frecuencia, la dirección de las plicas se utiliza para indicar la
continuidad de dos líneas melódicas simultáneas. Aquí, todas las
plicas de las notas agudas se dirigen hacia arriba y las de las notas
graves hacia abajo. Ésta es la primera indicación de que se requiere
Observe las notas que comienzan en la tercera parte del primer compás.
El La bemol es una negra con puntillo, el Fa es una negra y el Re
bemol es una blanca. Estas notas nos e pueden escribir como un acorde
-porque todas las ntoas de un acorde deben tener la misma duración.
+porque todas las notas de un acorde deben tener la misma duración.
Tampoco se pueden escribir como notas secuenciales, pues deben
comenzar al mismo tiempo. Esta sección del compás requiere tres
voces, y la práctica común sería escribir todo el compás como tres
las voces de numeración impar reciben las plicas hacia arriba y las de
numeración par hacia abajo. Las plicas de las voces 1 y 2 están
correctas, pero las plicas de la voz 3 debería ir hacia abajo en este
-fragmentoo en particular. Podemos corregir esto simplemente
+fragmento en particular. Podemos corregir esto simplemente
olvidándonos de la voz tres y situando la música en la voz cuatro:
@lilypond[quote,verbatim,fragment,ragged-right]
@code{\voiceOne} y @code{\voiceThree} hacen que estos objetos apunten
hacia arriba, mientras que @code{\voiceTwo} y @code{\voiceFour} los
hacen apuntar hacia abajo. Estas instrucciones también producen un
-desplazamientoo horizontal para cada voz cuando es necesario para
+desplazamiento horizontal para cada voz cuando es necesario para
evitar choques entre las cabezas. La instrucción @code{\oneVoice}
devuelve los ajustes de nuevo a los valores normales para una sola
voz.
Una expresión que aparece directamente dentro de @code{<< >>}
pertenece a la voz principal (pero, observe, @strong{no} dentro de una
-construcción @code{<< \\ >>}). Esto es útilo cuando aparecen voces
+construcción @code{<< \\ >>}). Esto es útil cuando aparecen voces
nuevas mientras la voz principal está sonando. A continuación podemos
ver una realización más correcta del ejemplo de la sección anterior.
Las notas rojas en forma de rombo muestran que la melodía principal
@cindex anidado de expresiones musicales
@cindex anidado de construcciones simultáneas
-Seon posibles construcciones polifónicas anidadas más profundamente, y
+Son posibles construcciones polifónicas anidadas más profundamente, y
si una voz aparece sólo brevemente podría haber una forma más natural
de tipografiar la música.
Este método de anida voces nuevas brevemente es útil cuando sólo hay
secciones polifónicas pequeñas, pero cuando todo el pentagrama es muy
-plifónico podría ser más claro usar varias voces todo el tiempo,
+polifónico podría ser más claro usar varias voces todo el tiempo,
usando notas espaciadoras para pasar por encima de las secciones en
que una voz está en silencio, como aquí:
columnas para evitar el solapamiento de las cabezas. Reciben el
nombre de columnas de notas. Hay columnas distintas para cada voz, y
el desplazamiento especificado en curso dependiente de la voz se
-applica a la columna de la nota si en caso contgrario se produjese una
+aplica a la columna de la nota si en caso contrario se produjese una
colisión. Esto se puede ver en el ejemplo anterior. En el compás 2 el
Do en la voz dos está desplazado a la derecha respecto del Re de la
voz uno, y en el último acorde el Do de la voz tres también está
Las instrucciones @code{\shiftOn}, @code{\shiftOnn}, @code{\shiftOnnn}
y @code{\shiftOff} especifican el grado en que se deben desplazar las
-ntoas y acordes de la voz si en caso contrariio ocurriese una
+notas y acordes de la voz si en caso contrario ocurriese una
colisión. De forma predeterminada, las voces exteriores (normalmente
-las voces uno y dos) llecan especificado @code{\shiftOff}, mientras
+las voces uno y dos) llevan especificado @code{\shiftOff}, mientras
que las voces interiores (tres y cuatro) tienen @code{\shiftOn}
especificado. Cuando se aplica un desplazamiento, las voces uno y
tres se desplazan hacia la derecha y las voces dos y cuatro se
desplazan hacia la izquierda.
@code{\shiftOnn} y @code{\shiftOnnn} definen niveles adicionales de
-desplazamiento que se peuden especificar temporalmente para resolver
+desplazamiento que se pueden especificar temporalmente para resolver
colisiones en situaciones complejas (véase @ref{Real music example}).
-Una columna de notas puede contener s´olo una nota (o acorde) de una
+Una columna de notas puede contener sólo una nota (o acorde) de una
voz con las plicas hacia arriba y una not (o acorde) de una voz con
las plicas hacia abajo. Si las notas de dos voces que tienen las
plicas en la misma dirección se sitúan en la misma posición y las dos
El barrado automático que LilyPond usa de forma predeterminada
funciona bien para la música instrumental, pero no ten bien para
música con letra, donde o bien el barrado no se necesita en absoluto,
-o bien se utiliza para indicar los melismaas de la letra. En el
+o bien se utiliza para indicar los melismas de la letra. En el
ejemplo anterior hemos utilizado la instrucción @code{\autoBeamOff}
para desactivar el barrado automático.
@section Contexts and engravers
Los contextos y grabadores se han mencionado de manera informal en
-secciones anteriore; ahora tan sólo vamos a ver estos conceptos con
+secciones anteriores; ahora tan sólo vamos a ver estos conceptos con
más detalle, pues son importantes en el ajuste fino de la salida de
LilyPond.
@cindex grabadores
Todas y cada una de las marcas de la salida impresa de una partitura
-hecha con LiilyPond está producida por un @code{Engraver} (grabador).
+hecha con LilyPond está producida por un @code{Engraver} (grabador).
Así, tenemos un grabador para imprimir pentagramas, otro para imprimir
las cabezas de las notas, otro para las plicas, otro para las barras,
etc, etc. ¡En total hay más de 120 grabadores! Afortunadamente, para
@tab Valor de ejemplo
@item extraNatural
@tab Booleano
- @tab Se es verdadero, poner becuadros adicionales antes de las alteraciones
+ @tab Si es verdadero, poner becuadros adicionales antes de las alteraciones
@tab @code{#t}, @code{#f}
@item currentBarNumber
@tab Entero
en cualquier contexto que exista, mediante el uso de la instrucción
@code{\set}. Pero si el nombre no es conocido para LilyPond, no
producirá ninguna acción. Esta es una de las razones por las que es
-muy recomendable ussar un editor que sea sensible al contexto y con
+muy recomendable usar un editor que sea sensible al contexto y con
resaltado de la sintaxis para la edición de archivos de LilyPond, como
por ejemplo Vim, Jedit, ConTEXT o Emacs, ya que los nombres de
propiedades desconocidas se resaltarán de forma distinta.
que un valor booleano verdadero o falso se especifica mediante ##t y
##f, con dos cuadradillos. Una propiedad de texto se debe encerrar
entre comillas dobles, como antes, aunque veremos más adelante que el
-texto realmente se peude especificar de una dorma mucho más general
+texto realmente se puede especificar de una forma mucho más general
utilizando la potentísima instrucción @code{markup}.
@}
@end example
-No necesitamos dos comandos @code{\version}. Vamos a necesitar la
-sección @code{melodia}. No queremos dos secciones @code{\score} (si
-tuviésemos dos @code{\score}s, acabaríamos con las dos particellas por
-separado. Queremos las dos juntas, como un dúo. Dentro de la sección
-@code{\score}, no nos hacen falta dos @code{\layout} ni dos
+No necesitamos dos instrucciones @code{\version}. Vamos a necesitar
+la sección @code{melodia}. No queremos dos secciones @code{\score}
+(si tuviésemos dos @code{\score}s, acabaríamos con las dos particellas
+por separado. Queremos las dos juntas, como un dúo. Dentro de la
+sección @code{\score}, no nos hacen falta dos @code{\layout} ni dos
@code{\midi}.
Si nos limitásemos a copiar y pegar la sección @code{melodia},
de las variables, y finalmente el bloque de partitura. Comencemos a
verlas por encima y más tarde completaremos los detalles.
-Utilizaremos los dos primeros compases del peludio de Bach basado en
+Utilizaremos los dos primeros compases del preludio de Bach basado en
@emph{Jesu, meine Freude}, que está escrito para órgano con dos
manuales y pedal. Tiene estos dos compases de música al final de la
sección. La parte del manual superior tiene dos voces, y el inferior
\new Staff = "ManualUno" <<
\new Voice @{ \MusicaManualUnoVozUno @}
\new Voice @{ \MusicaManualUnoVozDos @}
- >> % fun del contexto de Staff ManualUno
+ >> % fin del contexto de Staff ManualUno
\new Staff = "ManualDos" <<
\new Voice @{ \MusicaManualDos @}
>> % fin del contexto de Staff ManualDos
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Guitar
@section Guitar
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Input syntax
@chapter Input syntax
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Francisco Vila
@ifclear INSTALL
@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: e383a0fdd2e3001caccacf9d0a7d1f0806f3b94c
+ Translation of GIT committish: 03184badb3c2378e1ab3eec6ee62a6bdc0609082
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.38"
+
@node Introduction
@chapter Introduction
se acercan por primera vez deben comenzar por aquí.
@item
-@emph{@ref{Fundamental concepts}}
-explica algunos conceptos generales sobre el formato de los archivos
-de entrada de LilyPond. Si no está seguro de dónde colocar un comando
-¡lea este capítulo!
+@emph{@ref{Fundamental concepts}} explica algunos conceptos generales
+sobre el formato de los archivos de entrada de LilyPond. Si no está
+seguro de dónde colocar una instrucción ¡lea este capítulo!
@item
@emph{@ref{Working on LilyPond projects}}
@item
La
@emph{@r ef{Cheat sheet}}
-es una referencia manejable de los comandos de LilyPond más comunes.
+es una referencia manejable de las instrucciones de LilyPond más comunes.
@item
El
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of lilypond-program.tely
@ignore
- Translation of GIT committish: 66dde21fe63499f32a718f6098abe70e1429059b
+ Translation of GIT committish: 1de1bd7dd269ff09fc7566c2e240555347f52b65
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.38"
+
+@c Note: keep this node named so that `info lilypond-book' brings you here.
@node LilyPond-book
@chapter @command{lilypond-book}: Integrating text and music
-UNTRANSLATED NODE: IGNORE ME
+Si quiere añadir imágenes de música a un documento, puede hacerlo
+simplemente de la forma en que lo haría con otros tipos de imágenes.
+Las imágenes se crean por separado, dando como resultado una salida
+PostScript o imágenes PNG, y luego se incluyen en un documento de
+@LaTeX{} o de HTML.
+
+@command{lilypond-book} ofrece una manera de automatizar este proceso:
+este programa extrae los fragmentos de música del documento, ejecuta
+@command{lilypond} sobre cada uno de ellos, y devuelve como salida el
+documento con la música sustituida por las imágenes. Las definiciones
+de ancho de línea y tamaño de letra de la música se ajustan de forma
+que coincidan con los ajustes de su documento.
+
+Es un programa distinto a @command{lilypond} propiamente dicho, y se
+ejecuta sobre la línea de órdenes; para ver más información, consulte
+@ref{Command-line usage}.
+
+Este procedimiento se puede aplicar a documentos de @LaTeX{}, HTML,
+Texinfo o DocBook.
+
+@cindex texinfo
+@cindex latex
+@cindex texi
+@cindex html
+@cindex docbook
+@cindex documentos, insertar música en
+@cindex HTML, música dentro de
+@cindex Texinfo, música dentro de
+@cindex DocBook, música dentro de
+@cindex @LaTeX{}, música dentro de
+
+@menu
+* An example of a musicological document::
+* Integrating music and text::
+* Music fragment options::
+* Invoking lilypond-book::
+* Filename extensions::
+* Alternate methods of mixing text and music::
+@end menu
+
-@menu
-* An example of a musicological document::
-* Integrating music and text::
-* Music fragment options::
-* Invoking lilypond-book::
-* Filename extensions::
-* Alternate methods of mixing text and music::
-@end menu
@node An example of a musicological document
@section An example of a musicological document
-UNTRANSLATED NODE: IGNORE ME
+@cindex musicología
+Ciertos textos contienen ejemplos musicales. Son tratados musicales,
+cancioneros o manuales como este mismo. Estos textos se pueden hacer
+a mano, importando simplemente una imagen en formato PostScript en el
+editor de textos. Sin embargo, hay un procedimiento automático para
+reducir la carga de trabajo que esto implica los documentos de HTML,
+@LaTeX{}, Texinfo y DocBook.
+
+Un guión ejecutable llamado @code{lilypond-book} extrae los fragmentos
+de música, les da formato y vuelve a poner en su lugar la partitura
+resultante. A continuación presentamos un pequeño ejemplo de su
+utilización con @LaTeX{}. El ejemplo contiene también texto
+explicativo, por lo que no vamos a comentarlo posteriormente.
@subheading Input
+
+@quotation
+@verbatim
+\documentclass[a4paper]{article}
+
+\begin{document}
+
+Los documentos para \verb+lilypond-book+ pueden mezclar libremente
+música y texto. Por ejemplo:
+
+\begin{lilypond}
+\relative c' {
+ c2 g'2 \times 2/3 { f8 e d } c'2 g4
+}
+\end{lilypond}
+
+Las opciones se escriben entre corchetes.
+
+\begin[fragment,quote,staffsize=26,verbatim]{lilypond}
+ c'4 f16
+\end{lilypond}
+
+Los ejemplos grandes se pueden grabar en archivos separados e
+introducirse con \verb+\lilypondfile+.
+
+\lilypondfile[quote,noindent]{screech-boink.ly}
+
+(Si es necesario, sustituya screech-boink.ly por cualquier archivo .ly
+situado en el mismo directorio que este archivo.)
+
+\end{document}
+@end verbatim
+@end quotation
+
@subheading Processing
+
+Guarde el código anterior como un archivo llamado
+@file{lilybook.lytex}, y luego ejecute en un terminal:
+
+@c keep space after @version{} so TeX doesn't choke
+@example
+lilypond-book --output=out --pdf lilybook.lytex
+@emph{lilypond-book (GNU LilyPond) @version{} }
+@emph{Leyendo lilybook.lytex...}
+@emph{..montañas de mensajes suprimidos..}
+@emph{Compilando lilybook.tex...}
+cd out
+pdflatex lilybook
+@emph{..montañas de mensajes suprimidos..}
+xpdf lilybook
+@emph{(sustituya @command{xpdf} por su visor de PDF favorito)}
+@end example
+
+La ejecución de @command{lilypond-book} y @command{latex} crea un gran
+número de archivos temporales, que podrían abarrotar el directorio de
+trabajo. Para poner remedio a esto utilice la opción
+@code{--output=@var{directorio}}. Creará los archivos en un subdirectorio
+aparte @file{directorio}.
+
+Finalmente el resultado del ejemplo de @LaTeX{} que acabamos de
+mostrar@footnote{Este tutorial se procesa con Texinfo, por lo que el
+ejemplo presenta un resultado en la disposición ligeramente
+distinto.}. Así acaba la sección del tutorial.
+
+@page
+
@subheading Output
+
+Los documentos para @command{lilypond-book} pueden mezclar libremente
+música y texto. Por ejemplo:
+
+@lilypond
+\relative c' {
+ c2 g'2 \times 2/3 { f8 e d } c'2 g4
+}
+@end lilypond
+
+Las opciones se escriben entre corchetes.
+
+@lilypond[fragment,quote,staffsize=26,verbatim]
+c'4 f16
+@end lilypond
+
+Los ejemplos grandes se pueden grabar en archivos separados e
+introducirse con @code{\lilypondfile}.
+
+@lilypondfile[quote,noindent]{screech-boink.ly}
+
+
+@page
+
@node Integrating music and text
@section Integrating music and text
-UNTRANSLATED NODE: IGNORE ME
+Aquí vamos a explicar cómo integrar LilyPond con algunos otros
+formatos de salida.
+
+@menu
+* LaTeX::
+* Texinfo::
+* HTML::
+* DocBook::
+@end menu
-@menu
-* LaTeX::
-* Texinfo::
-* HTML::
-* DocBook::
-@end menu
@node LaTeX
@subsection @LaTeX{}
-UNTRANSLATED NODE: IGNORE ME
+@LaTeX{} es el estándar de facto para la publicación en el mundo de
+las ciencias exactas. Está construido encima del motor de composición
+tipográfica @TeX{}, proporcionando la tipografía de mejor calidad que
+existe.
+
+Consulte
+@uref{http://@/www@/.ctan@/.org/@/tex@/-archive/@/info/@/lshort/@/english/,
+@emph{The Not So Short Introduction to @LaTeX{}}} (Introducción no tan
+breve a @LaTeX{}) para ver una panorámica sobre cómo usar @LaTeX{}.
+
+La música se introduce usando
+
+@example
+\begin[las,opciones,van,aquí]@{lilypond@}
+ EL CÓDIGO DE LILYPOND
+\end@{lilypond@}
+@end example
+
+@noindent
+o bien
+
+@example
+\lilypondfile[las,opciones,van,aquí]@{@var{archivo}@}
+@end example
+
+@noindent
+o bien
+
+@example
+\lilypond@{ EL CÓDIGO DE LILYPOND @}
+@end example
+
+La ejecución de @command{lilypond-book} deja como resultado un archivo
+que se puede procesar posteriormente con @LaTeX{}.
+
+A continuación mostramos algunos ejemplos. El entorno @code{lilypond}
+
+@example
+\begin[quote,fragment,staffsize=26]@{lilypond@}
+ c' d' e' f' g'2 g'2
+\end@{lilypond@}
+@end example
+
+@noindent
+produce
+
+@lilypond[quote,fragment,staffsize=26]
+c' d' e' f' g'2 g'2
+@end lilypond
+
+La versión corta
+
+@example
+\lilypond[quote,fragment,staffsize=11]@{<c' e' g'>@}
+@end example
+
+@noindent
+produce
+
+@lilypond[quote,fragment,staffsize=11]{<c' e' g'>}
+
+@noindent
+Por el momento no es posible incluir llaves @code{@{} o @code{@}}
+dentro de @code{\lilypond@{@}}, así que esta instrucción solamente es
+útil con la opción @code{fragment}.
+
+El ancho predeterminado de las líneas de música se ajusta mediante el
+examen de las instrucciones del preámbulo del documento, la parte del
+documento que está antes de @code{\begin@{document@}}. La instrucción
+@command{lilypond-book} los envía a @LaTeX{} para averiguar la anchura
+del texto. El ancho de la línea para los fragmentos de música se
+ajusta entonces al ancho del texto. Observe que este algoritmo
+heurístico puede fácilmente fallar; en estos casos es necesario usar
+la opción @code{line-width} del fragmento de música.
+
+@cindex títulos y lilypond-book
+@cindex \header dentro de documentos @LaTeX{}
+
+Cada fragmento ejecutará los macros siguientes si han sido definidos
+por el usuario:
+
+@itemize bullet
+@item @code{\preLilyPondExample} que se llama antes de la música,
+
+@item @code{\postLilyPondExample} que se llama después de la música,
+
+@item @code{\betweenLilyPondSystem[1]} se llama entre los sistemas si
+@code{lilypond-book} ha dividido el fragmento en varios archivos
+PostScript. Se debe definir de forma que tome un parámetro y recibirá
+el número de archivos ya incluidos dentro del fragmento actual. La
+acción predeterminada es simplemente insertar un @code{\linebreak}.
+@end itemize
+
+@ignore
+Broken stuff. :(
+
+@cindex Latex, feta symbols
+@cindex fetachar
+
+To include feta symbols (such as flat, segno, etc) in a LaTeX
+document, use @code{\input@{titledefs@}}
+
+@example
+\documentclass[a4paper]@{article@}
+
+\input@{titledefs@}
+
+\begin@{document@}
+
+\fetachar\fetasharp
+
+\end@{document@}
+@end example
+
+The font symbol names are defined in the file feta20.tex; to find
+the location of this file, use the command
+
+@example
+kpsewhich feta20.tex
+@end example
+
+@end ignore
+
+@snippets
+
+A veces es útil mostrar elementos de música (como ligaduras) como si
+continuasen más allá del final del fragmento. Esto se puede hacer
+dividiendo el pentagrama y suprimiendo la inclusión del resto de la
+salida de LilyPond.
+
+En @LaTeX{}, defina @code{\betweenLilyPondSystem} de tal forma que la
+la inclusión de otros sistemas se dé por terminada una vez que se ha
+alcanzado el número deseado de sistemas requeridos. Puesto que
+@code{\betweenLilypondSystem} se llama en primer lugar @emph{después}
+del primer sistema, incluir solamente el primer sistema es algo
+trivial.
+
+@example
+\def\betweenLilyPondSystem#1@{\endinput@}
+
+\begin[fragment]@{lilypond@}
+ c'1\( e'( c'~ \break c' d) e f\)
+\end@{lilypond@}
+@end example
+
+Si se necesita un mayor número de sistemas, se tiene que usar un
+condicional de @TeX{} antes del @code{\endinput}. En este ejemplo,
+sustituya el @q{2} por el número de sistemas que quiere en la salida:
+
+@example
+\def\betweenLilyPondSystem#1@{
+ \ifnum##1<2\else\endinput\fi
+@}
+@end example
+
+Recuerde que la definición de @code{\betweenLilyPondSystem} es
+efectiva hasta que @TeX{} abandona el grupo actual (como el entorno
+@LaTeX{}) o se sobreescribe por otra definición (lo que casi siempre
+es por el resto del documento). Para reponer la definición, escriba
+
+@example
+\let\betweenLilyPondSystem\undefined
+@end example
+
+@noindent
+dentro de la fuente de @LaTeX{}.
+
+Se puede simplificar esto definiendo un macro de @TeX{}:
+
+@example
+\def\onlyFirstNSystems#1@{
+ \def\betweenLilyPondSystem##1@{\ifnum##1<#1\else\endinput\fi@}
+@}
+@end example
+
+@noindent
+y luego diciendo solamente cuántos sistemas quiere antes de cada
+fragmento:
+
+@example
+\onlyFirstNSystems@{3@}
+\begin@{lilypond@}...\end@{lilypond@}
+\onlyFirstNSystems@{1@}
+\begin@{lilypond@}...\end@{lilypond@}
+@end example
+
+@seealso
+Hay opciones de línea de órdenes específicas de
+@command{lilypond-book} y otros detalles que conocer para procesar
+documentos de@LaTeX{} véase @ref{Invoking lilypond-book}.
+
@node Texinfo
@subsection Texinfo
-UNTRANSLATED NODE: IGNORE ME
+Texinfo es el formato estándar para la documentación del proyecto GNU.
+Este mismo manual es un ejemplo de documento Texinfo. Las versiones
+HTML, PDF e Info del manual se hacen a partir del documento Texinfo.
+
+
+En el archivo de entrada, la música se especifica con
+
+@example
+@@lilypond[las,opciones,van,aquí]
+ EL CÓDIGO DE LILYPOND
+@@end lilypond
+@end example
+
+@noindent
+o bien
+
+@example
+@@lilypond[las,opciones,van,aquí]@{ EL CÓDIGO DE LILYPOND @}
+@end example
+
+@noindent
+o bien
+
+@example
+@@lilypondfile[las,opciones,van,aquí]@{@var{archivo}@}
+@end example
+
+Cuando se ejecuta @command{lilypond-book} sobre el archivo, se obtiene
+como resultado un archivo Texinfo (con la extensión @file{.texi}) que
+contiene etiquetas @code{@@image} para el HTML, Info y la salida
+impresa. @command{lilypond-book} genera imágenes de la música en
+formatos EPS y PDF para usarlos en la salida impresa, y en formato PNG
+para usarlos en las salidas HTML e Info.
+
+Aquí podemos ver dos ejemplos sencillos. Un entorno @code{lilypond}
+
+@example
+@@lilypond[fragment]
+c' d' e' f' g'2 g'
+@@end lilypond
+@end example
+
+@noindent
+produce
+
+@lilypond[fragment]
+c' d' e' f' g'2 g'
+@end lilypond
+
+La versión corta
+
+@example
+@@lilypond[fragment,staffsize=11]@{<c' e' g'>@}
+@end example
+
+@noindent
+produce
+
+@lilypond[fragment,staffsize=11]{<c' e' g'>}
+
+No como @LaTeX{}, @code{@@lilypond@{...@}} no genera una imagen en
+línea. Siempre consiste en un párrafo para ella sola.
+
@node HTML
@subsection HTML
-UNTRANSLATED NODE: IGNORE ME
+La música se introduce usando
+
+@example
+<lilypond fragment relative=2>
+\key c \minor c4 es g2
+</lilypond>
+@end example
+
+@noindent
+@command{lilypond-book} entonces produce un archivo HTML con las
+etiquetas de imagen adecuadas para los fragmentos de música:
+
+@lilypond[fragment,relative=2]
+\key c \minor c4 es g2
+@end lilypond
+
+Para imágenes en línea, utilice @code{<lilypond ... />}, donde las
+opciones están separadas de la música por el símbolo de dos puntos,
+por ejemplo
+
+@example
+Algo de música dentro de <lilypond relative=2: a b c/> una línea de texto.
+@end example
+
+Para incluir archivos externos, escriba
+
+@example
+<lilypondfile @var{opción1} @var{opción2} ...>@var{archivo}</lilypondfile>
+@end example
+
+@cindex títulos en HTML
+@cindex vista previa, imagen
+@cindex miniatura
@node DocBook
@subsection DocBook
-UNTRANSLATED NODE: IGNORE ME
+Para insertad fragmentos de LilyPond es bueno tratar de mantener la
+conformidad del documento de DocBook, permitiendo así el uso de
+editores de DocBook, validación, etc. Así pues, no usamos etiquetas
+personalizadas, sólo especificamos una convención basada en los
+elementos estándar de DocBook.
@subheading Common conventions
+
+Para insertar toda clase de fragmentos utilizamos los elementos
+@code{mediaobject} y @code{inlinemediaobject}, de forma que nuestros
+fragmentos puedan ser formateados en línea o no en línea. Las
+opciones de formateo del fragmento se escriben siempre dentro de la
+propiedad @code{role} del elemento más interno (véanse las secciones
+siguientes). Las etiquetas se eligen de forma que permitan a los
+editores de DocBook formatear el contenido satisfactoriamente. Los
+archivos de DocBook que se van a procesar con @command{lilypond-book}
+deben tener la extensión @file{.lyxml}.
+
@subheading Including a LilyPond file
+
+Este es el caso más sencillo. Debemos usar la extensión @file{.ly}
+para el archivo incluido, e insertarlo como un @code{imageobject}
+estándar, con la estructura siguiente:
+
+@example
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="music1.ly" role="printfilename" />
+ </imageobject>
+</mediaobject>
+@end example
+
+Observe que puede usar mediaobject o inlinemediaobject como el
+elemento más externo, a elección suya.
+
@subheading Including LilyPond code
+
+Se puede incluir código de LilyPond mediante la utilización de un
+elemento @code{programlisting}, en que el lenguaje se establece como
+@code{lilypond} con la estructura siguiente:
+
+@example
+<inlinemediaobject>
+ <textobject>
+ <programlisting language="lilypond" role="fragment verbatim staffsize=16 ragged-right relative=2">
+\context Staff \with @{
+ \remove Time_signature_engraver
+ \remove Clef_engraver@}
+ @{ c4( fis) @}
+ </programlisting>
+ </textobject>
+</inlinemediaobject>
+@end example
+
+Como puede ver, el elemento más externo es un @code{mediaobject} o un
+@code{inlinemediaobject}, y hay un elemento @code{textobject} que
+lleva el @code{programlisting} en su interior.
+
@subheading Processing the DocBook document
+
+Al ejecutar @command{lilypond-book} sobre el archivo @file{.lyxml} se
+creará un documento de DocBook válido que se puede procesar
+posteriormente con la extensión @file{.xml}. Si usa
+@uref{http://@/dblatex@/.sourceforge@/.net@/,dblatex}, creará un
+archivo PDF a partir de este documento automáticamente. Para la
+generación de HTML (HTML Help, JavaHelp, etc.) puede usar las hojas de
+estilo oficiales XSL de DocBook, aunque es posible que tenga que
+aplicarles algún tipo de personalización.
+
+
@node Music fragment options
@section Music fragment options
-UNTRANSLATED NODE: IGNORE ME
+Durante los próximos párrafos, una @q{instrucción de LilyPond} se
+refiere a cualquier instrucción descrita en las secciones anteriores
+que se maneja por parte de @command{lilypond-book} para que produzca
+un fragmento de música. Por simplicidad, las instrucciones de
+LilyPond solamente se muestran en la sintaxis de @LaTeX{}.
+
+Observe que la cadena de opciones se analiza de izquierda a derecha;
+si una opción aparece varias veces, se toma la última solamente.
+
+Están disponibles las siguientes opciones para las instrucciones de
+LilyPond:
+
+@table @code
+@item staffsize=@var{altura}
+Establecer la altura del pentagrama como @var{altura}, medida en
+puntos.
+
+@item ragged-right
+Producir líneas no justificadas por la derecha y con espaciado
+natural, es decir, se añade @code{ragged-right = ##t} al fragmento de
+LilyPond. Esta es la opción predeterminada para la instrucción
+@code{\lilypond@{@}} si no está presente la opción @code{line-width}.
+También es la opción predeterminada para el entorno @code{lilypond} si
+está establecida la opción @code{fragment}, y no se especifica la
+anchura de la línea explícitamente.
+
+@c does this option still exist in lilypond? -jm
+@item packed
+Producir líneas con el espaciado empaquetado, es decir, se añade
+@code{packed = ##t} al fragmento de código de LilyPond.
+
+@item line-width
+@itemx line-width=@var{tamaño}\@var{unidades}
+Establecer el ancho de línea como @var{tamaño}, utilizando
+@var{unidades} como unidad. @var{unidades} es una de las siguientes
+cadenas: @code{cm}, @code{mm}, @code{in} o @code{pt}. Esta opción
+afecta a la salida de LilyPond (esto es, a la longitud del pentagrama
+del fragmento musical), no al formato del texto.
+
+Si se usa sin ningún argumento, se establece el ancho de la línea a un
+valor predeterminado (calculado con un algoritmo heurístico).
+
+Si no se da ninguna opción @code{line-width}, @command{lilypond-book}
+trata de adivinar un valor predeterminado para los entornos
+@code{lilypond} que no usan la opción @code{ragged-right}.
+
+@item notime
+No imprimir la indicación de compás, y desactivar las indicaciones
+temporales de la música (armadura y líneas divisorias).
+
+@item fragment
+Hacer que @command{lilypond-book} añada algunos códigos necesarios
+para que podamos escribir simplemente, por ejemplo,
+
+@example
+c'4
+@end example
+
+@noindent
+sin @code{\layout}, @code{\score}, etc.
+
+@item nofragment
+No añadir escribir el código adicional que completa la sintaxis de
+LilyPond en los fragmentos de música. Al ser la opción
+predeterminada, @code{nofragment} normalmente es redundante.
+
+@item indent=@var{tamaño}\@var{unidades}
+Establecer el sangrado del primer sistema de pentagramas como
+@var{tamaño}, utilizando @var{unidades} como unidad. @var{unidades} es
+una de las siguientes cadenas: @code{cm}, @code{mm}, @code{in} o
+@code{pt}. Esta opción afecta a LilyPond, no al formato del texto.
+
+@item noindent
+Establecer el sangrado del primer sistema de la música como cero.
+Esta opción afecta a LilyPond, no al formato del texto. Puesto que el
+valor predeterminado es que no haya ningún sangrado, @code{noindent}
+normalmente es redundante.
+
+@item quote
+Reducir la longitud de la línea de un fragmento musical en
+@math{2*0.4}@dmn{in} (pulgadas) y colocar la salida dentro de un
+bloque de cita (quotation). El valor de @q{0.4@dmn{in}} se puede
+controlar con la opción @code{exampleindent}.
+
+@item exampleindent
+Establecer la longitud del sangrado que la opción @code{quote} aplica
+al fragmento musical.
+
+@item relative
+@itemx relative=@var{n}
+Usar el modo de octava relativa. De forma predeterminada, las notas
+se especifican con relación al Do@tie{}central. El argumento entero
+opcional especifica la octava de la nota inicial, donde el valor
+predeterminado @code{1} es el Do central.
+@end table
+
+LilyPond utiliza también @command{lilypond-book} para producir su
+propia documentación. Para hacerlo, están a nuestra disposición
+ciertas opciones algo esotéricas para los fragmentos musicales.
+
+@table @code
+@item verbatim
+El argumento de una instrucción de LilyPond se copia al archivo de
+salida y se incluye dentro de un bloque «verbatim» o preformateado,
+seguido del texto que se escriba con la opción @code{intertext} (que
+no funciona aún); después se imprime la música en sí. Esta opción no
+funciona bien con @code{\lilypond@{@}} si forma parte de un párrafo.
+
+Si se usa la opción @code{verbatim} dentro de una instrucción
+@code{lilypondfile}, es posible incluir con estilo preformateado sólo
+una parte del archivo fuente. Si el archivo de código fuente contiene
+un comentario que contiene @samp{begin verbatim} (sin las comillas),
+la cita del bloque de estilo preformateado empezará después de la
+última vez que aparezca este comentario; de forma similar, la cita del
+bloque preformateado se detendrá justo antes de la primera vez que
+aparezca un comentario que contenga @samp{end verbatim}, si lo hay.
+En el siguiente ejemplo de código fuente, la música se interpreta en
+el modo relativo, pero la cita preformateada no presentará el bloque
+@code{relative}, es decir
+
+@example
+\relative c' @{ % begin verbatim
+ c4 e2 g4
+ f2 e % end verbatim
+@}
+@end example
+
+@noindent
+se imprimirá como un bloque preformateado como
+
+@example
+ c4 e2 g4
+ f2 e
+@end example
+
+@item addversion
+(Sólo para la salida de Texinfo.) Anteponer la línea @code{\version
+@@w@{"@@version@{@}"@}} a la salida de @code{verbatim}.
+
+@item texidoc
+(Sólo para la salida de Texinfo.) Si se llama a @command{lilypond}
+con la opción @option{--header=@/texidoc}, y el archivo que se procesa
+se llama @file{fulanito@/.ly}, crea un archivo
+@file{fulanito@/.texidoc} si existe un campo @code{texidoc} dentro del
+bloque @code{\header} de cabecera. La opción @code{texidoc} hace que
+@command{lilypond-book} incluya estos archivos, añadiendo su contenido
+como un bloque de documentación inmediatamente antes del fragmento
+musical.
+
+Suponiendo que el archivo @file{fulanito@/.ly} contiene
+
+@example
+\header @{
+ texidoc = "Este archivo es un ejemplo de una sola nota."
+@}
+@{ c'4 @}
+@end example
+
+@noindent
+y que tenemos lo siguiente en nuestro documento de Texinfo
+@file{prueba.texinfo}
+
+@example
+@@lilypondfile[texidoc]@{fulanito.ly@}
+@end example
+
+@noindent
+la siguiente orden da como salida el resultado esperado:
+
+@example
+lilypond-book --process="lilypond --format=tex --tex \
+ --header=texidoc prueba.texinfo
+@end example
+
+La mayoría de los documentos de prueba de LilyPond (en el directorio
+@file{input} de la distribución) son pequeños archivos @file{.ly} que
+tienen exactamente este aspecto.
+
+@item lilyquote
+(Sólo para la salida de Texinfo.) Esta opción es similar a quote,
+pero se pone dentro del bloque de cita solamente el fragmento de
+música (y el bloque preformateado que se da en la opción
+@code{verbatim}). Esta opción es útil si queremos citar
+(@code{quote}) el fragmento musical pero no el bloque de documentación
+@code{texidoc}.
+
+@item printfilename
+Si un archivo de entrada de LilyPond se incluye con
+@code{\lilypondfile}, imprimir el nombre del archivo inmediatamente
+antes del fragmento musical. Para la salida HTML, esto es un enlace.
+Sólo se imprime el nombre base del archivo, es decir, se elimina la
+parte del directorio de la ruta del archivo.
+
+@item fontload
+Esta opción incluye las fuentes tipográficas en todos los archivos EPS
+generados para este fragmento. Se debe usar si el fragmento usa
+cualquier tipografía que LaTeX no es capaz de encontrar por sí solo.
+
+@end table
+
@node Invoking lilypond-book
@section Invoking @command{lilypond-book}
-UNTRANSLATED NODE: IGNORE ME
+@command{lilypond-book} produce un archivo con una de las siguientes
+extensiones: @file{.tex}, @file{.texi}, @file{.html} o @file{.xml},
+dependiendo del formato de salida. Todos los archivos @file{.tex},
+@file{.texi} y @file{.xml} necesitan un procesado posterior.
+
+@command{lilypond-book} también puede crear un archivo
+@file{.psfonts}, que se requiere por parte de @command{dvips} para
+producir archivos PostScript y PDF.
@subheading Format-specific instructions
+
@subsubheading @LaTeX{}
+
+Hay dos formas de procesar el documento en @LaTeX{} para su impresión
+o publicación: hacer un archivo PDF directamente con PDF@LaTeX{}, o
+generar un archivo PostScript con @LaTeX{} a través de un traductor de
+DVI a PostScript como @command{dvips}. la primera forma es más
+sencilla y es la que se recomienda@footnote{Observe que PDF@LaTeX{} y
+@LaTeX{} podrían no ser utilizables para compilar cualquier documento
+@LaTeX{}, y es por lo que explicamos las dos formas.}, y cualquiera
+que sea el método que utilice, podrá convertir fácilmente entre
+PostScript y PDF con herramientas como @command{ps2pdf} y
+@command{pdf2ps} que vienen incluidas con Ghostscript.
+
+Para producir un archivo PDF por medio de PDF@LaTeX{}, utilice
+
+@example
+lilypond-book --pdf miarchivo.pdftex
+pdflatex miarchivo.tex
+@end example
+
+@cindex tipografías de outline
+@cindex type1, tipografías
+@cindex dvips
+@cindex invocación de dvips
+
+Para producir una salida PDF por medio de
+@LaTeX{}/@command{dvips}/@command{ps2pdf}, debe hacer
+
+@example
+lilypond-book --psfonts miarchivo.lytex
+latex miarchivo.tex
+dvips -o -h miarchivo.psfonts -Ppdf miarchivo.dvi
+ps2pdf miarchivo.ps
+@end example
+
+@noindent
+El archivo @file{.dvi} creado por este proceso no contiene las cabezas
+de las notas. Esto es normal; si sigue las instrucciones, las cabezas
+aparecerán en los archivos @file{.ps} y @file{.pdf}.
+
+La ejecución de @command{dvips} dará como resultado algunas
+advertencias sobre las fuentes tipográficas; son inocuas y se pueden
+ignorar. Si está ejecutando @command{latex} en modo de dos columnas,
+recuerde añadir @code{-t landscape} a las opciones de @command{dvips}.
+
@subsubheading Texinfo
+
+Para producir un documento de Texinfo (en cualquier formato de
+salida), siga el procedimiento normal para Texinfo, esto es: o bien
+llame a @command{texi2pdf} o a @command{texi2dvi} o a
+@command{makeinfo}, según el formato de la salida que quiera crear.
+@ifinfo
+@xref{Format with texi2dvi, , , texinfo, GNU Texinfo}, y @ref{Creating
+an Info File, , , texinfo, GNU Texinfo}.
+@end ifinfo
+@ifnotinfo
+Consulte la documentación de Texinfo para ver más detalles.
+@end ifnotinfo
+
+
@subheading Command line options
+
+@command{lilypond-book} acepta las siguientes opciones de la línea de
+órdenes:
+
+@table @code
+@item -f @var{formato}
+@itemx --format=@var{formato}
+Especificar el tipo del documento que se va a procesar: @code{html},
+@code{latex}, @code{texi} (predeterminado) o @code{docbook}. Si falta
+esta opción, @command{lilypond-book} tratará de detectar el formato
+automáticamente, véase @ref{Filename extensions}. Por el momento,
+@code{texi} es lo mismo que @code{texi-html}.
+
+@c This complicated detail is not implemented, comment it out -jm
+@ignore
+The @code{texi} document type produces a Texinfo file with music
+fragments in the printed output only. For getting images in the HTML
+version, the format @code{texi-html} must be used instead.
+@end ignore
+
+@item -F @var{filtro}
+@itemx --filter=@var{filtro}
+Conducir los fragmentos a través de @var{filter} por medio de una
+tubería. @code{lilypond-book} no obedecerá --filter y --process al
+mismo tiempo. Por ejemplo,
+
+@example
+lilypond-book --filter='convert-ly --from=2.0.0 -' mi-libro.tely
+@end example
+
+@item -h
+@itemx --help
+Imprimir un breve mensaje de ayuda.
+
+@item -I @var{directorio}
+@itemx --include=@var{directorio}
+Añadir @var{directorio} a la ruta de inclusión.
+@command{lilypond-book} busca también los fragmentos ya compilados en
+la ruta de inclusión, y no los vuelve a escribir en el directorio de
+salida, así que en ciertos casos es necesario invocar instrucciones de
+procesado posteriores como @command{makeinfo} o @command{latex} con
+las mismas opciones @code{-I @var{directorio}}.
+
+@item -o @var{directorio}
+@itemx --output=@var{directorio}
+Colocar los archivos generados en el @var{directorio}. La ejecución
+de @command{lilypond-book} genera montañas de pequeños archivos que
+luego procesará LilyPond. Para evitar toda esta parafernalia en el
+mismo directorio que la fuente, utilice la opción @option{--output}, y
+cambie a este directorio antes de ejecutar @command{latex} o
+@command{makeinfo}.
+
+@example
+lilypond-book --output=out miarchivo.lytex
+cd out
+...
+@end example
+
+@itemx --left-padding=@var{cantidad}
+Rellenar las cajas EPS en esta medida, alrededor. @var{cantidad} se
+mide en milímetros, y es 3.0 como valor predeterminado. Esta opción
+se debe usar si las líneas de música están muy pegadas al margen
+derecho.
+
+El ancho de los sistemas que están muy ajustados dentro de su
+rectángulo puede variar, debido a los elementos de notación que están
+pegados al margen izquierdo, como los números de compás y el nombre
+del instrumento. Esta opción acorta todas las líneas y las mueve a la
+derecha en la misma medida.
+
+
+@item -P @var{proceso}
+@itemx --process=@var{instrucción}
+Procesar los fragmentos de LilyPond utilizando @var{instrucción}. La
+instrucción predeterminada es @code{lilypond}. @code{lilypond-book} no
+obedecerá a @code{--filter} y a @code{--process} al mismo tiempo.
+
+@item --pdf
+Crear archivos PDF para su uso con PDFLaTeX.
+
+@itemx --psfonts
+Extraer todas las tipografías PostScript en
+@file{@var{archivo}.psfonts} para dvips. Esto es necesario para
+@command{dvips -h @var{archivo}.psfonts}.
+
+@item -V
+@itemx --verbose
+Ser prolijo.
+
+@item -v
+@itemx --version
+Imprimir la información de la versión.
+@end table
+
+@knownissues
+
+La instrucción de Texinfo @code{@@pagesizes} no se interpreta. De
+forma similar, las instrucciones de @LaTeX{} que cambian los márgenes
+y anchos de línea después del preámbulo se ignoran.
+
+Sólo se procesa el primer @code{\score} de un bloque LilyPond.
+
+
@node Filename extensions
@section Filename extensions
-UNTRANSLATED NODE: IGNORE ME
+Puede usar cualquier extensión para el nombre del archivo de entrada,
+pero si no usa la extensión recomendada para un formato en particular
+tendrá que especificar manualmente el formato de salida; para ver más
+detalles, consulte @ref{Invoking lilypond-book}. En caso contrario,
+@command{lilypond-book} selecciona automáticamente el formato de
+salida basándose en la extensión del nombre del archivo de entrada.
+
+@quotation
+@multitable @columnfractions .2 .5
+@item @strong{extensión} @tab @strong{formato de salida}
+@item
+@item @file{.html} @tab HTML
+@item @file{.itely} @tab Texinfo
+@item @file{.latex} @tab @LaTeX{}
+@item @file{.lytex} @tab @LaTeX{}
+@item @file{.lyxml} @tab DocBook
+@item @file{.tely} @tab Texinfo
+@item @file{.tex} @tab @LaTeX{}
+@item @file{.texi} @tab Texinfo
+@item @file{.texinfo} @tab Texinfo
+@item @file{.xml} @tab HTML
+@end multitable
+@end quotation
+
+Si usa la misma extensión para el archivo de entrada que la que usa
+@command{lilypond-book} para el archivo de salida, y si el archivo de
+entrada está en el mismo directorio que el directorio de trabajo de
+@command{lilypond-book}, debe usar la opción @code{--output} para que
+funcione @command{lilypond-book}, pues en caso contrario saldrá con un
+mensaje de error como @qq{La salida sobreescribirá al archivo de
+entrada}.
+
@node Alternate methods of mixing text and music
@section Alternative methods of mixing text and music
-UNTRANSLATED NODE: IGNORE ME
+Esta sección presenta métodos para integrar texto y música distintos
+del método automatizado con @command{lilypond-book}.
+
+@menu
+* Many quotes from a large score::
+* Inserting LilyPond output into OpenOffice.org::
+* Inserting LilyPond output into other programs::
+@end menu
-@menu
-* Many quotes from a large score::
-* Inserting LilyPond output into OpenOffice.org::
-* Inserting LilyPond output into other programs::
-@end menu
@node Many quotes from a large score
@subsection Many quotes from a large score
-UNTRANSLATED NODE: IGNORE ME
+Si tiene que citar muchos fragmentos extraídos de una partitura grade,
+puede también usar la capacidad de recorte de sistemas, véase
+@ruser{Extracting fragments of notation}.
+
@node Inserting LilyPond output into OpenOffice.org
@subsection Inserting LilyPond output into OpenOffice.org
-UNTRANSLATED NODE: IGNORE ME
+@cindex OpenOffice.org
+
+Se puede añadir notación de LilyPond a los documentos de
+OpenOffice.org con
+@uref{http://@/ooolilypond@/.sourceforge@/.net@/,OOoLilyPond}.
+
@node Inserting LilyPond output into other programs
@subsection Inserting LilyPond output into other programs
-UNTRANSLATED NODE: IGNORE ME
+Para insertar la salida de LilyPond dentro de otros programas, use
+@code{lilypond} en vez de @code{lilypond-book}. Cada ejemplo debe
+crearse individualmente y añadirse al documento; consulte la
+documentación del programa correspondiente. La mayoría de los
+programas podrán insertar la salida de LilyPond en los formatos
+@file{PNG}, @file{EPS} o @file{PDF}.
+
+Para reducir el espacio vacío alrededor de la partitura de LilyPond,
+utilice las siguientes opciones:
+
+@example
+\paper@{
+ indent=0\mm
+ line-width=120\mm
+ oddFooterMarkup=##f
+ oddHeaderMarkup=##f
+ bookTitleMarkup = ##f
+ scoreTitleMarkup = ##f
+@}
+
+@{ c1 @}
+@end example
+
+Para obtener un archivo EPS que sea útil, utilice
+@example
+lilypond -dbackend=eps -dno-gs-load-fonts -dinclude-eps-fonts miarchivo.ly
+@end example
--- SKELETON FILE --
-When you actually translate this file, please remove these lines as
-well as all `UNTRANSLATED NODE: IGNORE ME' lines.
\input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
@ignore
- Translation of GIT committish: aae416a0211bad0bbed5c82b91d80a83d21e8054
+ Translation of GIT committish: 0184e537d7eda6265b92fe20f3565de0f0411869
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
\input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
@ignore
- Translation of GIT committish: 993fc5189dc039afd51a98df9b71adf59f2ab20f
+ Translation of GIT committish: 0184e537d7eda6265b92fe20f3565de0f0411869
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
\input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
@ignore
- Translation of GIT committish: ef9e465a87b15c4fab12e08337a40b9afe1d3766
+ Translation of GIT committish: 0184e537d7eda6265b92fe20f3565de0f0411869
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Literature list
@appendix Literature list
@c -*- coding: utf-8; mode: texinfo; -*-
@ignore
- Translation of GIT committish: 9cbbaed46b1d551db77c37566ae23a4a5a44b5e4
+ Translation of GIT committish: d0333749421c9695907a4da61a6e1cd7eafcb726
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@c ***** Displaying text *****
@c we need this since @q{\} doesn't work with makeinfo 4.8 --
-@c say @q{@value{backslash}} instead
-@set backslash \
+@c say @q{@bs{}} instead
+@macro bs
+\\
+@end macro
@c to get decent quotes in `foo' and ``foo''
@macro q{TEXT}
@macro internalsref{TEXT}
@vindex \TEXT\
-@ref{\TEXT\,,,lilypond-internals-big-page}
+@ref{\TEXT\,,,lilypond-internals-big-page,Referencia de Funcionamiento Interno}
@end macro
@macro rglos{TEXT}
@vindex \TEXT\
-@ref{\TEXT\,,,music-glossary-big-page}
+@ref{\TEXT\,,,music-glossary-big-page,Glosario Musical}
@end macro
@macro rprogram{TEXT}
@vindex \TEXT\
-@ref{\TEXT\,,,lilypond-program-big-page}
+@ref{\TEXT\,,,lilypond-program-big-page,Utilización del Programa}
@end macro
@macro ruser{TEXT}
@vindex \TEXT\
-@ref{\TEXT\,,,lilypond-big-page}
+@ref{\TEXT\,,,lilypond-big-page,Referencia de la Notación}
@end macro
@macro rlearning{TEXT}
@vindex \TEXT\
-@ref{\TEXT\,,,lilypond-learning-big-page}
+@ref{\TEXT\,,,lilypond-learning-big-page,Manual de Aprendizaje}
+@end macro
+
+@macro rlsr{TEXT}
+@ref{\TEXT\,,,lilypond-snippets-big-page,Fragmentos de código}
@end macro
@end ifset
@macro internalsref{TEXT}
@vindex \TEXT\
-@ref{\TEXT\,,,lilypond-internals}
+@ref{\TEXT\,,,lilypond-internals,Referencia de Funcionamiento Interno}
@end macro
@macro rglos{TEXT}
@vindex \TEXT\
-@ref{\TEXT\,,,music-glossary}
+@ref{\TEXT\,,,music-glossary,Glosario Musical}
@end macro
@macro rprogram{TEXT}
@vindex \TEXT\
-@ref{\TEXT\,,,lilypond-program}
+@ref{\TEXT\,,,lilypond-program,Utilización del Programa}
@end macro
@macro ruser{TEXT}
@vindex \TEXT\
-@ref{\TEXT\,,,lilypond}
+@ref{\TEXT\,,,lilypond,Referencia de la Notación}
@end macro
@macro rlearning{TEXT}
@vindex \TEXT\
-@ref{\TEXT\,,,lilypond-learning}
+@ref{\TEXT\,,,lilypond-learning,Manual de Aprendizaje}
+@end macro
+
+@macro rlsr{TEXT}
+@ref{\TEXT\,,,lilypond-snippets,Fragmentos de código}
@end macro
@end ifclear
@macro internalsref{TEXT}
@vindex \TEXT\
-@ref{\TEXT\,,,lilypond-internals}
+@ref{\TEXT\,,,lilypond-internals,Referencia de Funcionamiento Interno}
@end macro
@macro rglos{TEXT}
@vindex \TEXT\
-@ref{\TEXT\,,,music-glossary}
+@ref{\TEXT\,,,music-glossary,Glosario Musical}
@end macro
@macro rprogram{TEXT}
@vindex \TEXT\
-@ref{\TEXT\,,,lilypond-program}
+@ref{\TEXT\,,,lilypond-program,Utilización del Programa}
@end macro
@macro ruser{TEXT}
@vindex \TEXT\
-@ref{\TEXT\,,,lilypond}
+@ref{\TEXT\,,,lilypond,Referencia de la Notación}
@end macro
@macro rlearning{TEXT}
@vindex \TEXT\
-@ref{\TEXT\,,,lilypond-learning}
+@ref{\TEXT\,,,lilypond-learning,Manual de Aprendizaje}
@end macro
+@macro rlsr{TEXT}
+@ref{\TEXT\,,,lilypond-snippets,Fragmentos de código}
+@end macro
+
+
+
@end ifdocbook
@macro internalsref{TEXT}
@vindex \TEXT\
-@inforef{\TEXT\,,lilypond-internals}
+@inforef{\TEXT\,,lilypond-internals,Referencia de Funcionamiento Interno}
@end macro
@macro rglos{TEXT}
@vindex \TEXT\
-@inforef{\TEXT\,,music-glossary}
+@inforef{\TEXT\,,music-glossary,Glosario Musical}
@end macro
@macro rprogram{TEXT}
@vindex \TEXT\
-@ref{\TEXT\,,,lilypond-program}
+@ref{\TEXT\,,,lilypond-program,Utilización del Programa}
@end macro
@macro ruser{TEXT}
@vindex \TEXT\
-@ref{\TEXT\,,,lilypond}
+@ref{\TEXT\,,,lilypond,Referencia de la Notación}
@end macro
@macro rlearning{TEXT}
@vindex \TEXT\
-@ref{\TEXT\,,,lilypond-learning}
+@ref{\TEXT\,,,lilypond-learning,Manual de Aprendizaje}
@end macro
+@macro rlsr{TEXT}
+@ref{\TEXT\,,,lilypond-snippets,Fragmentos de código}
+@end macro
+
+
+
@end ifinfo
@macro rglos {TEXT}
@vindex \TEXT\
-@ref{\TEXT\,,,music-glossary}
+@ref{\TEXT\,,,music-glossary,Glosario Musical}
@end macro
@macro rprogram{TEXT}
-el manual de utilización del programa, @ref{\TEXT\,,,lilypond-program.es}
+el manual de utilización del programa, @ref{\TEXT\,,,lilypond-program.es,Utilización del Programa}
@c @internalsref{\TEXT\}
@end macro
@macro ruser{TEXT}
-el manual de referencia de la notación, @ref{\TEXT\,,,lilypond.es}
+el manual de referencia de la notación, @ref{\TEXT\,,,lilypond.es,Referencia de la Notación}
@c @internalsref{\TEXT\}
@end macro
@macro rlearning{TEXT}
-el manual de aprendizaje, @ref{\TEXT\,,,lilypond-learning.es}
+el manual de aprendizaje, @ref{\TEXT\,,,lilypond-learning.es,Manual de Aprendizaje}
@c @internalsref{\TEXT\}
@end macro
+@macro rlsr{TEXT}
+@ref{\TEXT\,,,lilypond-snippets,Fragmentos de código}
+@end macro
+
+
+
@end iftex
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c A menu is needed before every deeper *section nesting of @node's; run
@c M-x texinfo-all-menus-update
@c to automatically fill in these menus before saving changes
@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: 8dc2dfbc1a56529781640f968f836b7ec1e314aa
+ Translation of GIT committish: da006143c0f2d621c51a0f1892ee25d4257b1eb3
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.38"
+
@node Notation manual tables
@appendix Notation manual tables
* Overview of text markup commands::
* Overview of text markup list commands::
* List of articulations::
+* All context properties::
+* Layout properties::
+* Identifiers::
+* Scheme functions::
@end menu
La sintaxis para el uso de colores se encuentra detallada en @ref{Coloring objects}.
-@cindex Lista de colores
-@cindex Colores, lista de
+@cindex lista de colores
+@cindex colores, lista de
@verbatim
black white red green
@appendixsec The Feta font
@cindex Feta, tipografía
-@cindex Tipografía Feta
+@cindex tipografía Feta
Los símbolos siguientes están disponibles en la tipografía Emmentaler y es posible acceder a ellos
directamente utilizando elementos de marcado textual como @code{g^\markup @{
@node Overview of text markup commands
@appendixsec Overview of text markup commands
-Todas las siguientes órdenes se pueden usar dentro de @code{\markup @{ @}}.
+Todas las instrucciones siguientes se pueden usar dentro de @code{\markup @{ @}}.
@include markup-commands.tely
@node Overview of text markup list commands
@appendixsec Overview of text markup list commands
-Todos las siguientes instrucciones se puede utilizar con @code{\markuplines}.
+Todas las instrucciones siguientes se pueden utilizar con @code{\markuplines}.
@include markup-list-commands.tely
@node List of articulations
@appendixsec List of articulations
+@cindex accent
@cindex acento
-@cindex marcato
-@cindex staccatissimo
-@cindex espressivo
-@cindex fermata
-@cindex calderón
@cindex apagado
-@cindex staccato
-@cindex portato
-@cindex tenuto
-@cindex arco arriba
@cindex arco abajo
-@cindex pedal, indicaciones de
-@cindex órgano, indicaciones de pedal de
-@cindex grupeto circular
-@cindex open
+@cindex arco arriba
+@cindex calderón
+@cindex coda
+@cindex downbow
+@cindex espressivo
+@cindex fermata
@cindex flageolet
+@cindex foot marks
+@cindex grupeto circular
@cindex grupeto circular invertido
-@cindex trino
+@cindex marcato
+@cindex mordent
+@cindex open
+@cindex organ pedal marks
+@cindex pedal, indicaciones de
+@cindex portato
+@cindex prall
+@cindex prallmordent
+@cindex prallprall
+@cindex reverseturn
+@cindex segno
@cindex semitrino
@cindex semitrino descendente
-@cindex prallprall
-@cindex prallmordent
-@cindex prall, up
-@cindex prall, down
+@cindex staccatissimo
+@cindex staccato
+@cindex stopped
+@cindex tenuto
@cindex thumb marking
-@cindex segno
-@cindex coda
+@cindex trill
+@cindex trino
+@cindex turn
+@cindex upbow
@cindex varcoda
+@cindex órgano, indicaciones de pedal de
He aquí un cuadro que muestra todas las articulaciones disponibles:
@lilypondfile[ragged-right,quote]{script-chart.ly}
+
+
+@node All context properties
+@appendixsec All context properties
+
+@include context-properties.tely
+
+
+@node Layout properties
+@appendixsec Layout properties
+
+@include layout-properties.tely
+
+
+@node Identifiers
+@appendixsec Identifiers
+
+@include identifiers.tely
+
+
+@node Scheme functions
+@appendixsec Scheme functions
+
+@include scheme-functions.tely
+
@c -*- coding: utf-8; mode: texinfo; -*-
@ignore
- Translation of GIT committish: 1859194a9f46a8886166cafee0e450b39fc5a963
+ Translation of GIT committish: 0184e537d7eda6265b92fe20f3565de0f0411869
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.38"
+
@node Musical notation
@chapter Musical notation
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Percussion
@section Percussion
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Piano music
@section Piano music
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Pitches
@section Pitches
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Preface
@unnumbered Preface
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Interfaces for programmers
@chapter Interfaces for programmers
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Putting it all together
@chapter Putting it all together
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Repeats
@section Repeats
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Rhythms
@section Rhythms
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Running LilyPond
@chapter Running LilyPond
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of lilypond-learning.tely
@ignore
- Translation of GIT committish: 442e889ce5bd4f250270b992a1b105ed7fc078db
+ Translation of GIT committish: 03184badb3c2378e1ab3eec6ee62a6bdc0609082
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.38"
+
@node Scheme tutorial
@appendix Scheme tutorial
En un archivo de música, los fragmentos de código de Scheme se
-esecriben con el signo de almohadilla @code{#}. Así, los ejemplos
+escriben con el signo de almohadilla @code{#}. Así, los ejemplos
anteriores traducidos a LilyPond son:
@example
\override Stem #'thickness = #2.6
@end example
-Esta isntrucción ajusta el aspecto de las plicas. El valor @code{2.6}
+Esta instrucción ajusta el aspecto de las plicas. El valor @code{2.6}
se pone dentro de la variable @code{thickness} de un objeto
@code{Stem}. @code{thickness} se mide a partir del grosor de las
líneas del pentagrama, y así estas plicas serán @code{2.6} veces el
grosor de las líneas del pentagrama. Esto hace que las plicas sean
-casi el doble de gruesas de lo normal. Para distinguir entr las
+casi el doble de gruesas de lo normal. Para distinguir entre las
variables que se definen en los archivos de entrada (como
@code{veintiCuatro} en el ejemplo anterior) y las variables de los
objetos internos, llamaremos a las últimas @q{propiedades} y a las
derecho) se introducen como @code{parejas}. Una pareja@footnote{En la
terminología de Scheme, la pareja se llama @code{cons}, y sus dos
elementos se llaman @code{car} y @code{cdr} respectivamente.} se
-introduce como @code{(first . second)} y, como los símbolos, se deben
-preceder de un apóstrofe,
+introduce como @code{(primero . segundo)} y, como los símbolos, se deben
+preceder de un apóstrofe:
@example
\override TextScript #'extra-offset = #'(1 . 2)
Esto asigna la pareja (1, 2) a la propiedad @code{extra-offset} del
objeto TextScript. Estos números se miden en espacios de pentagrama,
y así esta instrucción mueve el objeto un espacio de pentagrama a la
-derecha, y dos especios hacia arriba.
+derecha, y dos espacios hacia arriba.
Los dos elementos de una pareja pueden ser valores arbitrarios, por
ejemplo
profundamente usando instrucciones como @code{\override TextScript
#'extra-offset = ( 1 . -1)}. Pero tenemos incluso mucho más poder si
utilizamos Scheme. Para ver una explicación completa de esto,
-consulteel @ref{Scheme tutorial}, y @ruser{Interfaces for
+consulte el @ref{Scheme tutorial}, y @ruser{Interfaces for
programmers}.
Podemos usar Scheme simplemente para sobreescribir instrucciones con
@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond-program.tely
@ignore
- Translation of GIT committish: 35ad19e0e1bcd393d45de90abe1295c16e91190b
+ Translation of GIT committish: b9526773cf95ca29e3d3352c524718fc8e91c599
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.38"
+
@node Setup
@chapter Setup
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Simultaneous notes
@section Simultaneous notes
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Spacing issues
@chapter Spacing issues
@c -*- coding: utf-8; mode: texinfo; -*-
@ignore
- Translation of GIT committish: 1859194a9f46a8886166cafee0e450b39fc5a963
+ Translation of GIT committish: b9526773cf95ca29e3d3352c524718fc8e91c599
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.38"
+
@node Specialist notation
@chapter Specialist notation
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Staff notation
@section Staff notation
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Orchestral strings
@section Orchestral strings
@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: dbf68329a9829ba9f9eae3c1e058c38518b5eed7
+ Translation of GIT committish: 7cc6b12897031c450e3399d59cdb22ca9df4fd8c
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.38"
+
@node Templates
@appendix Templates
* Vocal ensembles::
* Ancient notation templates::
* Jazz combo::
-* Lilypond-book templates::
+* lilypond-book templates::
@end menu
@end ignore
-@node Lilypond-book templates
-@appendixsec Lilypond-book templates
+@node lilypond-book templates
+@appendixsec lilypond-book templates
Estas plantillas se usan para @code{lilypond-book}. Si no está familiarizado con este
-programa, consulte @rprogram{LilyPond-book}.
+programa, consulte @rprogram{lilypond-book}.
@appendixsubsec LaTeX
@@bye
@end example
+
+@appendixsubsec xelatex
+
+@verbatim
+\documentclass{article}
+\usepackage{ifxetex}
+\ifxetex
+%xetex specific stuff
+\usepackage{xunicode,fontspec,xltxtra}
+\setmainfont[Numbers=OldStyle]{Times New Roman}
+\setsansfont{Arial}
+\else
+%Esto puede estar en blanco si no vamos a usar pdftex
+\usepackage[T1]{fontenc}
+\usepackage[utf8]{inputenc}
+\usepackage{mathptmx}%Times
+\usepackage{helvet}%Helvetica
+\fi
+%Aquí podemos insertar todos los paquetes que pdftex también entiende
+\usepackage[spanish,ngerman,finnish,english]{babel}
+\usepackage{graphicx}
+
+\begin{document}
+\title{Un breve documento con LilyPond y xelatex}
+\maketitle
+
+Las instrucciones \textbf{font} normales dentro del \emph{text}
+funcionan, porque \textsf{están contempladas por \LaTeX{} y XeteX.}
+Si quiere usar instrucciones específicas como \verb+\XeTeX+, debe
+incluirlas también dentro de un entorno \verb+\ifxetex+. Puede usar
+esto para imprimir la instrucción \ifxetex \XeTeX{} \else XeTeX \fi
+que no es conocida para el \LaTeX normal.
+
+Dentro del texto normal puede usar fácilmente instrucciones de
+LilyPond, como ésta:
+
+\begin{lilypond}
+{a2 b c'8 c' c' c'}
+\end{lilypond}
+
+\noindent
+etcétera.
+
+Las tipografías de los fragmentos establecidas con LilyPond se tendrán
+que ajustar desde dentro del fragmento. Para esto debe leer el manual
+UA en cuanto a cómo usar lilypond-book.
+
+\selectlanguage{ngerman}
+Auch Umlaute funktionieren ohne die \LaTeX -Befehle, wie auch alle
+anderen
+seltsamen Zeichen: __ ______, wenn sie von der Schriftart
+unterst__tzt werden.
+\end{document}
+@end verbatim
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Text
@section Text
@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: 8847716091a1785f02bdc92554610478ca1e7c6e
+ Translation of GIT committish: d0333749421c9695907a4da61a6e1cd7eafcb726
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.38"
+
@ignore
Tutorial guidelines: (different from policy.txt!)
- unless you have a really good reason, use either
@subsection Compiling a file
@qq{Compilación} es una palabra que significa procesar un texto de
-entrada eb formato de LilyPond para producir un archivo que se puede
+entrada en formato de LilyPond para producir un archivo que se puede
imprimir y (de manera opcional) un archivo MIDI que se puede
reproducir. El primer ejemplo muestra el aspecto de un sencillo
archivo de texto de entrada.
@end example
@noindent
-el resultado tiene este aspecto
+el resultado tiene este aspecto:
@c in this case we don't want verbatim
@lilypond[quote,ragged-right]
}
@end lilypond
-@warning{La música y la letra escrita en el código de entrada de
+@warning{la música y la letra escrita en el código de entrada de
LilyPond tiene que ir siempre entre @strong{@{ llaves @}}. Las llaves
deberían también estar rodeadas por espacios a no ser que se
encuentren al principio o al final de una línea, para evitar
ambigüedades. Es posible que se omitan en algunos ejemplos del
-presente manual ¡pero no las omita en su propia música! Paara ver más
+presente manual ¡pero no las omita en su propia música! Para ver más
información sobre la presentación de los ejemplos del manual, consulte
@ref{How to read the manual}.}
-@cindex Sensible a las mayúsculas
-Además la entrada de LilyPond es @strong{sensible a las mayúsculas}. @code{ @{ c d e @}}
-es una entrada válida; @code{@{ C D E @}} producirá un mensaje de error.
+@cindex sensible a las mayúsculas
+Además la entrada de LilyPond es @strong{sensible a las mayúsculas}.
+@code{ @{ c d e @}} es una entrada válida; @code{@{ C D E @}}
+producirá un mensaje de error.
@smallspace
con un mejor apoyo a la edición de texto de LilyPond. Para ver más
información, consulte @rprogram{Text editor support}.
-@warning{La primera vez que ejecute LilyPond, tardará un minuto o dos
+@warning{la primera vez que ejecute LilyPond, tardará un minuto o dos
porque todas las tipografías del sistema han de ser analizadas
previamente. ¡Después de esto, LilyPond será mucho más rápido!}
archivo. Si se produce algún error, examine este archivo de registro.
-@subsubheading Unix
+@subsubheading UNIX
Cree un archivo de texto con el nombre @file{prueba.ly} y escriba en él:
Un comentario de bloque marca una sección entera de entrada musical
como comentario. Todo lo que está encerrado dentro de @code{%@{} y
@code{%@}} se ignora (pero los comentarios no pueden anidarse, lo que
-signnifica que un comentario de bloque no puede incluir otros
+significa que un comentario de bloque no puede incluir otros
comentarios de bloque). Si lo hiciera, el primer @code{%@}} daría por
terminado @emph{los dos} comentarios de bloque. El siguiente
fragmento muestra algunos posibles usos para los comentarios:
@quotation
@table @asis
@item Alteraciones accidentales
-ver @ruser{Accidentals} y @ruser{Automatic accidentals}.
+véase @ruser{Accidentals} y @ruser{Automatic accidentals}.
@item Armadura de la tonalidad
-ver @ruser{Key signature}.
+véase @ruser{Key signature}.
@end table
@end quotation
@cindex ligaduras de unión
@subheading Ties
-Una @rglos{tie} se crea adjuntando un carácter tilde @samp{~} a la primera
-nota ligada
+Una @rglos{tie} se crea adjuntando un carácter de tilde curva @samp{~} a la primera
+nota ligada:
@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
g4~ g c2~
@quotation
@table @asis
@item Ligaduras de unión
-ver @ruser{Ties}.
+véase @ruser{Ties}.
@item Ligaduras de expresión
-ver @ruser{Slurs}.
+véase @ruser{Slurs}.
@item Ligaduras de fraseo
-ver @ruser{Phrasing slurs}.
+véase @ruser{Phrasing slurs}.
@end table
@end quotation
@quotation
@table @asis
@item Articulaciones
-ver @ruser{Articulations}.
+véase @ruser{Articulations}.
@item Digitaciones
-ver @ruser{Fingering instructions}.
+véase @ruser{Fingering instructions}.
@item Matices
-ver @ruser{Dynamics}.
+véase @ruser{Dynamics}.
@end table
@end quotation
@quotation
@table @asis
@item Barras automáticas
-ver @ruser{Automatic beams}.
+véase @ruser{Automatic beams}.
@item Barras manuales
-ver @ruser{Manual beams}.
+véase @ruser{Manual beams}.
@end table
@end quotation
@subsection Advanced rhythmic commands
@cindex anacrusa
-@c @cindex anacruse @c redundant, in spanish. FVD
@cindex compás parcial
@subheading Partial measure
@quotation
@table @asis
@item Notas de adorno
-ver @ruser{Grace notes},
+véase @ruser{Grace notes},
@item Grupos especiales
-ver @ruser{Tuplets},
+véase @ruser{Tuplets},
@item Anacrusas
-ver @ruser{Partial measures}.
+véase @ruser{Partial measures}.
@end table
@end quotation
@subheading Simultaneous music expressions: multiple staves
+Glosario musical: @rglos{polyphony}.
+
Esta técnica es muy útil para la música polifónica. Para introducir música
con más voces o con más pentagramas, lo que hacemos es combinar varias expresiones en
paralelo. Para indicar que dos voces se deben interpretar al mismo tiempo,
al comienzo de una línea, pero el establecimiento de márgenes distintos dentro del código de LilyPond, de esta forma, lo
hace mucho más fácil de leer por nosotros los seres humanos.
-@strong{Advertencia}: cada nota se entiende relativa a la
-nota anterior de la entrada, no relativa a la @code{c''} dentro de la
-instrucción inicial @code{\relative}.
+@warning{cada nota se entiende relativa a la nota anterior de la
+entrada, no relativa a la @code{c''} dentro de la instrucción inicial
+@code{@bs{}\relative}.}
@subheading Simultaneous music expressions: single staff
@seealso
@quotation
-Ver @ruser{Basic polyphony}.
+Véase @ruser{Basic polyphony}.
@end quotation
@noindent
pero cualquier partitura de una complejidad mayor que la de este
-sencillo ejemplo se hace mejor separando la latra de la estructura de
+sencillo ejemplo se hace mejor separando la letra de la estructura de
pentagramas mediante variables (expresiones con nombre). Éstas se
tratan en @ref{Organizing pieces with variables}.
}
@end lilypond
-Las variabbles se pueden usar para otros muchos tipos de objetos
+Las variables se pueden usar para otros muchos tipos de objetos
dentro del código de entrada. Por ejemplo,
@example
-width = 4.5\cm
-name = "Wendy"
-aFivePaper = \paper @{ paperheight = 21.0 \cm @}
+ancho = 4.5\cm
+nombre = "Wendy"
+papelAcinco = \paper @{ paperheight = 21.0 \cm @}
@end example
Dependiendo de su contenido, la variable se puede usar en distintos
@example
\paper @{
- \aFivePaper
- line-width = \width
+ \papelAcinco
+ line-width = \ancho
@}
-@{ c4^\name @}
+@{ c4^\nombre @}
@end example
@example
\version @w{"@version{}"}
\header @{
- title = "Symphony"
- composer = "Me"
+ title = "Sinfonía"
+ composer = "Yo"
opus = "Op. 9"
@}
@{
- @dots{} music @dots{}
+ @dots{} música @dots{}
@}
@end example
@subsection After the tutorial
Después de terminar el tutorial, quizá debería probar a escribir una o
-dos piezas. Comience con una de las @ref{Templates} y añada algunas
+dos piezas. Comience con una de las plantillas del @ref{Templates} y añada algunas
notas. Si necesita un tipo de notación que no ha sido tratada en el
tutorial, eche un vistazo a la Referencia de Notación, empezando por
@ruser{Basic notation}. Si quiere escribir música para un conjunto
@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: 13290c3922962e4538d3acaf1f7abe14fce6bbff
+ Translation of GIT committish: 7cc6b12897031c450e3399d59cdb22ca9df4fd8c
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.38"
+
@node Tweaking output
@chapter Tweaking output
@menu
* Tweaking basics::
* The Internals Reference manual::
-* Moving objects::
-* Fixing overlapping notation::
-* Common tweaks::
-* Default files::
-* Fitting music onto fewer pages::
-* Advanced tweaks with Scheme::
-* Avoiding tweaks with slower processing::
+* Appearance of objects::
+* Placement of objects::
+* Collisions of objects::
+* Further tweaking::
@end menu
@node Tweaking basics
las propiedades asociadas con ese pentagrama en particular, por
ejemplo, su nombre y su armadura, además de otros detalles de los
grabadores que se han asignado para que operen dentro del contexto del
-pentagrama. De forma similar, hay objetos que guardan las propieades
+pentagrama. De forma similar, hay objetos que guardan las propiedades
de todos los demás contextos, como objetos de @code{Voice}, objetos de
@code{Score}, objetos de @code{Lyrics}, así como objetos que
representan todos los elementos notacionales como líneas divisorias,
gráficos tienen un color, un tamaño, una posición, etc., y todas estas
propiedades se procesan de la misma forma durante la interpretación
del archivo de entrada por parte de LilyPond. Para simplificar estas
-operaciones internas, estas acciones t propiedades comunes se agrupan
+operaciones internas, estas acciones y propiedades comunes se agrupan
en un objeto llamado @code{grob-interface}, interface de grob. Hay
muchas otras agrupaciones de propiedades comunes como ésta, y cada
-unoa recibe un nombre que acaba en @code{interface}. En total hay más
+una recibe un nombre que acaba en @code{interface}. En total hay más
de 100 interfaces de éstos. Veremos más adelante porqué esto es del
interés y de utilidad para el usuario.
@tab Clef_engraver, Note_heads_engraver
@item Interfaces
@tab aaa-aaa-interface
- @tab grob-interface, break-aligned-interface
+ @tab grob-interface, break-aligned-interface
@item Propiedades de contextos
@tab aaa o aaaAaaaAaaa
@tab alignAboveContext, skipBars
La sintaxis genérica de esta instrucción es:
@example
-\override @emph{contexto}.@emph{objeto_de_presentación}
+\override @emph{contexto}.@emph{objeto_de_presentación}
#'@emph{propiedad_de_presentación} = #@emph{valor}
@end example
Las últimas secciones tratan de forma exhaustiva las propiedades y sus
valores, pero para ilustrar el formato y utilización de estas
-iinstrucciones usaremos sólo unas cuantas propiedades y valores
+instrucciones usaremos sólo unas cuantas propiedades y valores
sencillos que sean fáciles de entender.
Por ahora no se preocupe por el @code{#'}, que debe anteponerse a la
@cindex revert, instrucción
@funindex \revert
-Una vez sobreescrita, la proopiedad retiene su nuevo valor hasta que
+Una vez sobreescrita, la propiedad retiene su nuevo valor hasta que
se sobreescribe de nuevo o se encuentra una instrucción
@code{\revert}. La instrucción @code{\revert} tiene la siguiente
sintaxis y ocasiona que el valor de la propiedad se devuelva a su
Vemos que la sobreescritura con override afecta a @emph{todas} las
notas del acorde. Esto es así porque todas las notas de un acorde
ocurren en el mismo @emph{momento musical}, y la acción de
-@code{\once} es aplicar la sobreescritura a todos los oobjetos de
+@code{\once} es aplicar la sobreescritura a todos los objetos de
presentación del tipo especificado que ocurren en el mismo momento
musical que la propia instrucción de sobreescritura @code{\override}.
LA instrucción @code{\tweak} opera de una forma distinta. Actúa sobre
-el elemento inmediatamente siguiente dentro del flujjo de entrada.
+el elemento inmediatamente siguiente dentro del flujo de entrada.
Sin embargo, es efectivo solamente sobre objetos que se crean
directamente a partir del flujo de entrada, en esencia las cabezas y
las articulaciones (los objetos como las plicas y las alteraciones se
<c \tweak #'font-size #-3 e g>4
@end lilypond
-Observe que la sintaxis de @code{\tweak} es diferente de la de la
-instrucción @code{\override}. Ni el contexto ni el objeto de
+Observe que la sintaxis de @code{\tweak} no es igual que la de
+@code{\override}. Ni el contexto ni el objeto de
presentación se deben especificar; de hecho, generaría un error
hacerlo. Los dos están implícitos por el siguiente elemento del flujo
de entrada. Así que la sintaxis genérica de la instrucción
-@code{\tweak} es, simmplemente:
+@code{\tweak} es, simplemente:
@example
\tweak #'@emph{propiedad_de_presentación} = #@emph{valor}
@c See issue 509
@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
\times 2/3 { c8[ c c]}
-\once \override TupletNumber
+\once \override TupletNumber
#'text = #tuplet-number::calc-fraction-text
\times 2/3 {
c[ c]
{
\time 6/8
{
- r4 b8 b[( g]) g |
- g[( e]) e d[( f]) a |
+ r4 b8 b[( g]) g |
+ g[( e]) e d[( f]) a |
a g
}
\addlyrics {
- The man who feels love's sweet e -- mo -- tion
+ The man who feels love's sweet e -- mo -- tion
}
}
-@end lilypond
+@end lilypond
Suponga ahora que decidimos que nos gustan las ligaduras algo más
gruesas. ¿Es posible? La ligadura es, ciertamente, un objeto de
página} ni el PDF. Para que los siguientes párrafos tengan algún
sentido deberá consultarlo realmente al tiempo que lee.
-@c Link names in English as these pages are not yet translated
+@c Link names in English as those pages are not yet translated. FV
Bajo el encabezamiento @strong{Top} podrá ver cinco enlaces.
Seleccione el enlace @emph{Backend}, que es donde se encuentra la
información sobre los objetos de presentación. Una vez allí, bajo el
(Una forma alternativa de encontrar esta página es a partir de la
Referencia de la Notación. En una de las páginas que tratan de las
ligaduras de expresión podrá encontrar un enlace al manual de
-referencia del funcioonamiento interno. Este enlace le llevará
+referencia del funcionamiento interno. Este enlace le llevará
directamente a esta página, aunque con frecuencia es más fácil ir
directamente al RFI y buscar allí.)
@example
\override Slur #'thickness = #5.0
-@end example
+@end example
¡No olvide el @code{#'} antes del nombre de la propiedad y @code{#}
antes del valor nuevo!
a g
}
\addlyrics {
- The man who feels love's sweet e -- mo -- tion
+ The man who feels love's sweet e -- mo -- tion
}
}
-@end lilypond
+@end lilypond
@noindent
y podemos ver que la ligadura, es sin duda, más pesada.
@code{\override} ocasiona que solamente cambie la ligadura que
comienza en la nota @strong{inmediata siguiente}. Si la nota
inmediata siguiente no da inicio a una ligadura, la instrucción no
-tiene niingún efecto en absoluto: no se recuerda hasta que se
+tiene ningún efecto en absoluto: no se recuerda hasta que se
encuentre alguna ligadura, sino que simplemente se ignora. Así pues,
la instrucción que lleva @code{\once} se debe reposicionar de la forma
siguiente:
r4 b8
% Increase thickness of immediately following slur only
\once \override Slur #'thickness = #5.0
- b[( g]) g |
- g[( e]) e d[( f]) a |
- a g
+ b[( g]) g |
+ g[( e]) e d[( f]) a |
+ a g
}
\addlyrics {
- The man who feels love's sweet e -- mo -- tion
+ The man who feels love's sweet e -- mo -- tion
}
}
-@end lilypond
+@end lilypond
@noindent
Hemos hecho que ahora solamente la primera ligadura sea más gruesa.
b[( g]) g |
% Increase thickness of immediately following slur only
\once \override Slur #'thickness = #5.0
- g[( e]) e d[( f]) a |
+ g[( e]) e d[( f]) a |
a g
}
\addlyrics {
- The man who feels love's sweet e -- mo -- tion
+ The man who feels love's sweet e -- mo -- tion
}
}
-@end lilypond
+@end lilypond
@noindent
o podríamos omitir la instrucción prefija @code{\once} y utilizar la
% Increase thickness of all following slurs from 1.2 to 5.0
\override Slur #'thickness = #5.0
b[( g]) g |
- g[( e])
+ g[( e])
% Revert thickness of all following slurs to default of 1.2
\revert Slur #'thickness
- e d[( f]) a |
+ e d[( f]) a |
a g
}
\addlyrics {
- The man who feels love's sweet e -- mo -- tion
+ The man who feels love's sweet e -- mo -- tion
}
}
@end lilypond
la instrucción @code{\revert} se puede utilizar para devolver
cualquier propiedad que se haya cambiado con @code{\override} a su
valor predeterminado. Puede utilizar el método que mejor se adapte a
-aquello que quere hacer.
+aquello que quiere hacer.
Así finaliza nuestra introducción al manual de RFI, y el método básico
de trucaje. A continuación, en las últimas secciones de este capítulo
¿Qué forma de instrucción @code{\override} necesitamos para hacerlo?
En primer lugar miramos en la página del RFI que relaciona todos los
objetos, @q{All layout objects}, como antes, y buscamos un objeto que
-pueda conteolar la letra de la canción. Encontramos @code{LyricText},
+pueda controlar la letra de la canción. Encontramos @code{LyricText},
que parece adecuado. Al seguir este enlace se presentan las
propiedades ajustables para el texto de la letra. Estos incluyen
@code{font-series} y @code{font-size}, pero nada que pudiera aplicar
una forma cursiva. Esto es porque la propiedad de la forma es común a
todos los objetos de fuente tipográfica, y por tanto, en vez de
-incluirlo en cada uno de los objetos de preesentación, se agrupa junto
+incluirlo en cada uno de los objetos de presentación, se agrupa junto
con otras propiedades comunes similares y se deposita en un
@strong{Interface}, el interface de las fuentes tipográficas
@code{font-interface}.
de los interfaces, y descubrir qué objetos usan estas propiedades de
interface.
-Mire de nuevo la página del RFI que decribe a LyricText. Al final de
+Mire de nuevo la página del RFI que describe a LyricText. Al final de
la página hay una lista de enlaces (en las versiones de html del RFI)
a los interfaces que LyricText contempla. La lista tiene siete
elementos, entre ellos @code{font-interface}. Al seguir este enlace
Algunos de ellos son nombres de propiedades, como @code{thickness} o
@code{font-shape}, otros son en efecto valores especiales que se les
puede dar a las propiedades, como @code{italic}. Observe la
-distincion entre esto y las cadenas de texto arbitrarias, que
+distinción entre esto y las cadenas de texto arbitrarias, que
aparecerían entrecomilladas como @code{"a text string"}.
De acuerdo, entonces la instrucción @code{\override} que necesitamos
}
\addlyrics {
\override LyricText #'font-shape = #'italic
- The man who feels love's sweet e -- mo -- tion
+ The man who feels love's sweet e -- mo -- tion
}
}
@end lilypond
@cindex contexto, especificación en modo letra
En el caso de la letra, si intenta especificar el contexto en el
-formato que acabamnos de dar, la instrucción no funcionará. Una
-sílaba escrita en el modo letra, «lyricmode» temina en un espacio, un
+formato que acabamos de dar, la instrucción no funcionará. Una
+sílaba escrita en el modo letra, «lyricmode» termina en un espacio, un
salto de línea o un dígito. Cualquier otro carácter se incluye como
parte de la sílaba. Por esta razón, un espacio o salto de línea debe
aparecer antes del último símbolo @code{@}} para evitar que se incluya
@tab Dos números separados por un @q{espacio . espacio}, encerrado entre paréntesis y precedido de un apóstrofe
@tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)}
@item Símbolo
- @tab Cualquiera del conjunto de símbolos premitidos para esa propiedad, precedido de un apóstrofe
+ @tab Cualquiera del conjunto de símbolos permitidos para esa propiedad, precedido de un apóstrofe
@tab @code{'italic}, @code{'inside}
@item Desconocido
@tab Un procedimiento o @code{#f} (para no producir ninguna acción)
@tab @code{#(#t #t #f)}
@end multitable
+@node Appearance of objects
+@section Appearance of objects
-@node Moving objects
-@section Moving objects
+Ahora vamos a poner en práctica lo que hemos aprendido con unos
+cuantos ejemplos que muestran cómo se pueden usar los trucos para
+cambiar el aspecto de la música impresa.
-Aunque pueda sorprenderle, LilyPond no es perfecto. Ciertos
-elementos de notación se pueden superponer, lo que es una lástima,
-pero en casi todos los casos se resuelve fácilmente.
+@menu
+* Visibility and color of objects::
+* Size of objects::
+* Length and thickness of objects::
+@end menu
-@c FIXME: find a better example for 5.1 Moving Objects. -gp
-@c yes, I want this TODO to be visible to end-users. It's better
-@c than having nothing at all.
-HACER: con las nuevas funcionalidades de espaciado en la versión 2.12, estos ejemplos específicos
-ya no son de relevancia. Sin embargo siguen demostrando las poderosas funcionalidades de lilypond,
-así que quedan aquí hasta que alguien elabore unos ejemplos mejores.
+@node Visibility and color of objects
+@subsection Visibility and color of objects
+
+Dentro de un uso educativo de la música, podríamos desear imprimir una
+partitura con ciertos elementos omitidos como ejercicio para el
+alumno, a quien se le pide que los complete. A la manera de ejemplo
+sencillo, supongamos que el ejercicio es escribir las líneas
+divisorias que faltan en un fragmento musical. Pero las líneas
+divisorias normalmente se insertan automáticamente. ¿Cómo hacemos para
+que no se impriman?
+
+Antes de enredarnos con esto, recordemos que las propiedades de los
+objetos se agrupan en lo que hemos llamado @emph{interfaces} (véase
+@ref{Properties found in interfaces}). Esto es simplemente agrupar
+las propiedades que normalmente se necesitan juntas: si una de ellas
+se necesita para un objeto, también las otras. Así, ciertos objetos
+necesitan las propiedades de algunos interfaces, otros necesitan las
+de otros interfaces. Los interfaces que contienen las propiedades que
+un determinado grob necesita se encuentran relacionadas en el manual
+RFI al final de la página que describe dicho grob, y esas propiedades
+se pueden ver mirando dichos interfaces.
+
+Hemos explicado cómo encontrar información sobre los grobs en
+@ref{Properties of layout objects}. Usando el mismo enfoque, vamos al
+RFI para buscar el objeto de presentación que imprime las líneas
+divisorias. A través del enlace @emph{Backend} y @emph{All layout
+objects} encontramos que hay un objeto de presentación llamado
+@code{BarLine}. Entre sus propiedades se encuentran dos que controlan
+la visibilidad: @code{break-visibility} y @code{stencil}. Las líneas
+divisorias también contemplan un número de interfaces, entre ellos el
+@code{grob-interface}, donde podemos encontrar las propiedades
+@code{transparent} y @code{color}. Todas ellas pueden afectar la
+visibilidad de las barras de compás (y, por supuesto, por extensión,
+también la de muchos otros objetos de presentación). Vamos a
+considerar cada uno de ellos por orden.
+
+@subheading stencil
+@cindex stencil (sello), propiedad
+
+Esta propiedad controla la apariencia de las barras de compás mediante
+la especificación del símbolo (o «glifo») que se debe imprimir. Igual
+que como otras muchas propiedades, se puede establecer de forma que no
+imprima nada ajustando su valor a @code{#f}. Vamos a probarlo, como
+antes, omitiendo el Contexto implícito, @code{Voice}:
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
- % temporary code to break this example:
- \override TextScript #'outside-staff-priority = ##f
-e4^\markup{ \italic ritenuto } g b e
+{
+ \time 12/16
+ \override BarLine #'stencil = ##f
+ c4 b8 c d16 c d8 |
+ g, a16 b8 c d4 e16 |
+ e8
+}
+@end lilypond
+
+Las barras de compás todavía se imprimen. ¿Qué es lo que está mal?
+Vuelva al RFI y mire de nuevo la página que ofrece las propiedades del
+objeto BarLine. Al principio de la página dice @qq{Barline objects
+are created by: Bar_engraver} (los objetos Barline se crean por el
+grabador Bar_engraver). Vaya a la página del grabador
+@code{Bar_engraver} siguiendo el enlace. Al final da una lista de
+contextos en los que el grabador de líneas divisorias opera. Todos
+ellos son del tipo @code{Staff}, y así la razón de que la instrucción
+@code{\override} no funcionara como esperábamos, es porque
+@code{Barline} no se encuentra en el contexto predeterminado
+@code{Voice}. Si el contexto se especifica mal, la instrucción
+simplemente no funciona. No se produce ningún mensaje de error, y no
+se registra nada en el archivo log de registro. Vamos a intentar
+corregirlo escribiendo el contexto correcto:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+{
+ \time 12/16
+ \override Staff.BarLine #'stencil = ##f
+ c4 b8 c d16 c d8 |
+ g, a16 b8 c d4 e16 |
+ e8
+}
@end lilypond
-@cindex padding
+Ahora las barras de compás han desaparecido.
+
+@subheading break-visibility
-La solución más fácil es aumentar la distancia entre el objeto
-(texto en este caso, pero muy bien podrían ser digitaciones o dinámicas)
-y la nota. En LilyPond, esto se llama la propiedad
-@code{padding} (relleno); se mide en espacios de pentagrama. Para la mayor
-parte de los objetos, este valor ronda la cantidad de 1.0 o menos (varía dependiendo del
-objeto). Queremos aumentarlo, así que probaremos el valor 1.5
+@cindex break-visibility property
+
+Vemos en las propiedades de @code{BarLine} que aparecen en el RFI que
+la propiedad @code{break-visibility} requiere un vector de tres
+valores booleanos. Controlan respectivamente si las barras de compás
+se imprimen al final de una línea, en mitad de una línea, y al
+principio de las líneas. Para nuestro ejemplo, queremos que todas las
+barras de compás se supriman, por lo que el valor que necesitamos es
+@code{#(#f #f #f)}. Vamos a probarlo, recordando incluir el contexto
+de @code{Staff}. Observa también que al escribir este valor tenemos
+dos símbolos de almohadilla antes del paréntesis de apertura. Se
+necesita uno como parte del valor para introducir un vector, y se
+necesita otro más, como siempre, para preceder el propio valor dentro
+de la instrucción @code{\override}.
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
- % temporary code to break this example:
- \override TextScript #'outside-staff-priority = ##f
-\once \override TextScript #'padding = #1.5
-e4^\markup{ \italic ritenuto } g b e
+{
+ \time 12/16
+ \override Staff.BarLine #'break-visibility = ##(#f #f #f)
+ c4 b8 c d16 c d8 |
+ g, a16 b8 c d4 e16 |
+ e8
+}
@end lilypond
-Esto tiene un mejor aspecto, pero no es suficiente. Después de probar
-con algunos valores, creemos que 2.3 es el mejor número en este caso. Sin embargo
-esta cantidad es el mero resultado del ensayo y error y de mi gusto personal
-acerca de la notación. Pruebe el ejemplo anterior con 2.3... pero también con otros valores
-mayores (y menores). ¿Cuál cree que queda mejor?
+Y podemos ver que esto también quita todas las líneas divisorias.
+
+@subheading transparent
+@cindex transparente, propiedad
+
+En la relación de propiedades que se especifican en la página del
+@code{grob-interface} del RFI podemos ver que la propiedad
+@code{transparent} es un valor booleano. Esto se debe establecer a
+@code{#t} para hacer que el grob sea transparente. En el ejemplo
+siguiente vamos a hacer que la indicación de compás, y no las líneas
+divisorias, sea transparente. Para hacerlo tenemos que buscar el
+nombre del grob de la indicación de compás. Volviendo a la página
+@q{All layout objects} del RFI, buscamos las propiedades del objeto de
+presentación @code{TimeSignature}. Se produce por parte del grabador
+@code{Time_signature_engraver} que como puede comprobar vive dentro
+del contexto de @code{Staff} y también contempla el interface
+@code{grob-interface}. Así pues, la instrucción que hace transparente
+a la indicación de compás es:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+{
+ \time 12/16
+ \override Staff.TimeSignature #'transparent = ##t
+ c4 b8 c d16 c d8 |
+ g, a16 b8 c d4 e16 |
+ e8
+}
+@end lilypond
-La propiedad @code{staff-padding} (relleno de pentagrama) está estrechamente relacionada.
-@code{padding} controla la cantidad de espacio mínima entre un objeto y el objeto más cercano
-(generalmente la nota o las líneas del pentagrama);
-@code{staff-padding} controla la cantidad mínima de espacio entre un
-objeto y el pentagrama. Ello supone una sutil diferencia, pero podrá
-observar el comportamiento a continuación.
+@noindent
+El compás ya no está, pero esta instrucción deja una separación en el
+lugar donde antes estaba la indicación de compás. Quizá esto es lo
+que queremos para un ejercicio en que el alumno deba escribirlo, pero
+en otras circunstancias esta separación podría no ser deseable. En
+vez de eso, para quitarla, el stencil o «sello» de la indicación de
+compás se debe establecer al valor @code{#f}:
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
- % temporary code to break this example:
- \override TextScript #'outside-staff-priority = ##f
-c4^"piu mosso" b a b
-\once \override TextScript #'padding = #4.6
-c4^"piu mosso" d e f
-\once \override TextScript #'staff-padding = #4.6
-c4^"piu mosso" fis a g
-\break
-c'4^"piu mosso" b a b
-\once \override TextScript #'padding = #4.6
-c4^"piu mosso" d e f
-\once \override TextScript #'staff-padding = #4.6
-c4^"piu mosso" fis a g
-@end lilypond
-
-@cindex desplazamiento adicional
-
-Otra solución nos proporciona un control absoluto sobre la situación del objeto: podemos
-moverlo horizontal o verticalmente. Se hace con la propiedad
-@code{extra-offset} (desplazamiento adicional). Es ligeramente más complicado y puede
-causar otros problemas. Cuando movemos objetos con @code{extra-offset},
-el movimiento se hace después de que LilyPond haya colocado todos los demás objetos.
-Esto significa
-que el resultado podría entrar en conflicto con otros objetos.
+{
+ \time 12/16
+ \override Staff.TimeSignature #'stencil = ##f
+ c4 b8 c d16 c d8 |
+ g, a16 b8 c d4 e16 |
+ e8
+}
+@end lilypond
+
+@noindent
+y la diferencia es obvia: al establecer el sello al valor @code{#f}
+quitamos el objeto por completo; al hacer el objeto @code{transparent}
+lo dejamos donde está, pero lo hacemos invisible.
+
+@subheading color
+@cindex color, propiedad
+
+Para finalizar, podríamos hacer invisibles las barras de compás
+pintándolas de color blanco. El interface @code{grob-interface}
+especifica que la propiedad del color es una lista, pero no hay
+ninguna explicación sobre lo que debe ir en esa lista. La lista que
+requiere es realmente una lista de valores en unidades internas, pero
+para evitar tener que saber cuáles son, se ofrecen varias vías para la
+especificación de los colores. La primera forma es utilizar uno de
+los colores @q{normales} que están relacionados en la primera tabla de
+la @ruser{List of colors}. Para poner las líneas divisorias de color
+blanco, escribimos:
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
- % temporary code to break this example:
- \override TextScript #'outside-staff-priority = ##f
-\once \override TextScript #'extra-offset = #'( 1.0 . -1.0 )
-e4^\markup{ \italic ritenuto } g b e
+{
+ \time 12/16
+ \override Staff.BarLine #'color = #white
+ c4 b8 c d16 c d8 |
+ g, a16 b8 c d4 e16 |
+ e8
+}
@end lilypond
-Con @code{extra-offset}, el primer número controla el movimiento
-horizontal (negativo hacia la izquierda); el segundo número controla el movimiento
-vertical (positivo hacia arriba). Después de algunos ensayos, hemos decidido que los siguientes valores
-son apropiados
+@noindent
+y de nuevo podemos comprobar que las barras de compás no son visibles.
+Observe que @emph{white} no viene precedido de un apóstrofe: no es un
+símbolo, sino una @emph{función}. Cuando se invoca, proporciona la
+lista de valores internos que se requieren para establecer el color a
+blanco. Los otros colores de la lista normal también son funciones.
+Para convencerse de que esto funciona, quizá quiera cambiar el color a
+una de las otras funciones de la lista.
+
+@cindex colores de X11
+@cindex X11, colores de
+
+La segunda forma de cambiar el color es utilizar la lista de nombres
+de colores de X11 que aparecen en la segunda lista de @ruser{List of
+colors}. Sin embargo, éstos deben ir precedidos de otra función, que
+convierte los nombres de colores de X11 en la lista de valores
+internos, @code{x11-color}, de la siguiente manera:
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
- % temporary code to break this example:
- \override TextScript #'outside-staff-priority = ##f
-\once \override TextScript #'extra-offset = #'( -1.6 . 1.0 )
-e4^\markup{ \italic ritenuto } g b e
+{
+ \time 12/16
+ \override Staff.BarLine #'color = #(x11-color 'white)
+ c4 b8 c d16 c d8 |
+ g, a16 b8 c d4 e16 |
+ e8
+}
@end lilypond
@noindent
-Una vez más, estos números son simplemente el resultado de algunos experimentos y
-de observar la salida. Quizá prefiera que el texto se encuentre algo más arriba,
-o a la izquierda, o en cualquier dirección. ¡Pruébelo y observe el resultado!
+Observe que en este caso la función @code{x11-color} toma un símbolo
+como argumento, así que el símbolo debe ir precedido de un apóstrofe y
+los dos deben ir entre paréntesis.
-Una advertencia final: en esta sección hemos usado
+@cindex rgb, colores
+@cindex color, rgb
+
+Aún hay una tercera función, que convierte valores RGB en colores
+internos: la función @code{rgb-color}. Toma tres argumentos que dan
+las intensidades de rojo, verde y azul. Cada uno de ellos puede tomar
+valores entre 0 y 1. Por lo tanto, para establecer el color a rojo el
+valor debe ser @code{(rgb-color 1 0 0)} y para blanco debe ser
+@code{(rgb-color 1 1 1)}:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+{
+ \time 12/16
+ \override Staff.BarLine #'color = #(rgb-color 1 1 1)
+ c4 b8 c d16 c d8 |
+ g, a16 b8 c d4 e16 |
+ e8
+}
+@end lilypond
+
+Finalmente, existe también una escala de grises como parte del
+conjunto de colores de X11. Varían desde el negro, @code{'grey0'},
+hasta el blanco, @code{'grey100}, en pasos de 1. Vamos a ilustrar esto
+estableciendo todos los objetos de presentación de nuestro ejemplo a
+varias gradaciones de gris:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+{
+ \time 12/16
+ \override Staff.StaffSymbol #'color = #(x11-color 'grey30)
+ \override Staff.TimeSignature #'color = #(x11-color 'grey60)
+ \override Staff.Clef #'color = #(x11-color 'grey60)
+ \override Voice.NoteHead #'color = #(x11-color 'grey85)
+ \override Voice.Stem #'color = #(x11-color 'grey85)
+ \override Staff.BarLine #'color = #(x11-color 'grey10)
+ c4 b8 c d16 c d8 |
+ g, a16 b8 c d4 e16 |
+ e8
+}
+@end lilypond
+
+@noindent
+Observe los contextos asociados con cada uno de los objetos de
+presentación. Es importante que estén correctamente escritos, o las
+instrucciones ¡no funcionarán! Recuerde que el contexto es aquel en
+que se encuentra el grabador correspondiente. El contesto
+predeterminado para los grabadores puede encontrarse empezando por el
+objeto de presentación, de ahí al grabador que lo produce, y en la
+página del grabador del RFI aparece en qué contexto se puede encontrar
+normalmente el grabador.
+
+
+@node Size of objects
+@subsection Size of objects
+
+Empezaremos examinando de nuevo un ejemplo anterior (véase
+@ref{Nesting music expressions}) que nos mostraba cómo introducir un
+pentagrama temporal, como en un @rglos{ossia}.
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+\new Staff ="main" {
+ \relative g' {
+ r4 g8 g c4 c8 d |
+ e4 r8
+ <<
+ { f c c }
+ \new Staff \with {
+ alignAboveContext = "main" }
+ { f8 f c }
+ >>
+ r4 |
+ }
+ }
+@end lilypond
+
+Los fragmentos de Ossia se escriben normalmente sin clave ni compás, y
+por lo normal se imprimen más pequeños que el pentagrama principal.
+Ya sabemos cómo quitar la clave y el compás: simplemente establecemos
+el sello de cada uno de ellos a @code{#f}, como sigue:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+\new Staff ="main" {
+ \relative g' {
+ r4 g8 g c4 c8 d |
+ e4 r8
+ <<
+ { f c c }
+ \new Staff \with {
+ alignAboveContext = "main"
+ }
+ {
+ \override Staff.Clef #'stencil = ##f
+ \override Staff.TimeSignature #'stencil = ##f
+ { f8 f c }
+ }
+ >>
+ r4 |
+ }
+}
+@end lilypond
+
+@noindent
+donde el par de llaves adicional después de la cláusula @code{\with}
+es necesario para asegurar que la sobreescritura encerrada y la música
+se aplican al pentagrama de ossia.
+
+Pero ¿cuál es la diferencia entre modificar el contexto de pentagrama
+usando @code{\with} y modificar los sellos de clave y de compás con
+\override? La diferencia principal es que los cambios que se realizan
+en una cláusula @code{\with} se hacen en el momento en que se crea el
+contexto, y permanecen activos como valores @strong{predeterminados}
+durante toda la duración de dicho contexto, mientras que las
+instrucciones @code{\set} o @code{\override} incluidas dentro de la
+música son dinámicas: hacen cambios sincronizados con un punto
+concreto de la música. Si los cambios se deshacen o se devuelven
+mediante @code{\unset} o @code{\revert} volverán a su valor
+predeterminado que será el establecido en la cláusula @code{\with}, o
+si no se ha establecido ninguno en este lugar, los valores
+predeterminados normales.
+
+Ciertas propiedades de contexto se pueden modificar solamente dentro
+de cláusulas @code{\with}. Son aquellas propiedades que no se pueden
+cambiar después de que el contexto se ha creado.
+@code{alignAboveContext} y su compañero, @code{alignBelowContext}, son
+dos de tales propiedades: una vez que el pentagrama se ha creado, su
+alineación está decidida y no tendría sentido intentar cambiarla más
+tarde.
+
+Los valores predeterminados de las propiedades de los objetos de
+presentación también se pueden establecer dentro de cláusulas
+@code{\with}. Simplemente utilice la instrucción @code{\override}
+normal dejando aparte el nombre del contexto, ya que está definido sin
+ambigüedad como el contexto que la cláusula @code{\with} está
+modificando. De hecho, se producirá un error si se especifica un
+contexto en este lugar.
+
+Así pues, podemos reemplazar el ejemplo anterior con
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+\new Staff ="main" {
+ \relative g' {
+ r4 g8 g c4 c8 d |
+ e4 r8
+ <<
+ { f c c }
+ \new Staff \with {
+ alignAboveContext = "main"
+ % Don't print clefs in this staff
+ \override Clef #'stencil = ##f
+ % Don't print time signatures in this staff
+ \override TimeSignature #'stencil = ##f
+ }
+ { f8 f c }
+ >>
+ r4 |
+ }
+}
+@end lilypond
+
+Finalmente llegamos a la forma de cambiar el tamaño de los objetos de
+presentación.
+
+Ciertos objetos de presentación se crean como glifos sacados de una
+fuente tipográfica. Entre ellos se encuentran las cabezas,
+alteraciones, elementos de marcado, claves, indicaciones de compás,
+indicaciones dinámicas y la letra de las canciones. Su tamaño se
+cambia mediante la modificación de la propiedad @code{font-size}, como
+veremos en breve. Otros objetos de presentación como ligaduras de
+unión y de expresión (en general, objetos de extensión) se trazan
+individualmente, por lo que no hay un tamaño de tipografía
+@code{font-size} asociado a ellos. Estos objetos generalmente derivan
+su tamaño de los objetos a los que están adosados, y por ello
+normalmente no hay necesidad de cambiarles el tamaño manualmente. Aún
+otras propiedades como la longitud de las plicas y las barras de
+compás, el grosor de las barras de corchea y otras líneas, y la
+separación de las líneas del pentagrama se deben modificar de otras
+formas especiales.
+
+Volviendo al ejemplo del ossia, vamos a cambiar en primer lugar el
+tamaño de la tipografía. Podemos hacerlo de dos formas. Podemos
+cambiar el tamaño de las tipografías de cada uno de los tipos de
+objeto como las cabezas (@code{NoteHead}s) con instrucciones como
@example
-\once \override TextScript @dots{}
+\override NoteHead #'font-size = #-2
@end example
-Esto altera la presentación del texto para la nota siguiente. Si la nota no
-tiene ningún texto, este truco no hace nada (y @strong{no} se queda esperando al
-siguiente fragmento de texto). Para cambiar el comportamiento permanentemente a partir
-del comando, omita el @code{\once}. Para detener este truco, use
-@code{\revert} (revertir). Todo esto se explica en profundidad en
-@ruser{The \override command}.
+o podemos cambiar el tamaño de todas las tipografías estableciendo una
+propiedad especial, @code{fontSize}, utilizando @code{\set}, o
+mediante su inclusión dentro de una cláusula @code{\with} (pero sin el
+@code{\set}).
-@lilypond[quote,fragment,ragged-right,verbatim,relative=3]
- % temporary code to break this example:
- \override TextScript #'outside-staff-priority = ##f
-c4^"piu mosso" b
-\once \override TextScript #'padding = #4.6
- a4 b
-c4^"piu mosso" d e f
-\once \override TextScript #'padding = #4.6
-c4^"piu mosso" d e f
-c4^"piu mosso" d e f
-\break
-\override TextScript #'padding = #4.6
-c4^"piu mosso" d e f
-c4^"piu mosso" d e f
-\revert TextScript #'padding
-c4^"piu mosso" d e f
+@example
+\set fontSize = #-2
+@end example
+
+Los dos enunciados producirían una reducción del tamaño de la
+tipografía en dos pasos a partir de su valor previo, donde cada paso
+reduce o aumenta el tamaño aproximadamente en un 12%.
+
+Vamos a probarlo en nuestro ejemplo del ossia:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+\new Staff ="main" {
+ \relative g' {
+ r4 g8 g c4 c8 d |
+ e4 r8
+ <<
+ { f c c }
+ \new Staff \with {
+ alignAboveContext = "main"
+ \override Clef #'stencil = ##f
+ \override TimeSignature #'stencil = ##f
+ % Reduce all font sizes by ~24%
+ fontSize = #-2
+ }
+ { f8 f c }
+ >>
+ r4 |
+ }
+}
@end lilypond
-@seealso
+Aún no está demasiado bien. Las cabezas y los corchetes de las notas
+son más pequeños, pero las plicas son demasiado largas en proporción,
+y las líneas del pentagrama están demasiado separadas entre sí. Se
+debe reducir su escala en proporción a la reducción de la tipografía.
+El siguiente apartado trata sobre cómo se hace esto.
+
+@node Length and thickness of objects
+@subsection Length and thickness of objects
+
+@cindex distancias
+@cindex grosor
+@cindex longitud
+@cindex magstep
+@cindex tamaño, cambiar
+@cindex plica, cambiar la longitud
+@cindex pentagrama, cambiar la separación de las líneas
+
+Las distancias y longitudes en LilyPond se miden generalmente en
+espacios de pentagrama, la distancia entre líneas adyacentes de la
+pauta (o de manera ocasional medios espacios), mientras que la mayoría
+de las propiedades de @code{thickness} (grosor) se miden en unidades
+de una propiedad interna llamada @code{line-thickness.} Por ejemplo,
+de forma predeterminada, a las líneas de los reguladores se les da un
+grosor de 1 unidad de @code{line-thickness}, mientras que el
+@code{thickness} de una plica es 1.3. Observe sin embargo que ciertas
+propiedades de grosor son diferentes; por ejemplo, el grosor de las
+barras de corchea se mide en espacios de pentagrama.
+
+Entonces ¿cómo se tienen que escalar las longitudes en proporción al
+tamaño de la tipografía? Se puede hacer con la ayuda de una función
+especial que se llama @code{magstep}, pensada especialmente para este
+propósito. Toma un argumento, el cambio de tamaño de la tipografía
+(#-2 en nuestro ejemplo) y devuelve un factor de escalado adecuado
+para reducir otros objetos en la misma proporción. Se usa de la
+siguiente forma:
-En el presente manual: @ruser{The \override command}, @ruser{Common tweaks}.
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+\new Staff ="main" {
+ \relative g' {
+ r4 g8 g c4 c8 d |
+ e4 r8
+ <<
+ { f c c }
+ \new Staff \with {
+ alignAboveContext = "main"
+ \override Clef #'stencil = ##f
+ \override TimeSignature #'stencil = ##f
+ fontSize = #-2
+ % Reduce stem length and line spacing to match
+ \override StaffSymbol #'staff-space = #(magstep -2)
+ }
+ { f8 f c }
+ >>
+ r4 |
+ }
+}
+@end lilypond
+@noindent
+Puesto que la longitud de las plicas y muchas otras propiedades
+relacionadas con la longitudes calculan siempre con relación al valor
+de la propiedad @code{staff-space}, su longitud también ve reducida su
+escala automáticamente. Observe que esto afecta solamente a la escala
+vertical del ossia: la escala horizontal se determina por medio de la
+disposición de la música principal con el objeto de mantenerse en
+sincronía con ella, de forma que no resulte afectada por ninguno de
+estos cambios de tamaño. Por supuesto, si la escala de toda la música
+principal se cambiase de esta forma, entonces el espaciado horizontal
+se vería afectado. Trataremos de esto más tarde en la sección sobre
+la disposición.
+
+Esto, en fin, completa la creación de un ossia. Los tamaños y
+longitudes del resto de los objetos se pueden modificar de manera
+análoga.
+
+Para cambios de escala pequeños, como en el ejemplo de arriba, el
+grosor de las diversas líneas dibujadas como divisorias, barras de
+corchea, reguladores, ligaduras, etc, no requieren normalmente ningún
+ajuste global. Si el grosor de cualquier objeto de presentación en
+particular necesita ajustarse, se puede hacer mejor mediante la
+sobreescritura de su propiedad @code{thickness}. Anteriormente
+mostramos un ejemplo de cambio de grosor en las ligaduras, en
+@ref{Properties of layout objects}. El grosor de todos los objetos
+trazados (es decir, aquellos que no se producen a partir de una
+tipografía) se pueden cambiar de la misma forma.
+
+
+@node Placement of objects
+@section Placement of objects
-@node Fixing overlapping notation
-@section Fixing overlapping notation
+@menu
+* Automatic behaviour::
+* Within-staff objects::
+* Outside staff objects::
+@end menu
-En @ruser{Moving objects}, pudimos ver cómo mover un objeto @code{TextScript}.
-El mismo mecanismo se puede usar para mover otros tipos de
-objetos; simplemente sustituya @code{TextScript} con el nombre de
-otro objeto.
-Para encontrar el nombre del objeto, consulte la sección @q{@strong{véase también}} al
-final de la página relevante dentro de la documentación. Por ejemplo, al
-final de @ruser{Dynamics}, vemos
+@node Automatic behaviour
+@subsection Automatic behaviour
+
+Hay ciertos objetos en notación musical que pertenecen al pentagrama y
+otros cuyo lugar se sitúa fuera del pentagrama. Reciben el nombre de
+objetos dentro-del-pentagrama y objetos fuera-del-pentagrama,
+respectivamente.
+
+Los objetos dentro-del-pentagrama son los que se sitúan sobre la
+pauta: cabezas, plicas, alteraciones, etc. Sus posiciones normalmente
+se fijan por la propia música; se posicionan verticalmente sobre
+líneas específicas del pentagrama o están unidos a otros objetos
+posicionados de esta forma. Las colisiones entre cabezas, plicas y
+alteraciones en acordes de notas muy juntas, normalmente se evitan
+automáticamente. Hay instrucciones y sobreescrituras que pueden
+modificar este comportamiento automático, como veremos en breve.
+
+Entre los objetos que pertenecen al exterior de la pauta se encuentran
+cosas como las marcas de ensayo, las marcas de texto y las de
+dinámica. La regla de LilyPond para la colocación vertical de los
+objetos fuera-de-pentagrama es colocarlos tan cerca del pentagrama
+como sea posible, pero no tan cerca como para que puedan chocar con
+algún otro objeto. LilyPond utiliza la propiedad
+@code{outside-staff-priority} para determinar el orden en que se deben
+situar los objetos, como veremos ahora.
+
+En primer lugar, LilyPond sitúa todos los objetos
+dentro-del-pentagrama. Después ordena los objetos
+fuera-del-pentagrama de acuerdo con su prioridad
+@code{outside-staff-priority}. Los objetos fuera-del-pentagrama se
+toman de uno en uno, comenzando por el que tiene la prioridad
+@code{outside-staff-priority} más baja, y se sitúan de forma que no
+colisionen con ningún objeto que se haya colocado ya. Esto es, si dos
+grobs fuera-del-pentagrama compiten por el mismo espacio, el que tiene
+la prioridad @code{outside-staff-priority} más baja se colocará más
+cerca del pentagrama. Si dos objetos tienen la misma
+@code{outside-staff-priority}, el que se ha encontrado primero se
+situará más cerca de la pauta.
+
+En el siguiente ejemplo, todos los textos de marcado tienen la misma
+prioridad (pues no se ha establecido explícitamente). Observe que
+@q{Text3} se posiciona de nuevo automáticamente cerca del pentagrama,
+acomodado por debajo de @q{Text2}.
-@quotation
-@seealso
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+c2^"Text1"
+c^"Text2"
+c^"Text3"
+c^"Text4"
+@end lilypond
-Referencia del programa: @internalsref{DynamicText}, @internalsref{Hairpin}.
-La posición vertical de estos símbolos se maneja por medio de
-@internalsref{DynamicLineSpanner}.
-@end quotation
+Los pentagramas también se posicionan, de forma predeterminada, tan
+cerca unos de otros como sea posible (sujeto a una separación mínima).
+Si las notas se proyectan muy lejos en dirección a un pentagrama
+adyacente, forzarán a alejarse a los pentagramas sólo si en caso
+contrario fuese a ocurrir un solapamiento de la notación. El ejemplo
+siguiente muestra esta acomodación @q{nestling} de las notas sobre
+pentagramas adyacentes:
+
+@lilypond[quote,ragged-right,verbatim]
+<<
+ \new Staff {
+ \relative c' { c a, }
+ }
+ \new Staff {
+ \relative c'''' { c a, }
+ }
+>>
+@end lilypond
-@noindent
-Así que para mover expresiones dinámicas verticalmente, usamos
+
+@node Within-staff objects
+@subsection Within-staff objects
+
+Ya hemos visto cómo las instrucciones @code{\voiceXXX} affectan a la
+dirección de las ligaduras de expresión y de unión, digitaciones y
+todo lo demás que dependa de la dirección de las plicas. Cuando se
+escribe música polifónica, estas instrucciones son esenciales para que
+puedan distinguirse varias líneas melódicas entrelazadas. Pero
+ocasionalmente puede ser necesario sobreescribir este comportamiento
+automático. Se puede hacer por secciones de música completas o
+incluso para una nota individual. La propiedad que controla este
+comportamiento es la propiedad de @code{direction} (dirección) de cada
+objeto de presentación. En primer lugar explicaremos qué hace esto, y
+luego introduciremos algunas instrucciones listas para usar que le
+evitarán tener que codificar sobreescrituras explícitas para las
+modificaciones más comunes.
+
+Algunos objetos de presentación como las ligaduras se curvan hacia
+arriba o hacia abajo; otros como las plicas y los corchetes también se
+mueven a la derecha o a la izquierda cuando apuntan hacia arriba o
+hacia abajo. Esto se controla automáticamente cuando está establecida
+la propiedad @code{direction}.
+
+El ejemplo siguiente muestra en el compás 1 el comportamiento
+predeterminado de las plicas, con las de las notas agudas apuntando
+hacia abajo y las graves hacia arriba, seguidas de cuatro notas con
+todas las plicas forzadas hacia abajo, cuatro notas con las plicas
+forzadas hacia arriba, y por último cuatro notas devueltas al
+comportamiento predeterminado.
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+a4 g c a
+\override Stem #'direction = #DOWN
+a g c a
+\override Stem #'direction = #UP
+a g c a
+\revert Stem #'direction
+a g c a
+@end lilypond
+
+Aquí utilizamos las constantes @code{DOWN} (abajo) y @code{UP}
+(arriba). Éstos tienen los valores @code{-1} y @code{+1}
+respectivamente, y dichos valores numéricos también se pueden usar
+directamente. El valor @code{0} también se puede usar en algunos
+casos. Se trata simplemente con el significado de @code{UP} para las
+plicas, pero para algunos objetos tiene el significado de
+@q{centrado}. Existe una constante @code{CENTER} que tiene el valor
+@code{0}.
+
+Sin embargo, estas sobreescrituras no se usan muy a menudo porque
+están disponibles instrucciones predefinidas equivalentes más
+sencillas. Aquí podemos ver una tabla de las más comunes. Se
+menciona el significado de cada una allí donde no es obvio.
+
+@multitable @columnfractions .2 .2 .2 .4
+@headitem Abajo o Izquierda
+ @tab Arriba o Derecha
+ @tab Anular
+ @tab Efecto
+@item @code{\arpeggioDown}
+ @tab @code{\arpeggioUp}
+ @tab @code{\arpeggioNeutral}
+ @tab La flecha está abajo, arriba o no hay flecha
+@item @code{\dotsDown}
+ @tab @code{\dotsUp}
+ @tab @code{\dotsNeutral}
+ @tab Dirección del desplazamiento para evitar las líneas del pentagrama
+@item @code{\dynamicDown}
+ @tab @code{\dynamicUp}
+ @tab @code{\dynamicNeutral}
+ @tab
+@item @code{\phrasingSlurDown}
+ @tab @code{\phrasingSlurUp}
+ @tab @code{\phrasingSlurNeutral}
+ @tab Nota: diferente de las instrucciones de ligaduras de expresión
+@item @code{\slurDown}
+ @tab @code{\slurUp}
+ @tab @code{\slurNeutral}
+ @tab
+@item @code{\stemDown}
+ @tab @code{\stemUp}
+ @tab @code{\stemNeutral}
+ @tab
+@item @code{\textSpannerDown}
+ @tab @code{\textSpannerUp}
+ @tab @code{\textSpannerNeutral}
+ @tab El texto introducido como objeto de extensión está debajo o encima del pentagrama
+@item @code{\tieDown}
+ @tab @code{\tieUp}
+ @tab @code{\tieNeutral}
+ @tab
+@item @code{\tupletDown}
+ @tab @code{\tupletUp}
+ @tab @code{\tupletNeutral}
+ @tab Los grupos especiales están debajo o encima de las notas
+@end multitable
+
+Observe que estas instrucciones predefinidas @strong{no} pueden ir
+precedidas de @code{\once}. Si quiere limitar el efecto a una sola
+nota, deberá elegir entre usar la instrucción @code{\once \override}
+equivalente, o usar la instrucción predefinida, seguida después de la
+nota afectada por la instrucción @code{\xxxNeutral} correspondiente.
+
+@subheading Fingering
+@cindex digitación, colocación
+
+La colocación de las digitaciones también resulta afectada por el
+valor de su propiedad @code{direction}, pero existen instrucciones
+especiales que permiten controlar las digitaciones de notas
+individuales, situando la digitación encima, debajo, a la izquierda o
+a la derecha de cada nota.
+
+En primer lugar, he aquí el efecto de @code{direction} sobre las
+digitaciones; el primer compás muestra el comportamiento
+predeterminado, y después el efecto de especificar @code{DOWN} y
+@code{UP}:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+c-5 a-3 f-1 c'-5
+\override Fingering #'direction = #DOWN
+c-5 a-3 f-1 c'-5
+\override Fingering #'direction = #UP
+c-5 a-3 f-1 c'-5
+@end lilypond
+
+Así es como se controla la digitación sobre notas aisladas, pero la
+propiedad @code{direction} se ignora para los acordes. En su lugar,
+de forma predeterminada las digitaciones se colocan automáticamente
+encima y debajo de las notas del acorde, como se muestra aquí:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+<c-5 g-3>
+<c-5 g-3 e-2>
+<c-5 g-3 e-2 c-1>
+@end lilypond
+
+Es posible tener un mayor control sobre la situación exacta de las
+digitaciones mediante la utilización de la instrucción @code{\set
+fingeringOrientations}. El formato de esta instrucción es
@example
-\override DynamicLineSpanner #'padding = #2.0
+@code{\set fingeringOrientations = #'([up] [left/right] [down])}
@end example
-No podemos listar todos y cada uno de los objetos, pero presentamos a continuación una lista
-de los objetos más comunes.
-
-@multitable @columnfractions .33 .66
-@headitem Tipo de objeto @tab Nombre del objeto
-@item Expresiones dinámicas (verticalmente) @tab @code{DynamicLineSpanner}
-@item Expresiones dinámicas (horizontalmente) @tab @code{DynamicText}
-@item Ligaduras de unión @tab @code{Tie}
-@item Ligaduras de expresión @tab @code{Slur}
-@item Articulaciones @tab @code{Script}
-@item Digitaciones @tab @code{Fingering}
-@item Texto, p.ej. @code{^"text"} @tab @code{TextScript}
-@item Llamadas de ensayo o marcas de texto @tab @code{RehearsalMark}
+@noindent
+se utiliza @code{\set} porque @code{fingeringOrientations} es una
+propiedad del contexto @code{Voice}, creado y usado por el grabador
+@code{New_fingering_engraver}.
+
+La propiedad se puede establecer al valor de una lista de entre uno y
+tres valores. Controla si las digitaciones se pueden colocar por
+encima (si @code{up} aparece en la lista), por debajo (si aparece
+@code{down}), a la izquierda (si aparece @code{left}) o a la derecha
+(si aparece @code{right}). A la inversa, si una colocación no está en
+la lista, no se sitúa ninguna digitación en dicho lugar. LilyPond
+coma estas restricciones y se trabaja la mejor colocación para la
+digitación de las notas de los acordes que siguen. Observe que
+@code{left} y @code{right} son mutuamente excluyentes: las
+digitaciones pueden situarse en un lado o en el otro, no en los dos.
+
+Para controlar la colocación de la digitación de una sola nota usando
+esta instrucción es necesario escribirla como un acorde de una sola
+nota encerrándola entre ángulos simples.
+
+Aquí podemos ver algunos ejemplos:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
+\set fingeringOrientations = #'(left)
+<f-2>
+< c-1 e-2 g-3 b-5 > 4
+\set fingeringOrientations = #'(left)
+<f-2>
+< c-1 e-2 g-3 b-5 > 4
+\set fingeringOrientations = #'(up left down)
+<f-2>
+< c-1 e-2 g-3 b-5 > 4
+\set fingeringOrientations = #'(up left)
+<f-2>
+< c-1 e-2 g-3 b-5 > 4
+\set fingeringOrientations = #'(right)
+<f-2>
+< c-1 e-2 g-3 b-5 > 4
+@end lilypond
+
+@noindent
+Si la digitación parece un poco superpoblada, se puede reducir el
+tamaño @code{font-size}. El valor predeterminado puede verse en el
+objeto @code{Fingering} del RFI que es @code{-5}, así que probaremos
+@code{-7}:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
+\override Fingering #'font-size = #-7
+\set fingeringOrientations = #'(left)
+<f-2>
+< c-1 e-2 g-3 b-5 > 4
+\set fingeringOrientations = #'(left)
+<f-2>
+< c-1 e-2 g-3 b-5 > 4
+\set fingeringOrientations = #'(up left down)
+<f-2>
+< c-1 e-2 g-3 b-5 > 4
+\set fingeringOrientations = #'(up left)
+<f-2>
+< c-1 e-2 g-3 b-5 > 4
+\set fingeringOrientations = #'(right)
+<f-2>
+< c-1 e-2 g-3 b-5 > 4
+@end lilypond
+
+@node Outside staff objects
+@subsection Outside staff objects
+
+Los objetos fuera-del-pentagrama se colocan automáticamente para
+evitar las colisiones. Los objetos que tienen el valor más bajo de la
+propiedad @code{outside-staff-priority} se sitúan más cerca del
+pentagrama, y entonces otros objetos fuera-del-pentagrama se elevan
+tanto como sea necesario para evitar la colisión. La prioridad
+@code{outside-staff-priority} se defina en el @code{grob-interface} y
+así es una propiedad de todos los objetos de presentación. De forma
+predeterminada se establece a @code{#f} para todos los objetos
+dentro-del-pentagrama, y a un valor numérico adecuado a cada objeto
+fuera-del-pentagrama cuando se crea el objeto. La tabla siguiente
+presenta los valores numéricos predeterminados para algunos de los
+objetos fuera-del-pentagrama que están inicialmente dentro de los
+contextos @code{Staff} o @code{Voice}.
+
+@multitable @columnfractions .3 .3 .3
+@headitem Objeto de presentación
+ @tab Prioridad
+ @tab Controla la posición de:
+@item @code{MultiMeasureRestText}
+ @tab @code{450}
+ @tab Texto sobre silencios de compás completo
+@item @code{TextScript}
+ @tab @code{450}
+ @tab Elementos de marcado de texto
+@item @code{OttavaBracket}
+ @tab @code{400}
+ @tab Corchetes de octava alta y baja
+@item @code{TextSpanner}
+ @tab @code{350}
+ @tab Objetos de extensión de texto
+@item @code{DynamicLineSpanner}
+ @tab @code{250}
+ @tab Todas las indicaciones dinámicas
+@item @code{VoltaBracketSpanner}
+ @tab @code{100}
+ @tab Corchetes de primera y segunda vez
+@item @code{TrillSpanner}
+ @tab @code{50}
+ @tab Trinos mantenidos
+@end multitable
+
+He aquí un ejemplo que muestra la situación predeterminada de algunos
+de ellos.
+
+@cindex texto, extensiones de
+@funindex \startTextSpan
+@funindex \stopTextSpan
+@cindex octava alta y baja, corchete de
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
+% Set details for later Text Spanner
+\override TextSpanner #'bound-details #'left #'text
+ = \markup { \small \bold Slower }
+% Place dynamics above staff
+\dynamicUp
+% Start Ottava Bracket
+#(set-octavation 1)
+c' \startTextSpan
+% Add Dynamic Text
+c\pp
+% Add Dynamic Line Spanner
+c\<
+% Add Text Script
+c^Text
+c c
+% Add Dynamic Text
+c\ff c \stopTextSpan
+% Stop Ottava Bracket
+#(set-octavation 0)
+c, c c c
+@end lilypond
+
+Este ejemplo también muestra cómo crear textos con extensión (Text
+Spanners) : textos con líneas extensoras por encima de una sección de
+música. El extensor abarca desde la instrucción @code{\startTextSpan}
+hasta la instrucción @code{\stopTextSpan}, y el formado del texto se
+define por medio de la instrucción @code{\override TextSpanner}. Para
+ver más detalles, consulte @ruser{Text spanners}.
+
+También muestra la manera de crear corchetes de octava alta y baja.
+
+Observe que los números de compás, las indicaciones metronómicas y las
+mercas de ensayo no se muestran. De forma predeterminada, se crean
+dentro del contexto @code{Score} y su prioridad
+@code{outside-staff-priority} se ignora con relación a los objetos de
+presentación que se crean dentro del contexto @code{Staff}. Si quiere
+colocar los números de compás, indicaciones metronómicas o llamadas de
+ensayo en concordancia con el valor de su
+@code{outside-staff-priority}, los grabadores
+@code{Bar_number_engraver}, @code{Metronome_mark_engraver} o
+@code{Mark_engraver} respectivamente se deben eliminar del contexto
+@code{Score} y colocarlos en el contexto @code{Staff} del nivel
+superior. Si se hace así, estas marcas obtendrán los siguientes
+valores predeterminados de @code{outside-staff-priority}:
+
+@multitable @columnfractions .3 .3
+@headitem Objeto de presentación @tab Prioridad
+@item @code{RehearsalMark} @tab @code{1500}
+@item @code{MetronomeMark} @tab @code{1000}
+@item @code{BarNumber} @tab @code{ 100}
@end multitable
+Si los valores predeterminados de @code{outside-staff-priority} no le
+ofrecen las colocaciones deseadas se puede sobreescribir la prioridad
+de cualquiera de los objetos. Suponga que quisiéramos que el corchete
+de octava estuviera situado por debajo del elemento extensor de texto
+en el ejemplo de arriba. Todo lo que debemos hacer es localizar la
+prioridad de @code{OttavaBracket} en el RFI o en las tablas
+anteriores, y reducirlo a un valor inferior al de @code{TextSpanner},
+recordando que @code{OttavaBracket} se crea dentro del contexto de
+@code{Staff}:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
+% Set details for later Text Spanner
+\override TextSpanner #'bound-details #'left #'text
+ = \markup { \small \bold Slower }
+% Place dynamics above staff
+\dynamicUp
+%Place following Ottava Bracket below Text Spanners
+\once \override Staff.OttavaBracket #'outside-staff-priority = #340
+% Start Ottava Bracket
+#(set-octavation 1)
+c' \startTextSpan
+% Add Dynamic Text
+c\pp
+% Add Dynamic Line Spanner
+c\<
+% Add Text Script
+c^Text
+c c
+% Add Dynamic Text
+c\ff c \stopTextSpan
+% Stop Ottava Bracket
+#(set-octavation 0)
+c, c c c
+@end lilypond
-@node Common tweaks
-@section Common tweaks
+Los cambios en @code{outside-staff-priority} también se pueden emplear
+para controlar la situación vertical de los objetos individuales,
+aunque los resultados pueden no siempre ser deseables. Suponga que
+quiere que @qq{Text3} se sitúe por encima de @qq{Text4} en el ejemplo
+bajo el epígrafe Comportamiento Automático de más arriba (véase
+@ref{Automatic behaviour}). Todo lo que debemos hacer es localizar la
+prioridad de @code{TextScript} en el RFI o en las tablas de arriba, y
+aumentar la prioridad de @qq{Text3} hasta un valor superior:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+c2^"Text1"
+c^"Text2"
+\once \override TextScript #'outside-staff-priority = #500
+c^"Text3"
+c^"Text4"
+@end lilypond
-Algunas sustituciones son tan comunes que se proporcionan comandos preestablecidos
-como atajos, como @code{\slurUp} (ligadura hacia arriba) y @code{\stemDown} (plica hacia abajo). Estos
-comandos se describen dentro de la Referencia de Notación bajo las secciones
-correspondientes.
+Esto, ciertamente, eleva a @qq{Text3} por encima de @qq{Text4} pero
+también lo eleva por encima de @qq{Text2}, y @qq{Text4} ahora se
+desploma hacia abajo. Quizá no sea tan buena idea. ¿Y si lo que
+realmente queremos hacer es posicionar todas las anotaciones a la
+misma distancia por encima del pentagrama? Para hacerlo, vamos a
+necesitar claramente espaciar las notas en sentido horizontal para
+hacer sitio para el texto. Esto se hace empleando la instrucción
+@code{textLengthOn}.
-La lista completa de modificaciones disponibles para cada tipo de
-objeto (como ligaduras o barras de corchea) están documentadas en la Referencia del
-Programa. Sin embargo, muchos objetos de la presentación comparten propiedades que se pueden
-usar para aplicar trucos genéricos.
+@subheading \textLengthOn
-@itemize @bullet
+@funindex \textLengthOn
+@cindex notas, espaciar junto al texto
-@cindex relleno
+De forma predeterminada, el texto producido mediante marcado no ocupa
+ningún espacio horizontal en cuanto se refiere a la disposición de la
+música. La instrucción @code{\textLengthOn} invierte este
+comportamiento, ocasionando que las notas resulten tan espaciadas como
+sea necesario para acomodar el texto:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+\textLengthOn % Cause notes to space out to accommodate text
+c2^"Text1"
+c^"Text2"
+c^"Text3"
+c^"Text4"
+@end lilypond
+
+La instrucción para volver al comportamiento predeterminado es
+@code{\textLengthOff}. Recuerde que @code{\once} funciona solamente
+con @code{\override}, @code{\set}, @code{\revert} o @code{unset}, así
+que no se puede usar con @code{\textLengthOn}.
+
+El texto de marcado también evita las notas que se proyectan por
+encima del pentagrama. Si esto no es lo que deseamos, el
+desplazamiento automático hacia arriba se puede desactivar mediante el
+establecimiento de la prioridad a @code{#f}. He aquí un ejemplo que
+muestra cómo el texto de marcado interactúa con tales notas.
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+% This markup is short enough to fit without collision
+c2^"Tex"
+c''2
+R1
+% This is too long to fit, so it is displaced upwards
+c,,2^"Text"
+c''2
+R1
+% Turn off collision avoidance
+\once \override TextScript #'outside-staff-priority = ##f
+c,,2^"Long Text "
+c''2
+R1
+% Turn off collision avoidance
+\once \override TextScript #'outside-staff-priority = ##f
+\textLengthOn % and turn on textLengthOn
+c,,2^"Long Text " % Spaces at end are honoured
+c''2
+@end lilypond
+
+
+@subheading Dynamics
+
+Las indicaciones de matiz dinámico normalmente se colocarán por debajo
+del pentagrama, pero se pueden posicionar por encima con la
+instrucción @code{dynamicUp}. Se situarán verticalmente respecto a la
+nota a la que van adosadas, y flotarán por debajo (o por encima) de
+todos los objetos dentro-del-pentagrama tales como ligaduras de fraseo
+y números de compás. Esto puede ofrecer resultados bastante
+aceptables, como muestra este ejemplo:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
+\clef "bass"
+\key aes \major
+\time 9/8
+\dynamicUp
+bes4.~\f\< \( bes4 bes8 des4\ff\> c16 bes\! |
+ees,2.~\)\mf ees4 r8 |
+@end lilypond
+
+Sin embargo, si las notas y sus indicaciones dinámicas adosadas están
+muy cerca, la colocación automática evitará las colisiones desplazando
+las marcas dinámicas posteriores más lejos, aunque este puede no ser
+el lugar óptimo, como muestra el siguiente ejemplo más bien
+artificial:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+\dynamicUp
+a4\f b\mf c\mp b\p
+@end lilypond
+
+@noindent
+Si se presentara una situación similar en música @q{real}, podría ser
+preferible espaciar las notas un poco más entre sí, de forma que todas
+las marcas dinámicas puedan caber a la misma distancia vertical desde
+el pentagrama. Hemos sido capaces de hacer esto para el texto de
+marcado utilizando la instrucción @code{\textLengthOn}, pero no existe
+una instrucción equivalente para las indicaciones de matiz dinámico.
+Por tanto, tendremos que averiguar cómo hacerlo utilizando
+instrucciones @code{\override}.
+
+@subheading Grob sizing
+
+@cindex grob, cambio de tamaño de un
+@cindex escala de los grobs
+@cindex @code{X-offset}
+@cindex @code{Y-offset}
+@cindex @code{X-extent}
+@cindex @code{Y-extent}
+
+En primer lugar debemos aprender cómo se especifica el tamaño de los
+grobs. Todos los grobs tienen un punto de referencia definido dentro
+de ellos que se usa para colocarlos respecto a su objeto padre.
+Entonces, este punto del grob se posiciona a una distancia horizontal,
+@code{X-offset}, y una distancia vertical, @code{Y-offset}, a partir
+de su padre. La dimensión horizontal del objeto viene dada por una
+pareja de números, @code{X-extent}, que dice dónde están los límites
+izquierdo y derecho respecto del punto de referencia. La amplitud
+vertical se define de forma similar mediante una pareja de números,
+@code{Y-extent}. Éstas son propiedades de todos los grobs que
+contemplan el @code{grob-interface}.
+
+@cindex @code{extra-spacing-width}
+
+De forma predeterminada, los objetos fuera-del-pentagrama reciben una
+anchura cero, de manera que pueden solaparse en la dirección
+horizontal. Esto se hace mediante el truco de añadir una cantidad
+infinita a la dimensión más a la izquierda y menos infinito a la
+dimensión más a la derecha estableciendo el valor de
+@code{extra-spacing-width} a @code{'(+inf.0 . -inf.0)}. Así, para
+asegurar que no se superponen en la dirección horizontal tendremos que
+sobreescribir este valor de @code{extra-spacing-width} a @code{'(0
+. 0)} de forma que el verdadero ancho se presente. Esta es la
+instrucción que lo hace para las indicaciones dinámicas:
+
+@example
+\override DynamicText #'extra-spacing-width = #'(0 . 0)
+@end example
+
+@noindent
+Veamos si funciona en nuestro ejemplo anterior:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+\dynamicUp
+\override DynamicText #'extra-spacing-width = #'(0 . 0)
+a4\f b\mf c\mp b\p
+@end lilypond
+
+@noindent
+Bueno, ciertamente ha hecho que las marcas dinámicas ya no estén
+desplazadas, pero aún quedan dos problemas. Las marcas tendrían que
+separarse un poco más entre sí, y sería mejor si todas estuvieran a la
+misma distancia del pentagrama. Podemos resolver el primer problema
+fácilmente. En vez de hacer cero la anchura
+@code{extra-spacing-width}, podemos añadirle algo más. Las unidades
+son el espacio entre dos líneas de pentagrama, así que al mover el
+límite izquierdo media unidad a la izquierda y el límite derecho media
+unidad hacia la derecha, deberíamos conseguirlo:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+\dynamicUp
+% Extend width by 1 staff space
+\override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
+a4\f b\mf c\mp b\p
+@end lilypond
+
+@noindent
+Esto tiene un mejor aspecto, pero quizá habríamos preferido que las
+indicaciones de dinámica estuvieran alineadas sobre la misma línea de
+base en lugar de ir hacia arriba y hacia abajo con las notas. La
+propiedad que lo hace es @code{staff-padding} (relleno de pentagrama)
+que se estudia en la sección siguiente.
+
+
+@node Collisions of objects
+@section Collisions of objects
+
+@menu
+* Moving objects::
+* Fixing overlapping notation::
+* Real music example::
+@end menu
+
+@node Moving objects
+@subsection Moving objects
+
+Aunque pueda sorprenderle, LilyPond no es perfecto. Ciertos elementos
+de notación se pueden superponer, lo que es una lástima, pero en
+realidad es bastante poco frecuente. Normalmente la necesidad de
+mover objetos es por claridad o razones estéticas: el aspecto es mejor
+con un poco más o un poco menos de espacio de separación.
+
+Existen tres enfoques principales que llevan a la resolución de
+superposiciones en la notación. Se deben considerar en el siguiente
+orden:
+
+@enumerate
+@item
+La @strong{dirección} de uno de los objetos que se superponen se puede
+cambiar usando las instrucciones predefinidas que están relacionadas
+arriba para los objetos dentro-del-pentagrama (véase @ref{Within-staff
+objects}). Se pueden recolocar fácilmente las plicas, ligaduras de
+expresión y de unión, barras de corchea, indicaciones dinámicas, texto
+y grupos de valoración especial de esta forma. La limitación es que
+sólo tiene la posibilidad de elegir entre dos posiciones, y podría ser
+que ninguna de ellas sea la adecuada.
+
+@item
+Las @strong{propiedades del objeto}, que LilyPond usa cuando está
+colocando los objetos de presentación, se pueden modificar usando la
+instrucción de sobreescritura @code{\override}. Las ventadas de hacer
+cambios a este tipo de propiedad son: a) que algún otro objeto se
+moverá automáticamente si es necesario, para dejarle sitio, y b) una
+única sobreescritura se puede aplicar a todas las instancias del mismo
+tipo de objeto. Entre tales propiedades se encuentran:
+@itemize
+
+@item
+@code{direction} (dirección)
+
+Ya se ha estudiado con cierto detalle: véase @ref{Within-staff
+objects}.
@item
-La propiedad @code{padding} (relleno) se puede establecer de forma que incremente
-(o disminuya) la distancia entre símbolos que se imprimen encima
-o debajo de las notas. Se aplica a todos los objetos con
+@code{padding} (relleno), @code{left-padding} (relleno por la
+izquierda), @code{right-padding} (relleno por la derecha),
+@code{staff-padding} (relleno de pentagrama)
+
+@cindex left-padding, propiedad
+@cindex padding, propiedad
+@cindex right-padding, propiedad
+@cindex staff-padding, propiedad
+Según un objeto se está colocando, el valor de su propiedad de relleno
+@code{padding} especifica el espacio intermedio que se debe dejar
+entre él mismo y el límite más próximo del objeto contra el que se
+está colocando. Observe que es el valor de @code{padding} del objeto
+@strong{que se está colocando} el que se usa; el valor de
+@code{padding} del objeto que ya está colocado se ignora. Los
+espacios intermedios especificados mediante @code{padding} se pueden
+aplicar a todos los objetos que contemplan el interface
@code{side-position-interface}.
+En lugar de con @code{padding}, la colocación de los grupos de
+alteraciones se controla con @code{left-padding} y
+@code{right-padding}. Estas propiedades se encontrarán en el objeto
+@code{AccidentalPlacement} que, observe, vive dentro del contexto de
+@strong{staff}. Como las alteraciones accidentales siempre se
+posicionan según las cabezas de las notas y a su izquierda, solamente
+tiene algún efecto la propiedad de relleno por la derecha
+@code{right-padding}.
+
+La propiedad @code{staff-padding} está estrechamente relacionada con
+la propiedad @code{padding}: @code{padding} controla la separación
+mínima entre cualquier objeto que contemple el interface
+@code{side-position-interface} y el objeto más cercano (generalmente
+la nota o las líneas del pentagrama); @code{staff-padding} se aplica
+sólo a los objetos que siempre se sitúan fuera del pentagrama:
+controla la separación mínima entre dicho objeto y el pentagrama.
+Observe que @code{staff-padding} no tiene ningún efecto sobre objetos
+que se posicionan respecto a la nota en vez de hacerlo respecto al
+pentagrama, incluso aunque puede ser sobreescrito sin error por tales
+objetos: simplemente se ignora.
+
+Para descubrir qué propiedad de relleno se necesita para el objeto que
+quiere recolocar, debe volver al manual de RFI y buscar las
+propiedades del objeto. Tenga cuidado porque las propiedades de
+relleno podrían no estar en el objeto más obvio, así que busque en los
+objetos que puedan tener alguna relación con él.
+
+Todos los valores de relleno se miden en espacios del pentagrama.
+Para la mayor parte de los objetos el valor se establece de forma
+predeterminada en aproximadamente 1.0 o menos (varía con cada objeto).
+Se puede sobreescribir si se necesita una separación intermedia mayor
+(o menor).
+
+@item
+@code{self-alignment-X} (Auto-alineamiento en el eje X)
+
+@cindex self-alignment-X, propiedad
+Esta propiedad se puede usar para alinear el objeto a la izquierda, a
+la derecha, o centrarlo con respecto al punto de referencia del objeto
+«padre». Se puede usar con todos los objetos que contemplan el
+interface
+@code{self-alignment-interface}. En general son objetos que contienen
+texto. Los valores son @code{LEFT}, @code{RIGHT} o @code{CENTER}. De
+forma alternativa se puede especificar un valor numérico entre
+@code{-1} y @code{+1}, donde @code{-1} es alineado por la izquierda,
+@code{+1} es alineado por la derecha, y los números intermedios mueven
+el texto progresivamente desde alineado por la izquierda hasta alineado
+por la derecha. Se pueden especificar valores numéricos mayores de
+@code{1} para mover el texto incluso más lejos hacia la izquierda, o
+menos de @code{-1} para alejarlo más hacia la derecha. Un cambio en
+@code{1} en el valor corresponde a un movimiento de la mitad de la
+longitud total del propio texto.
+
+@item
+@code{extra-spacing-width} (anchura de separación adicional)
+
+@cindex extra-spacing-width, propiedad
+Esta propiedad está disponible para todos los objetos que contemplan
+el interface @code{item-interface}. Toma dos números, el primero se
+suma al límite izquierdo y el segundo se suma al límite derecho. Los
+números negativos desplazan el límite a la izquierda y los positivos a
+la derecha, por lo que para ensanchar un objeto el primer número debe
+ser negativo y el segundo positivo. Observe que no todos los objetos
+ostentan los dos números. Por ejemplo, el objeto @code{Accidental}
+(alteración) sólo toma nota del primer número (el borde izquierdo).
+
+@item
+@code{staff-position} (posición de pentagrama)
+
+@cindex staff-position, propiedad
+@code{staff-position} es una propiedad del interface
+@code{staff-symbol-referencer-interface}, que está contemplado por los
+objetos que se colocan con relación al pentagrama. Especifica la
+posición vertical del objeto con relación a la tercera línea del
+pentagrama en medios espacios de pentagrama. Es útil en la
+resolución de colisiones entre objetos de presentación como silencios
+multi-compás, ligaduras de unión y notas en distintas voces.
+
+@item
+@code{force-hshift} (forzar desplazamiento horizontal)
+
+@cindex force-hshift, propiedad
+
+Las notas muy juntas de un acorde, o aquellas que ocurren al mismo
+tiempo en voces distintas, se disponen en dos (y ocasionalmente más)
+columnas para evitar la superposición de las cabezas. Éstas reciben
+el nombre de columnas de notas, y se crea un objeto llamado
+@code{NoteColumn} para disponer las notas en dicha columna.
+
+La propiedad @code{force-hshift} es una propiedad de una
+@code{NoteColumn} (realmente lo es del interface
+@code{note-column-interface}). Modificarlo permite mover una columna
+de notas en unidades adecuadas a una columna de notas, por ejemplo la
+anchura de la cabeza de la nota de la primera voz. Se debe usar en
+situaciones complejas donde las instrucciones @code{\shiftOn} normales
+(véase @ref{Explicitly instantiating voices}) no resuelven el
+conflicto entre las notas. Es preferible a la propiedad
+@code{extra-offset} para este propósito porque no hay necesidad de
+averiguar la distancia en espacios de pentagrama, y mover las notas
+dentro o fuera de una @code{NoteColumn} afecta a otras acciones como a
+la fusión entre cabezas de nota.
+
+@end itemize
+
+@item
+Finalmente, cuando todo lo demás falla, los objetos se pueden
+reposicionar manualmente con relación a la tercera línea del
+pentagrama verticalmente, o desplazándolas una cierta distancia a una
+nueva posición. Las desventajas son que los valores correctos para el
+reposicionamiento se deben adivinar, a menudo por ensayo y error, para
+cada objeto individual y, puesto que el movimiento se hace después de
+que LilyPond ha colocado todos los demás objetos es usuario es
+responsable de evitar cualquier colisión que pudiera producirse. Pero
+la dificultar principal con este enfoque es que los valores de
+reposicionado podrían tener que ser vueltos a calcular si la música se
+modifica más tarde. Las propiedades que se pueden usar para este tipo
+de posicionamiento manual son:
+
+@table @code
+@item extra-offset (desplazamiento adicional)
+@cindex extra-offset, propiedad
+Esta propiedad se aplica a cualquier objeto de presentación que
+contemple el @code{grob-interface}. Toma una pareja de números que
+especifican el desplazamiento adicional en las direcciones horizontal
+y vertical. Los números negativos mueven el objeto a la izquierda o
+hacia abajo. Las unidades son espacios de pentagrama. El
+desplazamiento adicional se hace después de que la composición
+tipográfica de los objetos ha terminado, así que un objeto puede ser
+reposicionado a cualquier lugar sin afectar a ninguna otra cosa.
+
+@item positions (posiciones)
+@cindex positions, propiedad
+Ésta es de la mayor utilidad para ajustar manualmente la inclinación y
+la altura de las barras de corchea, ligaduras de expresión y corchetes
+de grupos de valoración especial. Toma una pareja de números que dan
+la posición de los extremos izquierdo y derecho de la barra, ligadura,
+etc. con relación a la tercera línea del pentagrama. Las unidades son
+espacios de pentagrama. Observe, sin embargo, que las ligaduras de
+expresión y de fraseo no se pueden reposicionar en cantidades
+arbitrariamente grandes. LilyPond en primer lugar genera una lista de
+posiciones posibles para la ligadura y de forma predeterminada
+encuentra la ligadura que tiene @qq{mejor aspecto}. Si la propiedad
+@code{positions} se ha sobreescrito, la ligadura que está más cerca de
+las posiciones que se han solicitado, se selecciona de la lista.
+@end table
+
+@end enumerate
+
+Un objeto en particular podría no tener todas estas propiedades. Es
+necesario ir al manual RFI para buscar qué propiedades se encuentran
+disponibles para el objeto en cuestión.
+
+
+Aquí presentamos una lista de los objetos que es más probable que
+estén implicados en colisiones, con el nombre del objeto que habría
+que buscar en el RFI para descubrir qué propiedades se deben usar para
+moverlos.
+
+@multitable @columnfractions .5 .5
+@headitem Tipo de objeto @tab Nombre del objeto
+@item Articulaciones @tab @code{Script}
+@item Barras @tab @code{Beam}
+@item Dinámica (verticalmente) @tab @code{DynamicLineSpanner}
+@item Dinámica (horizontalmente) @tab @code{DynamicText}
+@item Digitaciones @tab @code{Fingering}
+@item Llamadas de ensayo y textuales @tab @code{RehearsalMark}
+@item Ligaduras de expresión @tab @code{Slur}
+@item Texto, por ejemplo @code{^"texto"} @tab @code{TextScript}
+@item Ligaduras de unión @tab @code{Tie}
+@item Grupos de valoración especial @tab @code{TupletBracket}
+@end multitable
+
+
+@node Fixing overlapping notation
+@subsection Fixing overlapping notation
+
+Veamos ahora cómo pueden ser de ayuda las propiedades que hemos visto
+en la sección anterior, para resolver problemas de notación que se
+superpone.
+
+@subheading padding property
+@cindex relleno, propiedad
+@cindex padding, propiedad
+
+La propiedad @code{padding} se puede ajustar para aumentar (o
+disminuir) la distancia entre símbolos impresos encima o debajo de las
+notas.
+
@lilypond[quote,fragment,relative=1,verbatim]
c2\fermata
\override Script #'padding = #3
d1
@end lilypond
-Observe en el segundo ejemplo cuán importante es determinar qué contexto
-maneja un objeto determinado. Debido a que el objeto @code{MetronomeMark} (indicación metronómica)
-se maneja en el contexto @code{Score}, los cambios de propiedades dentro del
-contexto @code{Voice} no se tendrán en cuenta. Para ver más detalles, consulte
-@ruser{Constructing a tweak}.
+Observe en el segundo ejemplo la gran importancia que tiene saber qué
+contexto maneja un determinado objeto. Puesto que el objeto
+@code{MetronomeMark} se maneja dentro del contexto @code{Score}, los
+cambios de propiedades en el contexto @code{Voice} pasarán
+inadvertidos. Para ver más detalles, consulte @ruser{Constructing a
+tweak}.
-@cindex extra-offset (desplazamiento adicional)
+Si la propiedad de relleno @code{padding} de un objeto se incrementa
+cuando dicho objeto se encuentra en una pila de objetos que se están
+colocando de acuerdo a su prioridad @code{outside-staff-priority},
+entonces ese objeto se moverá, y también todos los que están por fuera
+de él.
-@item
-La propiedad @code{extra-offset} mueve objetos en la salida;
-requiere una pareja de números. El primer número
-controla el movimiento horizontal, un número positivo moverá
-el objeto hacia la derecha. El segundo número controla el movimiento
-vertical; un número positivo lo desplazará hacia arriba. La
-propiedad @code{extra-offset} es una funcionalidad de bajo nivel: el motor
-de formateo es completamente olvidadizo respecto de estos desplazamientos.
-En el ejemplo siguiente, la segunda digitación se desplaza un poco hacia
-la izquierda y 1.8 espacios de pentagrama hacia abajo:
+@subheading left-padding and right-padding
+@cindex left-padding, propiedad
+@cindex right-padding, propiedad
+
+La propiedad @code{right-padding} afecta al espaciado entre la
+alteración y la nota a que se aplica. Normalmente no es necesaria,
+pero el ejemplo siguiente muestra una situación en la que sí se
+necesita. Suponga que queremos presentar un acorde que contiene un Si
+natural y un Si bemol. Para evitar la ambigüedad querríamos preceder
+las notas con un becuadro y un bemol. Aquí vienen varios intentos de
+hacerlo así:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+<b bes>
+<b! bes>
+<b? bes>
+@end lilypond
+
+Ninguno de ellos funciona y el segundo además presenta una fea
+colisión entre las dos alteraciones.
+
+Una forma de conseguirlo es sobreescribir el sello de la alteración
+con un elemento de marcado que contenga los símbolos de becuadro y
+bemol en el orden que nos gustaría que estuvieran, así:
+
+@lilypond[quote,ragged-right,verbatim]
+naturalplusflat = \markup { \natural \flat }
+\relative c'' {
+ \once \override Accidental
+ #'stencil = #ly:text-interface::print
+ \once \override Accidental #'text = #naturalplusflat
+ \once \override Score.AccidentalPlacement #'right-padding = #1.5
+ <b bes>
+}
+@end lilypond
+
+@noindent
+Esto utiliza necesariamente una sobreescritura para el sello de la
+alteración que no se estudiará hasta más adelante. El tipo de sello
+debe ser un procedimiento, aquí modificado para que imprima el
+contenido de la propiedad @code{text} del objeto @code{Accidental},
+que a su vez está establecido como un signo de becuadro seguido de un
+bemol. Entonces el conjunto se puede separar de la cabeza de la nota
+sobreescribiendo @code{right-padding}.
+
+@noindent
+
+@subheading staff-padding property
+@cindex staff-padding, propiedad
+
+@code{staff-padding} se puede usar para alinear objetos como matices
+dinámicos a lo largo de una línea de base a una altura fija sobre el
+pentagrama, en lugar de hacerlo a una altura que dependa de la
+posición de la nota a la que están adosados. No es una propiedad de
+@code{DynamicText} sino de @code{DynamicLineSpanner}. Esto es así
+porque la línea de base debe aplicarse por igual a @strong{todas} las
+dinámicas, entre ellas las que se han creado como objetos de
+extensión. Así que ésta es la forma de alinear las indicaciones de
+matiz en el ejemplo de la sección anterior:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+\dynamicUp
+% Extend width by 1 unit
+\override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
+% Align dynamics to a base line 2 units above staff
+\override DynamicLineSpanner #'staff-padding = #2
+a4\f b\mf c\mp b\p
+@end lilypond
+
+
+@subheading self-alignment-X property
+@cindex self-alignment-X, propiedad
+
+El ejemplo siguiente muestra cómo esto puede resolver la colisión
+entre un objeto de digitación de cuerda y la plica de una nota
+mediante el alineamiento del límite derecho con el punto de referencia
+de la nota «padre»:
+
+@lilypond[quote,fragment,ragged-right,verbatim,relative=3]
+\voiceOne
+< a \2 >
+\once \override StringNumber #'self-alignment-X = #RIGHT
+< a \2 >
+@end lilypond
+
+@subheading staff-position property
+@cindex staff-position, propiedad
+
+Los silencios multi-compás en una voz pueden chocar con las notas en
+otra voz. Puesto que estos silencios se tipografían centrados entre
+las barras de compás se necesitaría bastante esfuerzo para que
+LilyPond averiguara qué otras notas podrían chocar con él, ya que
+actualmente todo el manejo de colisiones entre notas y silencios se
+hace solamente para notas y silencios que ocurren al mismo tiempo. He
+aquí un ejemplo de colisión de este tipo:
+
+@lilypond[quote,verbatim,fragment,ragged-right, relative=1]
+<< {c c c c} \\ {R1} >>
+@end lilypond
+
+La mejor solución aquí es mover el silencio multi-compás hacia abajo,
+pues el silencio está en la voz dos. El ajuste predeterminado para
+@code{\voiceTwo} (es decir, en la segunda voz de una construcción
+@code{<<@{...@} \\ @{...@}>>}) es que @code{staff-position} tenga el
+valor -4 para MultiMeasureRest, así que tenemos que bajarlo, digamos,
+cuatro semi-espacios de pentagrama, al valor @code{-8}.
+
+@lilypond[quote,verbatim,fragment,ragged-right, relative=1]
+<<
+ {c c c c}
+\\
+ \override MultiMeasureRest #'staff-position = #-8
+ {R1}
+>>
+@end lilypond
+
+Esto es mejor que utilizar, por ejemplo, @code{extra-offset}, porque
+la línea adicional por encima del silencio se inserta automáticamente.
+
+@subheading extra-offset property
+@cindex extra-offset, propiedad
+
+La propiedad @code{extra-offset} da un completo control sobre el
+posicionamiento de un objeto tanto vertical como horizontalmente.
+
+En el ejemplo siguiente, la segunda digitación se desplaza ligeramente
+a la izquierda, y 1.8 espacios de pentagrama hacia abajo:
@lilypond[quote,fragment,relative=1,verbatim]
\stemUp
f-5
@end lilypond
-@item
-El establecimiento de la propiedad @code{transparent} provocará que un objeto se imprima
-con @q{tinta invisible}: el objeto no se imprime, pero se conserva todo el resto
-de su comportamiento. El objeto aún ocupa un espacio, toma parte en las colisiones,
-y se le pueden adjuntar ligaduras de unión o de expresión y barras de corchea.
-@cindex objetos transparentes
-@cindex quitar objetos
-@cindex ocultar objetos
-@cindex objetos invisibles
-El ejemplo siguiente demuestra cómo conectar distintas voces
-utilizando ligaduras. Normalmente las ligaduras sólo unen dos notas de la misma voz.
-Al introducir una ligadura en una voz distinta,
+@subheading positions property
+@cindex positions, propiedad
-@lilypond[quote,fragment,relative=2]
-<< {
- b8~ b8\noBeam
-} \\ {
- b[ g8]
-} >>
+La propiedad @code{positions} permite controlar manualmente la
+posición e inclinación de los tresillos, ligaduras de expresión y de
+fraseo, y barras de corchea. He aquí un ejemplo que tiene una fea
+ligadura de fraseo debido a que intenta evitar la ligadura de
+expresión que está sobre la acciaccatura.
+
+@lilypond[quote,verbatim,fragment,ragged-right,relative=1]
+r4 \acciaccatura e8\( d8 c ~c d c d\)
@end lilypond
@noindent
-y suprimiendo la primera plica hacia arriba en dicha voz, la ligadura parece cruzarse de una
-voz a otra:
+Simplemente podemos mover la ligadura de fraseo por encima de las
+notas, y de hecho ésta será la solución preferida:
+@lilypond[quote,verbatim,fragment,ragged-right,relative=1]
+r4
+\phrasingSlurUp
+\acciaccatura e8\( d8 c ~c d c d\)
+@end lilypond
-@lilypond[quote,fragment,relative=2,verbatim]
-<< {
- \once \override Stem #'transparent = ##t
- b8~ b8\noBeam
-} \\ {
- b[ g8]
-} >>
+@noindent
+pero si por algún motivo no pudiéramos hacerlo, la otra alternativa
+sería mover el extremo izquierdo de la ligadura de fraseo un poco
+hacia abajo usando la propiedad @code{positions}. Esto también
+resuelve la forma algo indecente de la ligadura.
+
+@lilypond[quote,verbatim,fragment,ragged-right,relative=1]
+r4
+\once \override PhrasingSlur #'positions = #'(-4 . -3)
+\acciaccatura
+e8\( d8 c ~c d c d\)
@end lilypond
-Para asegurarse de que la plica que hemos suprimido no aprieta demasiado a la
-ligadura, también alargamos la plica, estableciendo su @code{length} (longitud) a
-@code{8},
+Presentamos un ejemplo más extraído del comienzo del pentagrama de la
+mano izquierda del preludio de Chopin Op 28 No. 2. vemos que la barra
+choca con las notas superiores:
-@lilypond[quote,fragment,relative=2,verbatim]
-<< {
- \once \override Stem #'transparent = ##t
- \once \override Stem #'length = #8
- b8~ b8\noBeam
-} \\ {
- b[ g8]
-} >>
+@lilypond[quote,verbatim,fragment,ragged-right]
+{
+\clef "bass"
+<< {b,8 ais, b, g,} \\ {e, g e, g} >>
+<< {b,8 ais, b, g,} \\ {e, g e, g} >>
+}
@end lilypond
-@end itemize
-
-@cindex Trucos, distancias
-@cindex Distancias
+@noindent
+Esto se puede resolver manualmente elevando los dos extremos de la
+barra desde su posición a dos espacios de pentagrama sobre la línea
+central hasta, digamos, 3 espacios:
-Las distancias en LilyPond se miden en espacios de pentagrama, mientras que
-las propiedades de grosor se miden en grosores de líneas de pentagrama. Algunas
-propiedades son diferentes; por ejemplo, el grosor de las barras de corchea
-se mide en espacios de pentagrama. Para más información, consulte la porción
-correspondiente de la referencia del programa.
+@lilypond[quote,verbatim,fragment,ragged-right]
+{
+ \clef "bass"
+ <<
+ \override Beam #'positions = #'(3 . 3)
+ {b,8 ais, b, g,}
+ \\
+ {e, g e, g}
+ >>
+ << {b,8 ais, b, g,} \\ {e, g e, g} >>
+}
+@end lilypond
+@noindent
+Observe que la sobreescritura sigue aplicándose en la primera voz del
+segundo bloque de corcheas, pero no a ninguna de las barras de la
+segunda voz.
+
+@subheading force-hshift property
+@cindex force-hshift, propiedad
+@c FIXME: formatting stuff (ie not important right now IMO)
+@c @a nchor Chopin finally corrected TODOgp
+
+Ahora podremos ver cómo aplicar las correcciones finales al ejemplo de
+Chopin que presentamos al final de @ref{I'm hearing Voices}, que
+dejamos con este aspecto:
+
+@lilypond[quote,verbatim,fragment,ragged-right]
+\new Staff \relative c'' {
+ \key aes \major
+ <<
+ { c2 aes4. bes8 } \\
+ { aes2 f4 fes } \\
+ { \voiceFour
+ <ees c>2
+ des2
+ }
+ >> |
+ <c ees aes c>1 |
+}
+@end lilypond
-@menu
-* Size of objects::
-@end menu
+@noindent
+Las dos notas inferiores del primer acorde (es decir, las que están en
+al tercera voz) no deberían separarse de la columna de notas de las dos
+notas agudas. Para corregir esto, establecemos el valor de
+@code{force-hshift} (que es una propiedad de @code{NoteColumn}) de
+esas notas a cero. La nota más grave del segundo acorde se sitúa
+mejor justo a la derecha de las más agudas. Lo conseguimos
+estableciendo el valor de @code{force-hshift} de esta nota a 0.5, o
+sea, la anchura de media cabeza de nota a la derecha de la columna de
+las notas agudas.
+
+Presentamos a continuación el resultado final:
+
+@lilypond[quote,verbatim,fragment,ragged-right]
+\new Staff \relative c'' {
+ \key aes \major
+ <<
+ { c2 aes4. bes8 } \\
+ { aes2 f4 fes } \\
+ { \voiceFour
+ \once \override NoteColumn #'force-hshift = #0 <ees c>2
+ \once \override NoteColumn #'force-hshift = #0.5 des2
+ }
+ >> |
+ <c ees aes c>1 |
+}
+@end lilypond
-@node Size of objects
-@subsection Size of objects
-UNTRANSLATED NODE: IGNORE ME
+@node Real music example
+@subsection Real music example
+
+Finalizaremos esta sección sobre los trucos mostrando los pasos que se
+deben tomar para tratar con un ejemplo complicado que necesita varios
+trucos para producir el resultado deseado. El ejemplo se ha escogido
+deliberadamente para ilustrar el uso de la Referencia de la Notación
+para resolver problemas de notación poco comunes. No es
+representativo de un proceso de grabado más usual, por lo que ¡le
+recomendamos que no deje que estas dificultades le desanimen!
+¡Afortunadamente, las dificultades como éstas no son muy comunes!
+
+El ejemplo está extraído de la Primera Balada de Chopin, Op. 23,
+compases 6 al 9, la transición entre el Lento inicial y el Moderato.
+Presentamos en primer lugar el aspecto que queremos que tenga el
+resultado, pero para evitar complicar demasiado el ejemplo hemos
+quitado las indicaciones dinámicas, las digitaciones y el pedal.
+
+@c The following should appear as music without code
+@lilypond[quote,ragged-right]
+rhMusic = \relative c'' {
+ r2
+ c4.\( g8 |
+ \once \override Tie #'staff-position = #3.5
+ bes1~ |
+ \bar "||"
+ \time 6/4
+ \override Staff.NoteCollision #'merge-differently-headed = ##t
+ \override Staff.NoteCollision #'merge-differently-dotted = ##t
+ bes2.^\markup {\bold "Moderato"} r8
+ <<
+ {c,8[ d fis bes a] | }
+ \\
+ % Reposition the c2 to the right of the merged note
+ {c,8~ \once \override NoteColumn #'force-hshift = #1.0
+ % Move the c2 out of the main note column so the merge will work
+ \shiftOnn c2}
+ \\
+ % Stem on the d2 must be down to permit merging
+ {s8 \stemDown \once \override Stem #'transparent = ##t d2}
+ \\
+ {s4 fis4.}
+ >>
+ \revert Staff.NoteCollision #'merge-differently-headed
+ \revert Staff.NoteCollision #'merge-differently-dotted
+ g2.\)
+}
-@node Default files
-@section Default files
+lhMusic = \relative c' {
+ r2 <c g ees>2( |
+ <d g, d>1)\arpeggio |
+ r2. d,,4 r4 r |
+ r4
+}
-La documentación de la Referencia del Programa contiene una gran cantidad de información
-sobre LilyPond, pero más información aún se puede obtener a partir de la observación
-de los archivos internos de LilyPond.
+\score {
+ \new PianoStaff <<
+ \new Staff = "RH" <<
+ \key g \minor
+ \rhMusic
+ >>
+ \new Staff = "LH" <<
+ \key g \minor
+ \clef "bass"
+ \lhMusic
+ >>
+ >>
+}
+@end lilypond
-Algunos ajustes por omisión como las definiciones de las
-@code{\header@{@}}s (encabezamientos) están almacenados en archivos @code{.ly}.
-Otros ajustes como las definiciones de los comandos de marcado se almacenan
-como archivos @code{.scm} (de Scheme). Cae fuera del ámbito de presente manual
-cualquier explicación más profunda; los usuarios están advertidos de que se necesita
-una considerable cantidad de conocimientos técnicos
-para comprender estos archivos.
+Observamos en primer lugar que la parte de la mano derecha del tercer
+compás requiere cuatro voces. Son las cinco corcheas unidas por una
+barra, la nota Do ligada, el Re blanca que se funde con el Re corchea,
+y el Fa sostenido negra con puntillo, que también está fundida con la
+corchea de su misma altura. Todo lo demás está en una sola voz, así
+que lo más fácil es introducir estas cuatro voces temporalmente en el
+momento en que se necesiten. Si ha olvidado cómo hacerlo, lea
+@ref{I'm hearing Voices}. Vamos a comenzar introduciendo las notas
+como dos variables y disponiendo la estructura de pentagramas en un
+bloque score, y veremos qué produce LilyPond de forma predeterminada:
-@itemize @bullet
+@lilypond[quote,verbatim,ragged-right]
+rhMusic = \relative c'' {
+ r2 c4. g8 |
+ bes1~ |
+ \time 6/4
+ bes2. r8
+ % Start polyphonic section of four voices
+ <<
+ {c,8 d fis bes a | }
+ \\
+ {c,8~ c2 | }
+ \\
+ {s8 d2 | }
+ \\
+ {s4 fis4. | }
+ >>
+ g2.
+}
-@item Linux: @file{@var{directorio_de_instalación}/lilypond/usr/share/lilypond/current/}
+lhMusic = \relative c' {
+ r2 <c g ees>2 |
+ <d g, d>1 |
+ r2. d,,4 r4 r |
+ r4
+}
-@item OSX:
-@file{@var{carpeta_de_instalación}/LilyPond.app/Contents/Resources/share/lilypond/current/}.
-Para llegar aquí, o bien entre con @code{cd} en este directorio desde el
-Terminal, o haga control-clic sobre la aplicación LilyPond y elija
-@q{Mostrar el Contenido del Paquete}.
+\score {
+ \new PianoStaff <<
+ \new Staff = "RH" <<
+ \key g \minor
+ \rhMusic
+ >>
+ \new Staff = "LH" <<
+ \key g \minor
+ \clef "bass"
+ \lhMusic
+ >>
+ >>
+}
+@end lilypond
-@item Windows: @file{@var{carpeta_de_instalación}/LilyPond/usr/share/lilypond/current/}
+Todas las notas son correctas, pero el aspecto está lejos de ser
+satisfactorio. La ligadura de unión choca con el cambio de compás, el
+barrado del tercer compás es incorrecto, las notas no se funden
+correctamente, y faltan algunos elementos de notación. En primer
+lugar trataremos con lo más fácil. Podemos corregir el barrado de las
+corcheas insertando una barra manualmente, y podemos añadir fácilmente
+la ligadura de expresión de la mano izquierda y la ligadura de fraseo
+de la mano derecha, pues todo ello se estudió en el Tutorial. Al
+hacerlo así obtenemos:
-@end itemize
+@lilypond[quote,verbatim,ragged-right]
+rhMusic = \relative c'' {
+ r2 c4.\( g8 |
+ bes1~ |
+ \time 6/4
+ bes2. r8
+ % Start polyphonic section of four voices
+ <<
+ {c,8[ d fis bes a] | }
+ \\
+ {c,8~ c2 | }
+ \\
+ {s8 d2 | }
+ \\
+ {s4 fis4. | }
+ >>
+ g2.\)
+}
-Los directorios @file{ly/} y @file{scm/} son de especial interés.
-Archivos como @file{ly/property-init.ly} y
-@file{ly/declarations-init.ly} definen todos los trucos comunes.
+lhMusic = \relative c' {
+ r2 <c g ees>2( |
+ <d g, d>1) |
+ r2. d,,4 r4 r |
+ r4
+}
+\score {
+ \new PianoStaff <<
+ \new Staff = "RH" <<
+ \key g \minor
+ \rhMusic
+ >>
+ \new Staff = "LH" <<
+ \key g \minor
+ \clef "bass"
+ \lhMusic
+ >>
+ >>
+}
+@end lilypond
-@node Fitting music onto fewer pages
-@section Fitting music onto fewer pages
+El primer compás ahora es correcto. El segundo compás contiene un
+arpegio y acaba en una doble barra. ¿Cómo los hacemos, pues no han
+sido mencionados en este Manual de Aprendizaje? Aquí es donde tenemos
+que volver e la Referencia de la Notación. Buscando la palabra
+@q{arpegio} y @q{línea divisoria} en el índice nos muestra rápidamente
+que un arpegio se hace añadiendo @code{\arpeggio} a un acorde, y la
+doble barra se produce por medio de la instrucción @code{\bar "||"}.
+Esto podemos hacerlo fácilmente. A continuación tenemos que corregir
+la colisión entre la ligadura de unión y la indicación de compás.
+Esto se hace mejor moviendo la ligadura hacia arriba. Estudiamos cómo
+mover objetos anteriormente en @ref{Moving objects}, donde dice que
+los objetos que están situados de forma relativa al pentagrama se
+pueden mover sobreescribiendo su propiedad @code{staff-position}, que
+se especifica en unidades de medio espacio de pentagrama respecto de
+la línea central del pentagrama. Así pues, la sobreescritura
+siguiente colocada justo antes de la primera nota ligada subirá la
+ligadura 3.5 medios espacios de pentagrama por encima de la línea
+central:
+
+@code{\once \override Tie #'staff-position = #3.5}
+
+Con esto se completa el compás dos, dando como resultado:
-A veces puede acabar con uno o dos pentagramas en una segunda página
-(o tercera, o cuarta...). Es fastidioso sobre todo si observa las
-páginas anteriores y parece haber
-espacio suficiente en ellas.
+@lilypond[quote,verbatim,ragged-right]
+rhMusic = \relative c'' {
+ r2 c4.\( g8 |
+ \once \override Tie #'staff-position = #3.5
+ bes1~ |
+ \bar "||"
+ \time 6/4
+ bes2. r8
+ % Start polyphonic section of four voices
+ <<
+ {c,8[ d fis bes a] | }
+ \\
+ {c,8~ c2 | }
+ \\
+ {s8 d2 | }
+ \\
+ {s4 fis4. | }
+ >>
+ g2.\)
+}
-Al investigar asuntos relacionados con la presentación, la herramienta
-@code{annotate-spacing} (anotar el espaciado) no tiene precio.
-Este comando imprime los valores de algunos comandos de espaciado;
-consulte @ruser{Displaying spacing} para ver más detalles. A partir de
-la salida de de @code{annotate-spacing}, podemos ver qué márgenes podríamos desear alterar.
+lhMusic = \relative c' {
+ r2 <c g ees>2( |
+ <d g, d>1)\arpeggio |
+ r2. d,,4 r4 r |
+ r4
+}
-Aparte de los márgenes, existen otras opciones para ahorrar espacio:
+\score {
+ \new PianoStaff <<
+ \new Staff = "RH" <<
+ \key g \minor
+ \rhMusic
+ >>
+ \new Staff = "LH" <<
+ \key g \minor
+ \clef "bass"
+ \lhMusic
+ >>
+ >>
+}
+@end lilypond
-@itemize
-@item
-Puede indicarle a LilyPond que coloque los sistemas tan juntos como sea
-posible (para que quepan tantos sistemas como sea posible sobre una página),
-pero luego separar estos sistemas para que no haya ningún espacio vacío
-al final de la página.
+Vayamos ahora al tercer compás y comienzo de la sección Moderato. El
+tutorial nos enseñó cómo escribir texto en negrita mediante la
+instrucción @code{\markup}, por lo que añadir @q{Moderato} en negrita
+es fácil. Pero ahora ¿cómo fundimos notas que están en distintas
+voces? El índice de la Referencia de la Notación no menciona la
+mezcla de notas, pero una búsqueda de texto por la palabra @q{fusión}
+o @q{mezcla} nos lleva rápidamente a las sobreescrituras necesarias
+para mezclar o fusionar notas con distinta cabeza y con o sin puntillo
+en @ruser{Collision Resolution}. En nuestro ejemplo tenemos que
+fusionar ambos tipos de nota en el transcurso de la sección polifónica
+del compás 3; por tanto, en virtud de la información que aparece en la
+Referencia de la Notación, escribimos
@example
-\paper @{
- between-system-padding = #0.1
- between-system-space = #0.1
- ragged-last-bottom = ##f
- ragged-bottom = ##f
-@}
+\override Staff.NoteCollision #'merge-differently-headed = ##t
+\override Staff.NoteCollision #'merge-differently-dotted = ##t
@end example
-@item
-Puede forzar el número de sistemas (es decir, si LilyPond quiere
-tipografiar la música con 11 sistemas, puede forzarlo
-para que use 10).
+@noindent
+al principio de la sección, y
@example
-\paper @{
- system-count = #10
-@}
+\revert Staff.NoteCollision #'merge-differently-headed
+\revert Staff.NoteCollision #'merge-differently-dotted
@end example
-@item
-Evite (o reduzca) el uso de objetos que aumenten el tamaño
-vertical de un sistema. Por ejemplo, las repeticiones con
-primera y segunda vez necesitan espacio adicional. Si
-estas repeticiones abarcan dos sistemas, ocuparán más espacio
-que un solo sistema con las repeticiones y otro sistema sin ellas.
+@noindent
+al final, dando como resultado:
+
+@lilypond[quote,verbatim,ragged-right]
+rhMusic = \relative c'' {
+ r2 c4.\( g8 |
+ \once \override Tie #'staff-position = #3.5
+ bes1~ |
+ \bar "||"
+ \time 6/4
+ bes2.^\markup {\bold "Moderato"} r8
+ \override Staff.NoteCollision #'merge-differently-headed = ##t
+ \override Staff.NoteCollision #'merge-differently-dotted = ##t
+ % Start polyphonic section of four voices
+ <<
+ {c,8[ d fis bes a] | }
+ \\
+ {c,8~ c2 | }
+ \\
+ {s8 d2 | }
+ \\
+ {s4 fis4. | }
+ >>
+ \revert Staff.NoteCollision #'merge-differently-headed
+ \revert Staff.NoteCollision #'merge-differently-dotted
+ g2.\)
+}
-Otro ejemplo es desplazar las expresiones dinámicas que se
-@q{asoman por encima} de un sistema.
+lhMusic = \relative c' {
+ r2 <c g ees>2( |
+ <d g, d>1)\arpeggio |
+ r2. d,,4 r4 r |
+ r4
+}
-@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
+\score {
+ \new PianoStaff <<
+ \new Staff = "RH" <<
+ \key g \minor
+ \rhMusic
+ >>
+ \new Staff = "LH" <<
+ \key g \minor
+ \clef "bass"
+ \lhMusic
+ >>
+ >>
}
@end lilypond
-@item
-Altere el espaciado horizontal por medio de @code{SpacingSpanner}. Consulte
-@ruser{Changing horizontal spacing} para ver más detalles.
+Estas sobreescrituras han fundido los dos Fa sostenido, pero no los
+dos Re. ¿Por qué no? La respuesta está en la misma sección de la
+Referencia de la Notación: las notas que se fusionan deben tener las
+plicas en direcciones opuestas y dos notas no se pueden fusionar bien
+si hay una tercera nota en la misma columna. Aquí los dos Re tienen
+las plicas hacia arriba y hay una tercera nota: el Do. Sabemos cómo
+cambiar la dirección de la plica usando @code{\stemDown}, y la
+Referencia de la Notación también explica cómo mover el Do: aplicar un
+desplazamiento usando una de las instrucciones @code{\shift}. Pero
+¿cuál? El Do está en la voz dos que tiene desactivado el
+desplazamiento, y los dos Re están en las voces uno y tres, que tienen
+el desplazamiento desactivado y activado, respectivamente. Por ello
+tenemos que desplazar el Do un nivel más todavía, usando
+@code{\shiftOnn} para evitar que interfiera con los dos Re. Al
+aplicar estos cambios obtenemos:
+
+@lilypond[quote,verbatim,ragged-right]
+rhMusic = \relative c'' {
+ r2 c4.\( g8 |
+ \once \override Tie #'staff-position = #3.5
+ bes1~ |
+ \bar "||"
+ \time 6/4
+ bes2.^\markup {\bold "Moderato"} r8
+ \override Staff.NoteCollision #'merge-differently-headed = ##t
+ \override Staff.NoteCollision #'merge-differently-dotted = ##t
+ % Start polyphonic section of four voices
+ <<
+ {c,8[ d fis bes a] | }
+ \\
+ % Move the c2 out of the main note column so the merge will work
+ {c,8~ \shiftOnn c2 | }
+ \\
+ % Stem on the d2 must be down to permit merging
+ {s8 \stemDown d2 | }
+ \\
+ {s4 fis4. | }
+ >>
+ \revert Staff.NoteCollision #'merge-differently-headed
+ \revert Staff.NoteCollision #'merge-differently-dotted
+ g2.\)
+}
+
+lhMusic = \relative c' {
+ r2 <c g ees>2( |
+ <d g, d>1)\arpeggio |
+ r2. d,,4 r4 r |
+ r4
+}
-@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)
- }
- }
+ \new PianoStaff <<
+ \new Staff = "RH" <<
+ \key g \minor
+ \rhMusic
+ >>
+ \new Staff = "LH" <<
+ \key g \minor
+ \clef "bass"
+ \lhMusic
+ >>
+ >>
}
@end lilypond
-@end itemize
+Ya casi está. Solamente quedan dos problemas: la plica hacia abajo
+sobre el Re fusionado no tendría que estar ahí, y el Do estaría mejor
+colocado a la derecha de los Re. Sabemos cómo hacer las dos cosas a
+partir de trucos anteriores: hacemos la plica transparente, y movemos
+el Do con la propiedad @code{force-hshift}. Aquí tenemos el resultado
+final:
+@lilypond[quote,verbatim,ragged-right]
+rhMusic = \relative c'' {
+ r2
+ c4.\( g8 |
+ \once \override Tie #'staff-position = #3.5
+ bes1~ |
+ \bar "||"
+ \time 6/4
+ bes2.^\markup {\bold "Moderato"} r8
+ \override Staff.NoteCollision #'merge-differently-headed = ##t
+ \override Staff.NoteCollision #'merge-differently-dotted = ##t
+ <<
+ {c,8[ d fis bes a] | }
+ \\
+ % Reposition the c2 to the right of the merged note
+ {c,8~ \once \override NoteColumn #'force-hshift = #1.0
+ % Move the c2 out of the main note column so the merge will work
+ \shiftOnn c2}
+ \\
+ % Stem on the d2 must be down to permit merging
+ {s8 \stemDown \once \override Stem #'transparent = ##t d2}
+ \\
+ {s4 fis4.}
+ >>
+ \revert Staff.NoteCollision #'merge-differently-headed
+ \revert Staff.NoteCollision #'merge-differently-dotted
+ g2.\)
+}
-@node Advanced tweaks with Scheme
-@section Advanced tweaks with Scheme
+lhMusic = \relative c' {
+ r2 <c g ees>2( |
+ <d g, d>1)\arpeggio |
+ r2. d,,4 r4 r |
+ r4
+}
+
+\score {
+ \new PianoStaff <<
+ \new Staff = "RH" <<
+ \key g \minor
+ \rhMusic
+ >>
+ \new Staff = "LH" <<
+ \key g \minor
+ \clef "bass"
+ \lhMusic
+ >>
+ >>
+}
+@end lilypond
+
+
+@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
+
+@itemize
-Hemos visto cómo la salida de LilyPond se puede modificar de manera muy profunda utilizando
-comandos como
-@code{\override TextScript #'extra-offset = ( 1 . -1)}. Pero
-tenemos un potencial incluso mayor si utilizamos Scheme. Para ver una explicación completa
-de esto, consulte el @ruser{Scheme tutorial} e
-@ruser{Interfaces for programmers}.
+@cindex transparent, uso de la propiedad
+@cindex objetos, hace invisibles
+@cindex eliminar objetos
+@cindex objetos, eliminar
+@cindex ocultar objetos
+@cindex invisibles, objetos
+@cindex ligar notas entre voces distintas
+
+@item
+@subheading Tying notes across voices
-Podemos usar Scheme simplemente para sobreponer (@code{\override}) comandos,
+El ejemplo siguiente muestra cómo conectar notas que están en
+distintas voces utilizando ligaduras de unión. Normalmente sólo se
+pueden conectar mediante ligaduras de unión dos notas que estén en la
+misma voz. Usando dos voces, con las notas ligadas en una de ellas:
+
+@lilypond[quote,fragment,relative=2]
+<< { b8~ b8\noBeam }
+\\ { b[ g8] }
+>>
+@end lilypond
+
+@noindent
+y borrando la primera plica hacia arriba en esa voz, da la impresión
+de que la ligadura se cruza entre las voces:
+
+@lilypond[quote,fragment,relative=2,verbatim]
+<<
+ {
+ \once \override Stem #'transparent = ##t
+ b8~ b8\noBeam
+ }
+\\
+ { b[ g8] }
+>>
+@end lilypond
+
+Para estar seguros de que la plica que acabamos de borrar no aprieta
+demasiado a la ligadura, podemos alargar la plica estableciendo su
+valor de longitud @code{length} a @code{8},
+
+@lilypond[quote,fragment,relative=2,verbatim]
+<<
+ {
+ \once \override Stem #'transparent = ##t
+ \once \override Stem #'length = #8
+ b8~ b8\noBeam
+ }
+\\
+ { b[ g8] }
+>>
+@end lilypond
+
+@item
+@subheading Simulating a fermata
+
+@cindex sello, uso de la propiedad
+@cindex fermata, realización en MIDI
+
+Para los objetos fuera-del-pentagrama, normalmente es mejor
+sobreescribir la propiedad @code{stencil} («sello») del objeto que su
+propiedad @code{transparent} cuando desee quitarlos de la salida
+impresa. Mediante el establecimiento de la propiedad @code{stencil}
+de un objeto al valor @code{#f} podemos quitar el objeto por completo
+de la salida impresa. Esto significa que no tiene efecto sobre la
+colocación de otros objetos que pudieran colocarse en relación a él.
+
+Por ejemplo, si quisiéramos cambiar la indicación metronómica con el
+propósito de simular un calderón en la salida MIDI, seguramente no
+querríamos que la indicación metronómica apareciese en la salida
+impresa, y no querríamos influir sobre la separación entre los dos
+sistemas o entre las notas del pentagrama. Por lo tanto, establecer
+su propiedad @code{stencil} al valor @code{#f} sería la mejor manera.
+Mostramos aquí el efecto de los dos métodos:
@lilypond[quote,verbatim,ragged-right]
-padText = #(define-music-function (parser location padding) (number?)
-#{
- \once \override TextScript #'padding = #$padding
-#})
-
-\relative c''' {
- c4^"piu mosso" b a b
- \padText #1.8
- c4^"piu mosso" d e f
- \padText #2.6
- c4^"piu mosso" fis a g
+\score {
+ \relative c'' {
+ % Visible tempo marking
+ \tempo 4=120
+ a4 a a
+ \once \override Score.MetronomeMark #'transparent = ##t
+ % Invisible tempo marking to lengthen fermata note in MIDI
+ \tempo 4=80
+ a\fermata
+ \once \override Score.MetronomeMark #'stencil = ##f
+ % Invisible tempo marking to restore tempo in MIDI
+ \tempo 4=120
+ a a a a
+ }
+ \layout { }
+ \midi { }
}
@end lilypond
-Podemos usarlo para crear comandos nuevos,
+@noindent
+Ambos métodos quitan la indicación metronómica de la salida impresa, y
+los dos afectan al tempo del MIDI tal y como queríamos, pero la
+primera indicación de metrónomo (la transparente) aún influye sobre la
+separación de las notas, mientras que la segunda (sin «sello») no
+influye.
-@lilypond[quote,verbatim,ragged-right]
-tempoMark = #(define-music-function (parser location padding marktext)
- (number? string?)
-#{
- \once \override Score . RehearsalMark #'padding = $padding
- \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
- \mark \markup { \bold $marktext }
-#})
+@end itemize
-\relative c'' {
- c2 e
- \tempoMark #3.0 #"Allegro"
- g c
+@node Using variables for tweaks
+@subsection Using variables for tweaks
+
+Las instrucciones de sobreescritura son con frecuencia largas y
+tediosas de escribir, y se tienen que escribir de forma absolutamente
+correcta. Si las mismas sobreescrituras se van a utilizar muchas
+veces, podría merecer la pena definir variables para guardarlas.
+Suponga que queremos realzar ciertas palabras de la letra de una
+canción imprimiéndolas en cursiva y negrita. Las instrucciones
+@code{\italic} y @code{\bold} no funcionan dentro de la letra de las
+canciones, así que tenemos de usar en su lugar las siguientes
+instrucciones @code{\override} y @code{\revert}:
+
+@example
+@code{\override Lyrics . LyricText #'font-shape = #'italic}
+@code{\override Lyrics . LyricText #'font-series = #'bold}
+
+@code{\revert Lyrics . LyricText #'font-shape}
+@code{\revert Lyrics . LyricText #'font-series}
+@end example
+
+Estas instrucciones serían extremadamente tediosas de escribir si
+hubiera muchas palabras que quisiéramos subrayar. Entonces, en vez de
+esto las definimos como dos variables, y las usamos de la siguiente
+forma:
+
+@lilypond[quote,verbatim]
+emph = {
+ \override Lyrics . LyricText #'font-shape = #'italic
+ \override Lyrics . LyricText #'font-series = #'bold
+}
+norm = {
+ \revert Lyrics . LyricText #'font-shape
+ \revert Lyrics . LyricText #'font-series
}
-@end lilypond
-E incluso se le pueden pasar expresiones musicales.
+global = { \time 4/4 \partial 4 \key c \major}
+SopMusic = \relative c' { c4 | e4. e8 g4 g | a a g }
+AltoMusic = \relative c' { c4 | c4. c8 e4 e | f f e }
+TenorMusic = \relative c { e4 | g4. g8 c4. b8 | a8 b c d e4 }
+BassMusic = \relative c { c4 | c4. c8 c4 c | f8 g a b c4 }
+VerseOne = \lyrics { E -- | ter -- nal \emph Fa -- ther, \norm | strong to save, }
+VerseTwo = \lyricmode { O | \emph Christ, \norm whose voice the | wa -- ters heard, }
+VerseThree = \lyricmode { O | \emph Ho -- ly Spi -- rit, \norm | who didst brood }
+VerseFour = \lyricmode { O | \emph Tri -- ni -- ty \norm of | love and pow'r }
-@lilypond[quote,verbatim,ragged-right]
-pattern = #(define-music-function (parser location x y) (ly:music? ly:music?)
-#{
- $x e8 a b $y b a e
-#})
-
-\relative c''{
- \pattern c8 c8\f
- \pattern {d16 dis} { ais16-> b\p }
+\score {
+ \new ChoirStaff <<
+ \new Staff <<
+ \clef "treble"
+ \new Voice = "Sop" { \voiceOne \global \SopMusic }
+ \new Voice = "Alto" { \voiceTwo \AltoMusic }
+ \new Lyrics \lyricsto "Sop" { \VerseOne }
+ \new Lyrics \lyricsto "Sop" { \VerseTwo }
+ \new Lyrics \lyricsto "Sop" { \VerseThree }
+ \new Lyrics \lyricsto "Sop" { \VerseFour }
+ >>
+ \new Staff <<
+ \clef "bass"
+ \new Voice = "Tenor" { \voiceOne \TenorMusic }
+ \new Voice = "Bass" { \voiceTwo \BassMusic }
+ >>
+ >>
}
@end lilypond
+
+@node Other sources of information
+@subsection Other sources of information
+
+La documentación del manual de Referencia de Funcionamiento Interno
+contiene montañas de información sobre LilyPond, pero se puede obtener
+más información aún leyendo los archivos internos de LilyPond. Para
+echarles un vistazo, en primer lugar busque la carpeta correspondiente
+a su sistema, de la siguiente forma:
+
+@strong{Linux}
+
+Diríjase a
+@file{@var{installdir}/lilypond/usr/share/lilypond/current/}
+
+@strong{MacOS X}
+
+Diríjase a
+@file{@var{installdir}/LilyPond.app/Contents/Resources/share/lilypond/current/}
+bien haciendo @code{cd} hacia este directorio desde el Terminal, o
+bien manteniendo pulsada la tecla de Control y haciendo click sobre la
+aplicación de LilyPond, y allí eligiendo @q{Mostrar el contenido del
+paquete}.
+
+@strong{Windows}
+
+Mediante el Explorador de Windows, diríjase a
+@file{@var{installdir}/LilyPond/usr/share/lilypond/current/}
+
+Dentro de esta carpeta, las dos subcarpetas interesantes son
+
+@itemize
+@item @file{../ly/ } - contiene archivos en formato LilyPond
+@item @file{../scm/} - contiene archivos en formato Scheme
+@end itemize
+
+Vamos a comenzar observando algunos archivos que están en
+@file{../ly/}. Abra @file{../ly/property-init.ly} con un editor de
+textos. El mismo que usaría normalmente para los archivos @code{.ly}
+servirá perfectamente. Este archivo contiene las definiciones de
+todas las instrucciones incorporadas como estándar dentro de LilyPond,
+como por ejemplo @code{\stemUp} y @code{\slurDotted}. Podrá ver que
+no son nada más que definiciones de variables que contienen una o
+varias instrucciones @code{\override}. Por ejemplo, @code{/tieDotted}
+está definido de tal forma que su valor es:
+
+@example
+tieDotted = @{
+ \override Tie #'dash-period = #0.75
+ \override Tie #'dash-fraction = #0.1
+@}
+@end example
+
+Si no le gustan los valores predeterminados, estas instrucciones
+incorporadas se pueden redefinir con facilidad como cualquier otra
+variable, al principio de su archivo de código de entrada.
+
+Los siguientes son los archivos más útiles que se encuentran en
+@file{../ly/}:
+
+@multitable @columnfractions .4 .6
+@headitem Archivo
+ @tab Contenido
+@item @file{../ly/engraver-init.ly}
+ @tab Definiciones de Contextos de grabadores
+@item @file{../ly/paper-defaults.ly}
+ @tab especificaciones de valores predeterminados relacionados con el papel
+@item @file{../ly/performer-init.ly}
+ @tab Definiciones de Contextos de interpretación
+@item @file{../ly/property-init.ly}
+ @tab Definiciones de todas las instrucciones incorporadas que son comunes
+@end multitable
+
+Otros ajustes (como las definiciones de las instrucciones de marcado)
+se almacenan como archivos @code{.scm} (de Scheme). El lenguaje de
+programación Scheme se utiliza para proporcionar un interfaz
+programable en el funcionamiento interno de LilyPond. Cualquier
+explicación adicional sobre estos archivos se encuentra por el momento
+fuera del ámbito de este manual, porque se requieren conocimientos del
+lenguaje Scheme. Se advierte a los usuarios que se necesita una
+importante cantidad de conocimientos técnicos o de tiempo para
+comprender el lenguaje Scheme y estos archivos (véase @ref{Scheme
+tutorial}).
+
+Si ya tiene estos conocimientos, los archivos de Scheme que pueden
+interesarle son:
+
+@multitable @columnfractions .4 .6
+@headitem Archivo
+ @tab Contenido
+@item @file{../scm/auto-beam.scm}
+ @tab Valores predeterminados de sub-barrado
+@item @file{../scm/define-grobs.scm}
+ @tab valores predeterminados de las propiedades de grobs
+@item @file{../scm/define-markup-commands.scm}
+ @tab Especificar todas las instrucciones de marcado
+@item @file{../scm/midi.scm}
+ @tab Ajustes predeterminados para la salida MIDI
+@item @file{../scm/output-lib.scm}
+ @tab Ajustes que afectan al aspecto de los trastes, colores, alteraciones, lineas divisorias, etc.
+@item @file{../scm/parser-clef.scm}
+ @tab Definiciones de las claves contempladas
+@item @file{../scm/script.scm}
+ @tab Ajustes predeterminados para las articulaciones
+@end multitable
+
+
+
@node Avoiding tweaks with slower processing
-@section Avoiding tweaks with slower processing
+@subsection Avoiding tweaks with slower processing
LilyPond puede llevar a cabo comprobaciones adicionales al tiempo que
-procesa los archivos. Estos comandos consumen tiempo, pero el
-resultado puede necesitar menos trucos manuales.
+procesa los archivos. Estas instrucciones consumen tiempo, pero el
+resultado puede necesitar menos trucos manuales para obtener un
+resultado aceptable. Si una inscripción de texto o parte de la letra
+se sale de los márgenes, estas comprobaciones comprimirán dicha línea
+en la medida justa como para que encaje dentro de los márgenes.
+
+Para que sean efectivos bajo cualquier circunstancia, estas
+comprobaciones deben habilitarse colocando las instrucciones de
+sobreescritura dentro del bloque @code{\with} dentro de un Score, y no
+en línea con la música, de la forma siguiente:
+
@example
-%% asegura que las marcas de texto y letras de las canciones se encuentran dentro de los márgenes de la página
-\override Score.PaperColumn #'keep-inside-line = ##t
+\new Score \with @{
+ % asegura que las marcas de texto y letras de las canciones se encuentran dentro de los márgenes de la página
+ \override PaperColumn #'keep-inside-line = ##t
+ \override NonMusicalPaperColumn #'keep-inside-line = ##t
+@} @{
+ ..
+@}
@end example
+@node Advanced tweaks with Scheme
+@subsection Advanced tweaks with Scheme
+
+Aunque es posible hacer muchas cosas con las instrucciones
+@code{\override} y @code{\tweak} , tenemos una forma incluso más
+poderosa de modificar el funcionamiento de LilyPond, a través de un
+interface programable hacia las operaciones internas de LilyPond. Se
+puede incorporar código escrito en el lenguaje de programación Scheme,
+directamente en el mecanismo de funcionamiento de LilyPond. Por
+supuesto, para hacer esto se necesitan al menos unos conocimientos
+básicos de programación en Scheme, y damos una introducción en el
+@ref{Scheme tutorial}.
+
+Como ejemplo que ilustra una de las muchas posibilidades, en lugar de
+dar a una propiedad un valor constante, se puede establecer al
+resultado de un procedimiento de Scheme que se invoca cada vez que
+LilyPond accede a esta propiedad. La propiedad se puede establecer
+dinámicamente a un valor determinado por el procedimiento en el
+momento en que se invoca. En este ejemplo damos a las cabezas de las
+notas un color que depende de su posición dentro del pentagrama.
+@lilypond[quote,verbatim,ragged-right]
+#(define (color-notehead grob)
+ "Color the notehead according to its position on the staff."
+ (let ((mod-position (modulo (ly:grob-property grob 'staff-position) 7)))
+ (case mod-position
+ ;; Return rainbow colors
+ ((1) (x11-color 'red )) ; for C
+ ((2) (x11-color 'orange )) ; for D
+ ((3) (x11-color 'yellow )) ; for E
+ ((4) (x11-color 'green )) ; for F
+ ((5) (x11-color 'blue )) ; for G
+ ((6) (x11-color 'purple )) ; for A
+ ((0) (x11-color 'violet )) ; for B
+ )
+ )
+)
+
+\relative c' {
+ % Arrange to obtain color from color-notehead procedure
+ \override NoteHead #'color = #color-notehead
+ c2 c' |
+ b4 g8 a b4 c |
+ c,2 a' |
+ g1 |
+}
+\addlyrics {
+ Some -- where o -- ver the Rain -- bow way up high,
+}
+@end lilypond
+Se pueden encontrar ejemplos adicionales que muestran la utilización
+de estos interfaces programables, en @ref{Tweaking with Scheme}.
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Vocal music
@section Vocal music
@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: e1c119e97fca9bce4bb8749e56bf2952598589f6
+ Translation of GIT committish: 7cc6b12897031c450e3399d59cdb22ca9df4fd8c
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.38"
+
@node Working on LilyPond projects
@chapter Working on LilyPond projects
@node Suggestions for writing LilyPond files
@section Suggestions for writing LilyPond files
-En este momento está preparado para comenzar a escribir archivos de LilyPond más grandes -- no sólo los
-pequeños ejemplos que aparecen en el tutorial, sino piezas completas --. Pero ¿cómo debe proceder
-para hacerlo?
+En este momento está preparado para comenzar a escribir archivos de
+LilyPond más grandes -- no sólo los pequeños ejemplos que aparecen en
+el tutorial, sino piezas completas --. Pero ¿cómo debe proceder para
+hacerlo?
-En la medida en que LilyPond entienda sus archivos y produzca la salida que usted
-pretendía, realmente no importa mucho qué aspecto tengan sus archivos. Sin embargo
-existen algunas otras cosas a tener en cuenta cuando se escriben archivos de LilyPond.
+En la medida en que LilyPond entienda sus archivos y produzca la
+salida que usted pretendía, realmente no importa mucho qué aspecto
+tengan sus archivos. Sin embargo existen algunas otras cosas a tener
+en cuenta cuando se escriben archivos de LilyPond.
@itemize @bullet
@item ¿Qué ocurre si comete un fallo? La estructura de un archivo
-lilypond puede hacer que ciertos errores se hagan más fáciles (o más difíciles) de encontrar.
+de LilyPond puede hacer que ciertos errores se hagan más fáciles (o
+más difíciles) de encontrar.
@item ¿Qué ocurre si quiere compartir sus archivos con otras personas?
-De hecho, ¿y si quiere alterar sus propios archivos después de algunos años?
-Algunos archivos de lilypond se comprenden a primera vista;
-otros pueden tenerle rascándose la cabeza
-durante una hora.
-
-@item ¿Qué ocurre si quiere actualizar su archivo de lilypond para poderlo usar con
-una versión más reciente del programa? La sintaxis de la entrada se modifica
-de forma ocasional según lilypond se va perfeccionando. Casi todos los cambios se pueden
-hacer de forma automática con @code{convert-ly}, pero algunos podrían necesitar de una
-ayuda manual. Los archivos de LilyPond se pueden estructurar para que sean
-más fáciles (o más difíciles) de actualizar.
+De hecho, ¿y si quiere alterar sus propios archivos después de algunos
+años? Algunos archivos de LilyPond se comprenden a primera vista;
+otros pueden tenerle rascándose la cabeza durante una hora.
+
+@item ¿Qué ocurre si quiere actualizar su archivo de LilyPond para poderlo usar con
+una versión más reciente del programa? La sintaxis de la entrada se
+modifica de forma ocasional según LilyPond se va perfeccionando. Casi
+todos los cambios se pueden hacer de forma automática con
+@code{convert-ly}, pero algunos podrían necesitar de una ayuda manual.
+Los archivos de LilyPond se pueden estructurar para que sean más
+fáciles (o más difíciles) de actualizar.
@end itemize
@menu
@itemize @bullet
@item Introduzca un sistema del manuscrito (la copia física) cada vez (pero mantenga
-la práctica de escribir un compás por línea de texto), y
-compruebe cada sistema cuando lo haya terminado. Puede usar el comando
-@code{showLastLength} para acelerar el proceso -- ver
-@ruser{Skipping corrected music} -- .
+la práctica de escribir un compás por línea de texto), y compruebe
+cada sistema cuando lo haya terminado. Puede usar la instrucción
+@code{showLastLength} para acelerar el proceso -- ver @ruser{Skipping
+corrected music} -- .
@item Defina @code{mBreak = @{ \break @}} e inserte @code{\mBreak}
dentro del archivo de entrada donde el manuscrito tenga un saldo de línea. De esta forma
@subsection Large projects
Al trabajar en proyecto grande se hace esencial tener una estructura clara
-en los archivos de lilypond.
+en los archivos de LilyPond
@itemize @bullet
@item @strong{Separe los trucos de las definiciones musicales}.
Ya se mencionó con anterioridad, pero para proyectos grandes es vital.
-Quizá tengamos que cambiar la definición de @code{fthenp}, pero en ese
+Quizá tengamos que cambiar la definición de @code{fluegop}, pero en ese
caso sólo lo tendremos que hacer una vez, y aún podremos evitar tocar
nada dentro de @code{violin}.
@example
-fthenp = _\markup@{
+fluegop = _\markup@{
\dynamic f \italic \small @{ 2nd @} \hspace #0.1 \dynamic p @}
violin = \relative c'' @{
-g4\fthenp c'8. e16
+g4\fluegop c'8. e16
@}
@end example
@end lilypond
Sin embargo también puede usar estos identificadores (que también se conocen como
-variables, macros o comandos definidos por el usuario) para hacer trucos:
+variables, macros o instrucciones definidas por el usuario) para hacer trucos:
@lilypond[quote,verbatim,ragged-right]
dolce = \markup{ \italic \bold dolce }
@itemize
@item Evite usar notas, tonalidades o compases demasiado complicados, a no ser que quiera
demostrar algo sobre el comportamiento de estos elementos precisamente.
-@item No use comandos @code{\override} a no ser que ése sea el propósito
+@item No use instrucciones @code{\override} a no ser que ése sea el propósito
del ejemplo.
@end itemize
@noindent
sustituye el contenido de @file{trompa.ly} en esta posición dentro del
-archivo, así que @code{notasTrompa} se define con posterioridad. El comando
-@code{\transpose f@tie{}c'} indica que el argumento constituido por
-@code{\notasTrompa} se debe transponer una quinta hacia arriba. Lo que suena como
-@code{f} se escribe como @code{c'}, lo que corresponde con el tono de afinación de
-una trompa normal en@tie{}Fa. La transposición se puede ver en la
-siguiente salida
+archivo, así que @code{notasTrompa} se define con posterioridad. La
+instrucción @code{\transpose f@tie{}c'} indica que el argumento
+constituido por @code{\notasTrompa} se debe transponer una quinta
+hacia arriba. Lo que suena como @code{f} se escribe como @code{c'},
+lo que corresponde con el tono de afinación de una trompa normal
+en@tie{}Fa. La transposición se puede ver en la siguiente salida
@lilypond[quote,ragged-right]
\transpose f c' \relative c {
@end example
@noindent
-Este comando establece el valor de la propiedad @code{skipBars} en el
+Esta instrucción establece el valor de la propiedad @code{skipBars} en el
contexto de @code{Score} a verdadero (@code{##t}). Anteponiendo el silencio y
esta opción a la música anterior, llegamos al siguiente resultado
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Valentin Villenave
@c Translation checkers: Jean-Charles Malahieude, John Mandereau
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Valentin Villenave
@c Translation checkers: Jean-Charles Malahieude, John Mandereau
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Valentin Villenave
@c Translation checkers: Gilles Thibault
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Valentin Villenave
@c TODO: add tablature.
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Valentin Villenave
@c Translation checkers: Jean-Charles Malahieude, John Mandereau
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Jean-Charles Malahieude
@node Converting from other formats
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@quotation
Nous souhaitons dédier ce programme à tous les amis que nous avons
rencontrés par la musique.
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Jean-Charles Malahieude
@node Editorial annotations
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Valentin Villenave
@c Translation checkers: Jean-Charles Malahieude, John Mandereau
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Valentin Villenave
@c Translation checkers: Jean-Charles Malahieude, John Mandereau
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Valentin Villenave
@c Translation checkers: Jean-Charles Malahieude, John Mandereau
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Jean-Charles Malahieude
@node Input syntax
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Install
@chapter Install
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Ludovic Sardain, John Mandereau
@c Translation checkers: Jean-Charles Malahieude, Jean-Yves Baudais
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node LilyPond-book
@chapter @command{lilypond-book}: Integrating text and music
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Literature list
@appendix Literature list
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Valentin Villenave
@c Translation checkers: Jean-Charles Malahieude
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Frédéric Chiasson, Jean-Charles Malahieude
@node Notation manual tables
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Musical notation
@chapter Musical notation
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Valentin Villenave
@c Translation checkers: Jean-Charles Malahieude, John Mandereau
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Valentin Villenave
@c Translation checkers: Jean-Charles Malahieude, John Mandereau
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Frédéric Chiasson
@c Translation checkers: Valentin Villenave, Jean-Charles Malahieude
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Valentin Villenave
@c Translation checkers: Ludovic Sardain
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Interfaces for programmers
@chapter Interfaces for programmers
+++ /dev/null
-@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
-@c This file is part of lilypond.tely
-@ignore
- Translation of GIT committish: 27af34a245b02a6b89c9af3becefcfe676b2e19d
-
- When revising a translation, copy the HEAD committish of the
- version that you are working on. See TRANSLATION for details.
-@end ignore
-
-@c FIXME outdated stuff, to be soon deleted
-
-@node Putting it all together
-@chapter Putting it all together
-
-Ce chapitre traite des principes généraux de LilyPond, et de
-la manière de créer des blocs @code{\score} @footnote{Le terme
-@q{score} signifie partition en anglais.}.
-
-
-@menu
-* An orchestral part::
-@end menu
-
-@node An orchestral part
-@section An orchestral part
-
-Dans la musique d'orchestre, toutes les notes sont imprimées deux fois.
-D'abord dans les parties séparées destinées aux musiciens, et ensuite
-dans le conducteur destiné au chef. Les variables sont là pour vous éviter
-un double travail. La musique n'est entrée qu'une seule fois, et stockée dans
-une variable, dont le contenu servira à imprimer à la fois la partie
-séparée et la partition d'orchestre.
-
-Il est judicieux de définir les notes dans un fichier séparé. Par
-exemple, supposons que le fichier @file{musique-Cor.ly} contienne la
-partie suivante pour un duo cor/@/basson.
-
-@example
-notesCor = \relative c @{
- \time 2/4
- r4 f8 a cis4 f e d
-@}
-@end example
-
-@noindent
-On établira alors une partie séparée en constituant un nouveau fichier :
-
-@example
-\include "musique-Cor.ly"
-\header @{
- instrument = "Cor en Fa"
-@}
-
-@{
- \transpose f c' \notesCor
-@}
-@end example
-
-À la ligne
-
-@example
-\include "musique-Cor.ly"
-@end example
-
-@noindent
-sera substitué le contenu du fichier @file{musique-Cor.ly}, et de ce
-fait la variable @code{notesCor} se trouvera définie. La commande
-@code{\transpose f@tie{}c'} indique que son argument @code{\notesCor}
-sera transposé à la quinte supérieure : le son réel @samp{f} s'écrit
-@code{c'}, ce qui est la caractéristique d'un Cor en Fa. La transposition
-est visible comme suit :
-
-@lilypond[quote,ragged-right]
-\transpose f c' \relative c {
- \time 2/4
- r4 f8 a cis4 f e d
-}
-@end lilypond
-
-Dans les pièces d'ensemble, il arrive souvent qu'une voix ne joue pas
-pendant plusieurs mesures. Un silence spécial, appelé silence multi-mesures,
-l'indique alors. On l'obtient par un @samp{R} majuscule, suivi d'une
-durée : @code{1}@tie{}pour une pause, @code{2}@tie{}pour une demi-pause,
-etc. Cette durée peut être multipliée pour établir de plus longs silences.
-Par exemple, le silence suivant dure 3@tie{}mesures à 2/4.
-
-@example
-R2*3
-@end example
-
-Dans une partie séparée, les silences multi-mesures sont compressés.
-Il faut pour cela définir la propriété @code{skipBars} à @q{vrai} :
-
-@example
-\set Score.skipBars = ##t
-@end example
-
-@noindent
-Cette commande assigne la valeur @q{vrai} --- @q{true} en anglais, et
-@samp{#t} dans le langage Scheme --- à cette propriété dans le
-contexte @code{Score}. Si l'on ajoute dans la musique ci-dessus le
-silence multi-mesures et cette option, on obtient le résultat suivant :
-
-@lilypond[quote,ragged-right]
-\transpose f c' \relative c {
- \time 2/4
- \set Score.skipBars = ##t
- R2*3
- r4 f8 a cis4 f e d
-}
-@end lilypond
-
-Le conducteur rassemble toute la musique. Si l'on suppose que l'autre
-voix de notre duo se trouve dans le fichier @file{musique-Basson.ly} en
-tant que variable @code{notesBasson}, on établira un conducteur avec
-
-@example
-\include "musique-Basson.ly"
-\include "musique-Cor.ly"
-
-<<
- \new Staff \notesCor
- \new Staff \notesBasson
->>
-@end example
-
-@noindent
-ce qui équivaut à
-
-@lilypond[quote,ragged-right]
-\relative c <<
- \new Staff {
- \time 2/4 R2*3
- r4 f8 a cis4 f e d
- }
- \new Staff {
- \clef bass
- r4 d,8 f | gis4 c | b bes |
- a8 e f4 | g d | gis f
- }
->>
-@end lilypond
-
-Des informations plus détaillées sur la mise en place de conducteurs
-et de parties séparées se trouvent dans le manuel : voir
-@ruser{Orchestral music}.
-
-Les variables (@q{propriétés}) réglables sont abordées en détail dans
-@ruser{Changing context properties on the fly}.
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Valentin Villenave
@c Translation checkers: Jean-Charles Malahieude, John Mandereau
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Frédéric Chiasson
@c Translation checkers: Valentin Villenave, Jean-Charles Malahieude
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Running LilyPond
@chapter Running LilyPond
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Scheme tutorial
@appendix Scheme tutorial
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Setup
@chapter Setup
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Frédéric Chiasson, Valentin Villenave
@c Translation checkers: Jean-Charles Malahieude, John Mandereau
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Spacing issues
@chapter Spacing issues
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Specialist notation
@chapter Specialist notation
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Valentin Villenave, Jean-Charles Malahieude
@c Translation checkers: John Mandereau
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Valentin Villenave
@c Translation checkers: Jean-Charles Malahieude, John Mandereau
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Templates
@appendix Templates
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Jean-Charles Malahieude
@c Translation checkers: Valentin Villenave, John Mandereau
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@ignore
Tutorial guidelines:
- unless you have a really good reason, use either
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Valentin Villenave, Nicolas Klutchnikoff
@c Translation checkers: Jean-Charles Malahieude, John Mandereau
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Valentin Villenave
@c Translation checkers: Jean-Charles Malahieude
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c Translators: Ludovic Sardain
@c Translation checkers: Jean-Yves Baudais, Valentin Villenave, John Mandereau, Jean-Charles Malahieude
de même pas votre temps à lire ce chapitre.
@menu
-* Suggestions for writing LilyPond files::
-* Saving typing with identifiers and functions::
-* Style sheets::
-* Updating old files::
-* Troubleshooting (taking it all apart)::
-* Minimal examples::
+* Suggestions for writing LilyPond files::
+* When things don't work::
+* Scores and parts::
@end menu
@node Suggestions for writing LilyPond files
@end itemize
@menu
-* General suggestions::
-* Typesetting existing music::
-* Large projects::
+* General suggestions::
+* Typesetting existing music::
+* Large projects::
+* Saving typing with variables and functions::
+* Style sheets::
@end menu
@node General suggestions
@end itemize
-@node Saving typing with identifiers and functions
-@section Saving typing with identifiers and functions
+@node Saving typing with variables and functions
+@subsection Saving typing with variables and functions
@cindex variables
@cindex identificateurs
@node Style sheets
-@section Style sheets
+@subsection Style sheets
La sortie que produit LilyPond peut être largement modifiée --- voir
@ruser{Tweaking output} pour plus de détails. Mais que faire si vous
\include "../init/init-papier.ly"
@end example
+@node When things don't work
+@section When things don't work
+
+@menu
+* Updating old files::
+* Troubleshooting (taking it all apart)::
+* Minimal examples::
+@end menu
+
@node Updating old files
-@section Updating old files
+@subsection Updating old files
La syntaxe de LilyPond change de temps en temps. Ces changements de
syntaxe du langage d'entrée accompagnent les améliorations du
@node Troubleshooting (taking it all apart)
-@section Troubleshooting (taking it all apart)
+@subsection Troubleshooting (taking it all apart)
Tôt ou tard, vous écrirez un fichier que LilyPond ne peut pas
compiler. Les messages que LilyPond affiche peuvent vous aider à
@node Minimal examples
-@section Minimal examples
+@subsection Minimal examples
Un exemple minimal est un exemple de code aussi court que possible.
De tels exemples sont bien plus compréhensibles que des exemples
@item n'utilisez pas de commandes @code{\override} sauf si elles font
l'intérêt de l'exemple.
@end itemize
+
+@node Scores and parts
+@section Scores and parts
+
+Dans la musique d'orchestre, toutes les notes sont imprimées deux fois.
+D'abord dans les parties séparées destinées aux musiciens, et ensuite
+dans le conducteur destiné au chef. Les variables sont là pour vous éviter
+un double travail. La musique n'est entrée qu'une seule fois, et stockée dans
+une variable, dont le contenu servira à imprimer à la fois la partie
+séparée et la partition d'orchestre.
+
+Il est judicieux de définir les notes dans un fichier séparé. Par
+exemple, supposons que le fichier @file{musique-Cor.ly} contienne la
+partie suivante pour un duo cor/@/basson.
+
+@example
+notesCor = \relative c @{
+ \time 2/4
+ r4 f8 a cis4 f e d
+@}
+@end example
+
+@noindent
+On établira alors une partie séparée en constituant un nouveau fichier :
+
+@example
+\include "musique-Cor.ly"
+\header @{
+ instrument = "Cor en Fa"
+@}
+
+@{
+ \transpose f c' \notesCor
+@}
+@end example
+
+À la ligne
+
+@example
+\include "musique-Cor.ly"
+@end example
+
+@noindent
+sera substitué le contenu du fichier @file{musique-Cor.ly}, et de ce
+fait la variable @code{notesCor} se trouvera définie. La commande
+@code{\transpose f@tie{}c'} indique que son argument @code{\notesCor}
+sera transposé à la quinte supérieure : le son réel @samp{f} s'écrit
+@code{c'}, ce qui est la caractéristique d'un Cor en Fa. La transposition
+est visible comme suit :
+
+@lilypond[quote,ragged-right]
+\transpose f c' \relative c {
+ \time 2/4
+ r4 f8 a cis4 f e d
+}
+@end lilypond
+
+Dans les pièces d'ensemble, il arrive souvent qu'une voix ne joue pas
+pendant plusieurs mesures. Un silence spécial, appelé silence multi-mesures,
+l'indique alors. On l'obtient par un @samp{R} majuscule, suivi d'une
+durée : @code{1}@tie{}pour une pause, @code{2}@tie{}pour une demi-pause,
+etc. Cette durée peut être multipliée pour établir de plus longs silences.
+Par exemple, le silence suivant dure 3@tie{}mesures à 2/4.
+
+@example
+R2*3
+@end example
+
+Dans une partie séparée, les silences multi-mesures sont compressés.
+Il faut pour cela définir la propriété @code{skipBars} à @q{vrai} :
+
+@example
+\set Score.skipBars = ##t
+@end example
+
+@noindent
+Cette commande assigne la valeur @q{vrai} --- @q{true} en anglais, et
+@samp{#t} dans le langage Scheme --- à cette propriété dans le
+contexte @code{Score}. Si l'on ajoute dans la musique ci-dessus le
+silence multi-mesures et cette option, on obtient le résultat suivant :
+
+@lilypond[quote,ragged-right]
+\transpose f c' \relative c {
+ \time 2/4
+ \set Score.skipBars = ##t
+ R2*3
+ r4 f8 a cis4 f e d
+}
+@end lilypond
+
+Le conducteur rassemble toute la musique. Si l'on suppose que l'autre
+voix de notre duo se trouve dans le fichier @file{musique-Basson.ly} en
+tant que variable @code{notesBasson}, on établira un conducteur avec
+
+@example
+\include "musique-Basson.ly"
+\include "musique-Cor.ly"
+
+<<
+ \new Staff \notesCor
+ \new Staff \notesBasson
+>>
+@end example
+
+@noindent
+ce qui équivaut à
+
+@lilypond[quote,ragged-right]
+\relative c <<
+ \new Staff {
+ \time 2/4 R2*3
+ r4 f8 a cis4 f e d
+ }
+ \new Staff {
+ \clef bass
+ r4 d,8 f | gis4 c | b bes |
+ a8 e f4 | g d | gis f
+ }
+>>
+@end lilypond
+
+Des informations plus détaillées sur la mise en place de conducteurs
+et de parties séparées se trouvent dans le manuel : voir
+@ruser{Orchestral music}.
+
+Les variables (@q{propriétés}) réglables sont abordées en détail dans
+@ruser{Changing context properties on the fly}.
msgstr ""
"Project-Id-Version: es\n"
"Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2008-03-23 16:29+0100\n"
-"PO-Revision-Date: 2008-03-25 18:45+0100\n"
+"POT-Creation-Date: 2008-03-28 18:07+0100\n"
+"PO-Revision-Date: 2008-03-30 17:19+0200\n"
"Last-Translator: Francisco Vila <francisco.vila@hispalinux.es>\n"
-"Language-Team: Español <traductores@es.gnome.org>\n"
+"Language-Team: Español <lilypond.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#. @subsubheading in ../../../Documentation/fr/user/macros.itexi
#. @subsubheading in ../../../Documentation/de/user/macros.itexi
msgid "Predefined commands"
-msgstr "Comandos predefinidos"
+msgstr "Instrucciones predefinidas"
#. @subsubheading in ../../../Documentation/user/macros.itexi
#. @subsubheading in ../../../Documentation/fr/user/macros.itexi
#. @node in ../../../Documentation/fr/user/expressive.itely
#. @unnumberedsubsubsec in ../../../Documentation/fr/user/expressive.itely
#. @subheading in ../../../Documentation/es/user/tutorial.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
#. @node in ../../../Documentation/es/user/expressive.itely
#. @subsubsection in ../../../Documentation/es/user/expressive.itely
#. @subheading in ../../../Documentation/de/user/tutorial.itely
#. @node in ../../../Documentation/de/user/tutorial.itely
#. @subsection in ../../../Documentation/de/user/tutorial.itely
msgid "Advanced rhythmic commands"
-msgstr "Comandos rítmicos avanzados"
+msgstr "Instrucciones rítmicas avanzadas"
#. @subheading in ../../../Documentation/user/tutorial.itely
#. @subheading in ../../../Documentation/fr/user/tutorial.itely
#. @rglos in ../../../Documentation/user/tweaks.itely
#. @rglos in ../../../Documentation/user/staff.itely
#. @rglos in ../../../Documentation/es/user/fundamental.itely
+#. @rglos in ../../../Documentation/es/user/tweaks.itely
msgid "ossia"
msgstr "ossia"
#. @node in ../../../Documentation/user/tweaks.itely
#. @section in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @section in ../../../Documentation/es/user/tweaks.itely
msgid "Tweaking basics"
msgstr "Elementos de trucaje"
# ?? FVD
#. @node in ../../../Documentation/user/tweaks.itely
#. @subsection in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @subsection in ../../../Documentation/es/user/tweaks.itely
msgid "Introduction to tweaks"
msgstr "Introducción al trucaje"
#. @node in ../../../Documentation/user/tweaks.itely
#. @subsection in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @subsection in ../../../Documentation/es/user/tweaks.itely
msgid "Objects and interfaces"
msgstr "Objetos e interfaces"
#. @node in ../../../Documentation/user/tweaks.itely
#. @subsection in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @subsection in ../../../Documentation/es/user/tweaks.itely
msgid "Naming conventions of objects and properties"
msgstr "Convenciones de nombres de objetos y propiedades"
#. @node in ../../../Documentation/user/tweaks.itely
#. @subsection in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @subsection in ../../../Documentation/es/user/tweaks.itely
msgid "Tweaking methods"
msgstr "Métodos de trucaje"
#. @node in ../../../Documentation/user/tweaks.itely
#. @section in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @section in ../../../Documentation/es/user/tweaks.itely
msgid "The Internals Reference manual"
msgstr "Manual de referencia de funcionamiento interno"
#. @node in ../../../Documentation/user/tweaks.itely
#. @subsection in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @subsection in ../../../Documentation/es/user/tweaks.itely
msgid "Properties of layout objects"
msgstr "Propiedades de los objetos de presentación"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "Finding the context"
msgstr "Búsqueda del contexto"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "Overriding once only"
msgstr "Sobreescritura por una sola vez"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "Reverting"
msgstr "Recuperación del ajuste"
#. @node in ../../../Documentation/user/tweaks.itely
#. @subsection in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @subsection in ../../../Documentation/es/user/tweaks.itely
msgid "Properties found in interfaces"
msgstr "Propiedades de los interfaces"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "Specifying the context in lyric mode"
msgstr "Especificación del contexto en modo letra"
#. @node in ../../../Documentation/user/tweaks.itely
#. @subsection in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @subsection in ../../../Documentation/es/user/tweaks.itely
msgid "Types of properties"
msgstr "Tipos de propiedades"
#. @node in ../../../Documentation/user/tweaks.itely
#. @section in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @section in ../../../Documentation/es/user/tweaks.itely
msgid "Appearance of objects"
msgstr "Apariencia de los objetos"
#. @node in ../../../Documentation/user/tweaks.itely
#. @subsection in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @subsection in ../../../Documentation/es/user/tweaks.itely
msgid "Visibility and color of objects"
msgstr "Visibilidad y color de los objetos"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "stencil"
msgstr "sello"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "break-visibility"
msgstr "break-visibility (visibilidad en el salto)"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "transparent"
msgstr "transparente"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "color"
msgstr "color"
#. @node in ../../../Documentation/user/tweaks.itely
#. @subsection in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @subsection in ../../../Documentation/es/user/tweaks.itely
msgid "Length and thickness of objects"
msgstr "Longitud y grosor de los objetos"
#. @node in ../../../Documentation/user/tweaks.itely
#. @section in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @section in ../../../Documentation/es/user/tweaks.itely
msgid "Placement of objects"
msgstr "Colocación de los objetos"
#. @node in ../../../Documentation/user/tweaks.itely
#. @subsection in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @subsection in ../../../Documentation/es/user/tweaks.itely
msgid "Automatic behaviour"
msgstr "Comportamiento automático"
#. @node in ../../../Documentation/user/tweaks.itely
#. @subsection in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @subsection in ../../../Documentation/es/user/tweaks.itely
msgid "Within-staff objects"
msgstr "Objetos interiores al pentagrama"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "Fingering"
msgstr "Digitaciones"
#. @node in ../../../Documentation/user/tweaks.itely
#. @subsection in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @subsection in ../../../Documentation/es/user/tweaks.itely
msgid "Outside staff objects"
msgstr "Objetos fuera del pentagrama"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "\\textLengthOn"
msgstr "\\textLengthOn"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "Grob sizing"
msgstr "Escalado de un «Grob»"
#. @node in ../../../Documentation/user/tweaks.itely
#. @section in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @section in ../../../Documentation/es/user/tweaks.itely
msgid "Collisions of objects"
msgstr "Colisiones de objetos"
#. @node in ../../../Documentation/fr/user/tweaks.itely
#. @section in ../../../Documentation/fr/user/tweaks.itely
#. @node in ../../../Documentation/es/user/tweaks.itely
-#. @section in ../../../Documentation/es/user/tweaks.itely
+#. @subsection in ../../../Documentation/es/user/tweaks.itely
#. @node in ../../../Documentation/de/user/tweaks.itely
#. @section in ../../../Documentation/de/user/tweaks.itely
msgid "Moving objects"
#. @node in ../../../Documentation/fr/user/tweaks.itely
#. @section in ../../../Documentation/fr/user/tweaks.itely
#. @node in ../../../Documentation/es/user/tweaks.itely
-#. @section in ../../../Documentation/es/user/tweaks.itely
+#. @subsection in ../../../Documentation/es/user/tweaks.itely
#. @node in ../../../Documentation/de/user/tweaks.itely
#. @section in ../../../Documentation/de/user/tweaks.itely
msgid "Fixing overlapping notation"
msgstr "Arreglar notación con superposiciones"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "padding property"
-msgstr "propiedad de relleno"
+msgstr "la propiedad padding (relleno)"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "left-padding and right-padding"
-msgstr "relleno por la izquierda y por la derecha"
+msgstr "left-padding y right-padding (relleno por la izquierda y por la derecha)"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "staff-padding property"
-msgstr "propiedad staff-padding"
+msgstr "la propiedad staff-padding (relleno de pentagrama)"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "self-alignment-X property"
-msgstr "propiedad self-alignment-X"
+msgstr "la propiedad self-alignment-X (auto-alineación en X)"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "staff-position property"
-msgstr "propiedad staff-position"
+msgstr "la propiedad staff-position (posición en el pentagrama)"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "extra-offset property"
-msgstr "propiedad extra-offset"
+msgstr "la propiedad extra-offset (desplazamiento adicional)"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "positions property"
-msgstr "propiedad positions"
+msgstr "la propiedad positions (posiciones)"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "force-hshift property"
-msgstr "propiedad force-hshift"
+msgstr "la propiedad force-hshift (forzar desplazamiento horizontal)"
#. @node in ../../../Documentation/user/tweaks.itely
#. @subsection in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @subsection in ../../../Documentation/es/user/tweaks.itely
msgid "Real music example"
msgstr "Ejemplos reales de música"
#. @node in ../../../Documentation/user/tweaks.itely
#. @section in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @section in ../../../Documentation/es/user/tweaks.itely
msgid "Further tweaking"
msgstr "Trucajes adicionales"
#. @node in ../../../Documentation/user/tweaks.itely
#. @subsection in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @subsection in ../../../Documentation/es/user/tweaks.itely
msgid "Other uses for tweaks"
msgstr "Otras aplicaciones de los trucos"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "Tying notes across voices"
msgstr "Ligar notas entre voces distintas"
#. @subheading in ../../../Documentation/user/tweaks.itely
+#. @subheading in ../../../Documentation/es/user/tweaks.itely
msgid "Simulating a fermata"
msgstr "Simulación de una fermata"
#. @node in ../../../Documentation/user/tweaks.itely
#. @subsection in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @subsection in ../../../Documentation/es/user/tweaks.itely
msgid "Using variables for tweaks"
msgstr "Uso de variables para los trucos"
#. @node in ../../../Documentation/user/tweaks.itely
#. @subsection in ../../../Documentation/user/tweaks.itely
+#. @node in ../../../Documentation/es/user/tweaks.itely
+#. @subsection in ../../../Documentation/es/user/tweaks.itely
msgid "Other sources of information"
msgstr "Otras fuentes de información"
#. @node in ../../../Documentation/fr/user/tweaks.itely
#. @section in ../../../Documentation/fr/user/tweaks.itely
#. @node in ../../../Documentation/es/user/tweaks.itely
-#. @section in ../../../Documentation/es/user/tweaks.itely
+#. @subsection in ../../../Documentation/es/user/tweaks.itely
#. @node in ../../../Documentation/de/user/tweaks.itely
#. @section in ../../../Documentation/de/user/tweaks.itely
msgid "Avoiding tweaks with slower processing"
#. @node in ../../../Documentation/fr/user/tweaks.itely
#. @section in ../../../Documentation/fr/user/tweaks.itely
#. @node in ../../../Documentation/es/user/tweaks.itely
-#. @section in ../../../Documentation/es/user/tweaks.itely
+#. @subsection in ../../../Documentation/es/user/tweaks.itely
#. @node in ../../../Documentation/de/user/tweaks.itely
#. @section in ../../../Documentation/de/user/tweaks.itely
msgid "Advanced tweaks with Scheme"
#. @node in ../../../Documentation/user/working.itely
#. @subsection in ../../../Documentation/user/working.itely
#. @node in ../../../Documentation/es/user/working.itely
-#. @section in ../../../Documentation/es/user/working.itely
+#. @subsection in ../../../Documentation/es/user/working.itely
msgid "Saving typing with variables and functions"
msgstr "Ahorrar tecleo mediante variables y funciones"
#. @node in ../../../Documentation/fr/user/working.itely
#. @section in ../../../Documentation/fr/user/working.itely
#. @node in ../../../Documentation/es/user/working.itely
-#. @section in ../../../Documentation/es/user/working.itely
+#. @subsection in ../../../Documentation/es/user/working.itely
#. @node in ../../../Documentation/de/user/working.itely
#. @section in ../../../Documentation/de/user/working.itely
msgid "Style sheets"
#. @node in ../../../Documentation/user/working.itely
#. @section in ../../../Documentation/user/working.itely
+#. @node in ../../../Documentation/es/user/working.itely
+#. @section in ../../../Documentation/es/user/working.itely
msgid "When things don't work"
msgstr "Cuando las cosas no van"
#. @node in ../../../Documentation/fr/user/working.itely
#. @section in ../../../Documentation/fr/user/working.itely
#. @node in ../../../Documentation/es/user/working.itely
-#. @section in ../../../Documentation/es/user/working.itely
+#. @subsection in ../../../Documentation/es/user/working.itely
#. @node in ../../../Documentation/de/user/working.itely
#. @section in ../../../Documentation/de/user/working.itely
msgid "Updating old files"
#. @node in ../../../Documentation/fr/user/working.itely
#. @section in ../../../Documentation/fr/user/working.itely
#. @node in ../../../Documentation/es/user/working.itely
-#. @section in ../../../Documentation/es/user/working.itely
+#. @subsection in ../../../Documentation/es/user/working.itely
#. @node in ../../../Documentation/de/user/working.itely
#. @section in ../../../Documentation/de/user/working.itely
msgid "Troubleshooting (taking it all apart)"
#. @node in ../../../Documentation/fr/user/working.itely
#. @section in ../../../Documentation/fr/user/working.itely
#. @node in ../../../Documentation/es/user/working.itely
-#. @section in ../../../Documentation/es/user/working.itely
+#. @subsection in ../../../Documentation/es/user/working.itely
#. @node in ../../../Documentation/de/user/working.itely
#. @section in ../../../Documentation/de/user/working.itely
msgid "Minimal examples"
#. @node in ../../../Documentation/user/working.itely
#. @section in ../../../Documentation/user/working.itely
+#. @node in ../../../Documentation/es/user/working.itely
+#. @section in ../../../Documentation/es/user/working.itely
msgid "Scores and parts"
msgstr "Partituras y particellas"
#. @node in ../../../Documentation/user/scheme-tutorial.itely
#. @appendixsec in ../../../Documentation/user/scheme-tutorial.itely
+#. @node in ../../../Documentation/es/user/scheme-tutorial.itely
+#. @appendixsec in ../../../Documentation/es/user/scheme-tutorial.itely
msgid "Tweaking with Scheme"
msgstr "Trucos con Scheme"
#. @node in ../../../Documentation/de/user/lilypond.tely
#. @appendix in ../../../Documentation/de/user/lilypond.tely
msgid "LilyPond command index"
-msgstr "Índice de comandos de LilyPond"
+msgstr "Índice de instrucciones de LilyPond"
#. @node in ../../../Documentation/user/notation.itely
#. @chapter in ../../../Documentation/user/notation.itely
#. @node in ../../../Documentation/user/staff.itely
#. @subsubsection in ../../../Documentation/user/staff.itely
-msgid "Initiating new staves"
-msgstr "Preparar pentagramas nuevos"
+msgid "Instantiating new staves"
+msgstr "Crear instancias de pentagramas nuevos"
#. @rglos in ../../../Documentation/user/staff.itely
msgid "staff"
msgid "bracket"
msgstr "llave o corchete"
+#. @node in ../../../Documentation/user/staff.itely
+#. @subsubsection in ../../../Documentation/user/staff.itely
+msgid "Deeper nested staff groups"
+msgstr "Grupos de pentagramas más complejos"
+
#. @node in ../../../Documentation/user/staff.itely
#. @subsection in ../../../Documentation/user/staff.itely
msgid "Modifying single staves"
#. @section in ../../../Documentation/fr/user/tweaks.itely
#. @node in ../../../Documentation/fr/user/spacing.itely
#. @subsection in ../../../Documentation/fr/user/spacing.itely
-#. @node in ../../../Documentation/es/user/tweaks.itely
-#. @section in ../../../Documentation/es/user/tweaks.itely
#. @node in ../../../Documentation/es/user/spacing.itely
#. @subsection in ../../../Documentation/es/user/spacing.itely
#. @node in ../../../Documentation/de/user/tweaks.itely
#. @node in ../../../Documentation/es/user/changing-defaults.itely
#. @node in ../../../Documentation/de/user/changing-defaults.itely
msgid "The \\override command"
-msgstr "El comando \\override"
+msgstr "La instrucción \\override"
#. @section in ../../../Documentation/user/changing-defaults.itely
#. @section in ../../../Documentation/fr/user/changing-defaults.itely
#. @section in ../../../Documentation/es/user/changing-defaults.itely
#. @section in ../../../Documentation/de/user/changing-defaults.itely
msgid "The @code{\\override} command"
-msgstr "El comando @code{\\override}"
+msgstr "La instrucción @code{\\override}"
# ?? FVD
#. @node in ../../../Documentation/user/changing-defaults.itely
#. @node in ../../../Documentation/de/user/programming-interface.itely
#. @subsection in ../../../Documentation/de/user/programming-interface.itely
msgid "New markup command definition"
-msgstr "Definición de un comando nuevo de marcado"
+msgstr "Definición de una instrucción de marcado nueva"
#. @node in ../../../Documentation/user/programming-interface.itely
#. @subsection in ../../../Documentation/user/programming-interface.itely
#. @node in ../../../Documentation/es/user/notation-appendices.itely
#. @appendixsec in ../../../Documentation/es/user/notation-appendices.itely
msgid "Overview of text markup commands"
-msgstr "Panorámica de los comandos de marcado de texto"
+msgstr "Panorámica de las instrucciones de marcado de texto"
#. @node in ../../../Documentation/user/notation-appendices.itely
#. @appendixsec in ../../../Documentation/user/notation-appendices.itely
#. @node in ../../../Documentation/es/user/notation-appendices.itely
#. @appendixsec in ../../../Documentation/es/user/notation-appendices.itely
msgid "Overview of text markup list commands"
-msgstr "Panorámica de los comandos de listas de marcado de texto"
+msgstr "Panorámica de las instrucciones de listas de marcado de texto"
#. @node in ../../../Documentation/user/notation-appendices.itely
#. @appendixsec in ../../../Documentation/user/notation-appendices.itely
#. @node in ../../../Documentation/fr/user/tweaks.itely
#. @section in ../../../Documentation/fr/user/tweaks.itely
-#. @node in ../../../Documentation/es/user/tweaks.itely
-#. @section in ../../../Documentation/es/user/tweaks.itely
#. @node in ../../../Documentation/de/user/tweaks.itely
#. @section in ../../../Documentation/de/user/tweaks.itely
msgid "Common tweaks"
#. @node in ../../../Documentation/fr/user/tweaks.itely
#. @section in ../../../Documentation/fr/user/tweaks.itely
-#. @node in ../../../Documentation/es/user/tweaks.itely
-#. @section in ../../../Documentation/es/user/tweaks.itely
#. @node in ../../../Documentation/de/user/tweaks.itely
#. @section in ../../../Documentation/de/user/tweaks.itely
msgid "Default files"
#. @node in ../../../Documentation/de/user/repeats.itely
#. @unnumberedsubsubsec in ../../../Documentation/de/user/repeats.itely
msgid "Manual repeat commands"
-msgstr "Comandos de repetición manual"
+msgstr "Instrucciones de repetición manual"
#. @node in ../../../Documentation/fr/user/repeats.itely
#. @subsection in ../../../Documentation/fr/user/repeats.itely
%%%%% UPDATING DOCS
-convert-ly -e --from=... --to=... --no-version *.itely
-
-% to find the current version number,
-grep "version \"" fundamental.itely
-
-Please don't forget updating translated docs (in LANGS/user) too!
-
-% (nobody ever remembers to update this file, so I've stopped
-% trying to record it here)
+cd into Documentation and run
+find -name '*.itely' | xargs convert-ly -e
+(This also updates translated docs.)
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Ancient notation
@section Ancient notation
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Bagpipes
@section Bagpipes
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Changing defaults
@chapter Changing defaults
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c TODO: add tablature.
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Chords
@section Chords
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Converting from other formats
@chapter Converting from other formats
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@quotation
We want to dedicate this program to all the friends that we
met through music.
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Editorial annotations
@section Editorial annotations
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Expressive marks
@section Expressive marks
@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond-learning.tely
+@ignore
+ Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
+
+ 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.38"
@node Fundamental concepts
@chapter Fundamental concepts
This looks a bit messy; the indentation is messed up now. That is
easily fixed. Here's the complete soprano and cello template.
-@lilypond[quote,verbatim,ragged-right]
-\version "2.11.38"
+@lilypond[quote,verbatim,ragged-right,addversion]
sopranoMusic = \relative c' {
\clef treble
\key c \major
Combining all these together and adding the music
for the three bars of the example above gives:
-@lilypond[quote,verbatim,ragged-right]
-\version "2.11.38"
+@lilypond[quote,verbatim,ragged-right,addversion]
global = { \key d \major \time 4/4 }
sopMusic = \relative c'' {
\clef "treble"
may vary. All that remains now
is to add the music, and combine all the parts together.
-@lilypond[quote,verbatim,ragged-right]
-\version "2.11.38"
+@lilypond[quote,verbatim,ragged-right,addversion]
\header {
title = "Jesu, meine Freude"
composer = "J S Bach"
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Guitar
@section Guitar
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Input syntax
@chapter Input syntax
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@ifclear INSTALL
@node Install
@chapter Install
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Introduction
@chapter Introduction
@end ignore
+
@subheading Program usage
This book explains how to execute the program and how to integrate
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
@c Note: keep this node named so that `info lilypond-book' brings you here.
@node LilyPond-book
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Literature list
@appendix Literature list
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c A menu is needed before every deeper *section nesting of @node's; run
@c M-x texinfo-all-menus-update
@c to automatically fill in these menus before saving changes
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Notation manual tables
@appendix Notation manual tables
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Musical notation
@chapter Musical notation
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Percussion
@section Percussion
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Piano music
@section Piano music
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Pitches
@section Pitches
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Preface
@unnumbered Preface
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Interfaces for programmers
@chapter Interfaces for programmers
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Repeats
@section Repeats
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Rhythms
@section Rhythms
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Running LilyPond
@chapter Running LilyPond
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Scheme tutorial
@appendix Scheme tutorial
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Setup
@chapter Setup
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Simultaneous notes
@section Simultaneous notes
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@c A menu is needed before every deeper *section nesting of @node's; run
@c M-x texinfo-all-menus-update
@c to automatically fill in these menus before saving changes
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Specialist notation
@chapter Specialist notation
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Staff notation
@section Staff notation
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Orchestral strings
@section Orchestral strings
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Templates
@appendix Templates
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Text
@section Text
This section explains how to include text (with various
formatting) in your scores.
-Some text elements that are not dealt with here are discussed in other
-specific sections:
-@itemize
-@item @ref{Vocal music}
-@item @ref{Titles and headers}
-@end itemize
+@noindent
+Some text elements that are not dealt with here are discussed in other
+specific sections: @ref{Vocal music}, @ref{Titles and headers}.
@cindex Text, other languages
@cindex text items, non-empty
@cindex non-empty texts
-It is possible to add arbitrary text indications with
-@var{note}@code{-"}@var{text}@code{"}.
+It is possible to add arbitrary text indications
+to a score, as demonstrated in the following example.
Such indications can also be manually placed
above or below the staff, using the
simple syntax described in @ref{Controlling direction and
@seealso
Notation Reference: @ref{Rehearsal marks},
-@ref{Formatting text}.
+@ref{Formatting text}, @ref{The Feta font}.
Snippets: @lsrdir{Text,Text}
\markup @{
@var{..}
@}
-
-\score @{
- @var{..}
-@}
@end example
@noindent
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@ignore
Tutorial guidelines: (different from policy.txt!)
- unless you have a really good reason, use either
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Tweaking output
@chapter Tweaking output
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Vocal music
@section Vocal music
version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.38"
+
@node Working on LilyPond projects
@chapter Working on LilyPond projects
include_snippets = '@lysnippets'
fragment_options = 'printfilename,texidoc'
-
-def help ():
- sys.stdout.write (r"""Usage: %(program_name)s [OPTIONS]... LY-FILE...
+help_text = r"""Usage: %(program_name)s [OPTIONS]... LY-FILE...
Construct tely doc from LY-FILEs.
Options:
instead of standard template; TEMPLATE should contain a command
'%(include_snippets)s' to tell where to insert LY-FILEs. When this
option is used, NAME and TITLE are ignored.
-""" % vars ())
+"""
+
+def help (text):
+ sys.stdout.write ( text)
sys.exit (0)
(options, files) = getopt.getopt (sys.argv[1:], 'f:hn:t:',
o = opt[0]
a = opt[1]
if o == '-h' or o == '--help':
- help ()
+ # We can't use vars () inside a function, as that only contains all
+ # local variables and none of the global variables! Thus we have to
+ # generate the help text here and pass it to the function...
+ help (help_text % vars ())
elif o == '-n' or o == '--name':
name = a
elif o == '-t' or o == '--title':
def print_measure (nr, fifth, mode, atts = "", final = ""):
print """ <measure number="%s">
<attributes>
-%s <key>
+ <key>
<fifths>%s</fifths>
<mode>%s</mode>
</key>
- </attributes>
+%s </attributes>
<note>
<pitch>
<step>C</step>
<voice>1</voice>
<type>half</type>
</note>
-%s </measure>""" % (nr, atts, fifth, mode, final)
+%s </measure>""" % (nr, fifth, mode, atts, final)
first_atts = """ <divisions>1</divisions>
<time symbol="common">
\once \override TextScript #'padding = #2
af16 \sustainDown
^ \markup \italic { non staccato }
- _ \markup \italic { molto \dynamic p, sempre tranquillo
+ _ \markup \italic { molto \concat {\dynamic {p},} sempre tranquillo
ed egualmente, non rubato }
<ef' c'>16
<ef' c'>16
<measure number="1">
<attributes>
<divisions>1</divisions>
+ <key>
+ <fifths>-11</fifths>
+ <mode>major</mode>
+ </key>
<time symbol="common">
<beats>2</beats>
<beat-type>4</beat-type>
<sign>G</sign>
<line>2</line>
</clef>
- <key>
- <fifths>-11</fifths>
- <mode>major</mode>
- </key>
</attributes>
<note>
<pitch>
<fifths>0</fifths>
<mode>major</mode>
</key>
- <time symbol="common">
+ <time symbol="common">
<beats>2</beats>
- <beat-type>4</beat-type>
+ <beat-type>2</beat-type>
</time>
<clef>
<sign>G</sign>
<line>2</line>
</clef>
- <time symbol="common">
- <beats>2</beats>
- <beat-type>2</beat-type>
- </time>
</attributes>
<note>
<pitch>
<work><work-title>No key or clef given</work-title></work>
<identification/>
<part-list>
- <score-part id="0">
+ <score-part id="P0">
<part-name></part-name>
</score-part>
</part-list>
- <part id="0">
+ <part id="P0">
<measure number="1">
<attributes>
<divisions>1</divisions>
</encoding>
</identification>
<part-list>
- <score-part id="0">
+ <score-part id="P0">
<part-name>Chord test</part-name>
- <score-instrument id="#1">
+ <score-instrument id="I1">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#1">
+ <midi-instrument id="I1">
<midi-channel>1</midi-channel>
<midi-program>1</midi-program>
</midi-instrument>
</score-part>
</part-list>
- <part id="0">
+ <part id="P0">
<measure number="1">
<attributes>
<divisions>960</divisions>
</encoding>
</identification>
<part-list>
- <score-part id="0">
+ <score-part id="P0">
<part-name>Chord test</part-name>
- <score-instrument id="#1">
+ <score-instrument id="I1">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#1">
+ <midi-instrument id="I1">
<midi-channel>1</midi-channel>
<midi-program>1</midi-program>
</midi-instrument>
</score-part>
</part-list>
- <part id="0">
+ <part id="P0">
<measure number="1">
<attributes>
<divisions>960</divisions>
</encoding>
</identification>
<part-list>
- <score-part id="0">
+ <score-part id="P0">
<part-name>Chord test</part-name>
- <score-instrument id="#1">
+ <score-instrument id="I1">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#1">
+ <midi-instrument id="I1">
<midi-channel>1</midi-channel>
<midi-program>1</midi-program>
</midi-instrument>
</score-part>
</part-list>
- <part id="0">
+ <part id="P0">
<measure number="1">
<attributes>
<divisions>960</divisions>
</encoding>
</identification>
<part-list>
- <score-part id="0">
+ <score-part id="P0">
<part-name>Chord test</part-name>
- <score-instrument id="1">
+ <score-instrument id="I1">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="1">
+ <midi-instrument id="I1">
<midi-channel>1</midi-channel>
<midi-program>1</midi-program>
</midi-instrument>
</score-part>
</part-list>
- <part id="0">
+ <part id="P0">
<measure number="1">
<attributes>
<divisions>8</divisions>
<measure number="1">
<attributes>
<divisions>4</divisions>
- <clef>
- <sign>G</sign>
- <line>2</line>
- </clef>
<key>
<fifths>0</fifths>
</key>
<beats>3</beats>
<beat-type>4</beat-type>
</time>
+ <clef>
+ <sign>G</sign>
+ <line>2</line>
+ </clef>
</attributes>
<note>
<pitch>
--- /dev/null
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE score-partwise PUBLIC "-//Recordare//DTD MusicXML 1.1 Partwise//EN"
+ "http://www.musicxml.org/dtds/partwise.dtd">
+<score-partwise version="1.1">
+ <movement-title>Tempo markings</movement-title>
+ <identification/>
+ <defaults/>
+ <part-list>
+ <score-part id="P1">
+ <part-name></part-name>
+ <score-instrument id="P1-I1">
+ <instrument-name>Grand Piano</instrument-name>
+ </score-instrument>
+ <midi-instrument id="P1-I1">
+ <midi-channel>1</midi-channel>
+ <midi-program>1</midi-program>
+ </midi-instrument>
+ </score-part>
+ </part-list>
+ <!--=========================================================-->
+ <part id="P1">
+ <measure number="1" width="527">
+ <attributes>
+ <divisions>1</divisions>
+ <key>
+ <fifths>0</fifths>
+ <mode>major</mode>
+ </key>
+ <time symbol="common">
+ <beats>4</beats>
+ <beat-type>4</beat-type>
+ </time>
+ <clef>
+ <sign>G</sign>
+ <line>2</line>
+ </clef>
+ </attributes>
+ <direction>
+ <direction-type>
+ <metronome>
+ <beat-unit>quarter</beat-unit>
+ <beat-unit-dot/>
+ <per-minute>100</per-minute>
+ </metronome>
+ </direction-type>
+ </direction>
+ <note>
+ <pitch><step>C</step><octave>5</octave></pitch>
+ <duration>1</duration>
+ <voice>1</voice>
+ <type>quarter</type>
+ </note>
+ <note>
+ <pitch><step>C</step><octave>5</octave></pitch>
+ <duration>1</duration>
+ <voice>1</voice>
+ <type>quarter</type>
+ </note>
+ <direction>
+ <direction-type>
+ <words>Adagio</words>
+ </direction-type>\r
+ <direction-type>\r
+ <metronome>\r
+ <beat-unit>long</beat-unit>\r
+ <per-minute>100</per-minute>\r
+ </metronome>\r
+ </direction-type>\r
+ </direction>
+ <note>
+ <pitch><step>C</step><octave>5</octave></pitch>
+ <duration>1</duration>
+ <voice>1</voice>
+ <type>quarter</type>
+ </note>
+ <note>
+ <pitch><step>C</step><octave>5</octave></pitch>
+ <duration>1</duration>
+ <voice>1</voice>
+ <type>quarter</type>
+ </note>
+ </measure>
+ <!--=======================================================-->
+ <measure number="2">
+ <direction>
+ <direction-type>
+ <metronome>
+ <beat-unit>quarter</beat-unit>
+ <beat-unit-dot/>
+ <beat-unit>half</beat-unit>
+ <beat-unit-dot/>
+ </metronome>
+ </direction-type>
+ </direction>
+ <note>
+ <pitch><step>C</step><octave>5</octave></pitch>
+ <duration>1</duration>
+ <voice>1</voice>
+ <type>quarter</type>
+ </note>
+ <note>
+ <pitch><step>C</step><octave>5</octave></pitch>
+ <duration>1</duration>
+ <voice>1</voice>
+ <type>quarter</type>
+ </note>
+ <direction>\r
+ <direction-type>\r
+ <metronome>\r
+ <beat-unit>long</beat-unit>\r
+ <beat-unit>32nd</beat-unit>\r
+ <beat-unit-dot/>\r
+ </metronome>\r
+ </direction-type>
+ </direction>
+ <note>
+ <pitch><step>C</step><octave>5</octave></pitch>
+ <duration>1</duration>
+ <voice>1</voice>
+ <type>quarter</type>
+ </note>
+ <note>
+ <pitch><step>C</step><octave>5</octave></pitch>
+ <duration>1</duration>
+ <voice>1</voice>
+ <type>quarter</type>
+ </note>
+ </measure>
+ <!--=======================================================-->
+ <measure number="3">
+ <direction>
+ <direction-type>
+ <metronome parentheses="yes">
+ <beat-unit>quarter</beat-unit>
+ <beat-unit-dot/>
+ <beat-unit>half</beat-unit>
+ <beat-unit-dot/>
+ </metronome>
+ </direction-type>
+ </direction>
+ <note>
+ <pitch><step>C</step><octave>5</octave></pitch>
+ <duration>1</duration>
+ <voice>1</voice>
+ <type>quarter</type>
+ </note>
+ <note>
+ <pitch><step>C</step><octave>5</octave></pitch>
+ <duration>1</duration>
+ <voice>1</voice>
+ <type>quarter</type>
+ </note>
+ <direction>
+ <direction-type>
+ <metronome parentheses="yes">
+ <beat-unit>quarter</beat-unit>
+ <beat-unit-dot/>
+ <per-minute>77</per-minute>
+ </metronome>
+ </direction-type>
+ </direction>
+ <note>
+ <pitch><step>C</step><octave>5</octave></pitch>
+ <duration>1</duration>
+ <voice>1</voice>
+ <type>quarter</type>
+ </note>
+ <note>
+ <pitch><step>C</step><octave>5</octave></pitch>
+ <duration>1</duration>
+ <voice>1</voice>
+ <type>quarter</type>
+ </note>
+ <barline location="right">
+ <bar-style>light-heavy</bar-style>
+ </barline>
+ </measure>
+ </part>
+ <!--=========================================================-->
+</score-partwise>
<movement-title>Lyrics and melismata</movement-title>\r
<identification/>\r
<defaults/>\r
- <credit/>\r
<part-list>\r
<score-part id="P1">\r
<part-name></part-name>\r
</encoding>
</identification>
<part-list>
- <score-part id="0">
+ <score-part id="P0">
<part-name>Part 1</part-name>
- <score-instrument id="#1">
+ <score-instrument id="I1">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#1">
+ <midi-instrument id="I1">
<midi-channel>1</midi-channel>
<midi-program>1</midi-program>
</midi-instrument>
</score-part>
- <score-part id="1">
+ <score-part id="P1">
<part-name>Part 2</part-name>
- <score-instrument id="#2">
+ <score-instrument id="I2">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#2">
+ <midi-instrument id="I2">
<midi-channel>2</midi-channel>
</midi-instrument>
</score-part>
- <score-part id="2">
+ <score-part id="P2">
<part-name>Part 3</part-name>
- <score-instrument id="#3">
+ <score-instrument id="I3">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#3">
+ <midi-instrument id="I3">
<midi-channel>3</midi-channel>
</midi-instrument>
</score-part>
- <score-part id="3">
+ <score-part id="P3">
<part-name>Part 4</part-name>
- <score-instrument id="#4">
+ <score-instrument id="I4">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#4">
+ <midi-instrument id="I4">
<midi-channel>4</midi-channel>
</midi-instrument>
</score-part>
</part-list>
- <part id="0">
+ <part id="P0">
<measure number="1">
<attributes>
<divisions>960</divisions>
+ <key>
+ <fifths>1</fifths>
+ <mode>major</mode>
+ </key>
<time>
<beats>4</beats>
<beat-type>4</beat-type>
<sign>G</sign>
<line>2</line>
</clef>
- <key>
- <fifths>1</fifths>
- <mode>major</mode>
- </key>
</attributes>
<note>
<pitch>
</note>
</measure>
</part>
- <part id="1">
+ <part id="P1">
<measure number="1">
<attributes>
<divisions>960</divisions>
+ <key>
+ <fifths>1</fifths>
+ <mode>major</mode>
+ </key>
<time>
<beats>4</beats>
<beat-type>4</beat-type>
<sign>G</sign>
<line>2</line>
</clef>
- <key>
- <fifths>1</fifths>
- <mode>major</mode>
- </key>
</attributes>
<note>
<pitch>
</note>
</measure>
</part>
- <part id="2">
+ <part id="P2">
<measure number="1">
<attributes>
<divisions>960</divisions>
+ <key>
+ <fifths>1</fifths>
+ <mode>major</mode>
+ </key>
<time>
<beats>4</beats>
<beat-type>4</beat-type>
<sign>G</sign>
<line>2</line>
</clef>
- <key>
- <fifths>1</fifths>
- <mode>major</mode>
- </key>
</attributes>
<note>
<pitch>
</note>
</measure>
</part>
- <part id="3">
+ <part id="P3">
<measure number="1">
<attributes>
<divisions>960</divisions>
+ <key>
+ <fifths>1</fifths>
+ <mode>major</mode>
+ </key>
<time>
<beats>4</beats>
<beat-type>4</beat-type>
<sign>G</sign>
<line>2</line>
</clef>
- <key>
- <fifths>1</fifths>
- <mode>major</mode>
- </key>
</attributes>
<note>
<pitch>
</encoding>
</identification>
<part-list>
- <score-part id="0">
+ <score-part id="P0">
<part-name></part-name>
- <score-instrument id="#1">
+ <score-instrument id="I1">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#1">
+ <midi-instrument id="I1">
<midi-channel>1</midi-channel>
<midi-program>1</midi-program>
</midi-instrument>
</score-part>
- <score-part id="1">
+ <score-part id="P1">
<part-name></part-name>
- <score-instrument id="#2">
+ <score-instrument id="I2">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#2">
+ <midi-instrument id="I2">
<midi-channel>2</midi-channel>
</midi-instrument>
</score-part>
- <score-part id="2">
+ <score-part id="P2">
<part-name></part-name>
- <score-instrument id="#3">
+ <score-instrument id="I3">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#3">
+ <midi-instrument id="I3">
<midi-channel>3</midi-channel>
</midi-instrument>
</score-part>
- <score-part id="3">
+ <score-part id="P3">
<part-name></part-name>
- <score-instrument id="#4">
+ <score-instrument id="I4">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#4">
+ <midi-instrument id="I4">
<midi-channel>4</midi-channel>
</midi-instrument>
</score-part>
- <score-part id="4">
+ <score-part id="P4">
<part-name></part-name>
- <score-instrument id="#5">
+ <score-instrument id="I5">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#5">
+ <midi-instrument id="I5">
<midi-channel>5</midi-channel>
</midi-instrument>
</score-part>
- <score-part id="5">
+ <score-part id="P5">
<part-name></part-name>
- <score-instrument id="#6">
+ <score-instrument id="I6">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#6">
+ <midi-instrument id="I6">
<midi-channel>6</midi-channel>
</midi-instrument>
</score-part>
- <score-part id="6">
+ <score-part id="P6">
<part-name></part-name>
- <score-instrument id="#7">
+ <score-instrument id="I7">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#7">
+ <midi-instrument id="I7">
<midi-channel>7</midi-channel>
</midi-instrument>
</score-part>
- <score-part id="7">
+ <score-part id="P7">
<part-name></part-name>
- <score-instrument id="#8">
+ <score-instrument id="I8">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#8">
+ <midi-instrument id="I8">
<midi-channel>8</midi-channel>
</midi-instrument>
</score-part>
- <score-part id="8">
+ <score-part id="P8">
<part-name></part-name>
- <score-instrument id="#9">
+ <score-instrument id="I9">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#9">
+ <midi-instrument id="I9">
<midi-channel>9</midi-channel>
</midi-instrument>
</score-part>
- <score-part id="9">
+ <score-part id="P9">
<part-name></part-name>
- <score-instrument id="#10[D]">
+ <score-instrument id="I10">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#10[D]">
+ <midi-instrument id="I10">
<midi-channel>10</midi-channel>
</midi-instrument>
</score-part>
- <score-part id="10">
+ <score-part id="P10">
<part-name></part-name>
- <score-instrument id="#11">
+ <score-instrument id="I11">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#11">
+ <midi-instrument id="I11">
<midi-channel>11</midi-channel>
</midi-instrument>
</score-part>
- <score-part id="11">
+ <score-part id="P11">
<part-name></part-name>
- <score-instrument id="#12">
+ <score-instrument id="I12">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#12">
+ <midi-instrument id="I12">
<midi-channel>12</midi-channel>
</midi-instrument>
</score-part>
- <score-part id="12">
+ <score-part id="P12">
<part-name></part-name>
- <score-instrument id="#13">
+ <score-instrument id="I13">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#13">
+ <midi-instrument id="I13">
<midi-channel>13</midi-channel>
</midi-instrument>
</score-part>
- <score-part id="13">
+ <score-part id="P13">
<part-name></part-name>
- <score-instrument id="#14">
+ <score-instrument id="I14">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#14">
+ <midi-instrument id="I14">
<midi-channel>14</midi-channel>
</midi-instrument>
</score-part>
- <score-part id="14">
+ <score-part id="P14">
<part-name></part-name>
- <score-instrument id="#15">
+ <score-instrument id="I15">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#15">
+ <midi-instrument id="I15">
<midi-channel>15</midi-channel>
</midi-instrument>
</score-part>
- <score-part id="15">
+ <score-part id="P15">
<part-name></part-name>
- <score-instrument id="#16">
+ <score-instrument id="I16">
<instrument-name>0</instrument-name>
</score-instrument>
- <midi-instrument id="#16">
+ <midi-instrument id="I16">
<midi-channel>16</midi-channel>
</midi-instrument>
</score-part>
- <score-part id="16">
+ <score-part id="P16">
<part-name></part-name>
</score-part>
- <score-part id="17">
+ <score-part id="P17">
<part-name></part-name>
</score-part>
- <score-part id="18">
+ <score-part id="P18">
<part-name></part-name>
</score-part>
- <score-part id="19">
+ <score-part id="P19">
<part-name></part-name>
</score-part>
</part-list>
- <part id="0">
+ <part id="P0">
<measure number="1">
<attributes>
<divisions>960</divisions>
</note>
</measure>
</part>
- <part id="1">
+ <part id="P1">
<measure number="1">
<attributes>
<divisions>960</divisions>
</note>
</measure>
</part>
- <part id="2">
+ <part id="P2">
<measure number="1">
<attributes>
<divisions>960</divisions>
</note>
</measure>
</part>
- <part id="3">
+ <part id="P3">
<measure number="1">
<attributes>
<divisions>960</divisions>
</note>
</measure>
</part>
- <part id="4">
+ <part id="P4">
<measure number="1">
<attributes>
<divisions>960</divisions>
</note>
</measure>
</part>
- <part id="5">
+ <part id="P5">
<measure number="1">
<attributes>
<divisions>960</divisions>
</note>
</measure>
</part>
- <part id="6">
+ <part id="P6">
<measure number="1">
<attributes>
<divisions>960</divisions>
</note>
</measure>
</part>
- <part id="7">
+ <part id="P7">
<measure number="1">
<attributes>
<divisions>960</divisions>
</note>
</measure>
</part>
- <part id="8">
+ <part id="P8">
<measure number="1">
<attributes>
<divisions>960</divisions>
</note>
</measure>
</part>
- <part id="9">
+ <part id="P9">
<measure number="1">
<attributes>
<divisions>960</divisions>
</note>
</measure>
</part>
- <part id="10">
+ <part id="P10">
<measure number="1">
<attributes>
<divisions>960</divisions>
</note>
</measure>
</part>
- <part id="11">
+ <part id="P11">
<measure number="1">
<attributes>
<divisions>960</divisions>
</note>
</measure>
</part>
- <part id="12">
+ <part id="P12">
<measure number="1">
<attributes>
<divisions>960</divisions>
</note>
</measure>
</part>
- <part id="13">
+ <part id="P13">
<measure number="1">
<attributes>
<divisions>960</divisions>
</note>
</measure>
</part>
- <part id="14">
+ <part id="P14">
<measure number="1">
<attributes>
<divisions>960</divisions>
</note>
</measure>
</part>
- <part id="15">
+ <part id="P15">
<measure number="1">
<attributes>
<divisions>960</divisions>
</note>
</measure>
</part>
- <part id="16">
+ <part id="P16">
<measure number="1">
<attributes>
<divisions>960</divisions>
</note>
</measure>
</part>
- <part id="17">
+ <part id="P17">
<measure number="1">
<attributes>
<divisions>960</divisions>
</note>
</measure>
</part>
- <part id="18">
+ <part id="P18">
<measure number="1">
<attributes>
<divisions>960</divisions>
</note>
</measure>
</part>
- <part id="19">
+ <part id="P19">
<measure number="1">
<attributes>
<divisions>960</divisions>
<dot/>
<stem>up</stem>
</note>
+ <!-- Check how well the application handles an empty element (invalid MusicXML!) -->
<figured-bass>
</figured-bass>
<note>
</encoding>\r
</identification>\r
<defaults/>\r
- <credit/>\r
<part-list>\r
<score-part id="P1">\r
<part-name></part-name>\r
$(outdir)/%.texi: $(outdir)/%.tely
- echo $(LILYPOND_BOOK_PROCESS)
$(PYTHON) $(LILYPOND_BOOK) $(LILYPOND_BOOK_INCLUDES) --process='$(LILYPOND_BOOK_PROCESS) $(LILYPOND_BOOK_INCLUDES) $(LILYPOND_BOOK_LILYPOND_FLAGS)' --output=$(outdir) --format=$(LILYPOND_BOOK_FORMAT) $(LILYPOND_BOOK_FLAGS) $<
#
# DON'T REMOVE SOURCE FILES, otherwise the .TEXI ALWAYS OUT OF DATE.
self.factor.denominator ())
- def ly_expression (self, factor = None):
+ def ly_expression (self, factor = None, scheme_mode = False):
if not factor:
factor = self.factor
if self.duration_log < 0:
- str = {-1: "\\breve", -2: "\\longa"}.get (self.duration_log, "1")
+ if scheme_mode:
+ longer_dict = {-1: "breve", -2: "longa"}
+ else:
+ longer_dict = {-1: "\\breve", -2: "\\longa"}
+ str = longer_dict.get (self.duration_log, "1")
else:
str = '%d' % (1 << self.duration_log)
str += '.'*self.dots
else:
return ''
+
+class TempoMark (Music):
+ def __init__ (self):
+ Music.__init__ (self)
+ self.baseduration = None
+ self.newduration = None
+ self.beats = None
+ self.parentheses = False
+ def set_base_duration (self, dur):
+ self.baseduration = dur
+ def set_new_duration (self, dur):
+ self.newduration = dur
+ def set_beats_per_minute (self, beats):
+ self.beats = beats
+ def set_parentheses (self, parentheses):
+ self.parentheses = parentheses
+ def wait_for_note (self):
+ return False
+ def duration_to_markup (self, dur):
+ if dur:
+ # Generate the markup to print the note, use scheme mode for
+ # ly_expression to get longa and not \longa (which causes an error)
+ return "\\general-align #Y #DOWN \\smaller \\note #\"%s\" #UP" % dur.ly_expression(None, True)
+ else:
+ return ''
+ def tempo_markup_template (self):
+ return "\\mark\\markup { \\fontsize #-2 \\line { %s } }"
+ def ly_expression (self):
+ res = ''
+ if not self.baseduration:
+ return res
+ if self.beats:
+ if self.parentheses:
+ dm = self.duration_to_markup (self.baseduration)
+ contents = "\"(\" %s = %s \")\"" % (dm, self.beats)
+ res += self.tempo_markup_template() % contents
+ else:
+ res += "\\tempo %s=%s" % (self.baseduration.ly_expression(), self.beats)
+ elif self.newduration:
+ dm = self.duration_to_markup (self.baseduration)
+ ndm = self.duration_to_markup (self.newduration)
+ if self.parentheses:
+ contents = "\"(\" %s = %s \")\"" % (dm, ndm)
+ else:
+ contents = " %s = %s " % (dm, ndm)
+ res += self.tempo_markup_template() % contents
+ else:
+ return ''
+ return res
+
class FiguredBassNote (Music):
def __init__ (self):
Music.__init__ (self)
return return_string
+def musicxml_duration_to_log (dur):
+ return {'256th': 8,
+ '128th': 7,
+ '64th': 6,
+ '32nd': 5,
+ '16th': 4,
+ 'eighth': 3,
+ 'quarter': 2,
+ 'half': 1,
+ 'whole': 0,
+ 'breve': -1,
+ 'longa': -2,
+ 'long': -2}.get (dur, 0)
+
+
+
class Xml_node:
def __init__ (self):
self._children = []
if ch:
log = ch.get_text ().strip()
- return {'256th': 8,
- '128th': 7,
- '64th': 6,
- '32nd': 5,
- '16th': 4,
- 'eighth': 3,
- 'quarter': 2,
- 'half': 1,
- 'whole': 0,
- 'breve': -1,
- 'longa': -2}.get (log, 0)
+ return musicxml_duration_to_log (log)
elif self.get_maybe_exist_named_child (u'grace'):
# FIXME: is it ok to default to eight note for grace notes?
return 3
class FiguredBass (Music_xml_node):
pass
+class BeatUnit (Music_xml_node):
+ pass
+
+class BeatUnitDot (Music_xml_node):
+ pass
+
+class PerMinute (Music_xml_node):
+ pass
+
## need this, not all classes are instantiated
'barline': Barline,
'bar-style': BarStyle,
'beam' : Beam,
+ 'beat-unit': BeatUnit,
+ 'beat-unit-dot': BeatUnitDot,
'bend' : Bend,
'bracket' : Bracket,
'chord': Chord,
'part-group': Part_group,
'part-list': Part_list,
'pedal': Pedal,
+ 'per-minute': PerMinute,
'pitch': Pitch,
'rest': Rest,
'score-part': Score_part,
#"delayed-turn": "?",
"detached-legato": (musicexp.ShortArticulationEvent, "_"), # or "portato"
"doit": musicxml_doit_to_lily_event,
- #"double-tongue": "",
+ #"double-tongue": "?",
"down-bow": "downbow",
"falloff": musicxml_falloff_to_lily_event,
"fingering": musicxml_fingering_event,
- #"fingernails": "",
- #"fret": "",
- #"hammer-on": "",
+ #"fingernails": "?",
+ #"fret": "?",
+ #"hammer-on": "?",
"harmonic": "flageolet",
- #"heel": "",
+ #"heel": "?",
"inverted-mordent": "prall",
"inverted-turn": "reverseturn",
"mordent": "mordent",
"open-string": "open",
- #"plop": "",
- #"pluck": "",
- #"pull-off": "",
+ #"plop": "?",
+ #"pluck": "?",
+ #"pull-off": "?",
#"schleifer": "?",
- #"scoop": "",
+ #"scoop": "?",
#"shake": "?",
"snap-pizzicato": musicxml_snappizzicato_event,
- #"spiccato": "",
+ #"spiccato": "?",
"staccatissimo": (musicexp.ShortArticulationEvent, "|"), # or "staccatissimo"
"staccato": (musicexp.ShortArticulationEvent, "."), # or "staccato"
"stopped": (musicexp.ShortArticulationEvent, "+"), # or "stopped"
- #"stress": "",
+ #"stress": "?",
"string": musicxml_string_event,
"strong-accent": (musicexp.ShortArticulationEvent, "^"), # or "marcato"
- #"tap": "",
+ #"tap": "?",
"tenuto": (musicexp.ShortArticulationEvent, "-"), # or "tenuto"
"thumb-position": "thumb",
- #"toe": "",
+ #"toe": "?",
"turn": "turn",
"tremolo": musicxml_tremolo_to_lily_event,
"trill-mark": "trill",
- #"triple-tongue": "",
- #"unstress": ""
+ #"triple-tongue": "?",
+ #"unstress": "?"
"up-bow": "upbow",
#"wavy-line": "?",
}
needed_additional_definitions.append ("eyeglasses")
return musicexp.MarkEvent ("\\eyeglasses")
+def next_non_hash_index (lst, pos):
+ pos += 1
+ while pos < len (lst) and isinstance (lst[pos], musicxml.Hash_text):
+ pos += 1
+ return pos
+
+def musicxml_metronome_to_ly (mxl_event):
+ children = mxl_event.get_all_children ()
+ if not children:
+ return
+
+ index = -1
+ index = next_non_hash_index (children, index)
+ if isinstance (children[index], musicxml.BeatUnit):
+ # first form of metronome-mark, using unit and beats/min or other unit
+ ev = musicexp.TempoMark ()
+ if hasattr (mxl_event, 'parentheses'):
+ ev.set_parentheses (mxl_event.parentheses == "yes")
+
+ d = musicexp.Duration ()
+ d.duration_log = musicxml.musicxml_duration_to_log (children[index].get_text ())
+ index = next_non_hash_index (children, index)
+ if isinstance (children[index], musicxml.BeatUnitDot):
+ d.dots = 1
+ index = next_non_hash_index (children, index)
+ ev.set_base_duration (d)
+ if isinstance (children[index], musicxml.BeatUnit):
+ # Form "note = newnote"
+ newd = musicexp.Duration ()
+ newd.duration_log = musicxml.musicxml_duration_to_log (children[index].get_text ())
+ index = next_non_hash_index (children, index)
+ if isinstance (children[index], musicxml.BeatUnitDot):
+ newd.dots = 1
+ index = next_non_hash_index (children, index)
+ ev.set_new_duration (newd)
+ elif isinstance (children[index], musicxml.PerMinute):
+ # Form "note = bpm"
+ try:
+ beats = int (children[index].get_text ())
+ ev.set_beats_per_minute (beats)
+ except ValueError:
+ pass
+ else:
+ error_message (_ ("Unknown metronome mark, ignoring"))
+ return
+ return ev
+ else:
+ #TODO: Implement the other (more complex) way for tempo marks!
+ error_message (_ ("Metronome marks with complex relations (<metronome-note> in MusicXML) are not yet implemented."))
+ return
+
# translate directions into Events, possible values:
# -) string (MarkEvent with that command)
# -) function (function(mxl_event) needs to return a full Event-derived object
# 'damp' : ???
# 'damp-all' : ???
'eyeglasses': musicxml_eyeglasses_to_ly,
-# 'harp-pedals' :
-# 'image' :
-# 'metronome' :
+# 'harp-pedals' : ???
+# 'image' : ???
+ 'metronome' : musicxml_metronome_to_ly,
'rehearsal' : musicxml_rehearsal_to_ly_mark,
-# 'scordatura' :
+# 'scordatura' : ???
'segno' : (musicexp.MusicGlyphMarkEvent, "segno"),
'words' : musicxml_words_to_lily_event,
}
res.append (note)
dur = n.get_maybe_exist_named_child ('duration')
if dur:
- # TODO: implement duration (given in base steps!)
# apply the duration to res
length = Rational(int(dur.get_text()), n._divisions)*Rational(1,4)
res.set_real_duration (length)
# symlinks, see replace_symlinks_urls in
# buildscripts/add_html_footer.py.
-ifneq ($(INFO_IMAGES_DIR),)
+ifneq ($(INFO_IMAGES_DIR),'')
# make dereferences symlinks, and $(INFO_IMAGES_DIR) is a symlink
# to $(outdir), so we can't use directly $(INFO_IMAGES_DIR) as a
projects / lilypond.git / commitdiff