@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond-program.tely
@ignore
- Translation of GIT committish: e831b9b97caae23725709d2fe11a6436240ed580
+ Translation of GIT committish: c6e236bc762071c4580cc15ea52695df646d31f7
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@end ignore
+@c Translators: Till Rettig, Reinhold Kainhofer
@ifclear INSTALL
@node Install
@end example
-@c TRANSLATORS:
-@c Please **do not** translate anything below this line. Users
-@c should not be compiling LilyPond themselves; if they really
-@c want to do so, they should be able to read the English docs,
-@c because they'll probably need to ask questions in English
-@c on the -devel list. -gp
-
@node Compiling from source
@section Compiling from source
englische Dokumentation verwiesen werden.
@c TODO: How do I insert a link to the English docs???
+@c TRANSLATORS:
+@c Please **do not** translate anything below this line. Users
+@c should not be compiling LilyPond themselves; if they really
+@c want to do so, they should be able to read the English docs,
+@c because they'll probably need to ask questions in English
+@c on the -devel list. -gp
+
@c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
@c This file is part of lilypond-program.tely
@ignore
- Translation of GIT committish: 4ac76531a06d6b6836b67d3650b57a2f58d1108f
+ Translation of GIT committish: 317e451cbe00c0fa25e177976327e260f3dc6539
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@end ignore
+@c Translators: Reinhold Kainhofer
@node Running LilyPond
@chapter Running LilyPond
@end example
@noindent
-erzeigt daher die Dateien @var{Dateiname}@file{-Geige.pdf} und
+erzeugt daher die Dateien @var{Dateiname}@file{-Geige.pdf} und
@var{Dateiname}@file{-Cello-1.pdf}.
@node Command line options
@subsection Command line options
-@untranslated
+Die folgenden Kommandozeilenoptionen werden von @command{lilypond} unterstützt:
+
+@table @code
+
+@item -e,--evaluate=@var{expr}
+Wertet den Scheme-Ausdruck @var{expr} aus, bevor die @file{.ly} Dateien
+gelesen und interpretiert werden.
+Die @code{-e} Option kann auch mehrfach angegeben werden, die Ausdrücke
+werden nacheinander ausgewertet.
+
+Da der Ausdruck im @code{guile-user} Modul ausgewertet wird, ist bei der
+Definitionen innerhalb von @var{expr} folgendes Vorgehen nötig. An der
+Kommandozeile wird z.B. @code{a} im @code{guile-user} Modul definiert:
+
+@example
+lilypond -e '(define-public a 42)'
+@end example
+
+@noindent
+Am Beginn der @file{.ly}-Datei muss dann das @code{guile-user} Modul noch geladen werden, bevor die Definition von @var{a} verfügbar ist:
+
+@example
+#(use-modules (guile-user))
+@end example
+
+
+@item -f,--format=@var{Format}
+Bestimmt das Ausgabeformat. Mögliche Werte von @var{Format} sind
+@code{svg}, @code{ps}, @code{pdf}, @code{png}, @code{tex} und @code{dvi}.
+
+Beispiel: @code{lilypond -fpng @var{Dateiname}.ly}
+
+
+
+@item -d,--define-default=@var{Variable}=@var{Wert}
+Damit wird die interne Programmoption @var{Variable} auf den Scheme-Wert
+@var{Wert} gesetzt. Wird kein @var{Wert} angegeben, so wird @var{#t} benutzt.
+Um eine Option auszuschalten, kann der Präfix @code{no-} dem Namen
+@var{Variable} der Variable vorangestellt werden. So ist etwa
+
+@cindex Point and Click, Kommandozeile
+
+@example
+-dno-point-and-click
+@end example
+
+@noindent
+dasselbe wie
+@example
+-dpoint-and-click='#f'
+@end example
+
+Hier sind ein paar interessante Optionen:
+
+@table @samp
+@item help
+Die Ausführung von @code{lilypond -dhelp} zeigt alle verfügbaren @code{-d}
+Optionen.
+
+@item paper-size
+Setzt das Standard-Papierformat,
+@example
+-dpaper-size=\"letter\"
+@end example
+
+@noindent
+Die Zeichenkette, die das Format angibt, muss in Anführungszeichen mit Backslash
+( @code{\"} ) stehen.
+
+
+@item safe
+Vertraut der @code{.ly} Datei nicht.
+
+Wenn LilyPond über einen Webserver verfügbar gemacht wird, @b{MUSS} unbedingt
+eine die Optionen @code{--safe} oder @code{--jail} angegeben werden.
+Die @code{--safe} Option verhindert, dass in der .ly-Datei angegebener
+Scheme-Code das System gefährden kann, wie etwa in folgendem Beispiel:
+
+@quotation
+@verbatim
+#(system "rm -rf /")
+{
+ c4^#(ly:export (ly:gulp-file "/etc/passwd"))
+}
+@end verbatim
+@end quotation
+
+Mit der @code{-dsafe} Option werden alle Scheme-Ausdrücke einem speziellen
+sicheren Modus ausgewertet. Dieser Modus ist vom GUILE @file{safe-r5rs} Modul
+abgeleitet und fügt noch zahlreiche weitere erlaubte Funktionen der
+LilyPond Programm-Schnittstelle hinzu. Diese Funktionen sind in
+@file{scm/@/safe@/-lily@/.scm} angegeben.
+
+Zusätzliche verbietet der sichere Modus auch @code{\include} Befehle sowie
+die Benutzung eines Backslashs in @TeX{} Zeichenketten.
+
+Im sicheren Modus ist es nicht möglich, LilyPond-Variablen nach Scheme
+zu exportieren.
+
+@code{-dsafe} erkennt jedoch @emph{KEINE} Überbeanspruchung der verfügbaren
+Ressourcen. In diesem Modus ist es also trotzdem möglich, dass LilyPond in einer
+Endlosschleife hängt, z.B. wenn zyklische Datenstrukturen an das Backend
+übergeben werden. Wenn LilyPond also auf einem öffentlich zugänglichen
+Webserver verfügbar gemacht wird, sollte der Prozess sowohl in der CPU-
+als auch in der Speichernutzung limitiert werden.
+
+Der sichere Modus verhindert auch, dass zahlreiche nützliche
+Musikfragmente von LilyPond verarbeitet werden. Die @code{--jail} Option ist
+eine sicherere Alternative, benötigt allerdings auch mehr Aufwand zur
+Einrichtung.
+
+@item backend
+Gibt an, welches Ausgabeformat das LilyPond Backend benutzt. Mögliche Werte
+für diese Option sind:
+@table @code
+@item tex
+@TeX{}-Ausgabeformat, das mit La@TeX{} weiterverarbeitet werden kann. Falls sie
+existiert, wird die Datei @file{file.textmetrics} gelesen, um die Textweiten
+zu bestimmen.
+@item texstr
+Schreibt alle Zeichenketten in eine @file{.texstr}-Datei, die mit (La)@TeX{}
+verarbeitet werden kann, um eine @code{.textmetrics}-Datei mit den Textweiten
+zu erstellen. @strong{Achtung:} Diese Funktionalität ist momentan nicht
+verfügbar, da der Quellcode stark umstrukturiert wurde.
+@item ps
+ PostScript-Ausgabeformat.
+@cindex PostScript Ausgabeformat
+
+ Postscript-Dateien enthalten auch TTF-, Type1- und OTF-Schriften. Allerdings
+ wird die gesamte Schriftart eingefügt und nicht nur die benötigten Zeichen.
+ Vor allem wenn nicht-westliche Zeichensätze benutzt werden, kann dies zu sehr
+ großen Dateien führen.
+
+@item eps
+ Erzeugt @q{encapsulated PostScript} (EPS). Jede Seite (oder jedes System) wird
+ als eigene @file{EPS}-Datei ausgegeben, inklusive Schriftarten. Außerdem wird
+ eine Datei mit allen Seiten (bzw. Systemen) und Schriftarten erzeugt.
+
+Dies ist die Standardeinstellung von @command{lilypond-book}.
+
+@item svg
+ SVG-Ausgabe (Scalable Vector Graphics). Jede Seite wird als eigene
+ @file{SVG}-Datei ausgegeben, inklusive eingebetteten Schriftarten.
+@cindex SVG (Scalable Vector Graphics)
+ Sie benötigen einen SVG-Betrachter, der eingebettete Schriftarten unterstützt,
+ oder einen SVG-Betrachter, der eingebettete Schriftarten durch OTF-Schriften
+ ersetzen kann. In UNIX und Linux kann z.B. @uref{http://www.inkscape.org,Inkscape}
+ (ab Version 0.42) benutzt werden, nachdem die OTF-Schriften aus dem
+ LilyPond-Verzeichnis (typischerweise @file{/usr/share/lilypond/VERSION/fonts/otf/})
+ in das Verzeichnis @file{~/.fonts/} kopiert wurden.
+@item scm
+ Gibt die rohen Scheme-basierenden Zeichenbefehle aus, wie sie intern von
+ LilyPond benutzt werden.
+@cindex Scheme dump
+@end table
+
+Beispiel: @code{lilypond -dbackend=svg @var{Dateiname}.ly}
+
+@cindex Ausgabeformat
+
+@item preview
+Erzeugt eine Ausgabedatei, die nur die Titelzeilen und das erste System
+enthält.
+
+@item print-pages
+Erzeugt vollständige Seiten (Standardeinstellung). @code{-dno-print-pages}
+ist in Verbindung mit @code{-dpreview} nützlich.
+
+@end table
+
+
+
+@item -h,--help
+Zeigt eine Zusammenfassung der Programmbenutzung und der Optionen.
+
+@item -H,--header=@var{FELD}
+Gibt den Inhalt eines Feldes aus dem @code{\header}-Block in die Datei
+@file{Dateiname.@var{FELD}} aus.
+
+@item --include, -I=@var{Verzeichnis}
+Fügt @var{Verzeichnis} zur Liste der Suchpfade hinzu.
+@cindex Dateisuche
+@cindex Suchpfad
+
+@item -i,--init=@var{Initialisierungsdatei}
+Benutzt @var{Initialisierungsdatei} zur gesamten Programminitialisierung. Der
+Standardwert ist @file{init.ly}.
+
+@item -o,--output=@var{DATEI}
+Schreibt das Ergebnis der Verarbeitung mit LilyPond in die Ausgabedatei
+@var{DATEI}. Die entsprechende Dateinamenserweiterung wird angehängt (z.B.
+@code{.pdf} für pdf, @code{.tex} für tex, etc.).
+
+@item --ps
+Erzeugt PostScript.
+
+@item --dvi
+Erzeugt DVI-Dateien. In diesem Fall sollte das @TeX{}-Backend angegeben werden,
+d.h. auch @code{-dbackend=tex}.
+
+@item --png
+Erzeugt eine Grafik-Datei im PNG-Format von jeder Seite. Diese Option
+impliziert auch @code{--ps}. Die Auflösung in DPI der Grafik kann festgelegt
+werden durch
+@example
+-dresolution=110
+@end example
+
+@item --pdf
+Erzeugt PDF-Dateien. Dies impliziert @code{--ps}.
+
+
+
+@item -j,--jail=@var{Benutzer},@var{Gruppe},@var{Jail-Verzeichnis},@var{Arbeitsverzeichnis}
+Führt @command{lilypond} in einem chroot-Jail aus.
+
+Die @code{--jail} Option ist eine flexiblere Alternative zu @code{--safe}, wenn
+LilyPond über das Internet verfügbar gemacht wird oder LilyPond-Quelldateien
+von Dritten automatisch vararbeitet werden.
+
+Sie funktioniert dergestalt, dass das Wurzelverzeichnis von
+@command{lilypond} auf @var{Jail-Verzeichnis} gesetzt wird, bevor die
+tatsächliche Kompilierung der .ly-Datei beginnt. Der Benutzer und die Gruppe
+werden auf die angegebenen Werte gesetzt und das aktuelle Arbeitsverzeichnis
+wird ebenfalls auf den angegebenen Wert @var{Arbeitsverzeichnis} gesetzt.
+Diese Einstellungen garantieren (zumindest in der Theorie), dass es nicht
+möglich ist, aus dem Jail auszubrechen. Damit @code{--jail} funktioniert, muss
+@command{lilypond} allerdings als root ausgeführt werden, was normalerweise
+auf sichere Art mit dem Kommando @command{sudo} erreicht werden kann.
+
+Das Jail-Verzeichnis zu erstellen ist etwas heikel, da LilyPond alle zur
+Ausführung nötigen Bibliotheken und Dateien @emph{innerhalb des
+Jail-Verzeichnisses} finden muss. Ein typisches Setup besteht aus folgenden
+Punkten:
+
+@table @asis
+@item Erstellung eines getrennten Dateisystems
+Ein eigenes Dateisystem muss für LilyPond erstellt werden, sodass es mit
+sicheren Einstellungen wie @code{noexec}, @code{nodev} und @code{nosuid}
+eingebunden werden kann. Damit ist es unmöglich, Programme von diesem
+Dateisystem auszuführen oder direkt auf eine Hardware-Schnittstelle
+zuzugreifen. Wenn Sie keine eigene Partition erstellen möchten, können Sie
+auch eine Datei der entsprechenden Größe erstellen und sie als @q{loop}-Gerät
+einbinden. Ein getrenntes Dateisystem garantiert auch, dass LilyPond nicht
+mehr Festplattenspeicher benutzt als erlaubt.
+
+@item Erstellung eines eigenen Benutzerkontos
+Es sollte ein eigener Benutzer und eine eigene Gruppe (z. B.
+@code{lily}/@code{lily}) mit geringen Rechten für die Ausführung von LilyPond
+innerhalb des Jails benutzt werden. Nur ein einziges Verzeichnis des Jails sollte
+für den Benutzer schreibbar sein und als @var{Arbeitsverzeichnis} an
+@code{lilypond} übergeben werden.
+
+@item Einrichtung des Jails
+LilyPond muss zahlreiche Dateien für die Ausführung einlesen. All diese
+Dateien müssen in das Jail-Verzeichnis kopiert werden (mit denselben Pfaden
+wie im tatsächlichen Wurzel-Dateisystem). Die gesamte LilyPond-Installation
+(typischerweise @file{/usr/share/lilypond}) sollte kopiert werden.
+
+Falls Probleme auftreten, ist es am einfachsten, Lilypond mittels
+@command{strace} zu starten, wodurch Sie relativ leicht feststellen können,
+welche Dateien im Jail noch fehlen.
+
+@item Ausführung von LilyPond
+In einem mit @code{noexec} eingebundenen Jail ist es nicht möglich, externe
+Programme auszuführen. Daher muss LilyPond auf eine Art gestartet werden,
+die keine weitere Ausführung von Programmen benötigt. Wie bereits erwähnt
+muss LilyPond mit Administrator-Rechten gestartet werden (die es allerdings
+sofort wieder abgibt), beispielsweise mittels @command{sudo}. Außerdem
+ist es eine gute Idee, die LilyPond zur Verfügung stehende CPU-Zeit zu
+limitieren (z. B. mit @command{ulimit -t}) und -- falls das Betriebssystem
+dies unterstützt -- auch den zur Verfügung stehenden Hauptspeicher.
+@end table
+
+
+@item -v,--version
+Gibt die Versionsnummer aus.
+
+@item -V,--verbose
+Gibt ausführliche informative Meldungen aus: Zeigt die vollen Dateipfade
+aller gelesenen Dateien sowie Informationen über die Laufzeit.
+
+@item -w,--warranty
+Zeigt die Garantiebedingungen an, unter denen GNU LilyPond steht. (Es besteht
+@strong{KEINERLEI GARANTIE}!)
+@end table
@node Environment variables
unerwarteten Fällen auf. Manchmal kann Lilypond auch eine fehlerhafte
Stelle zwar noch problemlos verarbeiten, ein paar Zeilen später wirkt
sich der Fehler aber dann doch noch aus. In solchen Fällen, wo Sie in
-der angegebenen Zeile keinen Fehler erkenn, sollten Sie auch die Zeilen
+der angegebenen Zeile keinen Fehler erkennen, sollten Sie auch die Zeilen
oberhalb der angegebenen Stelle genauer unter die Lupe nehmen.
Beispieldateien, die nicht minimal sind, können wir meist aus Zeitgründen
nicht effektiv bearbeiten.
-
-
-@c -- SKELETON FILE --
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of lilypond-learning.tely
@ignore
- Translation of GIT committish: 8e7d8cfcb162ae90efc1d24bd378de1868f98982
+ Translation of GIT committish: 54fcdc3c1f2550992fb811183122fc1c33ff714c
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
igualmente bellas pero más complejas.
@menu
-* How LilyPond files work::
-* Voices contain music::
-* Contexts and engravers::
-* Extending the templates::
-@end menu
+* How LilyPond files work::
+* Voices contain music::
+* Contexts and engravers::
+* Extending the templates::
+@end menu
@node How LilyPond files work
@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
+* 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
@node Introduction to the LilyPond file structure
@subsection Introduction to the LilyPond file structure
@example
\version @w{"@version{}"}
+\header @{ @}
\score @{
@var{...expresión musical compuesta...} % toda la música viene aquí
- \header @{ @}
\layout @{ @}
\midi @{ @}
@}
expresión musical. Por tanto, se pueden situar dentro de un bloque
@code{\score} o fuera de él. De hecho, estas instrucciones se sitúan
por lo general fuera del bloque @code{\score} (por ejemplo,
-@code{\header} se suele colocar antes de la instrucción @code{\score}
-porque las cabeceras aparecen de forma natural al principio de la
-partitura. Es tan sólo otra abreviatura que LilyPond acepta.
+@code{\header} se suele colocar antes de la instrucción @code{\score},
+como muestra el ejemplo que aparece al principio de la sección.
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
@code{\book}, ya sea explícita o implícitamente) afecta a los bloques
@code{\score} que están dentro de ese @code{\book}.
-Cada bloque @code{\context} afecta al contexto con nombre (por
-ejemplo, @code{\StaffGroup}) a todo lo largo del bloque (@code{\score}
-o @code{\book}) en que aparece.
-
Para ver más detalles, consulte @ruser{Multiple scores in a book}.
@cindex variables
@cindex score
@cindex partitura
-En la sección anterior, @ref{How LilyPond files work} hemos podido
-ver la organización general de los archivos de entrada de LilyPond.
-Pero parece que nos saltamos la parte más importante: ¿cómo
-averiguamos qué escribir después de @code{\score}?
+En la sección anterior, @ref{Introduction to the LilyPond file
+structure}, hemos podido ver la organización general de los archivos
+de entrada de LilyPond. Pero parece que nos saltamos la parte más
+importante: ¿cómo averiguamos qué escribir después de @code{\score}?
No nos hemos saltado nada en absoluto. El gran misterio es, sencillamente,
que no hay @emph{ningún} misterio. La siguiente línea lo explica
todo:
@quotation
-@emph{Un bloque @code{\score} debe comenzar con una única expresión
-musical compuesta.}
+@emph{Un bloque @code{\score} debe comenzar con una expresión musical
+compuesta.}
@end quotation
@noindent
Para comprender lo que se entiende por expresión musical y expresión
-musical compuesta, quizá encuentre útil dar un repaso a @ref{Music
-expressions explained}. En esta sección, vimos cómo elaborar grandes
-expresiones musicales a partir de pequeñas piezas (comenzábamos con
-notas, luego acordes, etc.). Ahora partiremos de una gran expresión
-musical y recorreremos el camino inverso hacia abajo.
+musical compuesta, quizá encuentre útil dar un repaso al tutorial,
+@ref{Music expressions explained}. En esta sección, vimos cómo
+elaborar grandes expresiones musicales a partir de pequeñas piezas
+(comenzábamos con notas, luego acordes, etc.). Ahora partiremos de
+una gran expresión musical y recorreremos el camino inverso hacia
+abajo.
@example
\score @{
Recuerde que usamos @code{<<} y @code{>>} en vez de @code{@{ ... @}}
para presentar música simultánea. Y, por supuesto, queremos presentar
las partes vocal y del piano al mismo tiempo, ¡no una después de otra!
-Sin embargo, la construcción @code{<< ... >>} no es realmente
-necesaria para el pentagrama del cantante (pues contiene una sola
-expresión musical), pero los pentagramas (Staff) a menudo necesitan
-varias voces (Voice) en su interior, así es bueno adoptar el hábito de
-usar @code{<< ... >>} en lugar de llaves. Escribiremos algo de música
-real más tarde; por ahora limitémonos a poner algunas notas y letra de
-relleno.
+Observe que la construcción @code{<< ... >>} no es realmente necesaria
+para el pentagrama del cantante (pues contiene una sola expresión
+musical); sin embargo, el uso de @code{<< ... >>} en lugar de llaves
+sigue siendo necesario si la música que debe ir en el pentagrama está
+compuesta por dos expresiones simultáneas, por ejemplo dos voces
+simultáneas o una voz con letra. Escribiremos algo de música real más
+tarde; por ahora limitémonos a poner algunas notas y letra de relleno.
@lilypond[verbatim,quote,ragged-right]
\score {
}
@end lilypond
-Tenga cuidado con la diferencia entre las notas, que se introducen con
-@code{\relative}, y la letra, que se introduce con @code{\lyricmode}.
-Estas instrucciones son esenciales para decirle a LilyPond que
-interprete el contenido que viene a continuación como música y texto,
-respectivamente.
+Tenga cuidado con la diferencia entre las notas, que van precedidas de
+@code{\relative} o insertadas directamente en la expresión musical, y
+la letra, que va precedida de @code{\lyricmode}. Estas instrucciones
+son esenciales para decirle a LilyPond que interprete el contenido que
+viene a continuación como música y texto, respectivamente.
Cuando escriba una sección @code{\score} o cuando la esté leyendo,
-hágalo despacio y con cuidado. Comience por la capa exterior y luego
-trabaje sobre cada una de las capas interiores. También ayuda ser
-estricto con los márgenes (asegúrese de que en su editor de texto cada
-elemento de la misma capa comienza en la misma posición horizontal).
+hágalo despacio y con cuidado. Comience por el nivel exterior y luego
+trabaje sobre cada uno de los niveles interiores. También es de gran
+ayuda ser muy estricto con los márgenes (asegúrese de que en su editor
+de texto cada elemento del mismo nivel comienza en la misma posición
+horizontal).
+
+@seealso
+
+Referencia de la notación:
+@ruser{Structure of a score}.
@node Nesting music expressions
\new Staff {
\relative g' {
r4 g8 g c4 c8 d |
- e4 r8
+ e4 r8
<<
{ f c c }
\new Staff {
siguiente:
@lilypond[verbatim,quote,ragged-right]
-\new Staff ="main" {
+\new Staff = "main" {
\relative g' {
r4 g8 g c4 c8 d |
e4 r8
colocar por encima del pentagrama llamado @qq{main} en vez de la
posición predeterminada que sería por debajo.
+@seealso
+
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
necesitaría más instrucciones que aún no se han visto. Véase
-@ref{Size of objects}
+@ref{Size of objects} y @ruser{Ossia staves}.
+
-
@node On the un-nestedness of brackets and ties
@subsection On the un-nestedness of brackets and ties
@item @code{< .. >}
@tab Encierra las notas de un acorde
@item @code{<< .. >>}
- @tab Encierra secciones concurrentes o simultáneas
+ @tab Encierra expresiones musicales simultáneas
@item @code{( .. )}
@tab Marca el comienzo y el final de una ligadura de expresión
@item @code{\( .. \)}
fundamental de todos--.
@menu
-* I'm hearing Voices::
-* Explicitly instantiating voices::
-* Voices and vocals::
-@end menu
+* I'm hearing Voices::
+* Explicitly instantiating voices::
+* Voices and vocals::
+@end menu
@node I'm hearing Voices
@subsection I'm hearing Voices
distintas duraciones: la negra Re, y la corchea Fa sostenido. ¿Cómo se
codifica esto? No se pueden escribir como un acorde porque todas las
notas de un acorde deben tener la misma duración. Y no se pueden
-escribir como dos notas separadas porque tienen que empezar en el
+escribir como dos notas en secuencia porque tienen que empezar en el
mismo momento. Aquí es donde se necesitan dos voces.
Veamos cómo se hace esto dentro de la sintaxis de entrada de LilyPond.
}
@end lilypond
-@funindex \voiceXXXStyle
+@funindex \voiceOneStyle
+@funindex \voiceTwoStyle
+@funindex \voiceThreeStyle
+@funindex \voiceFourStyle
+@funindex \voiceNeutralStyle
Las instrucciones @code{\voiceXXXStyle} están pensadas principalmente
para usarlas en documentos educativos como este mismo. Modifican el
de forma que las voces se puedan distinguir fácilmente. La voz uno
está establecida a rombos rojos, la voz dos a triángulos azules, la
voz tres a círculos verdes con aspas, y la voz cuatro (que no se
-utiliza aquí) a aspas color magenta. Veremos más adelante cómo el
-usuario puede crear instrucciones como éstas. Véase @ref{Visibility
-and color of objects} y @ref{Using variables for tweaks}.
+utiliza aquí) a aspas color magenta. @code{\voiceNeutralStyle} (also
+not used here) reverts the style back to the default.
+Veremos más adelante cómo el usuario puede crear instrucciones como
+éstas. Véase
+@ref{Visibility and color of objects} y
+@ref{Using variables for tweaks}.
La polifonía no cambia la relación de las notas dentro de un bloque
@code{notaB} es relativa a @code{notaA} @*
@code{notaC} es relativa a @code{notaB}, no a @code{notaA}; @*
@code{notaD} es relativa a @code{notaB}, no a @code{notaA} ni a
-@code{notaC}. @*
-@code{notaE} es relativa a @code{notaD}, no a @code{notaA}
+@code{notaC}; @*
+@code{notaE} es relativa a @code{notaD}, no a @code{notaA}.
Una forma alternativa, que podría ser más clara si las notas en las
voces están muy separadas, es colocar una instrucción @code{\relative}
<<
{ % Voice one
\voiceOneStyle
- c2 aes4. bes8
+ c2 aes4. bes8
}
\\ % Voice two
{ \voiceTwoStyle
- aes2 f4 fes
+ aes2 f4 fes
}
\\ % No Voice three (we want stems down)
\\ % Voice four
\once \override NoteColumn #'force-hshift = #0
<ees c>2
\once \override NoteColumn #'force-hshift = #0.5
- des2
+ des2
}
>> |
<c ees aes c>1 |
maneras de ajustar la colocación horizontal de las notas. Aún no
estamos preparados para ver cómo corregir esto, así que dejaremos este
problema aparcado hasta una sección posterior (véase la propiedad
-force-hshift en @ref{Fixing overlapping notation} )
+@code{force-hshift} en @ref{Fixing overlapping notation}).
+
+@seealso
+
+Referencia de la notación:
+@ruser{Multiple voices}.
+
@node Explicitly instantiating voices
@subsection Explicitly instantiating voices
@funindex \voiceTwo
@funindex \voiceThree
@funindex \voiceFour
+@funindex \oneVoice
@funindex \new Voice
@cindex contextos de voz, creación de
}
% Initiate second voice
\new Voice {
- % set stems, etc down
+ % Set stems, etc, down
\voiceTwo
s4 r8 e4 d c8 ~ | c8 b16 a b8 g ~ g2 |
}
% Initiate third voice
\new Voice {
- % set stems, etc up
+ % Set stems, etc, up
\voiceThree
s1 | s4 b4 c2 |
}
desplazamiento, se producirá el mensaje de error @qq{Chocan demasiadas
columnas de notas}.
+@seealso
+
+Referencia de la notación:
+@ruser{Multiple voices}.
+
+
@node Voices and vocals
@subsection Voices and vocals
}
@end lilypond
+@seealso
+
+Referencia de la notación:
+@ruser{Vocal music}.
+
+
@node Contexts and engravers
@section Contexts and engravers
LilyPond.
@menu
-* Contexts explained::
-* Creating contexts::
-* Engravers explained::
-* Modifying context properties::
-* Adding and removing engravers::
+* Contexts explained::
+* Creating contexts::
+* Engravers explained::
+* Modifying context properties::
+* Adding and removing engravers::
@end menu
@node Contexts explained
sin guión ni barra baja, por ejemplo:
@code{GregorianTranscriptionStaff}.
+@seealso
+
+Referencia de la notación:
+@ruser{Contexts explained}.
+
@node Creating contexts
@subsection Creating contexts
un ejemplo anotado de música real:
@lilypond[quote,verbatim,ragged-right]
-\score { % start single compound music expression
+\score { % start of single compound music expression
<< % start of simultaneous staves section
\time 2/4
\new Staff { % create RH staff
g8 <bes d> ees, <g c> |
g8 <bes d> ees, <g c> |
} % end of LH voice one notes
- } % end of first LH voice
+ } % end of LH voice one
\new Voice { % create LH voice two
\voiceTwo
\relative g { % start of LH voice two notes
Observe la distinción entre el nombre del tipo de contexto,
@code{Staff}, @code{Voice}, etc., y el nombre identificativo de una
instancia en particular de ese tipo, que puede ser cualquier secuencia
-de letras inventada por el usuario. El nombre identificativo se
-utiliza para referirnos más tarde a esa instancia en particular de un
-contexto. Hemos visto esto en la sección acerca de la letra, en
-@ref{Voices and vocals}.
+de letras inventada por el usuario. En el nombre identificativo
+también se pueden utilizar dígitos y espacios, pero en este caso aquél
+debe ir entre comillas p.ej. @code{\new Staff = "MiPentagrama 1"
+@var{expresión_musical}}. El nombre identificativo se utiliza para
+referirnos más tarde a esa instancia en particular de un contexto.
+Hemos visto esto en la sección acerca de la letra, en @ref{Voices and
+vocals}.
+
+@seealso
+
+Referencia de la notación:
+@ruser{Creating contexts}.
+
@node Engravers explained
@subsection Engravers explained
Los grabadores residen y operan dentro de Contextos. Los grabadores
como el grabador de la indicación metronómica,
-@code{Metronome_mark_engraver}, cuya acción y resultado se aplica a la
-partitura como un todo, operan en el contexto del nivel más alto: el
-contexto de partitura @code{Score}.
+@code{Metronome_mark_engraver}, cuya acción y resultado se aplican a
+la partitura como un todo, operan en el contexto del nivel más alto:
+el contexto de partitura @code{Score}.
El grabador de la clave @code{Clef_engraver} y el de la armadura
@code{Key_engraver} se encuentran probablemente en todos los contextos
-de pentagrama (Staff), pues los distintos pentagramas podrían requerir
-diferentes claves y armaduras.
+de pentagrama (@code{Staff}), pues los distintos pentagramas podrían
+requerir diferentes claves y armaduras.
El grabador de las cabezas de nota @code{Note_heads_engraver} y el de
las plicas @code{Stem_engraver} viven en cada uno de los contextos de
función. Estas propiedades, como las que están asociadas con los
contextos, se pueden modificar para cambiar el funcionamiento del
grabador o el aspecto de esos elementos en la partitura impresa.
-
+
Todos los grabadores tienen nombres compuestos de varias palabras que
describen su función. Sólo está en mayúsculas la inicial de la
primera palabra, y el resto se le une mediante guiones bajos. Así, el
junto a su función. Podrá comprobar que es fácil adivinar la función
a partir del nombre (en inglés), y viceversa.
-@multitable @columnfractions .3 .7
+@multitable @columnfractions .3 .7
@headitem Grabador
@tab Función
@item Accidental_engraver
@tab Graba las barras
@item Clef_engraver
@tab Graba las claves
-@item Dynamic_engraver
+@item Completion_heads_engraver
+ @tab Splits notes which cross bar lines
+@c The old Dynamic_engraver is deprecated. -jm
+@item New_dynamic_engraver
@tab Crea reguladores e indicaciones dinámicas textuales
+@item Forbid_line_break_engraver
+ @tab Prevents line breaks if a musical element is still active
@item Key_engraver
@tab Crea la armadura de la tonalidad
@item Metronome_mark_engraver
Más adelante veremos cómo la salida de LilyPond se puede cambiar
mediante la modificación del funcionamiento de los Grabadores.
-
+
+@seealso
+
+Referencia de funcionamiento interno:
+@rinternals{Engravers and Performers}.
+
@node Modifying context properties
@subsection Modifying context properties
equivocado, no se produce ningún mensaje de error, pero el
funcionamiento esperado no tendrá lugar. Por ejemplo, la propiedad
@code{instrumentName} (nombre del instrumento) vive claramente dentro
-del contexto de Staff, puesto que es el pentagrama el que debe ser
-nombrado. En este ejemplo, el primer pentagrama resulta etiquetado,
-pero no el segundo, porque hemos omitido el nombre del contexto.
+del contexto de @code{Staff}, puesto que es el pentagrama el que debe
+ser nombrado. En este ejemplo, el primer pentagrama resulta
+etiquetado, pero no el segundo, porque hemos omitido el nombre del
+contexto.
@lilypond[quote,verbatim,ragged-right]
<<
}
\new Staff \relative c' {
\set instrumentName = #"Alto" % Wrong!
- d4 d
+ d4 d
}
>>
@end lilypond
-Recuerde que el nombre del contexto predeterminado es Voice, así que
-la segunda instrucción @code{\set} establece la propiedad
-@code{instrumentName} del contexto Voice a @qq{Alto}, pero como
+Recuerde que el nombre del contexto predeterminado es @code{Voice},
+así que la segunda instrucción @code{\set} establece la propiedad
+@code{instrumentName} del contexto @code{Voice} a @qq{Alto}, pero como
LilyPond no busca esta propiedad en el contexto @code{Voice}, no se
realiza ninguna acción. Esto no es un error, y no se registra ningún
mensaje en el archivo Log de registro de errores.
cualquier @q{property} (ficticia) usando cualquier nombre que queramos
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 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.
+producirá ninguna acción. Algunos editores de texto que apoyan a los
+archivos de entrada de LilyPond de manera especial, documentan los
+nombres de propiedades con viñetas cuando psamos sobre ellos con el
+puntero del ratón, como JEdit con la extensión LilyPondTool, o
+resaltan los nombres de propiedades desconocidas de manera diferente,
+como ConTEXT. Si no se utiliza un editor con tales posibilidades, se
+recomienda comprobar la corrección del nombre de la propiedad en el
+manual de Referencia de funcionamiento interno: véase
+@rinternals{Tunable context properties} o @rinternals{Contexts}.
La propiedad @code{instrumentName} tendrá efecto solamente si se
establece dentro del contexto @code{Staff}, pero algunas propiedades
se pueden establecer en más de un contexto. Por ejemplo, la propiedad
-@code{extraNatural} está establecida por defecto al valor ##t
-(verdadero) para todos los pentagramas. Si se establece a ##f (falso)
-en un contexto de @code{Staff} determinado, se aplicará solamente a
-las alteraciones de ese pentagrama. Si se establece a falso en el
-contexto de la partitura, @code{Score}, se aplicará a todos los
-pentagramas.
+@code{extraNatural} está establecida por defecto al valor @code{##t}
+(verdadero) para todos los pentagramas. Si se establece a @code{##f}
+(falso) en un contexto de @code{Staff} determinado, se aplicará
+solamente a las alteraciones de ese pentagrama. Si se establece a
+falso en el contexto de la partitura, @code{Score}, se aplicará a
+todos los pentagramas.
Así, esto desactivará los becuadros adicionales en un pentagrama:
valor predeterminado, no el valor en curso.
@lilypond[quote,verbatim,ragged-right,relative=1,fragment]
-c4
+c4
% make note heads smaller
\set fontSize = #-4
d e
Hemos podido ver cómo establecer los valores de diversos tipos de
propiedad diferentes. Observe que los números enteros y reales van
siempre precedidos de un símbolo de cuadradillo, @code{#}, mientras
-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 puede especificar de una forma mucho más general
-utilizando la potentísima instrucción @code{markup}.
+que un valor booleano verdadero o falso se especifica mediante
+@code{##t} y @code{##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 puede especificar de una forma
+mucho más general utilizando la potentísima instrucción @code{markup}.
+@unnumberedsubsubsec Setting context properties with @code{\with}
@funindex \with
@cindex contexto, propiedades de, establecimiento con \with
dentro de una cláusula @code{\with}, tiene el efecto de reiniciar el
valor predeterminado del tamaño de la fuente tipográfica. Si más
tarde se modifica con @code{\set}, este nuevo valor predeterminado
-puede restablecerse con la instrucción @code{\unset fontSize}.xs
+puede restablecerse con la instrucción @code{\unset fontSize}.
+
+@unnumberedsubsubsec Setting context properties with @code{\context}
+
+Los valores de propiedad de los contextos se pueden establecer para
+@emph{todos} los contextos de un tipo determinado, como por ejemplo
+todos los contextos de @code{Staff}, con una única instrucción. El
+tipo de contexto se identifica mediante la utilización del nombre de
+su tipo, como @code{Staff}, precedido de una barra invertida:
+@code{\Staff}. El enunciado que establece el valor de la propiedad es
+el mismo que el que está en un bloque @code{\with}, presentado
+anteriormente. Se coloca en un bloque @code{\context} dentro de un
+bloque @code{\layout}. Cada bloque @code{\context} afecta a todos los
+contextos del tipo especificado a lo largo del bloque @code{\score} o
+@code{\book} en el que aparece el bloque @code{\layout}. A
+continuación presentamos un ejemplo que muestra el formato:
+
+@lilypond[verbatim,quote]
+\score {
+ \new Staff {
+ \relative c'' {
+ cis4 e d ces
+ }
+ }
+ \layout {
+ \context {
+ \Staff
+ extraNatural = ##t
+ }
+ }
+}
+@end lilypond
+
+@noindent
+Las propiedades de contexto establecidas de esta forma se pueden
+sobreescribir para ejemplares concretos de contextos mediante
+enunciados dentro de un bloque @code{\with}, y mediante instrucciones
+@code{\set} intercaladas dentro de enunciados musicales.
+
+@seealso
+
+Referencia de la notación:
+@ruser{Changing context default settings}.
+@c FIXME
+@c uncomment when backslash-node-name issue is resolved -pm
+@c @ruser{The set command}.
+
+Referencia de funcionamiento interno:
+@rinternals{Contexts},
+@rinternals{Tunable context properties}.
+
@node Adding and removing engravers
@subsection Adding and removing engravers
Como ilustración, repitamos un ejemplo extraído de la sección anterior
con las líneas del pentagrama eliminadas. Recuerde que las líneas del
-pentagrama están dibujadas por el grabador Staff_symbol_engraver.
+pentagrama están dibujadas por el grabador
+@code{Staff_symbol_engraver}.
@lilypond[quote,verbatim,ragged-right]
\new Staff \with {
\remove Staff_symbol_engraver
}
\relative c' {
- c4
+ c4
\set fontSize = #-4 % make note heads smaller
d e
\set fontSize = #2.5 % make note heads larger
f g
- \unset fontSize % return to original size
+ \unset fontSize % return to default size
a b
}
@end lilypond
Los grabadores también se pueden añadir a los contextos individuales
La instrucción que lo hace es
-@code{\consists @emph{Nombre_del_grabador}},
+@code{\consists @var{Nombre_del_grabador}},
situada dentro de un bloque @code{\with}. Ciertas partituras vocales
-tienen una indicación de @rglos{ambitus} situada al principio del
-pentagrama para indicar el ámbito de notas en dicho pentagrama. El
-ambitus se produce por parte del grabador @code{Ambitus_engraver}, que
-normalmente no está incluido en ningún contexto. Si lo añadimos al
-contexto @code{Voice}, calcula el rango a partir de esa única voz:
+tienen una indicación de ámbito o tesitura situada al principio del
+pentagrama para indicar el ámbito de notas en dicho pentagrama, véase
+@rglos{ambitus}. El ambitus se produce por parte del grabador
+@code{Ambitus_engraver}, que normalmente no está incluido en ningún
+contexto. Si lo añadimos al contexto @code{Voice}, calcula el rango a
+partir de esa única voz:
@lilypond[quote,verbatim,ragged-right]
\new Staff <<
\new Voice \with {
\consists Ambitus_engraver
}
- \relative c'' {
+ \relative c'' {
\voiceOne
- c a b g
+ c a b g
}
\new Voice
\relative c' {
@end lilypond
@noindent
-pero si añadimos el grabador de Ambitus al contexto de @code{Staff},
-calcula el rango a partir de todas las notas en todas las voces de ese
+pero si añadimos el grabador de ámbito al contexto de @code{Staff},
+calcula el rango de todas las notas en todas las voces de ese
pentagrama:
@lilypond[quote,verbatim,ragged-right]
}
<<
\new Voice
- \relative c'' {
+ \relative c'' {
\voiceOne
- c a b g
+ c a b g
}
\new Voice
\relative c' {
particular incluyendo la instrucción @code{\set} dentro de un bloque
@code{\context} de la misma forma.
+@seealso
+
+Referencia de la notación:
+@ruser{Modifying context plug-ins},
+@ruser{Changing context default settings}.
+
+
@node Extending the templates
@section Extending the templates
@menu
-* Soprano and cello::
-* Four-part SATB vocal score::
-* Building a score from scratch::
+* Soprano and cello::
+* Four-part SATB vocal score::
+* Building a score from scratch::
@end menu
@node Soprano and cello
justo debajo de todo lo de la soprano. También tenemos que poner
@code{<<} y @code{>>} antes y después de la música -- lo que indica a
LilyPond que hay más de una cosa (en este caso, @code{Staff})
-sucediendo al mismo tiempo -- . La @code{\score} se parecerá ahora a
-esto
+sucediendo al mismo tiempo --. La @code{\score} se parecerá ahora a
+esto:
@c Indentation in this example is deliberately poor
@example
}
@end lilypond
+@seealso
+
+Las plantillas de inicio se pueden encontrar en el apéndice
+@q{Templates}, véase @ref{Single staff}.
+
+
@node Four-part SATB vocal score
@subsection Four-part SATB vocal score
@c The following should appear as music without code
@lilypond[quote,ragged-right]
global = { \key d \major \time 4/4 }
-sopMusic = \relative c'' {
+sopranoMusic = \relative c'' {
\clef "treble"
r4 d2 a4 | d4. d8 a2 | cis4 d cis2 |
}
-sopWords = \lyricmode {
+sopranoWords = \lyricmode {
Wor -- thy is the lamb that was slain
}
altoMusic = \relative a' {
\clef "treble"
r4 a2 a4 | fis4. fis8 a2 | g4 fis e2 |
}
-altoWords = \sopWords
+altoWords = \sopranoWords
tenorMusic = \relative c' {
\clef "G_8"
r4 fis2 e4 | d4. d8 d2 | e4 a, cis2 |
}
-tenorWords = \sopWords
+tenorWords = \sopranoWords
bassMusic = \relative c' {
\clef "bass"
r4 d2 cis4 | b4. b8 fis2 | e4 d a'2 |
}
-bassWords = \sopWords
+bassWords = \sopranoWords
upper = \relative a' {
\clef "treble"
\global
\new ChoirStaff <<
\new Staff = "sopranos" <<
\set Staff.instrumentName = "Soprano"
- \new Voice = "sopranos" { \global \sopMusic }
+ \new Voice = "sopranos" { \global \sopranoMusic }
>>
- \new Lyrics \lyricsto "sopranos" { \sopWords }
+ \new Lyrics \lyricsto "sopranos" { \sopranoWords }
\new Staff = "altos" <<
\set Staff.instrumentName = "Alto"
\new Voice = "altos" { \global \altoMusic }
>> % end ChoirStaff
\new PianoStaff <<
- \set PianoStaff.instrumentName = "Piano "
+ \set PianoStaff.instrumentName = "Piano"
\new Staff = "upper" \upper
\new Staff = "lower" \lower
>>
Ninguna de las plantillas proporciona esta disposición con exactitud.
La más parecida es @q{partitura vocal SATB y reducción de piano
-automática}, pero necesitamos cambiar la disposición y añadir un
-acompañamiento de piano que no esté derviado automáticamente de las
-partes vocales. Las variables que contienen la música y la letra de
-las partes vocales es adecuada, pero tendremos que añadir variables
-para la reducción de piano.
+automática} (véase @ref{Vocal ensembles}), pero necesitamos cambiar la
+disposición y añadir un acompañamiento de piano que no esté derviado
+automáticamente de las partes vocales. Las variables que contienen la
+música y la letra de las partes vocales es adecuada, pero tendremos
+que añadir variables para la reducción de piano.
El orden en que aparecen los contextos en el ChoirStaff de la
plantilla no se corresponde con el orden de la partitura vocal que
\set Staff.instrumentName = "Tenor"
\new Voice = "tenores" @{ \global \musicaTenor @}
>>
- \new Lyrics \lyricsto "tenors" @{ \letraTenor @}
+ \new Lyrics \lyricsto "tenores" @{ \letraTenor @}
\new Staff = "bajos" <<
\set Staff.instrumentName = "Bass"
\new Voice = "bajos" @{ \global \musicaBajo @}
>>
- \new Lyrics \lyricsto "basses" @{ \letraBajo @}
+ \new Lyrics \lyricsto "bajos" @{ \letraBajo @}
>> % fin del ChoirStaff
@end example
\clef "bass"
\new Voice = "bajos" @{ \global \musicaBajo @}
>>
- \new Lyrics \lyricsto "bajos" @{ \letraBajo @}
+ \new Lyrics \lyricsto "bajos" @{ \letraBajo @}
>> % fin del ChoirStaff
\new PianoStaff <<
>>
}
@end lilypond
-
+
@node Building a score from scratch
@subsection Building a score from scratch
>>
@end example
-No es estrictamente necesario utilizar la construcción simultánea
-@code{<< >>} para el pentagrama del manual dos y el pentagrama del
-órgano de pedal, ya que contienen una única expresión, pero no hace
-daño y es una buena costumbre utilizar siempre dobles ángulos después
-de @code{\new Staff} cuando hay varias voces. Lo opuesto es cierto
-para las voces: normalmente deben ir seguidas de llaves @code{@{
-.. @}} en caso de que tengamos música codificada como distintas
-variables que se deben situar consecutivamente.
+No es necesario utilizar la construcción simultánea @code{<< >>} para
+el pentagrama del manual dos y el pentagrama del órgano de pedal, ya
+que contienen una única expresión, pero no hace daño, y es una buena
+costumbre utilizar siempre dobles ángulos después de @code{\new Staff}
+cuando hay varias voces. Lo opuesto es cierto para las voces:
+normalmente deben ir seguidas de llaves @code{@{ .. @}} en caso de que
+tengamos música codificada como distintas variables que se deben
+situar consecutivamente.
Añadamos esta estructura al bloque de partitura, y ajustemos el
sangrado de los márgenes. También escribimos las claves
-correspondientes, nos aseguramos de que las plicas de la segunda voz
-apuntan hacia abajo mediante @code{\voiceTwo} y escribimos el compás y
-la tonalidad en cada uno de los pentagramas usando nuestra variable
-previamente definida @code{\TimeKey}.
+correspondientes, nos aseguramos de que las plicas y ligaduras de
+unión y de expresión en cada una de las voces del pentagrama superior
+apuntan en la dirección adecuada con @code{\voiceOne} y
+@code{\voiceTwo} y escribimos el compás y la tonalidad en cada uno de
+los pentagramas usando nuestra variable previamente definida
+@code{\TimeKey}.
@example
\score @{
\new Staff = "ManualUno" <<
\TimeKey % establecer compás y tonalidad
\clef "treble"
- \new Voice @{ \MusicaManualUnoVozUno @}
+ \new Voice @{ \voiceOne \MusicaManualUnoVozUno @}
\new Voice @{ \voiceTwo \MusicaManualUnoVozDos @}
>> % fin del contexto de Staff ManualUno
\new Staff = "ManualDos" <<
\new Staff = "ManualOne" <<
\TimeKey % set time signature and key
\clef "treble"
- \new Voice { \ManualOneVoiceOneMusic }
+ \new Voice { \voiceOne \ManualOneVoiceOneMusic }
\new Voice { \voiceTwo \ManualOneVoiceTwoMusic }
>> % end ManualOne Staff context
\new Staff = "ManualTwo" <<
\TimeKey
\clef "bass"
\new Voice { \PedalOrganMusic }
- >> % end PedalOrgan Staff
+ >> % end PedalOrgan Staff context
>>
} % end Score context
@end lilypond
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of lilypond-program.tely
@ignore
- Translation of GIT committish: 57d7c13e226c65c8db7282d777a386b88cea68b6
+ Translation of GIT committish: d2956a4fd79a17f6b5b3ed8000678e460d1a580f
When revising a translation, copy the HEAD committish of the
@chapter Install
@end ifclear
-@c I don't know what this comment does. Remove? -gp
-@ignore
-@h tml
-<a name="download-source">
-@e nd html
-@end ignore
-
Existen dos conjuntos de ediciones o lanzamientos de LilyPond: las
ediciones estables y las ediciones inestables de desarrollo. Las
versiones estables tienen como número @q{menor} de versión un número
precompilados.
@menu
-* Precompiled binaries::
-* Compiling from source::
+* Precompiled binaries::
+* Compiling from source::
@end menu
@c TRANSLATORS:
@c Please **do not** translate anything below this line. Users
-@c should not be compiling LilyPond themselves; if they really
+@c should not be compiling LilyPond themselves; if they really
@c want to do so, they should be able to read the English docs,
@c because they'll probably need to ask questions in English
@c on the -devel list. -gp
* Building documentation::
* Testing LilyPond::
* Problems::
-@end menu
+@end menu
@node Downloading source code
@subsection Downloading source code
@unnumberedsubsubsec Compiling
@unnumberedsubsubsec Compiling for multiple platforms
@unnumberedsubsubsec Compiling outside the source tree
+@unnumberedsubsubsec Useful @command{make} variables
@node Building documentation
@subsection Building documentation
@untranslated
@menu
-* Commands for building documentation:: Compilar e instalar la documentación.
-* Building documentation without compiling LilyPond:: Usar un binario de LilyPond ya instalado.
+* Commands for building documentation:: Compilar e instalar la documentación.
+* Building documentation without compiling LilyPond:: Usar un binario de LilyPond ya instalado.
@end menu
@node Commands for building documentation
@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: 4f64fbb128ccedeaa5fdc9748d0bd408f095757c
+ Translation of GIT committish: 80929b75f56f4e278f20ed975771640a2d4d8ced
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@menu
-* Engraving::
-* Automated engraving::
-* What symbols to engrave?::
-* Music representation::
-* Example applications::
+* Engraving::
+* Automated engraving::
+* What symbols to engrave?::
+* Music representation::
+* Example applications::
@end menu
@node Engraving
@unnumberedsubsec Engraving
+@cindex grabado
+@cindex typografía musical
+@cindex musical, tipografía
+@cindex plancha, grabado en
+@cindex musical, grabado
+
El arte de la tipografía musical se conoce como @emph{grabado (en
plancha)}. El término deriva del proceso tradicional de la impresión
musical. Hace sólo unas décadas, la música impresa se hacía
@cindex ritmos regulares
@cindex espaciado regular
+@cindex regular, espaciado
Cada uno de los dos compases de este fragmento tiene solamente notas
de duración constante. El espaciado debería reflejarlo.
corrección y los de abajo sin ella, formando grupos de notas pegadas
con plica abajo/@/plica arriba.
-@cindex tipografía
-
Los músicos están normalmente más concentrados en tocar que en
estudiar el aspecto de una partitura, y por ello las pequeñeces sobre
los detalles tipográficos pueden parecer académicas. Pero no lo son.
@node Automated engraving
@unnumberedsubsec Automated engraving
+@cindex grabado automatizado
+@cindex automático, grabado
+
¿Cómo nos las arreglamos para implementar la tipografía? Si un
artesano necesita más de diez años para convertirse en un auténtico
maestro ¿cómo vamos a poder nosotros, simples «hackers», escribir un
tanto necesitamos un enfoque flexible para las reglas. El lenguaje
C++ fuerza un cierto método para agrupar las reglas que no encaja bien
con la manera de funcionar de la notación musical.
+
@end itemize
+@cindex Scheme, lenguaje de programación
+
Estos problemas se han solucionado integrando un intérprete del
lenguaje Scheme y reescribiendo parte del código de LilyPond en
Scheme. La actual arquitectura de formateo se construye alrededor del
}
@end lilypond
+@cindex partitura, dar formato a
+@cindex formato, dar a una partitura
+@cindex formateado, reglas de
+
@noindent
El proceso de formatear una partitura consiste en leer y escribir las
variables de los objetos gráficos. Ciertas variables tienen un valor
@cindex grabado
@cindex tipografía
+@cindex grabador
+@cindex plug-in
+@cindex complemento (plugin)
El proceso de formateo toma las decisiones sobre dónde colocar los
símbolos. Sin embargo esto sólo se puede hacer una vez que se ha
\score { \topVoice }
@end lilypond
+@cindex polifonía
+@cindex grabar varias voces
+@cindex contextos
+
Este sistema funciona bien para la música monofónica, pero ¿y con la
polifonía? En notación polifónica muchas voces pueden compartir el
mismo pentagrama.
@node Music representation
@unnumberedsubsec Music representation
+@cindex sintaxis
+@cindex recursivas, estructuras
+
Idealmente el formato de entrada para cualquier sistema de formateo de
alto nivel es una descripción abstracta del contenido. En este caso,
eso constituiría la propia música, lo que plantea un tremendo
@node Example applications
@unnumberedsubsec Example applications
+@cindex sencillos, ejemplos
+@cindex ejemplos sencillos
+
Escribimos LilyPond como un experimento de cómo condensar el arte del
grabado de música dentro de un programa de ordenador. Gracias a todo
este duro trabajo, el programa ahora se puede usar para hacer trabajos
Esta sección explica la distintas partes de la documentación.
+@cindex Manual de aprendizaje
+@cindex Glosario musical
+@cindex Referencia de la notación
+@cindex Utilización del programa
+@cindex Fragmentos de código
+@cindex Referencia de funcionamiento interno
@c leave these lines wrapping around. It's some texinfo 4.12 thing. -gp
+@c This is actually a limitation of texi2html. -jm
@menu
-* About the Learning Manual:: este manual es una introducción a LilyPond que porporciona explicaciones en profundidad sobre cómo crear notación.
-* About the Music Glossary:: este manual explica términos musicales y aporta traducciones de términos a otros idiomas.
+* About the Learning Manual:: este manual es una introducción a LilyPond que porporciona explicaciones en profundidad sobre cómo crear notación.
+* About the Music Glossary:: este manual explica términos musicales y aporta traducciones de términos a otros idiomas.
* About the Notation Reference:: este manual es la porción más importante de la documentación. Proporciona información detallada sobre la creación de notación. Este libro da por supuesto que el lector ya conoce el material básico cubierto en el Manual de aprendizaje y que está familiarizado con los términos musicales ingleses presentados en el Glosario musical.
* About the Application Usage:: trata sobre los programas concretos y los asuntos específicos de distintos sistemas operativos.
-* About the Snippet List:: es una colección de ejemplos breves de LilyPond.
+* About the Snippet List:: es una colección de ejemplos breves de LilyPond.
* About the Internals Reference:: este documento proporciona información sobre la programación interna de LilyPond, que es necesaria para construir los trucos.
* Other documentation:: existen algunas otras porciones de la documentación, como las Noticias y los archivos históricos de las listas de correo.
@end menu
@node About the Learning Manual
@unnumberedsubsec About the Learning Manual
+@cindex Manual de aprendizaje
+
Este libro explica cómo empezar a aprender LilyPond, así como algunos
conceptos clave en términos sencillos. Se recomienda leer estos
capítulos de forma secuencial.
@node About the Music Glossary
@unnumberedsubsec About the Music Glossary
+@cindex Glosario musical
@cindex frase idiomática
@cindex jerga
@cindex terminología
@cindex idomas extranjeros
@cindex idiomas
-@ref{Top,Music glossary,,music-glossary}: explica términos musicales e
-incluye traducciones a varios idiomas. Si no está familiarizado con
-la notación o la terminología musicales (especialmente si no es un
+@rglosnamed{Top,Glosario musical}: explica términos musicales e incluye
+traducciones a varios idiomas. Si no está familiarizado con la
+notación o la terminología musicales (especialmente si no es un
anglófono nativo), es muy recomendable que consulte el glosario.
@node About the Notation Reference
@unnumberedsubsec About the Notation Reference
+@cindex Referencia de la notación
+@cindex apéndices
+@cindex referencia, cuadros de
+@cindex cuadros de referencia
+
Este libro explica todas las instrucciones de LilyPond que producen
notación impresa. Da por supuesto que el lector está familiarizado
con los conceptos del manual de aprendizaje.
@node About the Application Usage
@unnumberedsubsec About the Application Usage
+@cindex Utilización del programa
+@cindex integrar LilyPond con otros programas
+
Este libro explica la manera de ejecutar el programa y cómo integrar
la notación de LilyPond con otros programas.
@unnumberedsubsec About the Snippet List
@cindex snippets (fragmentos de código)
+@cindex fragmentos de código (snippets)
@cindex LSR
+@cindex LilyPond Snippet Repository
-@c FIXME: check on kainhofer.
-@rlsrnamed{Top,LilyPond Snippet List}:
-presenta un conjunto seleccionado de pfragmentos de código de LilyPond
-procedentes del @uref{http://lsr@/.dsi@/.unimi@/.it,Repositorio de
-Fragmentos de Código} (LSR). Se encuentra en el dominio público.
+@rlsrnamed{Top,Lista de fragmentos de código de LilyPond}: presenta un conjunto
+seleccionado de pfragmentos de código de LilyPond procedentes del
+@uref{http://lsr@/.dsi@/.unimi@/.it,Repositorio de Fragmentos de
+Código} (LSR). Todos los fragmentos se encuentran en el dominio
+público.
Observe que este documento no es un subconjunto exacto de LSR. El LSR
ejecuta una versión estable de LilyPond, por lo que cualquier
@node About the Internals Reference
@unnumberedsubsec About the Internals Reference
-@c zzz
+@cindex Referencia de funcionamiento interno
-@itemize
-@item
-La
-@iftex
-Referencia de Funcionamiento Interno
-@end iftex
-@ifnottex
-@ref{Top,Internals Reference,,lilypond-internals}
-@end ifnottex
+@rinternalsnamed{Top,Referencia de funcionamiento interno}:
es un conjunto de páginas HTML con una tupida red de enlaces cruzados,
que documentan al detalle el meollo de todas y cada una de las clases,
objetos y funciones de LilyPond. Se produce directamente a partir de
@node Other documentation
@unnumberedsubsec Other documentation
-Existen algunos otros lugares que pueden resultar muy valiosos.
+Existen algunos otros lugares que pueden resultar muy valiosos como
+fuente de información.
-Cuando ya sea un usuario con experiencia podrá usar el manual como
-referencia: hay un índice muy completo@footnote{Si está buscando algo
-y no lo encuentra en el manual, eso se considera un @emph{bug}
-(fallo). En este caso le rogamos que envíe un informe de fallo.},
-pero el documento también está disponible en
-@iftex
-una sola página HTML,
-@end iftex
+@itemize
+
+@item
@ifhtml
-@uref{source/Documentation/user/lilypond-big-page.html,una sola página enorme},
+@ifset bigpage
+@uref{../topdocs/NEWS.html,News}:
+@end ifset
+@ifclear bigpage
+@uref{../../topdocs/NEWS.html,News}:
+@end ifclear
@end ifhtml
-en la que es fácil buscar cualquier cosa utilizando la función de búsqueda de su
-navegador de web.
-
-
-En todos los documentos HTML que tienen fragmentos de música
-incrustados, la entrada de LilyPond que se utilizó para producir dicha
-imagen se puede ver pulsando con el ratón sobre la imagen.
-
-La localización exacta de los archivos de documentación que hemos
-mencionado puede variar de un sistema a otro. En ocasiones este
-manual hace referencia a archivos de inicialización y de ejemplo. A
-lo largo del manual, nos referimos a archivos de entrada por su ruta
-relativa respecto de directorio de nivel más alto de los archivos de
-código fuente. Por ejemplo, @file{input/@/lsr/@/carpeta/@/bla@/.ly}
-puede referirse al archivo
+@ifnothtml
+Noticias:
+@end ifnothtml
+es un resumen de los cambios importantes y las posibilidades nuevas de
+LilyPond desde la versión anterior.
+
+@item @uref{http://lists.gnu.org/archive/html/lilypond-user/, Los archivos de la
+lista de correo de usuarios lilypond-user}: es una recopilación de
+todos los mensajes de correo que se han enviado a la lista de
+usuarios. Hay muchas preguntas que se han formulado varias veces; muy
+probablemente, si tiene alguna pregunta, la respuesta puede
+encontrarse en estos archivos.
+
+@item @uref{http://lists.gnu.org/archive/html/lilypond-devel/, Los
+archivos de la lista de correo de desarrollo lilypond-devel}: es una
+recopilación de todos los mensajes de correo que se han enviado a la
+lista de los desarrolladores. Aquí la discusión tiene un carácter más
+técnico; si tiene una pregunta avanzada relacionada con el
+funcionamiento interno de lilypond, la respuesta puede estar en estos
+archivos.
+
+@item Fragmentos de música incrustados: en todos los documentos en HTML que
+tienen fragmentos de música incluidos, el código de entrada exacto de
+LilyPond que se utilizó para producir dicha imagen se puede ver
+pulsando sobre ella.
+
+@item Archivos de inicio: La localización exacta de los archivos de
+documentación que hemos mencionado puede variar de un sistema a otro.
+En ocasiones este manual hace referencia a archivos de inicialización
+y de ejemplo. A lo largo del manual, nos referimos a archivos de
+entrada por su ruta relativa respecto de directorio de nivel más alto
+de los archivos de código fuente. Por ejemplo,
+@file{input/@/lsr/@/carpeta/@/bla@/.ly} puede referirse al archivo
@file{lilypond@/2.x.y/@/input/@/lsr/@/carpeta/@/bla@/.ly}. En los
-paquetes binarios para la plataforma Unix, normalmente la
+paquetes binarios para la plataforma UNIX, normalmente la
documentación y los ejemplos se encuentran en algún lugar dentro de
@file{/usr/@/share/@/doc/@/lilypond/}. Los archivos de inicialización,
como por ejemplo @file{scm/@/lily@/.scm}, o
@file{ly/@/engraver@/-init@/.ly}, se encuentran normalmente en el
-directorio @file{/usr/@/share/@/lilypond/}.
-
-@cindex ajustar la salida
-@cindex variables
-@cindex propiedades
-@cindex funcionamiento interno de lilypond
-@cindex documentación interna
-@cindex Scheme
-@cindex extender lilypond
-@cindex índice
-
-Por último, este y el resto de los manuales están disponibles en línea
-tanto como archivos PDF como en HTML en el sitio web, que encontrará
-en @uref{http://@/www@/.lilypond@/.org/}.
+directorio @file{/usr/@/share/@/lilypond/}. Para ver más detalles,
+consulte @ref{Other sources of information}.
+@end itemize
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: f02e10cde760bb4981b73742f0fb5a867e1d3d33
+ Translation of GIT committish: 5c1acf5a30331925b80a2d754f0a3e96b63784c0
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@node Keyboard instruments
@section Keyboard instruments
+@lilypondfile[quote]{keyboard-headword.ly}
+
+Esta sección se ocupa de varios aspectos de la notación musical que
+son exclusivos de los instrumentos de teclado.
+
@menu
-* Common notation for keyboards::
-* Piano::
-* Accordion::
+* Common notation for keyboards::
+* Piano::
+* Accordion::
@end menu
@node Common notation for keyboards
@subsection Common notation for keyboards
+Esta sección trata aspectos de notación que pueden aparecer en casi
+todos los instrumentos de teclado.
+
@menu
-* References for keyboards::
-* Changing staff manually::
-* Changing staff automatically::
-* Staff-change lines::
-* Cross-staff stems::
+* References for keyboards::
+* Changing staff manually::
+* Changing staff automatically::
+* Staff-change lines::
+* Cross-staff stems::
@end menu
@node References for keyboards
@unnumberedsubsubsec References for keyboards
-@untranslated
-@ifnothtml
-@englishref
-@end ifnothtml
+@cindex piano, pentagramas de
+@cindex pentagramas de piano
+@cindex pentagramas de instrumentos de teclado
+@cindex teclado, pentagramas para instrumentos de
+@cindex tecla, pentagramas para instrumentos de
+@funindex PianoStaff
+
+La notación de los instrumentos de teclado se suele realizar con
+sistemas de piano. Éstos son dos pentagramas normales agrupados
+mediante una llave. También se utiliza esta notación para otros
+instrumentos de teclado. La música de órgano se escribe normalmente
+con dos pentagramas dentro de un grupo @code{PianoStaff} y un tercer
+pentagrama normal para los pedales.
+
+Los pentagramas son hasta cierto punto independientes, pero a veces
+las voces pueden cruzarse entre los dos pentagramas. Esta sección
+trata técnicas de notación que son particulares de la música de
+teclado.
+
+En otros lugares se tratan varios problemas comunes de la música de
+teclado:
+
+@itemize
+
+@item La música para teclado suele contener varias voces y el número de
+éstas puede variar ampliamente; esto se describe en @ref{Collision
+resolution}.
+
+@item La música para teclado se puede escribir en paralelo, como se describe
+en @ref{Writing music in parallel}.
+
+@item Las digitaciones se indican como puede verse en @ref{Fingering instructions}.
+
+@item Las indicaciones de pedal de órgano se insertan como articulaciones,
+véase @ref{List of articulations}.
+
+@item Las líneas verticales de rejilla se pueden mostrar como se describe en @ref{Grid lines}.
+
+@item La música para teclado incluye con frecuencia ligaduras
+@notation{Laissez vibrer} así como ligaduras sobre arpegios y
+trémolos, descritos en @ref{Ties}.
-Los sistemas de piano son dos pentagramas normales agrupados mediante
-una llave. Los pentagramas son hasta cierto punto independientes,
-pero a veces las voces pueden cruzarse entre los dos pentagramas.
-También se utiliza esta notación para otros instrumentos de teclado y
-para el arpa. El @code{PianoStaff} está preparado
-especialmente para manejar este comportamiento de cruce de
-pentagramas. En esta sección trataremos el @code{PianoStaff}
-y alguna que otra peculiaridad pianística.
+@item La colocación de arpegios a través de varias voces y pentagramas se
+cubre en @ref{Arpeggio}.
+
+@item Las indicaciones de trémolo se describen en @ref{Tremolo repeats}.
+
+@item Varios de los trucos que pueden ser necesarios en música para teclado
+se muestran en @rlearning{Real music example}.
+
+@item Las notas ocultas se pueden usar para producir ligaduras de unión que
+se cruzan entre voces, como se explica en @rlearning{Other uses for
+tweaks}.
+
+@end itemize
+
+@seealso
+
+Manual de aprendizaje:
+@rlearning{Real music example},
+@rlearning{Other uses for tweaks}.
+
+Referencia de la notación:
+@ref{Grouping staves},
+@ref{Instrument names},
+@ref{Collision resolution},
+@ref{Writing music in parallel},
+@ref{Fingering instructions},
+@ref{List of articulations},
+@ref{Grid lines},
+@ref{Ties},
+@ref{Arpeggio},
+@ref{Tremolo repeats}.
+
+Referencia de funcionamiento interno:
+@rinternals{PianoStaff}.
+
+Fragmentos de código:
+@rlsr{Keyboards}.
@knownissues
+@cindex teclado, matices centrados para música de
+@cindex dinámica, indicaciones de, centradas para música de teclado
+@cindex piano, dinámica centrada para música de
+@cindex centrar indicaciones dinámicas en música para piano
+@funindex staff-padding
+
Los matices no se colocan centrados, pero se pueden utilizar ciertas
-alternativas. Consulte la plantilla @q{piano con matices centrados}
-que está en @rlearning{Piano templates}.
+alternativas. Una opción es la plantilla @q{piano con matices
+centrados} que está en @rlearning{Piano templates}; otra opción es
+aumentar el relleno (@code{staff-padding}) de los matices como se
+estudia en @rlearning{Moving objects}.
@node Changing staff manually
@cindex manual, cambio de pentagrama
@cindex pentagrama, cambios manuales de
+@cindex cambbio manual de pentagrama
+@cindex cruzado, pentagrama, notas de
+@cindex notes de pentagrama cruzado
+@cindex barras de pentagrama cruzado
+@cindex cruzado, pentagrama, barras de
+@funindex \change
+@funindex change
Las voces se pueden cambiar de pentagrama manualmente usando la instrucción
+
@example
-\change Staff = @var{nombre_del_pentagrama} @var{música}
+\change Staff = @var{nombre_del_pentagrama}
@end example
@noindent
La cadena @var{nombre_del_pentagrama} es el nombre del pentagrama.
Cambia la voz actual de su pentagrama en curso al pentagrama de nombre
-@var{nombre_del_pentagrama}. Por lo común @var{nombre_del_pentagrama}
-es @code{"up"} o @code{"down"}. El @code{Staff} referido debe
-existir previamente, por ello normalmente la preparación de una
-partitura empezará por la preparación de los pentagramas,
+@var{nombre_del_pentagrama}. Los valores más corrientes para
+@var{nombre_del_pentagrama} son @code{"arriba"} y @code{"abajo"}, o
+bien @code{"MD"} y @code{"MI"}.
-@example
-<<
- \new Staff = "up" @{
- \skip 1 * 10 % @emph{mantener vivo el pentagrama}
- @}
- \new Staff = "down" @{
- \skip 1 * 10 % @emph{ídem}
- @}
+Las notas de pentagrama cruzado reciben la barra automáticamente:
+
+@lilypond[verbatim,quote]
+\new PianoStaff <<
+ \new Staff = "up" {
+ <e' c'>8
+ \change Staff = "down"
+ g8 fis g
+ \change Staff = "up"
+ <g'' c''>8
+ \change Staff = "down"
+ e8 dis e
+ \change Staff = "up"
+ }
+ \new Staff = "down" {
+ \clef bass
+ % keep staff alive
+ s1
+ }
>>
-@end example
+@end lilypond
+Si el barrado necesita algún trucaje, efectúe en primer lugar los
+cambios en las direcciones de las plicas. Las posiciones de las
+barras se miden posteriormente a partir del centro del peentagrama que
+está más cerca de la barra. Para ver un ejemplo sencillo de trucaje
+de las barras, consulte @rlearning{Fixing overlapping notation}.
-y la @code{Voice} se inserta con posterioridad
+@seealso
-@example
-\context Staff = down
- \new Voice @{ @dots{} \change Staff = up @dots{} @}
-@end example
+Manual de aprendizaje:
+@rlearning{Fixing overlapping notation}.
+
+Referencia de la notación:
+@ref{Stems},
+@ref{Automatic beams}.
+
+Fragmentos de código:
+@rlsr{Keyboards}.
+
+Referencia de funcionamiento interno:
+@rinternals{Beam},
+@rinternals{ContextChange}.
@node Changing staff automatically
@unnumberedsubsubsec Changing staff automatically
-@cindex Cambio automático de pentagrama
+
+@cindex cambio automático de pentagrama
+@cindex automático, cambio de pentagrama
+@cindex pentagrama, cambio automático de
+@funindex \autochange
+@funindex autochange
+@funindex PianoStaff
Se puede hacer que las voces cambien automáticamente entre los
pentagramas inferior y superior. La sintaxis para conseguir esto es
-@quotation
@example
\autochange @dots{}@var{música}@dots{}
@end example
-@end quotation
@noindent
-Esto creará dos pentagramas dentro del PianoStaff actual, llamados
-@code{up} (arriba) y @code{down} (abajo). El pentagrama inferior
-estará en clave de Fa por omisión.
+Esto creará dos pentagramas dentro del grupo actual de pentagramas
+(normalmente un @code{PianoStaff}), llamados @code{"up"} (arriba) y
+@code{"down"} (abajo). El pentagrama inferior estará en clave de Fa
+de forma predeterminada. El cambiador automático hace el cambio
+basándose en la altura (el Do@tie{}central es el punto de inflexión),
+y se adelanta saltando sobre los silencios para hacer cambios por
+adelantado.
+
+@lilypond[quote,verbatim]
+\new PianoStaff {
+ \autochange {
+ g4 a b c'
+ d'4 r a g
+ }
+}
+@end lilypond
-Una sección marcada @code{\relative} que se encuentra fuera de
-@code{\autochange} no tiene efecto sobre las notas de la @var{música},
-por tanto, en caso necesario escriba @code{\relative} dentro de
-@code{\autochange}, como en
-
-@quotation
-@example
-\autochange \relative @dots{} @dots{}
-@end example
-@end quotation
+@cindex relativo, modo, autocambiador y
+@cindex autocambiador y el modo relativo
+@funindex \relative
+@funindex relative
+Una sección marcada @code{\relative} que se encuentra fuera de
+@code{\autochange} no tiene efecto sobre las notas de la música; por
+tanto, en caso necesario escriba @code{\relative} dentro de
+@code{\autochange}.
-El cambiador automático hace el cambio basándose en la altura (el Do
-central es el punto de inflexión), y se adelanta saltando sobre los
-silencios para hacer cambios por adelantado. He aquí un ejemplo
-práctico
+Si se necesita más control sobre los pentagramas individuales, se
+pueden crear manualmente con los nombres @code{"up"} y @code{"down"}.
+Entonces, la instrucción @code{\autochange} alternará su voz entre los
+pentagramas existentes. Por ejemplo, esto es necesario para colocar
+una armadura de tonalidad en el pentagrama inferior:
-@lilypond[quote,verbatim,ragged-right]
-\new PianoStaff
- \autochange \relative c'
- {
- g4 a b c d r4 a g
+@lilypond[quote,verbatim]
+\new PianoStaff <<
+ \new Staff = "up" {
+ \new Voice = "melOne" {
+ \key g \major
+ \autochange \relative c' {
+ g8 b a c b d c e
+ d8 r fis, g a2
+ }
+ }
}
+ \new Staff = "down" {
+ \key g \major
+ \clef bass
+ }
+>>
@end lilypond
-
@seealso
-En este manual: @ref{Inside the staff}.
-
-Referencia del programa: @rinternals{AutoChangeMusic}.
+Referencia de la notación:
+@ref{Changing staff manually}.
+Fragmentos de código:
+@rlsr{Keyboards}.
+Referencia de funcionamiento interno:
+@rinternals{AutoChangeMusic}.
@knownissues
+@cindex acordes, división entre pentagramas con \autochange
+
Los cambios de pentagrama pueden no acabar en lugares óptimos. Para
conseguir una salida de alta calidad es mejor especificar manualmente
los cambios de pentagrama.
-
-@code{\autochange} no puede estar dentro de @code{\times}.
-
+Los acordes no se dividen entre los pentagramas; se asignan a un
+pentagrama en función de la primera nota nombrada dentro de la
+construcción del acorde.
@node Staff-change lines
@unnumberedsubsubsec Staff-change lines
@cindex seguimiento de voz
@cindex pentagrama, cambio
@cindex cruce de pentagramas
-
+@cindex pentagrama, línea de cambio de
+@cindex cruzado, línea de pentagrama
+@cindex línea de seguimiento de pentagrama
+@cindex línea de cambio de pentagrama
+@cindex seguimiento de voz
+@cindex pentagrama, cambio de
+@cindex cruzado, pentagrama
@funindex followVoice
+@funindex \showStaffSwitch
+@funindex showStaffSwitch
+@funindex \hideStaffSwitch
+@funindex hideStaffSwitch
-Cuando una voz cambia a otro pentagrama, se puede imprimir automáticamente una línea
-que conecte las notas. Esto se activa estableciendo
-@code{followVoice} a verdadero
+Cuando una voz cambia a otro pentagrama, se puede imprimir
+automáticamente una línea que conecte las notas:
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+@lilypond[quote,verbatim,relative=1]
\new PianoStaff <<
- \new Staff="one" {
- \set followVoice = ##t
+ \new Staff = "one" {
+ \showStaffSwitch
c1
- \change Staff=two
+ \change Staff = "two"
b2 a
}
- \new Staff="two" { \clef bass \skip 1*2 }
+ \new Staff = "two" {
+ \clef bass
+ s1*2
+ }
>>
@end lilypond
-@seealso
-
-Referencia de funcionamiento interno: @rinternals{VoiceFollower}.
-
@predefined
-@funindex \showStaffSwitch
@code{\showStaffSwitch},
-@funindex \hideStaffSwitch
@code{\hideStaffSwitch}.
+@seealso
+
+Fragmentos de código:
+@rlsr{Keyboards}.
+
+Referencia de funcionamiento interno:
+@rinternals{Note_head_line_engraver},
+@rinternals{VoiceFollower}.
+
@node Cross-staff stems
@unnumberedsubsubsec Cross-staff stems
@cindex pentagrama cruzado, plica de
@cindex distancia entre pentagramas en música de piano
-Los acordes que cruzan pentagramas se pueden producir mediante el incremento de la longitud
-de la plica en el pentagrama inferior, de manera que alcance a la plica que está en el pentagrama
-superior, y viceversa.
+@cindex cruzado, notas de pentagrama
+@cindex cruzado, plicas de pentagrama
+@cindex cruzado, acordes de pentagrama
+@cindex notas de pentagrama cruzado
+@cindex plicas de pentagrama cruzado
+@cindex acordes de pentagrama cruzado
+@funindex Stem
+@funindex cross-staff
+@funindex length
+@funindex flag-style
-@lilypond[ragged-right,verbatim,quote]
-stemExtend = {
- \once \override Stem #'length = #10
- \once \override Stem #'cross-staff = ##t
-}
-noFlag = \once \override Stem #'flag-style = #'no-flag
+Se pueden hacer acordes que cruzan los pentagramas:
+
+@lilypond[verbatim,quote]
\new PianoStaff <<
\new Staff {
- \stemDown \stemExtend
- f'4
- \stemExtend \noFlag
- f'8
+ \relative c' {
+ f8 e4 d8 d f e4
+ }
}
\new Staff {
- \clef bass
- a4 a8
+ \relative c' {
+ << {
+ \clef bass
+ % stems may overlap the other staff
+ \override Stem #'cross-staff = ##t
+ % extend the stems to reach other other staff
+ \override Stem #'length = #12
+ % do not print extra flags
+ \override Stem #'flag-style = #'no-flag
+ % prevent beaming as needed
+ a8 g4 f8 f bes\noBeam g4
+ }
+ \\
+ {
+ f,2 bes4 c
+ } >>
+ }
}
>>
@end lilypond
+@snippets
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{indicating-cross-staff-chords-with-arpeggio-bracket.ly}
+
+@seealso
+
+Fragmentos de código:
+@rlsr{Keyboards}.
+
+Referencia de funcionamiento interno:
+@rinternals{Stem}.
@node Piano
@subsection Piano
+Esta sección trata de aspectos de la notación directamente
+relacionados con el piano.
+
@menu
-* Piano pedals::
+* Piano pedals::
@end menu
@node Piano pedals
@unnumberedsubsubsec Piano pedals
-@cindex Pedales
-
-El piano tiene pedales que alteran la forma en que se produce el
-sonido. Generalmente un piano tiene tres pedales: derecho, una corda
-y tonal (en inglés: sustain, una corda y sostenuto).
-
-Se puede expresar una instrucción de pedal de piano adjuntando
-@code{\sustainOn}, @code{\sustainOff}, @code{\unaCorda},
-@code{\treCorde}, @code{\sostenutoOn} y @code{\sostenutoOff} a una
-nota o acorde
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-c'4\sustainOn c'4\sustainOff
+@cindex piano, pedales de
+@cindex pedales de piano
+@cindex pedal forte
+@cindex pedal derecho
+@cindex derecho, pedal
+@cindex forte, pedal
+@cindex sostenuto, pedal
+@cindex una corda
+@cindex tre corde
+@cindex sos.
+@cindex U.C.
+@funindex \sustainOn
+@funindex sustainOn
+@funindex \sustainOff
+@funindex sustainOff
+@funindex \sostenutoOn
+@funindex sostenutoOn
+@funindex \sostenutoOff
+@funindex sostenutoOff
+@funindex \unaCorda
+@funindex unaCorda
+@funindex \treCorde
+@funindex treCorde
+
+En general, los pianos tienen tres pedales que alteran la forma de
+producir el sonido: el pedal de mantenimiento (pedal
+@notation{derecho} o pedal @notation{forte}), el pedal
+@notation{sostenuto} (@notation{sos.}, pedal central) y el pedal
+@notation{una corda} (@notation{U.C.}, pedal izquierdo). Los pedales
+de mantenimiento como el pedal derecho del piano se encuentran también
+en el vibráfono y en la celesta.
+
+@lilypond[quote,verbatim,relative=2]
+c4\sustainOn d e g
+<c, f a>1\sustainOff
+c4\sostenutoOn e g c,
+<bes d f>1\sostenutoOff
+c4\unaCorda d e g
+<d fis a>1\treCorde
@end lilypond
-Es posible modificar lo que se imprime estableciendo @code{pedal@var{X}Strings},
-donde @var{X} es uno de los tipos de pedal: @code{Sustain},
-@code{Sostenuto} o @code{UnaCorda}. Consulte
-@rinternals{SustainPedal} dentro de la referencia del programa para más
-información.
-
-Los pedales se pueden indicar también mediante una secuencia de corchetes, estableciendo la
-propiedad @code{pedalSustainStyle} a objetos corchete
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\set Staff.pedalSustainStyle = #'bracket
-c\sustainOn d e
-b\sustainOff\sustainOn
-b g \sustainOff a \sustainOn \bar "|."
-@end lilypond
-
-Un tercer estilo de notación de pedal es una mezcla de texto y corchetes,
-que se obtiene estableciendo la propiedad @code{pedalSustainStyle} a
-@code{mixed}
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
+@cindex pedal, estilos de indicación
+@cindex pedal, indicación textual
+@cindex pedal, indicación por corchete
+@cindex pedal, indicación mixta
+@cindex pedal de mantenimiento, estilo de
+@cindex mantenimiento, pedal, estilos de
+@funindex pedalSustainStyle
+@funindex mixed
+@funindex bracket
+@funindex text
+
+Existen tres estilos de indicaciones de pedal: textual, corchete y
+mixta. El pedal derecho y el pedal de una corda utilizan el estilo
+textual de forma predeterminada, mientras que el pedal sostenuto
+utiliza el método mixto de forma predeterminada.
+
+@lilypond[quote,verbatim,relative=2]
+c4\sustainOn g c2\sustainOff
\set Staff.pedalSustainStyle = #'mixed
-c\sustainOn d e
-b\sustainOff\sustainOn
-b g \sustainOff a \sustainOn \bar "|."
-@end lilypond
-
-El estilo por defecto @q{*Ped.} para los pedales derecho y una corda corresponde al
-estilo @code{#'text}. El pedal tonal usa el estilo @code{mixed} por
-defecto.
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c\sostenutoOn d e c, f g a\sostenutoOff
+c4\sustainOn g c d
+d\sustainOff\sustainOn g, c2\sustainOff
+\set Staff.pedalSustainStyle = #'bracket
+c4\sustainOn g c d
+d\sustainOff\sustainOn g, c2
+\bar "|."
@end lilypond
-Para hacer un ajuste fino del aspecto de un corchete de pedal, se
-pueden modificar las propiedades @code{edge-width}, @code{edge-height}
-y @code{shorten-pair} de los objetos @code{PianoPedalBracket} (véase
-@rinternals{PianoPedalBracket} en la Referencia del programa). Por
-ejemplo, el corchete se puede extender hasta el borde derecho de la
-cabeza de la nota
-
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-\override Staff.PianoPedalBracket #'shorten-pair = #'(0 . -1.0)
-c\sostenutoOn d e c, f g a\sostenutoOff
-@end lilypond
+La colocación de las instrucciones de pedal se corresponden con el
+movimiento físico del pedal derecho en el transcurso de la ejecución.
+La pedalización hasta la barra final de compás se indica mediante la
+omisión de la instrucción final de levantar el pedal.
@seealso
-Referencia de la notación: @ref{Ties} (laissez vibrer).
-
+Referencia de la notación:
+@ref{Ties}.
+
+Fragmentos de código:
+@rlsr{Keyboards}.
+
+Referencia de funcionamiento interno:
+@rinternals{SustainPedal},
+@rinternals{SustainPedalLineSpanner},
+@rinternals{SustainEvent},
+@rinternals{SostenutoPedal},
+@rinternals{SostenutoPedalLineSpanner},
+@rinternals{SostenutoEvent},
+@rinternals{UnaCordaPedal},
+@rinternals{UnaCordaPedalLineSpanner},
+@rinternals{UnaCordaEvent},
+@rinternals{PianoPedalBracket},
+@rinternals{Piano_pedal_engraver}.
@node Accordion
@subsection Accordion
+@cindex acordeón
+
+Esta sección se ocupa de la notación que es exclusiva del acordeón.
+
@menu
-* Discant symbols::
+* Discant symbols::
@end menu
@node Discant symbols
@unnumberedsubsubsec Discant symbols
-@untranslated
-@ifnothtml
-@englishref
-@end ifnothtml
+@cindex acordeón, signos de discanto
+@cindex discanto, signos de, del acordeón
+@cindex acordeón, cambios en el
+@cindex acordeón, signos de cambio en el
+
+Los acordeones se suelen construir con más de un conjunto de lengüetas
+que pueden estar al unísono, una octava por encima, o una octava por
+debajo de la altura escrita. Cada fabricante de acordeones utiliza
+distintos nombres para los @notation{cambios} que seleccionan las
+distintas combinaciones de lengüetas, como @notation{oboe},
+@notation{musette} o @notation{bandoneón}, de manera que se ha venido
+en usar un sistema de signos para simplificar las instrucciones de
+ejecución.
+
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{accordion-discant-symbols.ly}
+
+@seealso
+
+Fragmentos de código:
+@rlsr{Keyboards}.
\input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
@ignore
- Translation of GIT committish: 795cef0889e9cf5da040f434fc9334ffe28ae87b
+ Translation of GIT committish: d2956a4fd79a17f6b5b3ed8000678e460d1a580f
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: dc78324e8424699ec17df064941c0c787d4eb91c
+ Translation of GIT committish: d2956a4fd79a17f6b5b3ed8000678e460d1a580f
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@unnumbered Preface
-Debió ser en el transcurso de un ensayo de la EJE (Joven Orquesta
-de Eindhoven), allá por 1995 cuando Jan, uno de los violistas chiflados,
+Debió ser en el transcurso de un ensayo de la EJE (Joven Orquesta de
+Eindhoven), allá por 1995 cuando Jan, uno de los violistas chiflados,
le habló a Han-Wen, uno de los trompistas distorsionados, acerca del
gran proyecto en que estaba trabajando. Era un sistema automático para
-imprimir música (para ser exactos se trataba de MPP, un preprocesador para
-MusiXTeX). Ocurrió entonces que Han-Wen quiso imprimir
-unas particellas sacadas de una partitura, y así empezó a echarle un vistazo al programa, y
-en seguida se quedó estancado. Decidieron que MPP era un callejón sin salida. Después de
-muchísimo filosofar y de montañas de encendidas conversaciones por correo electrónico, Han-Wen inició
-el proyecto LilyPond en 1996. Esta vez fue Jan quien resultó absorbido por el nuevo proyecto de
-Han-Wen.
-
-En ciertos aspectos, desarrollar un programa de ordenador es como aprender a tocar
-un instrumento. Al principio es divertido descubrir cómo funciona, y supone un divertido
-reto intentar aquello que no eres capaz de hacer. Una vez pasado el entusiasmo inicial,
-hay que practicar más y más. Las escalas y los estudios pueden llegar a aturdir, y
-si no está motivado por otras personas (profesores, directores o el público)
-uno siempre está tentado de abandonarlo. Uno persevera y, poco a poco,
-tocar se convierte en parte de la vida de uno. Algunos días se acoge de forma natural, y
-es estupendo, y otros simplemente la cosa no funciona, pero uno sigue
-tocando día tras día.
-
-Igual que hacer música, trabajar en LilyPond puede ser un trabajo muy duro y
-hay días en que uno se siente como pisando un hormiguero.
-A pesar de todo, se ha convertido en parte de nuestra vida y seguimos haciéndolo.
-Con toda probabilidad la motivación más importante es que nuestro programa realmente
-hace algo útil por las personas. Cuando navegamos por la red
-encontramos mucha gente que utiliza LilyPond y produce unas partituras
-impresionantes con él. De esta observación se desprende una sensación algo irreal, pero muy agradable.
-
-Nuestros usuarios no sólo nos transmiten buenas vibraciones por usar el programa, también
-muchos de ellos nos ayudan enviando sugerencias e informes de fallo, por ello
-nos gustaría agradecer a todos los usuarios que nos han enviado estos informes, emitido
-sugerencias o contribuido a LilyPond de cualquier otra forma.
-
-Tocar e imprimir música es algo más que una bonita analogía. Programar
-juntos es muy divertido, y ayudar a las personas es algo profundamente gratificante, pero
-en último término trabajar en LilyPond es una forma de expresar nuestro profundo amor por
-la música. ¡Ojalá le ayude a elaborar montañas de preciosas partituras!
+imprimir música (concretamente se trataba de MPP, un preprocesador
+para MusiXTeX). Resulta que Han-Wen quiso imprimir unas particellas a
+partir de una partitura, así que empezó a echarle un vistazo al
+programa, pero se quedó estancado rápidamente. Decidieron que MPP era
+un callejón sin salida. Después de muchísimo filosofar y de montañas
+de encendidas conversaciones por correo electrónico, Han-Wen inició el
+proyecto LilyPond en 1996. Esta vez fue Jan quien resultó absorbido
+por el nuevo proyecto de Han-Wen.
+
+En ciertos aspectos, desarrollar un programa de ordenador es como
+aprender a tocar un instrumento. Al principio es divertido descubrir
+cómo funciona, y supone un divertido reto intentar aquello de lo que
+aún no eres capaz. Una vez pasado el entusiasmo inicial, hay que
+practicar más y más. Las escalas y los estudios pueden llegar a
+aturdir, y si no está motivado por otras personas (profesores,
+directores o el público) uno siempre está tentado de abandonarlo. Uno
+persevera y, poco a poco, tocar se convierte en parte de la vida de
+uno. Algunos días se acoge de forma natural, y es estupendo, y otros
+simplemente la cosa no funciona, pero uno sigue tocando día tras día.
+
+Igual que hacer música, trabajar en LilyPond puede ser un trabajo muy
+duro y hay días en que uno se siente como pisando un hormiguero. A
+pesar de todo, se ha convertido en parte de nuestra vida y seguimos
+haciéndolo. Con toda probabilidad la motivación más importante es que
+nuestro programa realmente hace algo útil por las personas. Cuando
+navegamos por la red encontramos mucha gente que utiliza LilyPond y
+produce unas partituras impresionantes con él. De esta observación se
+desprende una sensación algo irreal, pero muy agradable.
+
+Nuestros usuarios no sólo nos transmiten buenas vibraciones por usar
+el programa, también muchos de ellos nos ayudan enviando sugerencias e
+informes de fallo; por ello nos gustaría agradecer a todos los
+usuarios que nos han enviado estos informes, emitido sugerencias o
+contribuido a LilyPond de cualquier otra forma.
+
+Tocar e imprimir música es algo más que una bonita analogía.
+Programar juntos es muy divertido, y ayudar a las personas es algo
+profundamente gratificante, pero en último término trabajar en
+LilyPond es una forma de expresar nuestro profundo amor por la música.
+¡Ojalá le ayude a elaborar montañas de preciosas partituras!
Han-Wen y Jan
pueden controlar manualmente los signos de repetición.
@menu
-* Normal repeats::
-* Manual repeat marks::
-* Written-out repeats::
+* Normal repeats::
+* Manual repeat marks::
+* Written-out repeats::
@end menu
@cindex repeticiones normales
o bien
@lilypond[verbatim,quote,relative=2]
-\partial 4
+\partial 4
\repeat volta 4 { e4 | c2 d | e2 f | }
\alternative {
{ \partial 4*3 g4 g g }
símbolos de porcentaje, y trémolos.
@menu
-* Percent repeats::
-* Tremolo repeats::
+* Percent repeats::
+* Tremolo repeats::
@end menu
@node Percent repeats
@menu
-* Tweaking with Scheme::
+* Tweaking with Scheme::
@end menu
@node Tweaking with Scheme
@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond-program.tely
@ignore
- Translation of GIT committish: b258483467822a7fee6ec2d060e67e209e456582
+ Translation of GIT committish: d2956a4fd79a17f6b5b3ed8000678e460d1a580f
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
lea solamente las secciones que le interesen.
@menu
-* Setup for specific Operating Systems::
-* Text editor support::
-* Point and click::
+* Setup for specific Operating Systems::
+* Text editor support::
+* Point and click::
@end menu
específicos.
@menu
-* MacOS X on the command-line::
+* MacOS X on the command-line::
@end menu
Existe apoyo por parte de varios editores de texto para LilyPond.
@menu
-* Emacs mode::
-* Vim mode::
-* jEdit::
-* TexShop::
-* TextMate::
+* Emacs mode::
+* Vim mode::
+* jEdit::
+* TexShop::
+* TextMate::
+* LilyKDE::
@end menu
@node Emacs mode
@end example
+@node LilyKDE
+@subsection LilyKDE
+
+@uref{http://lilykde.googlecode.com/,LilyKDE} es un plugin o
+complemento para el editor de texto de KDE,
+@uref{http://kate-editor.org/,Kate}. Tiene un potente Asistente de
+Partitura para preparar rápidamente un documento de LilyPond, y un
+visor de PDF incluido.
+
+LilyKDE puede utilizar
+@uref{http://www.volny.cz/smilauer/rumor/,Rumor}, de manera que se
+puede introducir la música tocando sobre un teclado MIDI.
+
+Otras posibilidades son el enguionado de la letra y la ejecución de
+LilyPond sobre varios archivos de una sola vez desde dentro del
+administrador de archivos de KDE.
+
@node Point and click
@section Point and click
@item emacs
esto invoca a
@example
-emacsclient --no-wait +@var{line}:@var{column} @var{file}
+emacsclient --no-wait +@var{línea}:@var{columna} @var{archivo}
@end example
@item vim
esto invoca a
@example
-gvim --remote +:@var{line}:norm@var{char} @var{file}
+gvim --remote +:@var{línea}:norm@var{carácter} @var{archivo}
@end example
@item nedit
esto invoca a
@example
- nc -noask +@var{line} @var{file}'
+ nc -noask +@var{línea} @var{archivo}'
@end example
@end table
-La variable de entorno @code{LYEDITOR} se utiliza para sobreescribir esto. Contiene
-la instrucción de línea de órdenes para abrir el editor, donde @code{%(file)s},
-@code{%(column)s}, @code{%(line)s} se sustituye por el archivo, columna y
-línea respectivamente. El ajuste
+La variable de entorno @code{LYEDITOR} se utiliza para sobreescribir
+esto. Contiene la instrucción de línea de órdenes para abrir el
+editor, donde @code{%(archivo)s}, @code{%(columna)s} y
+@code{%(línea)s} se sustituyen por el archivo, columna y línea
+respectivamente. El ajuste
@example
-emacsclient --no-wait +%(line)s:%(column)s %(file)s
+emacsclient --no-wait +%(línea)s:%(columna)s %(archivo)s
@end example
@noindent
escribiendo
@example
-#(ly:set-option 'point-and-click #f)
+\pointAndClickOff
@end example
@noindent
-dentro de un archivo @file{.ly}. De forma alternativa, puede pasarlo como una opción de
-la linea de órdenes
+dentro de un archivo @file{.ly}. Se puede activar explícitamente la
+posibilidad de apuntar y pulsar con
@example
-lilypond -dno-point-and-click file.ly
+\pointAndClickOn
@end example
+De forma alternativa, puede desactivar la posibilidad de apuntar y
+pulsar con una opción de la línea de órdenes:
+
+@example
+lilypond -dno-point-and-click archivo.ly
+@end example
+
+@warning{Recuerde desactivar siempre la posibilidad Apuntar y pulsar
+en cualquier archivo de LilyPond que vaya a ser distribuido, para
+evitar incluir información de rutas de archivo relativas a su equipo
+dentro del archivo .pdf, lo que puede plantear un problema de
+seguridad.}
+
@c -*- coding: utf-8; mode: texinfo; -*-
-@c This file is part of lilypond.tely
+@c This file is part of lilypond-learning.tely
@ignore
- Translation of GIT committish: 7cc6b12897031c450e3399d59cdb22ca9df4fd8c
+ Translation of GIT committish: 62a48f8a7de866126eff6612304b3a5b4f00352e
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
ya preparada. Sólo tiene que escribir las notas, lanzar LilyPond y ¡disfrutar de
unas hermosas partituras impresas!
-@c bad node name for ancient notation to avoid confict
+@c bad node name for ancient notation to avoid conflict
@menu
-* Single staff::
-* Piano templates::
-* String quartet::
-* Vocal ensembles::
-* Ancient notation templates::
-* Jazz combo::
-* lilypond-book templates::
+* Single staff::
+* Piano templates::
+* String quartet::
+* Vocal ensembles::
+* Ancient notation templates::
+* Jazz combo::
+* lilypond-book templates::
@end menu
@node Single staff
@appendixsec Single staff
-@appendixsubsec Notes only
-
-El primer ejemplo le ofrece un pentagrama con notas, apropiado para un instrumento
-solista o un fragmento melódico. Córtelo y péguelo en un archivo,
-escriba las notas y ¡ha terminado!
-@lilypond[quote,verbatim,ragged-right]
-\version "2.11.51"
-melody = \relative c' {
- \clef treble
- \key c \major
- \time 4/4
+@appendixsubsec Notes only
- a4 b c d
-}
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,addversion]
+{single-staff-template-with-only-notes.ly}
-\score {
- \new Staff \melody
- \layout { }
- \midi {}
-}
-@end lilypond
@appendixsubsec Notes and lyrics
-El siguiente ejemplo es una demostración de una sencilla melodía con letra. Corte y
-pegue, escriba las notas y luego el texto de la letra. Este ejemplo desactiva
-el barrado de figuras automático, lo que es frecuente para las partes vocales. Si quiere usar el
-barrado automático, tendrá que cambiar o convertir en un comentario la línea
-correspondiente.
-
-@lilypond[quote,verbatim,ragged-right]
-\version "2.11.51"
-melody = \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
- \melody
- }
- \new Lyrics \lyricsto "one" \text
- >>
- \layout { }
- \midi { }
-}
-@end lilypond
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,addversion]
+{single-staff-template-with-notes-and-lyrics.ly}
@appendixsubsec Notes and chords
-¿Quiere preparar una «lead sheet» u hoja guía de una canción con acordes? ¡No busque más!
-
-@lilypond[quote,verbatim,ragged-right]
-\version "2.11.51"
-melody = \relative c' {
- \clef treble
- \key c \major
- \time 4/4
-
- f4 e8[ c] d4 g |
- a2 ~ a2 |
-}
-
-harmonies = \chordmode {
- c4:m f:min7 g:maj c:aug d2:dim b:sus
-}
-
-\score {
- <<
- \new ChordNames {
- \set chordChanges = ##t
- \harmonies
- }
- \new Staff \melody
- >>
-
- \layout{ }
- \midi { }
-}
-@end lilypond
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+{single-staff-template-with-notes-and-chords.ly}
@appendixsubsec Notes, lyrics, and chords.
-Esta plantilla le permite preparar una canción con melodía, letra y acordes.
-
-@lilypond[quote,verbatim,ragged-right]
-\version "2.11.51"
-melody = \relative c' {
- \clef treble
- \key c \major
- \time 4/4
-
- a b c d
-}
-
-text = \lyricmode {
- Aaa Bee Cee Dee
-}
-
-harmonies = \chordmode {
- a2 c2
-}
-
-\score {
- <<
- \new ChordNames {
- \set chordChanges = ##t
- \harmonies
- }
- \new Voice = "one" {
- \autoBeamOff
- \melody
- }
- \new Lyrics \lyricsto "one" \text
- >>
- \layout { }
- \midi { }
-}
-@end lilypond
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+{single-staff-template-with-notes,-lyrics,-and-chords.ly}
+
@node Piano templates
@appendixsec Piano templates
+
@appendixsubsec Solo piano
-He aquí un sencillo sistema de piano.
-
-@lilypond[quote,verbatim,ragged-right]
-\version "2.11.51"
-upper = \relative c'' {
- \clef treble
- \key c \major
- \time 4/4
-
- a b c d
-}
-
-lower = \relative c {
- \clef bass
- \key c \major
- \time 4/4
-
- a2 c
-}
-
-\score {
- \new PianoStaff <<
- \set PianoStaff.instrumentName = "Piano "
- \new Staff = "upper" \upper
- \new Staff = "lower" \lower
- >>
- \layout { }
- \midi { }
-}
-@end lilypond
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+{piano-template-simple.ly}
@appendixsubsec Piano and melody with lyrics
-Aquí tenemos el típico formato de canción: un pentagrama con la melodía y la letra, y debajo el
-acompañamiento de piano.
-
-@lilypond[quote,verbatim,ragged-right]
-\version "2.11.51"
-melody = \relative c'' {
- \clef treble
- \key c \major
- \time 4/4
-
- a b c d
-}
-
-text = \lyricmode {
- Aaa Bee Cee Dee
-}
-
-upper = \relative c'' {
- \clef treble
- \key c \major
- \time 4/4
-
- a b c d
-}
-
-lower = \relative c {
- \clef bass
- \key c \major
- \time 4/4
-
- a2 c
-}
-
-\score {
- <<
- \new Voice = "mel" {
- \autoBeamOff
- \melody
- }
- \new Lyrics \lyricsto mel \text
-
- \new PianoStaff <<
- \new Staff = "upper" \upper
- \new Staff = "lower" \lower
- >>
- >>
- \layout {
- \context { \RemoveEmptyStaffContext }
- }
- \midi { }
-}
-@end lilypond
-
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+{piano-template-with-melody-and-lyrics.ly}
@appendixsubsec Piano centered lyrics
-En lugar de tener un pentagrama dedicado a la melodía y la letra puede colocar
-la letra en medio de los pentagramas del piano (y omitir el pentagrama separado para la melodía).
-
-@lilypond[quote,verbatim,ragged-right]
-\version "2.11.51"
-upper = \relative c'' {
- \clef treble
- \key c \major
- \time 4/4
-
- a b c d
-}
-
-lower = \relative c {
- \clef bass
- \key c \major
- \time 4/4
-
- a2 c
-}
-
-text = \lyricmode {
- Aaa Bee Cee Dee
-}
-
-\score {
- \new GrandStaff <<
- \new Staff = upper { \new Voice = "singer" \upper }
- \new Lyrics \lyricsto "singer" \text
- \new Staff = lower {
- \clef bass
- \lower
- }
- >>
- \layout {
- \context { \GrandStaff \accepts "Lyrics" }
- \context { \Lyrics \consists "Bar_engraver" }
- }
- \midi { }
-}
-@end lilypond
-
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+{piano-template-with-centered-lyrics.ly}
@appendixsubsec Piano centered dynamics
-Muchas partituras de piano tienen las indicaciones dinámicas centradas entre los dos
-pentagramas. La realización de esto necesita un poco de trucaje, pero
-ya que la plantilla está aquí mismo, no tiene que hacer el trucaje
-usted mismo.
-
-@lilypond[quote,verbatim,ragged-right]
-\version "2.11.51"
-upper = \relative c'' {
- \clef treble
- \key c \major
- \time 4/4
-
- a b c d
-}
-
-lower = \relative c {
- \clef bass
- \key c \major
- \time 4/4
-
- a2 c
-}
-
-dynamics = {
- s2\fff\> s4
- s\!\pp
-}
-
-pedal = {
- s2\sustainOn s2\sustainOff
-}
-
-\score {
- \new PianoStaff <<
- \new Staff = "upper" \upper
- \new Dynamics = "dynamics" \dynamics
- \new Staff = "lower" <<
- \clef bass
- \lower
- >>
- \new Dynamics = "pedal" \pedal
- >>
- \layout {
- \context {
- \type "Engraver_group"
- \name Dynamics
- \alias Voice % So that \cresc works, for example.
- \consists "Output_property_engraver"
-
- \override VerticalAxisGroup #'minimum-Y-extent = #'(-1 . 1)
- \override DynamicLineSpanner #'Y-offset = #0
- pedalSustainStrings = #'("Ped." "*Ped." "*")
- pedalUnaCordaStrings = #'("una corda" "" "tre corde")
-
- \consists "Piano_pedal_engraver"
- \consists "Script_engraver"
- \consists "Dynamic_engraver"
- \consists "Text_engraver"
-
- \override TextScript #'font-size = #2
- \override TextScript #'font-shape = #'italic
-
- \consists "Skip_event_swallow_translator"
-
- \consists "Axis_group_engraver"
- }
- \context {
- \PianoStaff
- \accepts Dynamics
- }
- }
-}
-\score {
- \new PianoStaff <<
- \new Staff = "upper" << \upper \dynamics >>
- \new Staff = "lower" << \lower \dynamics >>
- \new Dynamics = "pedal" \pedal
- >>
- \midi {
- \context {
- \type "Performer_group"
- \name Dynamics
- \consists "Piano_pedal_performer"
- }
- \context {
- \PianoStaff
- \accepts Dynamics
- }
- }
-}
-@end lilypond
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+{piano-template-with-centered-dynamics.ly}
@node String quartet
@appendixsec String quartet
-@appendixsubsec String quartet
-
-Esta plantilla es una demostración de un cuarteto de cuerda. También usa una sección @code{\global}
-para las indicaciones del compás y de la armadura de la tonalidad.
-
-@lilypond[quote,verbatim,ragged-right]
-\version "2.11.51"
-
-global= {
- \time 4/4
- \key c \major
-}
-
-violinOne = \new Voice { \relative c''{
- \set Staff.instrumentName = "Violin 1 "
-
- c2 d e1
-
-\bar "|." }}
-violinTwo = \new Voice { \relative c''{
- \set Staff.instrumentName = "Violin 2 "
- g2 f e1
-
-\bar "|." }}
-viola = \new Voice { \relative c' {
- \set Staff.instrumentName = "Viola "
- \clef alto
-
- e2 d c1
-
-\bar "|." }}
-cello = \new Voice { \relative c' {
- \set Staff.instrumentName = "Cello "
- \clef bass
-
- c2 b a1
-
-\bar "|."}}
+@appendixsubsec String quartet
-\score {
- \new StaffGroup <<
- \new Staff << \global \violinOne >>
- \new Staff << \global \violinTwo >>
- \new Staff << \global \viola >>
- \new Staff << \global \cello >>
- >>
- \layout { }
- \midi { }
-}
-@end lilypond
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+{string-quartet-template-simple.ly}
@appendixsubsec String quartet parts
-El ejemplo anterior produce un bonito cuarteto de cuerda, pero ¿y si necesitamos
-imprimir las particellas? Esta plantilla es una demostración de cómo aprovechar la posibilidad
-de la instrucción @code{\tag} para dividir una pieza fácilmente en particellas individuales.
-
-Tenemos que dividir esta plantilla en archivos independientes; los nombres de archivo
-están incluidos en forma de comentarios al comienzo de cada archivo. @code{piece.ly}
-contiene todas las definiciones musicales. Los otros archivos (@code{score.ly},
-@code{vn1.ly}, @code{vn2.ly}, @code{vla.ly} y
-@code{vlc.ly}) producen la particella correspondiente.
-
-@verbatim
-%%%%% piece.ly
-\version "2.11.51"
-
-global= {
- \time 4/4
- \key c \major
-}
-
-Violinone = \new Voice { \relative c''{
- \set Staff.instrumentName = "Violin 1 "
-
- c2 d e1
-
-\bar "|." }} %*********************************
-Violintwo = \new Voice { \relative c''{
- \set Staff.instrumentName = "Violin 2 "
-
- g2 f e1
-
-\bar "|." }} %*********************************
-Viola = \new Voice { \relative c' {
- \set Staff.instrumentName = "Viola "
- \clef alto
-
- e2 d c1
-
-\bar "|." }} %*********************************
-Cello = \new Voice { \relative c' {
- \set Staff.instrumentName = "Cello "
- \clef bass
-
- c2 b a1
-
-\bar "|."}} %**********************************
-
-music = {
- <<
- \tag #'score \tag #'vn1 \new Staff { << \global \Violinone >> }
- \tag #'score \tag #'vn2 \new Staff { << \global \Violintwo>> }
- \tag #'score \tag #'vla \new Staff { << \global \Viola>> }
- \tag #'score \tag #'vlc \new Staff { << \global \Cello>> }
- >>
-}
-
-
-
-%%%%% score.ly
-\version "2.11.51"
-\include "piece.ly"
-#(set-global-staff-size 14)
-\score {
- \new StaffGroup \keepWithTag #'score \music
- \layout { }
- \midi { }
-}
-
-
-%%%%% vn1.ly
-\version "2.11.51"
-\include "piece.ly"
-\score {
- \keepWithTag #'vn1 \music
- \layout { }
-}
-
-
-%%%%% vn2.ly
-\version "2.11.51"
-\include "piece.ly"
-\score {
- \keepWithTag #'vn2 \music
- \layout { }
-}
-
-
-%%%%% vla.ly
-\version "2.11.51"
-\include "piece.ly"
-\score {
- \keepWithTag #'vla \music
- \layout { }
-}
-
-
-%%%%% vlc.ly
-\version "2.11.51"
-\include "piece.ly"
-\score {
- \keepWithTag #'vlc \music
- \layout { }
-}
-@end verbatim
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+{string-quartet-template-with-separate-parts.ly}
@node Vocal ensembles
@appendixsubsec SATB vocal score
-Aquí tenemos una partitura vocal estándar para coro SATB a cuatro voces. Con conjuntos más grandes,
-suele ser útil escribir una sección que luego será incluida en todas las partes.
-Por ejemplo, la indicación de compás y la armadura de la tonalidad son casi siempre las mismas
-para todas las partes.
-
-@lilypond[quote,verbatim,ragged-right]
-\version "2.11.51"
-global = {
- \key c \major
- \time 4/4
-}
-
-sopMusic = \relative c'' {
- c4 c c8[( b)] c4
-}
-sopWords = \lyricmode {
- hi hi hi hi
-}
-
-altoMusic = \relative c' {
- e4 f d e
-}
-altoWords =\lyricmode {
- ha ha ha ha
-}
-
-tenorMusic = \relative c' {
- g4 a f g
-}
-tenorWords = \lyricmode {
- hu hu hu hu
-}
-
-bassMusic = \relative c {
- c4 c g c
-}
-bassWords = \lyricmode {
- ho ho ho ho
-}
-
-\score {
- \new ChoirStaff <<
- \new Lyrics = sopranos { s1 }
- \new Staff = women <<
- \new Voice =
- "sopranos" { \voiceOne << \global \sopMusic >> }
- \new Voice =
- "altos" { \voiceTwo << \global \altoMusic >> }
- >>
- \new Lyrics = "altos" { s1 }
- \new Lyrics = "tenors" { s1 }
- \new Staff = men <<
- \clef bass
- \new Voice =
- "tenors" { \voiceOne <<\global \tenorMusic >> }
- \new Voice =
- "basses" { \voiceTwo <<\global \bassMusic >> }
- >>
- \new Lyrics = basses { s1 }
-
- \context Lyrics = sopranos \lyricsto sopranos \sopWords
- \context Lyrics = altos \lyricsto altos \altoWords
- \context Lyrics = tenors \lyricsto tenors \tenorWords
- \context Lyrics = basses \lyricsto basses \bassWords
- >>
-
- \layout {
- \context {
- % a little smaller so lyrics
- % can be closer to the staff
- \Staff
- \override VerticalAxisGroup #'minimum-Y-extent = #'(-3 . 3)
- }
- }
-}
-@end lilypond
-
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+{vocal-ensemble-template.ly}
@appendixsubsec SATB vocal score and automatic piano reduction
-Esta plantilla añade una reducción automática para piano a la partitura vocal para coro SATB.
-Es una demostración de uno de los puntos fuertes de LilyPond: podemos
-usar una definición musical más de una vez. Si hace algún cambio en las notas de la parte vocal
-(como p.ej. tenorMusic), los cambios se aplicarán también a la
-reducción de piano.
-
-@lilypond[quote,verbatim,ragged-right]
-\version "2.11.51"
-global = {
- \key c \major
- \time 4/4
-}
-
-sopMusic = \relative c'' {
- c4 c c8[( b)] c4
-}
-sopWords = \lyricmode {
- hi hi hi hi
-}
-
-altoMusic = \relative c' {
- e4 f d e
-}
-altoWords =\lyricmode {
- ha ha ha ha
-}
-
-tenorMusic = \relative c' {
- g4 a f g
-}
-tenorWords = \lyricmode {
- hu hu hu hu
-}
-
-bassMusic = \relative c {
- c4 c g c
-}
-bassWords = \lyricmode {
- ho ho ho ho
-}
-
-\score {
- <<
- \new ChoirStaff <<
- \new Lyrics = sopranos { s1 }
- \new Staff = women <<
- \new Voice =
- "sopranos" { \voiceOne << \global \sopMusic >> }
- \new Voice =
- "altos" { \voiceTwo << \global \altoMusic >> }
- >>
- \new Lyrics = "altos" { s1 }
- \new Lyrics = "tenors" { s1 }
- \new Staff = men <<
- \clef bass
- \new Voice =
- "tenors" { \voiceOne <<\global \tenorMusic >> }
- \new Voice =
- "basses" { \voiceTwo <<\global \bassMusic >> }
- >>
- \new Lyrics = basses { s1 }
-
- \context Lyrics = sopranos \lyricsto sopranos \sopWords
- \context Lyrics = altos \lyricsto altos \altoWords
- \context Lyrics = tenors \lyricsto tenors \tenorWords
- \context Lyrics = basses \lyricsto basses \bassWords
- >>
- \new PianoStaff <<
- \new Staff <<
- \set Staff.printPartCombineTexts = ##f
- \partcombine
- << \global \sopMusic >>
- << \global \altoMusic >>
- >>
- \new Staff <<
- \clef bass
- \set Staff.printPartCombineTexts = ##f
- \partcombine
- << \global \tenorMusic >>
- << \global \bassMusic >>
- >>
- >>
- >>
- \layout {
- \context {
- % a little smaller so lyrics
- % can be closer to the staff
- \Staff
- \override VerticalAxisGroup #'minimum-Y-extent = #'(-3 . 3)
- }
- }
-}
-@end lilypond
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+{vocal-ensemble-template-with-automatic-piano-reduction.ly}
@appendixsubsec SATB with aligned contexts
-Aquí todas las líneas de texto se colocan usando @code{alignAboveContext}
-y @code{alignBelowContext}.
-
-@lilypond[quote,verbatim,ragged-right]
-\version "2.11.51"
-global = {
- \key c \major
- \time 4/4
-}
-
-sopMusic = \relative c'' {
- c4 c c8[( b)] c4
-}
-sopWords = \lyricmode {
- hi hi hi hi
-}
-
-altoMusic = \relative c' {
- e4 f d e
-}
-altoWords =\lyricmode {
- ha ha ha ha
-}
-
-tenorMusic = \relative c' {
- g4 a f g
-}
-tenorWords = \lyricmode {
- hu hu hu hu
-}
-
-bassMusic = \relative c {
- c4 c g c
-}
-bassWords = \lyricmode {
- ho ho ho ho
-}
-
-\score {
- \new ChoirStaff <<
- \new Staff = women <<
- \new Voice =
- "sopranos" { \voiceOne << \global \sopMusic >> }
- \new Voice =
- "altos" { \voiceTwo << \global \altoMusic >> }
- >>
- \new Lyrics \with {alignAboveContext=women} \lyricsto sopranos \sopWords
- \new Lyrics \with {alignBelowContext=women} \lyricsto altos \altoWords
-% we could remove the line about this with the line below, since we want
-% the alto lyrics to be below the alto Voice anyway.
-% \new Lyrics \lyricsto altos \altoWords
-
- \new Staff = men <<
- \clef bass
- \new Voice =
- "tenors" { \voiceOne <<\global \tenorMusic >> }
- \new Voice =
- "basses" { \voiceTwo <<\global \bassMusic >> }
- >>
-
- \new Lyrics \with {alignAboveContext=men} \lyricsto tenors \tenorWords
- \new Lyrics \with {alignBelowContext=men} \lyricsto basses \bassWords
-% again, we could replace the line above this with the line below.
-% \new Lyrics \lyricsto basses \bassWords
- >>
-
- \layout {
- \context {
- % a little smaller so lyrics
- % can be closer to the staff
- \Staff
- \override VerticalAxisGroup #'minimum-Y-extent = #'(-3 . 3)
- }
- }
-}
-
-
-\score {
- \new ChoirStaff <<
- \new Staff = women <<
- \new Voice =
- "sopranos" { \voiceOne << \global \sopMusic >> }
- \new Voice =
- "altos" { \voiceTwo << \global \altoMusic >> }
- >>
-
- \new Lyrics \with {alignAboveContext=women} \lyricsto sopranos \sopWords
- \new Lyrics \lyricsto altos \altoWords
-
- \new Staff = men <<
- \clef bass
- \new Voice =
- "tenors" { \voiceOne <<\global \tenorMusic >> }
- \new Voice =
- "basses" { \voiceTwo <<\global \bassMusic >> }
- >>
-
- \new Lyrics \with {alignAboveContext=men} \lyricsto tenors \tenorWords
- \new Lyrics \lyricsto basses \bassWords
- >>
-
- \layout {
- \context {
- % a little smaller so lyrics
- % can be closer to the staff
- \Staff
- \override VerticalAxisGroup #'minimum-Y-extent = #'(-3 . 3)
- }
- }
-}
-@end lilypond
-
-
-@c bad node name to avoid node name confict
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+{vocal-ensemble-template-with-lyrics-aligned-below-and-above-the-staves.ly}
+
+
+@c bad node name to avoid node name conflict
@node Ancient notation templates
@appendixsec Ancient notation templates
@appendixsubsec Transcription of mensural music
-Cuando se transcribe música mensural, es útil un «incipit» al principio de la pieza
-para indicar la tonalidad y el compás originales. Aunque hoy en día
-los músicos están acostumbrados a las barras de compás para reconocer más rápidamente los patrones
-rítmicos, las líneas divisorias no se habían inventado aún en el período de la música mensural;
-de hecho, el compás solía cambiar cada pocas notas.
-A modo de compromiso, las líneas de compás se suelen imprimir entre los pentagramas
-en vez de hacerlo sobre ellos.
-
-@lilypond[quote,verbatim,line-width=11.0\cm]
-\version "2.11.51"
-
-global = {
- \set Score.skipBars = ##t
-
- % incipit
- \once \override Score.SystemStartBracket #'transparent = ##t
- \override Score.SpacingSpanner #'spacing-increment = #1.0 % tight spacing
- \key f \major
- \time 2/2
- \once \override Staff.TimeSignature #'style = #'neomensural
- \override Voice.NoteHead #'style = #'neomensural
- \override Voice.Rest #'style = #'neomensural
- \set Staff.printKeyCancellation = ##f
- \cadenzaOn % turn off bar lines
- \skip 1*10
- \once \override Staff.BarLine #'transparent = ##f
- \bar "||"
- \skip 1*1 % need this extra \skip such that clef change comes
- % after bar line
- \bar ""
-
- % main
- \revert Score.SpacingSpanner #'spacing-increment % CHECK: no effect?
- \cadenzaOff % turn bar lines on again
- \once \override Staff.Clef #'full-size-change = ##t
- \set Staff.forceClef = ##t
- \key g \major
- \time 4/4
- \override Voice.NoteHead #'style = #'default
- \override Voice.Rest #'style = #'default
-
- % FIXME: setting printKeyCancellation back to #t must not
- % occur in the first bar after the incipit. Dto. for forceClef.
- % Therefore, we need an extra \skip.
- \skip 1*1
- \set Staff.printKeyCancellation = ##t
- \set Staff.forceClef = ##f
-
- \skip 1*7 % the actual music
-
- % let finis bar go through all staves
- \override Staff.BarLine #'transparent = ##f
-
- % finis bar
- \bar "|."
-}
-
-discantusNotes = {
- \transpose c' c'' {
- \set Staff.instrumentName = "Discantus "
-
- % incipit
- \clef "neomensural-c1"
- c'1. s2 % two bars
- \skip 1*8 % eight bars
- \skip 1*1 % one bar
-
- % main
- \clef "treble"
- d'2. d'4 |
- b e' d'2 |
- c'4 e'4.( d'8 c' b |
- a4) b a2 |
- b4.( c'8 d'4) c'4 |
- \once \override NoteHead #'transparent = ##t c'1 |
- b\breve |
- }
-}
-
-discantusLyrics = \lyricmode {
- % incipit
- IV-
-
- % main
- Ju -- bi -- |
- la -- te De -- |
- o, om --
- nis ter -- |
- ra, __ om- |
- "..." |
- -us. |
-}
-
-altusNotes = {
- \transpose c' c'' {
- \set Staff.instrumentName = "Altus "
-
- % incipit
- \clef "neomensural-c3"
- r1 % one bar
- f1. s2 % two bars
- \skip 1*7 % seven bars
- \skip 1*1 % one bar
-
- % main
- \clef "treble"
- r2 g2. e4 fis g | % two bars
- a2 g4 e |
- fis g4.( fis16 e fis4) |
- g1 |
- \once \override NoteHead #'transparent = ##t g1 |
- g\breve |
- }
-}
-
-altusLyrics = \lyricmode {
- % incipit
- IV-
-
- % main
- Ju -- bi -- la -- te | % two bars
- De -- o, om -- |
- nis ter -- ra, |
- "..." |
- -us. |
-}
-
-tenorNotes = {
- \transpose c' c' {
- \set Staff.instrumentName = "Tenor "
-
- % incipit
- \clef "neomensural-c4"
- r\longa % four bars
- r\breve % two bars
- r1 % one bar
- c'1. s2 % two bars
- \skip 1*1 % one bar
- \skip 1*1 % one bar
-
- % main
- \clef "treble_8"
- R1 |
- R1 |
- R1 |
- r2 d'2. d'4 b e' | % two bars
- \once \override NoteHead #'transparent = ##t e'1 |
- d'\breve |
- }
-}
-
-tenorLyrics = \lyricmode {
- % incipit
- IV-
-
- % main
- Ju -- bi -- la -- te | % two bars
- "..." |
- -us. |
-}
-
-bassusNotes = {
- \transpose c' c' {
- \set Staff.instrumentName = "Bassus "
-
- % incipit
- \clef "bass"
- r\maxima % eight bars
- f1. s2 % two bars
- \skip 1*1 % one bar
-
- % main
- \clef "bass"
- R1 |
- R1 |
- R1 |
- R1 |
- g2. e4 |
- \once \override NoteHead #'transparent = ##t e1 |
- g\breve |
- }
-}
-
-bassusLyrics = \lyricmode {
- % incipit
- IV-
-
- % main
- Ju -- bi- |
- "..." |
- -us. |
-}
-
-\score {
- \new StaffGroup = choirStaff <<
- \new Voice =
- "discantusNotes" << \global \discantusNotes >>
- \new Lyrics =
- "discantusLyrics" \lyricsto discantusNotes { \discantusLyrics }
- \new Voice =
- "altusNotes" << \global \altusNotes >>
- \new Lyrics =
- "altusLyrics" \lyricsto altusNotes { \altusLyrics }
- \new Voice =
- "tenorNotes" << \global \tenorNotes >>
- \new Lyrics =
- "tenorLyrics" \lyricsto tenorNotes { \tenorLyrics }
- \new Voice =
- "bassusNotes" << \global \bassusNotes >>
- \new Lyrics =
- "bassusLyrics" \lyricsto bassusNotes { \bassusLyrics }
- >>
- \layout {
- \context {
- \Score
-
- % no bars in staves
- \override BarLine #'transparent = ##t
-
- % incipit should not start with a start delimiter
- \remove "System_start_delimiter_engraver"
- }
- \context {
- \Voice
-
- % no slurs
- \override Slur #'transparent = ##t
-
- % Comment in the below "\remove" command to allow line
- % breaking also at those barlines where a note overlaps
- % into the next bar. The command is commented out in this
- % short example score, but especially for large scores, you
- % will typically yield better line breaking and thus improve
- % overall spacing if you comment in the following command.
- %\remove "Forbid_line_break_engraver"
- }
- }
-}
-@end lilypond
-
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+{ancient-notation-template----modern-transcription-of-mensural-music.ly}
@appendixsubsec Gregorian transcription template
-Este ejemplo es una demostración de cómo hacer transcripción moderna de Canto
-Gregoriano. La música gregoriana no tiene compás ni plicas; usa solamente cabezas de
-nota de blanca y negra, y marcas especiales que indican silencios de distinta longitud.
-
-@lilypond[quote,verbatim,ragged-right]
-\include "gregorian-init.ly"
-\version "2.11.51"
-
-chant = \relative c' {
- \set Score.timing = ##f
- f4 a2 \divisioMinima
- g4 b a2 f2 \divisioMaior
- g4( f) f( g) a2 \finalis
-}
-
-verba = \lyricmode {
- Lo -- rem ip -- sum do -- lor sit a -- met
-}
-
-\score {
- \new Staff <<
- \new Voice = "melody" {
- \chant
- }
- \new Lyrics = "one" \lyricsto melody \verba
- >>
-
- \layout {
- \context {
- \Staff
- \remove "Time_signature_engraver"
- \remove "Bar_engraver"
- \override Stem #'transparent = ##t
- }
- \context {
- \Voice
- \override Stem #'length = #0
- }
- \context {
- \Score
- barAlways = ##t
- }
- }
-}
-@end lilypond
-
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+{ancient-notation-template----modern-transcription-of-gregorian-music.ly}
@node Jazz combo
@appendixsec Jazz combo
-Éste es un ejemplo mucho más complicado, para un conjunto de jazz. Fíjese en que todos los
-instrumentos están escritos en @code{\key c \major}. Esto se refiere a la tonalidad en tono de concierto;
-LilyPond transporta automáticamente la tonalidad si la música está dentro de una
-sección @code{\transpose}.
-
-@c TODO must clean up this jazz combo example
-@c - transpositions stated in names (ie "trumpet in Bb" or whatever)
-@c - one global section, instead of "global" (time) and "key"
-@c - does it need those wierd macros? sl, nsl, etc.
-@c - maybe ask Amelie Zapf to clean it up, or whether I should just
-@c make whatever changes I feel like.
-
-@c FIXME: produces a warning ; key change merge.
-@c The `line-width' argument is for the \header.
-
-@lilypond[quote,verbatim,ragged-right,line-width]
-\version "2.11.51"
-\header {
- title = "Song"
- subtitle = "(tune)"
- composer = "Me"
- meter = "moderato"
- piece = "Swing"
- tagline = \markup {
- \column {
- "LilyPond example file by Amelie Zapf,"
- "Berlin 07/07/2003"
- }
- }
- texidoc = "Jazz tune for combo
- (horns, guitar, piano, bass, drums)."
-}
-
-#(set-global-staff-size 16)
-\include "english.ly"
-
-%%%%%%%%%%%% Some macros %%%%%%%%%%%%%%%%%%%
-
-sl = {
- \override NoteHead #'style = #'slash
- \override Stem #'transparent = ##t
-}
-nsl = {
- \revert NoteHead #'style
- \revert Stem #'transparent
-}
-cr = \override NoteHead #'style = #'cross
-ncr = \revert NoteHead #'style
-
-%% insert chord name style stuff here.
-
-jzchords = { }
-
-
-%%%%%%%%%%%% Keys'n'thangs %%%%%%%%%%%%%%%%%
-
-global = {
- \time 4/4
-}
-
-Key = { \key c \major }
-
-% ############ Horns ############
-
-% ------ Trumpet ------
-trpt = \transpose c d \relative c'' {
- \Key
- c1 c c
-}
-trpharmony = \transpose c' d {
- \jzchords
-}
-trumpet = {
- \global
- \set Staff.instrumentName = #"Trumpet"
- \clef treble
- <<
- \trpt
- >>
-}
-
-% ------ Alto Saxophone ------
-alto = \transpose c a \relative c' {
- \Key
- c1 c c
-}
-altoharmony = \transpose c' a {
- \jzchords
-}
-altosax = {
- \global
- \set Staff.instrumentName = #"Alto Sax"
- \clef treble
- <<
- \alto
- >>
-}
-
-% ------ Baritone Saxophone ------
-bari = \transpose c a' \relative c {
- \Key
- c1 c \sl d4^"Solo" d d d \nsl
-}
-bariharmony = \transpose c' a \chordmode {
- \jzchords s1 s d2:maj e:m7
-}
-barisax = {
- \global
- \set Staff.instrumentName = #"Bari Sax"
- \clef treble
- <<
- \bari
- >>
-}
-
-% ------ Trombone ------
-tbone = \relative c {
- \Key
- c1 c c
-}
-tboneharmony = \chordmode {
- \jzchords
-}
-trombone = {
- \global
- \set Staff.instrumentName = #"Trombone"
- \clef bass
- <<
- \tbone
- >>
-}
-
-% ############ Rhythm Section #############
-
-% ------ Guitar ------
-gtr = \relative c'' {
- \Key
- c1 \sl b4 b b b \nsl c1
-}
-gtrharmony = \chordmode {
- \jzchords
- s1 c2:min7+ d2:maj9
-}
-guitar = {
- \global
- \set Staff.instrumentName = #"Guitar"
- \clef treble
- <<
- \gtr
- >>
-}
-
-%% ------ Piano ------
-rhUpper = \relative c'' {
- \voiceOne
- \Key
- c1 c c
-}
-rhLower = \relative c' {
- \voiceTwo
- \Key
- e1 e e
-}
-
-lhUpper = \relative c' {
- \voiceOne
- \Key
- g1 g g
-}
-lhLower = \relative c {
- \voiceTwo
- \Key
- c1 c c
-}
-
-PianoRH = {
- \clef treble
- \global
- \set Staff.midiInstrument = "acoustic grand"
- <<
- \new Voice = "one" \rhUpper
- \new Voice = "two" \rhLower
- >>
-}
-PianoLH = {
- \clef bass
- \global
- \set Staff.midiInstrument = "acoustic grand"
- <<
- \new Voice = "one" \lhUpper
- \new Voice = "two" \lhLower
- >>
-}
-
-piano = {
- <<
- \set PianoStaff.instrumentName = #"Piano"
- \new Staff = "upper" \PianoRH
- \new Staff = "lower" \PianoLH
- >>
-}
-
-% ------ Bass Guitar ------
-Bass = \relative c {
- \Key
- c1 c c
-}
-bass = {
- \global
- \set Staff.instrumentName = #"Bass"
- \clef bass
- <<
- \Bass
- >>
-}
-
-% ------ Drums ------
-up = \drummode {
- hh4 <hh sn>4 hh <hh sn> hh <hh sn>4
- hh4 <hh sn>4
- hh4 <hh sn>4
- hh4 <hh sn>4
-}
-
-down = \drummode {
- bd4 s bd s bd s bd s bd s bd s
-}
-
-drumContents = {
- \global
- <<
- \set DrumStaff.instrumentName = #"Drums"
- \new DrumVoice { \voiceOne \up }
- \new DrumVoice { \voiceTwo \down }
- >>
-}
-
-%%%%%%%%% It All Goes Together Here %%%%%%%%%%%%%%%%%%%%%%
-
-\score {
- <<
- \new StaffGroup = "horns" <<
- \new Staff = "trumpet" \trumpet
- \new Staff = "altosax" \altosax
- \new ChordNames = "barichords" \bariharmony
- \new Staff = "barisax" \barisax
- \new Staff = "trombone" \trombone
- >>
-
- \new StaffGroup = "rhythm" <<
- \new ChordNames = "chords" \gtrharmony
- \new Staff = "guitar" \guitar
- \new PianoStaff = "piano" \piano
- \new Staff = "bass" \bass
- \new DrumStaff { \drumContents }
- >>
- >>
-
- \layout {
- \context { \RemoveEmptyStaffContext }
- \context {
- \Score
- \override BarNumber #'padding = #3
- \override RehearsalMark #'padding = #2
- skipBars = ##t
- }
- }
-
- \midi { }
-}
-@end lilypond
-
-@ignore
-
-This isn't very useful, and only duplicates material in
-"global issues". And if this info changes, this section often
-gets forgotten.
-
-@no de Other templates
-@se ction Other templates
-@su bsection All headers
-
-This template displays all available headers. Some of them are only
-used in the Mutopia project; they don't affect the printed output at
-all. They are used if you want the piece to be listed with different
-information in the Mutopia database than you wish to have printed on the
-music. For example, Mutopia lists the composer of the famous D major
-violin concerto as TchaikovskyPI, whereas perhaps you wish to print
-"Petr Tchaikowski" on your music.
-
-@ The `line-width' is for \header.
-@li lypond[quote,verbatim,ragged-right,line-width]
-\version "2.11.51"
-\header {
- dedication = "dedication"
- title = "Title"
- subtitle = "Subtitle"
- subsubtitle = "Subsubtitle"
- composer = "Composer (xxxx-yyyy)"
- opus = "Opus 0"
- piece = "Piece I"
- meter = "meter"
- instrument = "Instrument"
- arranger = "Arranger"
- poet = "Poet"
- texttranslator = "Translator"
- copyright = "public domain"
-
- % These are headers used by the Mutopia Project
- % http://www.mutopiaproject.org/
- mutopiatitle = ""
- mutopiacomposer = ""
- mutopiapoet = ""
- mutopiainstrument = ""
- date = "composer's dates"
- source = "urtext "
- maintainer = "your name here"
- maintainerEmail = "your email here"
- maintainerWeb = "your home page"
- lastupdated = "2004/Aug/26"
-}
-
-\score {
- { c'4 }
- \header {
- piece = "piece1"
- opus = "opus1"
- }
-}
-
-\score {
- { c'4 }
- \header {
- piece = "piece2"
- opus = "opus2"
- }
-}
-@end lilypond
-@end ignore
-
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+{jazz-combo-template.ly}
@node lilypond-book templates
@appendixsec lilypond-book templates
@c -*- coding: utf-8; mode: texinfo; -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: 23542761090f167ad42dbff7ef11d44a9c1374ac
+ Translation of GIT committish: ee4be96cab0d3de900bdb527abf8a8b6fa9d2286
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@menu
-* Tweaking basics::
-* The Internals Reference manual::
-* Appearance of objects::
-* Placement of objects::
-* Collisions of objects::
-* Further tweaking::
+* Tweaking basics::
+* The Internals Reference manual::
+* Appearance of objects::
+* Placement of objects::
+* Collisions of objects::
+* Further tweaking::
@end menu
@node Tweaking basics
@section Tweaking basics
@menu
-* Introduction to tweaks::
-* Objects and interfaces::
-* Naming conventions of objects and properties::
-* Tweaking methods::
+* Introduction to tweaks::
+* Objects and interfaces::
+* Naming conventions of objects and properties::
+* Tweaking methods::
@end menu
@node Introduction to tweaks
referencia, presentamos una lista de los tipos de objetos y
propiedades más comunes, junto con las convenciones según las cuales
reciben su nombre, y un par de ejemplos de nombres reales. Hemos
-utilizado una «A» mayúscula para denotar cualquier carácter alfabético
-en mayúsculas, y «aaa» para cualquier número de caracteres alfabéticos
-en minúscula. Otros caracteres se utilizan literalmente como están.
+utilizado una @q{A} mayúscula para denotar cualquier carácter
+alfabético en mayúsculas, y @q{aaa} para cualquier número de
+caracteres alfabéticos en minúscula. Otros caracteres se utilizan
+literalmente como están.
@multitable @columnfractions .33 .33 .33
@headitem Objeto o tipo de propiedad
@tab Convención de nomenclatura
- @tab Ejemplo
+ @tab Ejemplos
@item Contextos
@tab Aaaa o AaaaAaaaAaaa
@tab Staff, GrandStaff
La sintaxis genérica de esta instrucción es:
@example
-\override @emph{contexto}.@emph{objeto_de_presentación}
- #'@emph{propiedad_de_presentación} = #@emph{valor}
+\override @var{Contexto}.@var{ObjetoDePresentación} #'@var{propiedad-de-presentación} = #@var{valor}
@end example
@noindent
Esto establecerá la propiedad de nombre
-@emph{propiedad_de_presentación} del objeto de presentación con el
-nombre @emph{objeto_de_presentación}, que es miembro del contexto
-@emph{contexto}, al valor @emph{valor}.
+@var{propiedad-de-presentación} del objeto de presentación con el
+nombre @var{ObjetoDePresentación}, que es miembro del contexto
+@var{Contexto}, al valor @var{valor}.
-El @emph{contexto} se puede omitir (y normalmente así es) cuando el
+El @var{contexto} se puede omitir (y normalmente así es) cuando el
contexto requerido se encuentra implicado sin ambigüedad y es uno de
los contextos del nivel más bajo, es decir: @code{Voice},
@code{ChordNames} o @code{Lyrics}, y lo omitiremos en muchos de los
se han utilizado varias instrucciones @code{\override}.
@example
-\revert @emph{contexto}.@emph{objeto_de_presentación} #'@emph{propiedad_de_presentación}
+\revert @var{Contexto}.@var{ObjetoDePresentación} #'@var{propiedad-de-presentación}
@end example
-Una vez más, igual que @emph{contexto} dentro de la instrucción
+Una vez más, igual que @var{Contexto} dentro de la instrucción
@code{\override}, con frecuencia no es necesario especificar el
-@emph{contexto}. Se omitirá en muchos de los ejemplos siguientes.
+@var{Contexto}. Se omitirá en muchos de los ejemplos siguientes.
Aquí devolvemos el color de la cabeza al valor predeterminado para las
dos últimas notas:
del acorde, mientras que @code{\tweak} afecta solamente al siguiente
elemento del flujo de entrada.
-He aquí un ejemplo. Suponga que queremos cambiar el tamaño de la nota
-intermedia (el Mi) en un acorde de Do mayor. En primer lugar, veamos
-lo que haría @code{\once \override}:
+He aquí un ejemplo. Suponga que queremos cambiar el tamaño de la
+cabeza de la nota intermedia (el Mi) en un acorde de Do mayor. En
+primer lugar, veamos lo que haría @code{\once \override}:
@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
<c e g>4
@end lilypond
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 objetos de
+cabezas de 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 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 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
-crean con posterioridad y no se pueden trucar de esta forma). Es más,
+La instrucción @code{\tweak} opera de una forma distinta. Actúa sobre
+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
+crean con posterioridad y no se pueden trucar de esta forma. Es más,
cuando se aplica a las cabezas de las notas, éstas @emph{deben} estar
dentro de un acorde, es decir, dentro de ángulos simples, así que para
trucar una sola nota la instrucción @code{\tweak} se debe colocar
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, simplemente:
+@code{\tweak} es, simplemente,
@example
-\tweak #'@emph{propiedad_de_presentación} = #@emph{valor}
+\tweak #'@var{propiedad-de-presentación} = #@var{valor}
@end example
Una instrucción @code{\tweak} también se puede usar para modificar
-\tweak #'color #green _Green
@end lilypond
+@noindent
Observe que la instrucción @code{\tweak} debe venir precedida de una
marca de articulación como si ella misma fuera una articulación.
}
@end lilypond
-Encontrará más detalles de la instrucción @code{\tweak} en
-@ruser{The tweak command}.
-
Si los grupos anidados no comienzan en el mismo momento, su apariencia
se puede modificar de la forma usual mediante instrucciones
@code{\override}:
}
@end lilypond
+@seealso
+
+Referencia de la notación:
+@ruser{The tweak command}.
+
+
@node The Internals Reference manual
@section The Internals Reference manual
@cindex Internals Reference
@menu
-* Properties of layout objects::
-* Properties found in interfaces::
-* Types of properties::
+* Properties of layout objects::
+* Properties found in interfaces::
+* Types of properties::
@end menu
@node Properties of layout objects
Utilicemos un ejemplo concreto con un sencillo fragmento de música
real:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
{
\time 6/8
{
la página web de LilyPond en @uref{http://lilypond.org}. Vaya a la
página de la documentación y siga el enlace Manual de Referencia de
Funcionamiento Interno (RFI). Para nuestros propósitos pedagógicos
-sería mejor que utilizase la versión html, no la @q{en una sola
+sería mejor que utilizase la versión en HTML, no la @q{en una sola
página} ni el PDF. Para que los siguientes párrafos tengan algún
sentido deberá consultarlo realmente al tiempo que lee.
alfabético. Siga el enlace Slur (ligadura de expresión), y aparecerán
relacionadas las propiedades de las ligaduras de expresión o Slurs.
-(Una forma alternativa de encontrar esta página es a partir de la
+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 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í.)
+directamente a esta página, aunque si tiene una idea del nombre del
+objeto de presentación que pretende trucar, le resultará más fácil ir
+directamente al RFI y buscar allí.
Esta página sobre las ligaduras de expresión dentro del manual RFI nos
dice en primer lugar que los objetos Slur se crean por el grabador
respuesta es: @q{Dentro de la música, antes de la primera ligadura y
cerca de ella.} Hagámoslo así:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
{
\time 6/8
{
la instrucción que lleva @code{\once} se debe reposicionar de la forma
siguiente:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
{
\time 6/8
{
inmediatamente antes de cada una de las notas en que comienzan las
ligaduras:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
{
\time 6/8
{
del grosor, @code{thickness}, a su valor predeterminado después de la
segunda ligadura:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
{
\time 6/8
{
y debe colocarse justo delante de, y cerca de, la letra a la que debe
afectar, como esto:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
{
\time 6/8
{
@tab @code{2.5}, @code{0.34}
@item Dirección
@tab Una constante válida de dirección o su equivalente numérico
- @tab @code{#LEFT}, @code{#CENTER}, @code{#UP},
+ @tab @code{LEFT}, @code{CENTER}, @code{UP},
@code{1}, @code{-1}
@item Entero
@tab Un número entero positivo
@tab @code{bend::print}, @code{ly:text-interface::print},
@code{#f}
@item Vector
- @tab Una lista de tres elementos encerrados entre paréntesis y precedida de una almohadilla, @code{#}.
- @tab @code{#(#t #t #f)}
+ @tab Una lista de tres elementos encerrados entre paréntesis y precedida de apóstrofe-almohadilla, @code{'#}.
+ @tab @code{'#(#t #t #f)}
@end multitable
@node Appearance of objects
cambiar el aspecto de la música impresa.
@menu
-* Visibility and color of objects::
-* Size of objects::
-* Length and thickness of objects::
+* Visibility and color of objects::
+* Size of objects::
+* Length and thickness of objects::
@end menu
@node Visibility and color of objects
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]
+@lilypond[quote,verbatim,relative=2]
{
\time 12/16
\override BarLine #'stencil = ##f
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]
+@lilypond[quote,verbatim,relative=2]
{
\time 12/16
\override Staff.BarLine #'stencil = ##f
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}.
+@code{'#(#f #f #f)}. Vamos a probarlo, recordando incluir el contexto
+de @code{Staff}. Observe también que al escribir este valor tenemos
+@code{#'#} antes del paréntesis de apertura. Se necesita @code{'#}
+como parte del valor para introducir un vector, y el primer símbolo de
+almohadilla @code{#} se necesita, como siempre, para preceder el valor
+en sí dentro de la instrucción @code{\override}.
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
{
@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]
+@lilypond[quote,verbatim,relative=2]
{
\time 12/16
\override Staff.TimeSignature #'transparent = ##t
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]
+@lilypond[quote,verbatim,relative=2]
{
\time 12/16
\override Staff.TimeSignature #'stencil = ##f
@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]
+Para finalizar, intentemos hacer invisibles las barras de compás
+pintándolas de color blanco (hay un problema relacionado, que consiste
+en que la línea divisoria blanca puede tapar o no tapar las líneas del
+pentagrama a las que cruza. Podrá observar en algunos de los ejemplos
+que aparecen a continuación, que esto sucede de forma impredecible.
+Los detalles sobre por qué esto ocurre así, y cómo controlarlo, se
+estudian en @ruser{Painting objects white}; de momento estamos
+estudiando el color, por lo que le rogamos que acepte esta limitación
+por ahora).
+
+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,verbatim,relative=2]
{
\time 12/16
\override Staff.BarLine #'color = #white
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]
+@lilypond[quote,verbatim,relative=2]
{
\time 12/16
\override Staff.BarLine #'color = #(x11-color 'white)
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]
+@lilypond[quote,verbatim,relative=2]
{
\time 12/16
\override Staff.BarLine #'color = #(rgb-color 1 1 1)
estableciendo todos los objetos de presentación de nuestro ejemplo a
varias gradaciones de gris:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
{
\time 12/16
\override Staff.StaffSymbol #'color = #(x11-color 'grey30)
@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]
+@lilypond[quote,verbatim,relative=2]
\new Staff ="main" {
\relative g' {
r4 g8 g c4 c8 d |
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]
+@lilypond[quote,verbatim,relative=2]
\new Staff ="main" {
\relative g' {
r4 g8 g c4 c8 d |
Así pues, podemos reemplazar el ejemplo anterior con
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
\new Staff ="main" {
\relative g' {
r4 g8 g c4 c8 d |
Vamos a probarlo en nuestro ejemplo del ossia:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
\new Staff ="main" {
\relative g' {
r4 g8 g c4 c8 d |
para reducir otros objetos en la misma proporción. Se usa de la
siguiente forma:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
\new Staff ="main" {
\relative g' {
r4 g8 g c4 c8 d |
@section Placement of objects
@menu
-* Automatic behaviour::
-* Within-staff objects::
-* Outside staff objects::
+* Automatic behaviour::
+* Within-staff objects::
+* Outside staff objects::
@end menu
@q{Text3} se posiciona de nuevo automáticamente cerca del pentagrama,
acomodado por debajo de @q{Text2}.
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
c2^"Text1"
c^"Text2"
c^"Text3"
forzadas hacia arriba, y por último cuatro notas devueltas al
comportamiento predeterminado.
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
a4 g c a
\override Stem #'direction = #DOWN
a g c a
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
+@multitable @columnfractions .2 .2 .25 .35
@headitem Abajo o Izquierda
@tab Arriba o Derecha
@tab Anular
predeterminado, y después el efecto de especificar @code{DOWN} y
@code{UP}:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
c-5 a-3 f-1 c'-5
\override Fingering #'direction = #DOWN
c-5 a-3 f-1 c'-5
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]
+@lilypond[quote,verbatim,relative=2]
<c-5 g-3>
<c-5 g-3 e-2>
<c-5 g-3 e-2 c-1>
@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
+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
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]
+@lilypond[quote,verbatim,relative=2]
c2^"Text1"
c^"Text2"
\once \override TextScript #'outside-staff-priority = #500
comportamiento, ocasionando que las notas resulten tan espaciadas como
sea necesario para acomodar el texto:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
\textLengthOn % Cause notes to space out to accommodate text
c2^"Text1"
c^"Text2"
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]
+@lilypond[quote,verbatim,relative=2]
% This markup is short enough to fit without collision
c2^"Tex"
c''2
el lugar óptimo, como muestra el siguiente ejemplo más bien
artificial:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
\dynamicUp
a4\f b\mf c\mp b\p
@end lilypond
@noindent
Veamos si funciona en nuestro ejemplo anterior:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
\dynamicUp
\override DynamicText #'extra-spacing-width = #'(0 . 0)
a4\f b\mf c\mp b\p
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]
+@lilypond[quote,verbatim,relative=2]
\dynamicUp
% Extend width by 1 staff space
\override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
@section Collisions of objects
@menu
-* Moving objects::
-* Fixing overlapping notation::
-* Real music example::
+* Moving objects::
+* Fixing overlapping notation::
+* Real music example::
@end menu
@node Moving objects
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
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}.
+@strong{staff}. Durante el proceso tipográfico, las cabezas de las
+notas se componen tipográficamente en primer lugar, y después las
+alteraciones, si existen, se añaden a la izquierda de las cabezas
+utilizando la propiedad de relleno por la derecha @code{right-padding}
+para determinar la separación entre la alteración y la cabeza. así
+pues, sólo la propiedad de relleno por la derecha @code{right-padding}
+del objeto @code{AccidentalPlacement} tiene efecto sobre la colocación
+de las alteraciones.
La propiedad @code{staff-padding} está estrechamente relacionada con
la propiedad @code{padding}: @code{padding} controla la separación
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{The
-\override command}.
+inadvertidos. Para ver más detalles, consulte @ruser{Modifying
+properties}.
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
las notas con un becuadro y un bemol. Aquí vienen varios intentos de
hacerlo así:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
<b bes>
<b! bes>
<b? bes>
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]
+@lilypond[quote,verbatim,relative=2]
\dynamicUp
% Extend width by 1 unit
\override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
bes1~ |
\bar "||"
\time 6/4
- \override Staff.NoteCollision #'merge-differently-headed = ##t
- \override Staff.NoteCollision #'merge-differently-dotted = ##t
+ \mergeDifferentlyHeadedOn
+ \mergeDifferentlyDottedOn
bes2.^\markup {\bold "Moderato"} r8
<<
{c,8[ d fis bes a] | }
\\
{s4 fis4.}
>>
- \revert Staff.NoteCollision #'merge-differently-headed
- \revert Staff.NoteCollision #'merge-differently-dotted
+ \mergeDifferentlyHeadedOff
+ \mergeDifferentlyDottedOff
g2.\)
}
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
+voces? Aquí es donde debemos volver a buscar ayuda en el manual de
+Referencia de la notación. Al buscar la palabra @qq{merge} (mezcla) en
+el índice de la Referencia de la notación llegamos rápidamente a las
+instrucciones para mezclar 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
-\override Staff.NoteCollision #'merge-differently-headed = ##t
-\override Staff.NoteCollision #'merge-differently-dotted = ##t
+\mergeDifferentlyHeadedOn
+\mergeDifferentlyDottedOn
@end example
@noindent
al principio de la sección, y
@example
-\revert Staff.NoteCollision #'merge-differently-headed
-\revert Staff.NoteCollision #'merge-differently-dotted
+\mergeDifferentlyHeadedOff
+\mergeDifferentlyDottedOff
@end example
@noindent
\bar "||"
\time 6/4
bes2.^\markup {\bold "Moderato"} r8
- \override Staff.NoteCollision #'merge-differently-headed = ##t
- \override Staff.NoteCollision #'merge-differently-dotted = ##t
+ \mergeDifferentlyHeadedOn
+ \mergeDifferentlyDottedOn
% Start polyphonic section of four voices
<<
{c,8[ d fis bes a] | }
\\
{s4 fis4. | }
>>
- \revert Staff.NoteCollision #'merge-differently-headed
- \revert Staff.NoteCollision #'merge-differently-dotted
+ \mergeDifferentlyHeadedOff
+ \mergeDifferentlyDottedOff
g2.\)
}
\bar "||"
\time 6/4
bes2.^\markup {\bold "Moderato"} r8
- \override Staff.NoteCollision #'merge-differently-headed = ##t
- \override Staff.NoteCollision #'merge-differently-dotted = ##t
+ \mergeDifferentlyHeadedOn
+ \mergeDifferentlyDottedOn
% Start polyphonic section of four voices
<<
{c,8[ d fis bes a] | }
\\
{s4 fis4. | }
>>
- \revert Staff.NoteCollision #'merge-differently-headed
- \revert Staff.NoteCollision #'merge-differently-dotted
+ \mergeDifferentlyHeadedOff
+ \mergeDifferentlyDottedOff
g2.\)
}
\bar "||"
\time 6/4
bes2.^\markup {\bold "Moderato"} r8
- \override Staff.NoteCollision #'merge-differently-headed = ##t
- \override Staff.NoteCollision #'merge-differently-dotted = ##t
+ \mergeDifferentlyHeadedOn
+ \mergeDifferentlyDottedOn
<<
{c,8[ d fis bes a] | }
\\
\\
{s4 fis4.}
>>
- \revert Staff.NoteCollision #'merge-differently-headed
- \revert Staff.NoteCollision #'merge-differently-dotted
+ \mergeDifferentlyHeadedOff
+ \mergeDifferentlyDottedOff
g2.\)
}
@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::
+* 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
>>
@end lilypond
-@subheading Simulating a fermata
+@subheading Simulating a fermata in MIDI
@cindex sello, uso de la propiedad
@cindex fermata, realización en MIDI
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:
+sistemas ni sobre la colocación de las anotaciones adyacentes sobre el
+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]
\score {
\tempo 4=120
a4 a a
\once \override Score.MetronomeMark #'transparent = ##t
- % Invisible tempo marking to lengthen fermata note in MIDI
+ % Invisible tempo marking to lengthen fermata in MIDI
\tempo 4=80
a\fermata
- \once \override Score.MetronomeMark #'stencil = ##f
- % Invisible tempo marking to restore tempo in MIDI
+ % New tempo for next section
+ \tempo 4=100
+ a a a a
+ }
+ \layout { }
+ \midi { }
+}
+@end lilypond
+
+@lilypond[quote,verbatim,ragged-right]
+\score {
+ \relative c'' {
+ % Visible tempo marking
\tempo 4=120
+ a4 a a
+ \once \override Score.MetronomeMark #'stencil = ##f
+ % Invisible tempo marking to lengthen fermata in MIDI
+ \tempo 4=80
+ a\fermata
+ % New tempo for next section
+ \tempo 4=100
a a a a
}
\layout { }
@end lilypond
@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.
+Ambos métodos quitan de la salida impresa la indicación metronómica
+que alarga el calderón, y los dos afectan al tempo del MIDI tal y como
+queríamos, pero la indicación metronómica transparente de la primera
+línea fuerza una colocación muy alta de la indicación de tempo que
+sigue, meintras que la segunda (con el sello suprimido) no lo hace.
@node Using variables for tweaks
@subsection Using variables for tweaks
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}:
+@code{\italic} y @code{\bold} sólo funcionan dentro de la letra de las
+canciones si están incluidas dentro de un @code{\markup}, lo que las
+hace tediosas de escribir. ¿Podríamos, como alternativa, utilizar las
+instrucciones @code{\override} y @code{\revert}?
@example
@code{\override Lyrics . LyricText #'font-shape = #'italic}
@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:
+Estas instrucciones también 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, aunque normalmente quizá elegiríamos unos nombres de variable
+más cortos para que fueran más rápidos de teclear:
@lilypond[quote,verbatim]
-emph = {
+emphasize = {
\override Lyrics . LyricText #'font-shape = #'italic
\override Lyrics . LyricText #'font-series = #'bold
}
-norm = {
+normal = {
\revert Lyrics . LyricText #'font-shape
\revert Lyrics . LyricText #'font-series
}
global = { \time 4/4 \partial 4 \key c \major}
-SopMusic = \relative c' { c4 | e4. e8 g4 g | a a g }
+SopranoMusic = \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 }
+VerseOne = \lyrics { E -- | ter -- nal \emphasize Fa -- ther, \normal | strong to save, }
+VerseTwo = \lyricmode { O | \emphasize Christ, \normal whose voice the | wa -- ters heard, }
+VerseThree = \lyricmode { O | \emphasize Ho -- ly Spi -- rit, \normal | who didst brood }
+VerseFour = \lyricmode { O | \emphasize Tri -- ni -- ty \normal of | love and pow'r }
\score {
\new ChoirStaff <<
\new Staff <<
\clef "treble"
- \new Voice = "Sop" { \voiceOne \global \SopMusic }
+ \new Voice = "Soprano" { \voiceOne \global \SopranoMusic }
\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 Lyrics \lyricsto "Soprano" { \VerseOne }
+ \new Lyrics \lyricsto "Soprano" { \VerseTwo }
+ \new Lyrics \lyricsto "Soprano" { \VerseThree }
+ \new Lyrics \lyricsto "Soprano" { \VerseFour }
>>
\new Staff <<
\clef "bass"
@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:
+echarles un vistazo, en primer lugar debe buscar la carpeta
+correspondiente a su sistema. La ubicación de esta carpeta depende
+(a) de si consiguió el programa LilyPond descargando un binario
+precompilado desde el sitio web lilypond.org o si lo instaló mediante
+un gestor de paquetes (es decir, distribuido con Linux, o instalado
+bajo fink o cygwin) o fue compilado a partir de la fuente, y (b) de
+qué sistema operativo está utilizando:
-@strong{Linux}
+
+@strong{Descargado de lilypond.org}
+
+@itemize @bullet
+@item Linux
Diríjase a
-@file{@var{installdir}/lilypond/usr/share/lilypond/current/}
+@file{@var{CARPETA_DE_INSTALACIÓN}/lilypond/usr/share/lilypond/current/}
-@strong{MacOS X}
+@item MacOS X
Diríjase a
-@file{@var{installdir}/LilyPond.app/Contents/Resources/share/lilypond/current/}
+@file{@var{CARPETA_DE_INSTALACIÓN}/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}
+@item Windows
Mediante el Explorador de Windows, diríjase a
-@file{@var{installdir}/LilyPond/usr/share/lilypond/current/}
+@file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond/usr/share/lilypond/current/}
+
+@end itemize
+
+@strong{Instalado mediante un gestor de paquetes o compilado a partir de la fuente}
+
+Diríjase a
+@file{@var{PREFIJO}/share/lilypond/@var{X.Y.Z}/}, donde @var{PREFIJO}
+se encuentra determinado por su administrador de paquetes o guión
+@code{configure}, y @var{X.Y.Z} es el número de la versión de
+LilyPond.
+
+@smallspace
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
+@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:
+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 = @{
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/}:
+@file{ly/}:
@multitable @columnfractions .4 .6
@headitem Archivo
@tab Contenido
-@item @file{../ly/engraver-init.ly}
+@item @file{ly/engraver-init.ly}
@tab Definiciones de Contextos de grabadores
-@item @file{../ly/paper-defaults.ly}
+@item @file{ly/paper-defaults.ly}
@tab especificaciones de valores predeterminados relacionados con el papel
-@item @file{../ly/performer-init.ly}
+@item @file{ly/performer-init.ly}
@tab Definiciones de Contextos de interpretación
-@item @file{../ly/property-init.ly}
+@item @file{ly/property-init.ly}
@tab Definiciones de todas las instrucciones incorporadas que son comunes
@end multitable
@multitable @columnfractions .4 .6
@headitem Archivo
@tab Contenido
-@item @file{../scm/auto-beam.scm}
+@item @file{scm/auto-beam.scm}
@tab Valores predeterminados de sub-barrado
-@item @file{../scm/define-grobs.scm}
+@item @file{scm/define-grobs.scm}
@tab valores predeterminados de las propiedades de grobs
-@item @file{../scm/define-markup-commands.scm}
+@item @file{scm/define-markup-commands.scm}
@tab Especificar todas las instrucciones de marcado
-@item @file{../scm/midi.scm}
+@item @file{scm/midi.scm}
@tab Ajustes predeterminados para la salida MIDI
-@item @file{../scm/output-lib.scm}
+@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}
+@item @file{scm/parser-clef.scm}
@tab Definiciones de las claves contempladas
-@item @file{../scm/script.scm}
+@item @file{scm/script.scm}
@tab Ajustes predeterminados para las articulaciones
@end multitable
\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' |
+ c2 c' |
+ b4 g8 a b4 c |
+ c,2 a' |
g1 |
}
\addlyrics {
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: 6f45665792b1f7394123246f47f9e55163624f3c
+ Translation of GIT committish: d2956a4fd79a17f6b5b3ed8000678e460d1a580f
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@node Wind instruments
@section Wind instruments
-@untranslated
+@lilypondfile[quote]{wind-headword.ly}
+
+Esta sección incluye ciertos elementos de notación musical que afloran
+al escribir para instrumentos de viento.
@menu
* Common notation for wind instruments::
@node Common notation for wind instruments
@subsection Common notation for wind instruments
-@untranslated
+Esta sección trata algunos asuntos que son comunes a casi todos los
+instrumentos de viento.
@menu
* References for wind instruments::
@node References for wind instruments
@unnumberedsubsubsec References for wind instruments
-@untranslated
+@cindex viento, instrumentos
+
+Muchas cuestiones de la notación para instrumentos de viento tienen
+que ver con las respiraciones y los golpes de lengua:
+
+@itemize
+@item Las respiraciones se pueden especificar mediante silencios o marcas de respiración, véase @ref{Breath marks}.
+@item La ejecución ligada se indica mediante ligaduras de expresión, véase @ref{Slurs}.
+@item Los distintos golpes de lengua, desde legato hasta staccato pasando por non legato, se presentan por lo general mediante articulaciones, en ocasiones combinadas con ligaduras de expresión, véase @ref{Articulations and ornamentations} y @ref{List of articulations}.
+@item El frullato se indica generalmente mediante una indicación de trémolo y una marca textual sobre la nota. Véase @ref{Tremolo repeats}.
+@end itemize
+
+También existen otros aspectos de la notación musical que son de
+aplicación a los instrumentos de viento:
+
+@itemize
+@item Muchos instrumentos de viento son transpositores, véase @ref{Instrument transpositions}.
+@item El portamento es característico del trombón, pero otros instrumentos de viento pueden realizar glissandos con llaves o válvulas. Véase @ref{Glissando}.
+@item Los glissandos de serie armónica, que son posibles en todos los metales pero bastante específicos de las trompas, se escriben en general como notas de adorno, véase @ref{Grace notes}.
+@item Las inflexiones de tono al final de una nota se tratan en @ref{Falls and doits}.
+@item Los golpes de llave o de válvula se suelen indicar con el estilo @code{cross} (aspas) de cabezas de nota, véase @ref{Special note heads}.
+@item Los instrumentos de viento-madera pueden sobreinflar las notas graves para producir armónicos. Éstos se muestran por medio de la articulación @code{flageolet}. Véase @ref{List of articulations}.
+@item El uso de sordinas para los metales se suele indicar mediante marcas de texto, pero en los lugares donde se suceden muchos cambios rápidos es mejor utilizar las articulaciones @code{stopped} (tapado) y @code{open} (abierto). Véase @ref{Articulations and ornamentations} y @ref{List of articulations}.
+@item Las trompas tapadas se indican por medio de la articulación @code{stopped}. Véase @ref{Articulations and ornamentations}.
+@end itemize
+
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{changing--flageolet-mark-size.ly}
+
+@seealso
+
+Referencia de la notación:
+@ref{Breath marks},
+@ref{Slurs},
+@ref{Articulations and ornamentations},
+@ref{List of articulations},
+@ref{Tremolo repeats},
+@ref{Instrument transpositions},
+@ref{Glissando},
+@ref{Grace notes},
+@ref{Falls and doits},
+@ref{Special note heads}.
+
+Snippets:
+@rlsr{Winds}
+
@node Fingerings
@unnumberedsubsubsec Fingerings
-@untranslated
+@c TODO add link to LSR snippet by Libero Mureddo once he has added
+@c it (after August 15th).
+Todos los instrumentos de viento aparte del trombón requieren el uso
+de los distintos dedos para producir cada nota.
+
+[REDACTAR]
@node Bagpipes
@subsection Bagpipes
-@untranslated
+Esta sección contiene información adicional de utilidad para la
+escritura para gaita.
@menu
* Bagpipe definitions::
@end menu
@node Bagpipe definitions
-@subsubsection Bagpipe definitions
+@unnumberedsubsubsec Bagpipe definitions
+
+@cindex gaita
+@cindex gaita escocesa de las tierras altas
+@cindex mordentes
+@cindex notas de adorno
+@funindex \taor
+@funindex taor
+@funindex \hideKeySignature
+@funindex hideKeySignature
+@funindex \showKeySignature
+@funindex showKeySignature
+
LilyPond contiene definiciones especiales para la música de gaita escocesa de las
tierras altas; para usarlas, escriba
sol agudo piobaireachd se puede escribir @code{gflat} cuando aparece en música
ligera.
+@seealso
+Fragmentos de código:
+@rlsr{Winds}.
+
@node Bagpipe example
@subsubsection Bagpipe example
+@cindex gaita, ejemplo de
+@cindex Amazing Grace, ejemplo de gaita
La conocida melodía Amazing Grace tiene este aspecto en notación de
gaita.
\bar "|."
}
@end lilypond
-
@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@c This file is part of lilypond-learning.tely
@ignore
- Translation of GIT committish: 007d0b5b94c36f9d9e228309d5b0e6a67ae27ebc
+ Translation of GIT committish: a4836ce5ec9488d795344735f2febc880fbb6a2f
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
tuplets written as @code{\times x/y @{..@}}, and grace notes
written as @code{\grace@{..@}}.
-Outside LilyPond, the conventional use of brackets requires
-the different types to be properly nested, like this,
-@code{<< [ @{ ( .. ) @} ] >>}, with the closing brackets being
-encountered in exactly the opposite order to the opening
-brackets. This @strong{is} a requirement for the three types of
-bracket described by the word @q{Encloses} in the table above --
-they must nest properly. However, the remaining brackets,
-described with the word @q{Marks} in the table above together
-with ties and tuplets, do @strong{not} have to nest properly
-with any of the brackets. In fact, these are not brackets in
-the sense that they enclose something -- they are simply
-markers to indicate where something starts and ends.
+Outside LilyPond, the conventional use of brackets requires the
+different types to be properly nested, like this, @code{<< [ @{ ( .. )
+@} ] >>}, with the closing brackets being encountered in exactly the
+opposite order to the opening brackets. This @strong{is} a
+requirement for the three types of bracket described by the word
+@q{Encloses} in the table above -- they must nest properly. However,
+the remaining brackets, described with the word @q{Marks} in the table
+above together with ties and tuplets, do @strong{not} have to nest
+properly with any of the brackets. In fact, these are not brackets in
+the sense that they enclose something -- they are simply markers to
+indicate where something starts and ends.
So, for example, a phrasing slur can start before a manually
inserted beam and end before the end of the beam -- not very
Voices are sometimes called @q{layers} in other notation
packages.
-In fact, a Voice layer or context is the only one which can
-contain music. If a Voice context is not explicitly declared
-one is created automatically, as we saw at the beginning of
-this chapter. Some instruments such as an
-Oboe can play only one note at a time. Music written for
-such instruments is monophonic and requires just a single
-voice. Instruments which can play more than one note at a
-time like the piano will often require multiple voices to
-encode the different concurrent notes and rhythms they are
-capable of playing.
+In fact, a Voice layer or context is the only one which can contain
+music. If a Voice context is not explicitly declared one is created
+automatically, as we saw at the beginning of this chapter. Some
+instruments such as an Oboe can play only one note at a time. Music
+written for such instruments is monophonic and requires just a single
+voice. Instruments which can play more than one note at a time like
+the piano will often require multiple voices to encode the different
+concurrent notes and rhythms they are capable of playing.
A single voice can contain many notes in a chord, of course,
so when exactly are multiple voices needed? Look first at
to a single staff, while a bar line must be synchronized across
the entire score.
-Within LilyPond, these rules and bits of information are grouped
-in @emph{Contexts}. We have already met the
-@code{Voice} context.
-Others are the @code{Staff} and @code{Score} contexts.
-Contexts are hierarchical to reflect the hierarchical nature of
-a musical score.
-For example: a @code{Staff} context can contain many
-@code{Voice} contexts, and a @code{Score} context can
-contain many @code{Staff} contexts.
+Within LilyPond, these rules and bits of information are grouped in
+@emph{Contexts}. We have already met the @code{Voice} context.
+Others are the @code{Staff} and @code{Score} contexts. Contexts are
+hierarchical to reflect the hierarchical nature of a musical score.
+For example: a @code{Staff} context can contain many @code{Voice}
+contexts, and a @code{Score} context can contain many @code{Staff}
+contexts.
@quotation
@sourceimage{context-example,5cm,,}
@subsection Creating contexts
@funindex \new
+@funindex new
@cindex new contexts
@cindex creating contexts
@cindex contexts, creating
-There can be only one top level context: the
-@code{Score}
-context. This is created with the @code{\score} command,
-or, in simple scores, it is created automatically.
+There can be only one top level context: the @code{Score} context.
+This is created with the @code{\score} command, or, in simple scores,
+it is created automatically.
-For scores with only one voice and one staff, the
-@code{Voice} and @code{Staff} contexts may be left to be
-created automatically, but for more complex scores it is
-necessary to create them by hand.
-The simplest command that does this is @code{\new}.
-It is prepended to a music expression, for example
+For scores with only one voice and one staff, the @code{Voice} and
+@code{Staff} contexts may be left to be created automatically, but for
+more complex scores it is necessary to create them by hand. The
+simplest command that does this is @code{\new}. It is prepended to a
+music expression, for example
@example
\new @var{type} @var{music-expression}
more than a few, and for simple scores you do not need to know
about any.
-Engravers live and operate in Contexts.
-Engravers such as the @code{Metronome_mark_engraver}, whose
-action and output apply to the score as a whole, operate in
-the highest level context -- the @code{Score} context.
+Engravers live and operate in Contexts. Engravers such as the
+@code{Metronome_mark_engraver}, whose action and output apply to the
+score as a whole, operate in the highest level context -- the
+@code{Score} context.
The @code{Clef_engraver} and @code{Key_engraver} are to be
found in every @code{Staff} Context, as different staves may require
@cindex context properties, modifying
@cindex modifying context properties
@funindex \set
+@funindex set
@funindex \unset
+@funindex unset
Contexts are responsible for holding the values of a number of
context @emph{properties}. Many of them can be changed to
in the @code{\set} statement. So when a Boolean is being
entered you need to code two hash signs, e.g., @code{##t}.
+@cindex properties operating in contexts
+@cindex setting properties within contexts
+
Before we can set any of these properties we need to know
in which context they operate. Sometimes this is obvious,
but occasionally it can be tricky. If the wrong context
@unnumberedsubsubsec Setting context properties with @code{\with}
@funindex \with
+@funindex with
@cindex context properties, setting with \with
Context properties may also be set at the time the context is
Properties set in this way may still be changed dynamically using
@code{\set} and returned to their default value with @code{\unset}.
+@cindex fontSize, default and setting
+
The @code{fontSize} property is treated differently. If this is
set in a @code{\with} clause it effectively resets the default
value of the font size. If it is later changed with @code{\set},
@unnumberedsubsubsec Setting context properties with @code{\context}
+@cindex context properties, setting with \context
+@funindex \context
+@funindex context
+
The values of context properties may be set in @emph{all} contexts
of a particular type, such as all @code{Staff} contexts, with a single
command. The context type is identified by using its
@subsection Adding and removing engravers
@cindex engravers, adding
+@cindex adding engravers
@cindex engravers, removing
+@cindex removing engravers
@funindex \consists
+@funindex consists
@funindex \remove
+@funindex remove
We have seen that contexts each contain several engravers, each
of which is responsible for producing a particular part of the
@subsubheading Changing all contexts of the same type
@funindex \layout
+@funindex layout
The examples above show how to remove or add engravers to
individual contexts. It is also possible to remove or add
@subsection Soprano and cello
@cindex template, modifying
+@cindex modifying templates
Start off with the template that seems closest to what you want to end
up with. Let's say that you want to write something for soprano and
The variables holding the music and words for the vocal parts are
fine, but we shall need to add variables for the piano reduction.
-The order in which the contexts appear in the ChoirStaff of
-the template do not correspond with the order in the vocal
-score shown above. We need to rearrange them so there are
-four staves with the words written directly underneath the
-notes for each part.
-All the voices should be @code{\voiceOne}, which is
-the default, so the @code{\voiceXXX} commands should be removed.
-We also need to specify the tenor clef for the tenors.
-The way in which lyrics are specified in the template has not yet
-been encountered so we need to use the method with which we are
-familiar. We should also add the names of each staff.
+The order in which the contexts appear in the ChoirStaff of the
+template do not correspond with the order in the vocal score shown
+above. We need to rearrange them so there are four staves with the
+words written directly underneath the notes for each part. All the
+voices should be @code{\voiceOne}, which is the default, so the
+@code{\voiceXXX} commands should be removed. We also need to specify
+the tenor clef for the tenors. The way in which lyrics are specified
+in the template has not yet been encountered so we need to use the
+method with which we are familiar. We should also add the names of
+each staff.
Doing this gives for our ChoirStaff:
@subsection Building a score from scratch
@cindex template, writing your own
+@cindex example of writing a score
+@cindex writing a score, example
+@cindex score, example of writing
After gaining some facility with writing LilyPond code, you
may find that it is easier to build a score from scratch
which formats should be written. Choices for @code{format} are
@code{svg}, @code{ps}, @code{pdf}, @code{png}, @code{tex}, @code{dvi}.
-Example: @code{lilypond -fpng filename.ly}
+Example: @code{lilypond -fpng @var{filename}.ly}
In safe mode, it is not possible to import LilyPond variables
into Scheme.
-safe does @emph{not} detect resource overuse. It is still possible to
+@code{-dsafe} does @emph{not} detect resource overuse. It is still possible to
make the program hang indefinitely, for example by feeding cyclic data
structures into the backend. Therefore, if using LilyPond on a
publicly accessible webserver, the process should be limited in both
@file{EPS} file, without fonts, and as one collated @file{EPS} file with
all pages (systems) including fonts.
-This mode is used by default by lilypond-book.
+This mode is used by default by @command{lilypond-book}.
@item svg
for SVG (Scalable Vector Graphics). This dumps every page as a separate
You need a SVG viewer which supports embedded fonts, or a SVG
viewer which is able to replace the embedded fonts with OTF fonts.
Under UNIX, you may use @uref{http://www.inkscape.org,Inkscape}
- (version 0.42 or later), after copying the OTF fonts in directory
- @file{PATH/TO/share/lilypond/VERSION/fonts/otf/} to @file{~/.fonts/}.
+ (version 0.42 or later), after copying the OTF fonts from the LilyPond directory
+ (typically @file{/usr/share/lilypond/VERSION/fonts/otf/}) to @file{~/.fonts/}.
@item scm
for a dump of the raw, internal Scheme-based drawing commands.
@cindex Scheme dump
@end table
-Example: @code{lilypond -dbackend=svg filename.ly}
+Example: @code{lilypond -dbackend=svg @var{filename}.ly}
@cindex output format, setting
@item -h,--help
Show a summary of usage.
-@item -H,--header=FIELD
-Dump a header field to file BASENAME.FIELD
+@item -H,--header=@var{FIELD}
+Dump a header field to file @file{BASENAME.@var{FIELD}}.
@item --include, -I=@var{directory}
Add @var{directory} to the search path for input files.
@item -o,--output=@var{FILE}
Set the default output file to @var{FILE}. The appropriate
-suffix will be added (ie @code{.pdf} for pdf, @code{.tex}
+suffix will be added (i.e. @code{.pdf} for pdf, @code{.tex}
for tex, etc).
@item --ps
> and prints page number -1 on the second page, for example.
-- default paper size is A4.
-
-
In 5.2.1 the @refbugs (line 495 in spacing.itely on master) it
states:
@end ignore
+
@node Spacing issues
@chapter Spacing issues
be placed in either.
@menu
-* Paper and pages::
+* Paper and pages::
* Music layout::
* Breaks::
* Vertical spacing::
within which music can be printed.
@menu
-* Paper size::
-* Page formatting::
+* Paper size::
+* Page formatting::
@end menu
@cindex paper size
@cindex page size
-@funindex papersize
-To change the paper size, there are two commands,
+Two functions are available for changing the paper size:
+@code{set-default-paper-size} and @code{set-paper-size}.
+@code{set-default-paper-size} may be placed in a @code{\paper}
+block or in the toplevel scope, and @code{set-paper-size} must be
+placed in a @code{\paper} block:
+
@example
#(set-default-paper-size "a4")
@end example
+
@example
\paper @{
#(set-paper-size "a4")
@}
@end example
-The first command sets the size of all pages. The second command sets the
-size
-of the pages that the @code{\paper} block applies to -- if the @code{\paper}
-block is at the top of the file, then it will apply to all pages. If the
-@code{\paper} block is inside a @code{\book}, then the paper size will only
-apply to that book.
+@noindent
+@code{set-default-paper-size} sets the size of all pages, whereas
+@code{set-paper-size} only sets the size of the pages that the
+@code{\paper} block applies to. For example, if the @code{\paper}
+block is at the top of the file, then it will apply the paper size
+to all pages. If the @code{\paper} block is inside a
+@code{\book}, then the paper size will only apply to that book.
+
+Common paper sizes are available, including @code{a4},
+@code{letter}, @code{legal}, and @code{11x17} (also known as
+tabloid). Many more paper sizes are supported by default. For
+details, see @file{scm/@/paper@/.scm}, and search for the
+definition of @code{paper-alist}.
-Support for the following paper sizes are included by default,
-@code{a6}, @code{a5}, @code{a4}, @code{a3}, @code{legal}, @code{letter},
-@code{11x17} (also known as tabloid).
+@c TODO add a new appendix for paper sizes (auto-generated) -pm
-@c TODO Add new paper sizes -td
+@warning{The default paper size is @code{a4}.}
-Extra sizes may be added by editing the definition for
-@code{paper-alist} in the initialization file @file{scm/paper.scm}.
+Extra sizes may be added by editing the definition of
+@code{paper-alist} in the initialization file
+@file{scm/@/paper@/.scm}, however they will be overridden on a
+subsequent install.
@cindex orientation
@cindex landscape
-If the symbol @code{landscape} is supplied as an argument to
-@code{set-default-paper-size}, the pages will be rotated by 90 degrees,
-and wider line widths will be set correspondingly.
+If the symbol @code{'landscape} is supplied as an argument to
+@code{set-default-paper-size}, pages will be rotated by 90
+degrees, and wider line widths will be set accordingly.
@example
#(set-default-paper-size "a6" 'landscape)
@end example
-Setting the paper size will adjust a number of @code{\paper} variables
-(such as margins). To use a particular paper size with altered
-@code{\paper} variables, set the paper size before setting the variables.
+Setting the paper size will adjust a number of @code{\paper}
+variables, such as margins. To use a particular paper size with
+altered @code{\paper} variables, set the paper size before setting
+the variables.
-@node Page formatting
-@subsection Page formatting
-
-@cindex page formatting
-@cindex margins
-@cindex header, page
-@cindex footer, page
-
-LilyPond will do page layout, set margins, and add headers and
-footers to each page.
+@seealso
-The default layout responds to the following settings in the
-@code{\paper} block.
+Installed Files:
+@file{scm/@/paper@/.scm}.
-@funindex \paper
+Snippets:
+@rlsr{Spacing}.
-@quotation
-@table @code
-@funindex first-page-number
-@item first-page-number
-The value of the page number of the first page. Default is@tie{}1.
-@funindex print-first-page-number
-@item print-first-page-number
-If set to true, will print the page number in the first page. Default is
-false.
+@node Page formatting
+@subsection Page formatting
-@funindex print-page-number
-@item print-page-number
-If set to false, page numbers will not be printed. Default is true.
+Margins, headers, and footers and other layout variables are
+automatically set according to the paper size.
-@funindex paper-width
-@item paper-width
-The width of the page. The default is taken from the current paper size,
-see @ref{Paper size}.
+This section lists and describes a number of paper variables that
+may be altered.
-@funindex paper-height
-@item paper-height
-The height of the page. The default is taken from the current paper size,
-see @ref{Paper size}.
+@menu
+* Vertical dimensions::
+* Horizontal dimensions::
+* Other layout variables::
+@end menu
-@funindex top-margin
-@item top-margin
-Margin between header and top of the page. Default is@tie{}5mm.
-@funindex bottom-margin
-@item bottom-margin
-Margin between footer and bottom of the page. Default is@tie{}6mm.
+@node Vertical dimensions
+@unnumberedsubsubsec Vertical dimensions
-@funindex left-margin
-@item left-margin
-Margin between the left side of the page and the beginning of the
-music. Unset by default, which means that the margins is determined
-based on the @code{paper-width} and @code{line-width} to center the
-score on the paper.
+These variables are used to set different vertical dimensions on a
+page:
-@funindex line-width
-@item line-width
-The length of the systems. Default is @code{paper-width} minus @tie{}20mm.
+@funindex \paper
-@funindex head-separation
-@item head-separation
-Distance between the top-most music system and the page header. Default
-is@tie{}4mm.
+@table @code
-@funindex foot-separation
-@item foot-separation
-Distance between the bottom-most music system and the page
-footer. Default is@tie{}4mm.
+@item after-title-space
+@funindex after-title-space
-@funindex page-top-space
-@item page-top-space
-Distance from the top of the printable area to the center of the first
-staff. This only works for staves which are vertically small. Big staves
-are set with the top of their bounding box aligned to the top of the
-printable area. Default is@tie{}12mm.
+The amount of space between the title and the first system.
+Default: @code{5\mm}.
-@funindex ragged-bottom
-@item ragged-bottom
-If set to true, systems will not be spread vertically across the page. This
-does not affect the last page. Default is false.
+@item before-title-space
+@funindex before-title-space
-This should be set to true for pieces that have only two or three
-systems per page, for example orchestral scores.
+Amount of space between the last system of the previous piece and the
+title of the next. Default: @code{10\mm}.
-@funindex ragged-last-bottom
-@item ragged-last-bottom
-If set to false, systems will be spread vertically to fill the last
-page. Default is true.
+@item between-system-padding
+@funindex between-system-padding
-Pieces that amply fill two pages or more should have this set to
-true.
+The minimum amount of white space that will always be present
+between the bottom-most symbol of one system, and the top-most of
+the next system. Default: @code{4\mm}.
-@funindex system-count
-@item system-count
-This variable, if set, specifies into how many lines a score should be
-broken. Unset by default.
+Increasing this will put systems whose bounding boxes almost touch
+farther apart.
-@funindex between-system-space
@item between-system-space
-This dimensions determines the distance between systems. It is the
-ideal distance between the center of the bottom staff of one system
-and the center of the top staff of the next system. Default is@tie{}20mm.
+@funindex between-system-space
-Increasing this will provide a more even appearance of the page at the
-cost of using more vertical space.
+The distance between systems. It is the ideal distance between
+the center of the bottom staff of one system and the center of the
+top staff of the next system. Default: @code{20\mm}.
-@funindex between-system-padding
-@item between-system-padding
-This dimension is the minimum amount of white space that will always
-be present between the bottom-most symbol of one system, and the
-top-most of the next system. Default is@tie{}4mm.
+Increasing this value will provide a more even appearance of the
+page at the cost of using more vertical space.
-Increasing this will put systems whose bounding boxes almost touch
-farther apart.
+@item between-title-space
+@funindex between-title-space
-@funindex page-breaking-between-system-padding
-@item page-breaking-between-system-padding
-This variable tricks the page breaker into thinking that
-@code{between-system-padding} is set to something different than it
-really is. For example, if this variable is set to something substantially
-larger than @code{between-system-padding}, then the page-breaker will put
-fewer systems on each page.
+Amount of space between consecutive titles (e.g., the title of the
+book and the title of a piece). Default: @code{2\mm}.
-@funindex horizontal-shift
-@item horizontal-shift
-All systems (including titles and system separators) are shifted by
-this amount to the right. Page markup, such as headers and footers are
-not affected by this. The purpose of this variable is to make space
-for instrument names at the left. Default is@tie{}0.
+@item bottom-margin
+@funindex bottom-margin
-@funindex after-title-space
-@item after-title-space
-Amount of space between the title and the first system. Default is@tie{}5mm.
+The margin between footer and bottom of the page. Default:
+@code{6\mm}.
-@funindex before-title-space
-@item before-title-space
-Amount of space between the last system of the previous piece and the
-title of the next. Default is@tie{}10mm.
+@item foot-separation
+@funindex foot-separation
-@funindex between-title-space
-@item between-title-space
-Amount of space between consecutive titles (e.g., the title of the
-book and the title of a piece). Default is@tie{}2mm.
+Distance between the bottom-most music system and the page
+footer. Default: @code{4\mm}.
-@funindex printallheaders
-@item printallheaders
-Setting this to #t will print all headers for each \score in the
-output. Normally only the piece and opus \headers are printed.
+@item head-separation
+@funindex head-separation
-@funindex systemSeparatorMarkup
-@item systemSeparatorMarkup
-This contains a markup object, which will be inserted between
-systems. This is often used for orchestral scores. Unset by default.
+Distance between the top-most music system and the page header.
+Default: @code{4\mm}.
-The markup command @code{\slashSeparator} is provided as a sensible
-default, for example
+@item page-top-space
+@funindex page-top-space
-@lilypond[ragged-right]
-#(set-default-paper-size "a6" 'landscape)
-\book {
- \score {
- \relative { c1 \break c1 }
- }
- \paper {
- systemSeparatorMarkup = \slashSeparator
- }
-}
-@end lilypond
+Distance from the top of the printable area to the center of the
+first staff. This only works for staves that are vertically
+small. Big staves are set with the top of their bounding box
+aligned to the top of the printable area. Default: @code{12\mm}.
-@funindex blank-page-force
-@item blank-page-force
-The penalty for having a blank page in the middle of a
-score. This is not used by @code{ly:optimal-breaking} since it will
-never consider blank pages in the middle of a score. Default value
-is 10.
+@item paper-height
+@funindex paper-height
-@funindex blank-last-page-force
-@item blank-last-page-force
-The penalty for ending the score on an odd-numbered page.
-Default value is 0.
+The height of the page. Default: the height of the current paper
+size. For details, see @ref{Paper size}.
-@funindex page-spacing-weight
-@item page-spacing-weight
-The relative importance of page (vertical) spacing and line (horizontal)
-spacing. High values will make page spacing more important. Default
-value is 10.
+@item top-margin
+@funindex top-margin
-@funindex auto-first-page-number
-@item auto-first-page-number
-The page breaking algorithm is affected by the first page number being
-odd or even. If this variable is set to #t, the page breaking algorithm
-will decide whether to start with an odd or even number. This will
-result in the first page number remaining as is or being increased by one.
+The margin between header and top of the page. Default:
+@code{5\mm}.
@end table
-@end quotation
@snippets
page given the system to put on it.
+@seealso
+
+Notation Reference:
+@ref{Vertical spacing between systems}.
+
+Snippets:
+@rlsr{Spacing}.
+
+
+@node Horizontal dimensions
+@unnumberedsubsubsec Horizontal dimensions
+
+@warning{If @code{paper-width} is manually set, @code{line-width},
+@code{left-margin}, @code{indent}, and @code{short-indent} may
+have to be adjusted as well.}
+
+There are a few variables that determine the horizontal dimensions
+on a page:
+
+@table @code
+
+@item horizontal-shift
+@funindex horizontal-shift
+
+The amount that all systems (including titles and system
+separators) are shifted to the right. Default: @code{0.0}.
+
+@item indent
+@funindex indent
+
+The level of indentation for the first system in a score.
+Default: @code{paper-width} divided by @code{14}, as determined by
+@code{set-default-paper-size} or @code{set-paper-size}.
+
+@item left-margin
+@funindex left-margin
+
+The margin between the left edge of the page and the beginning of
+each system. Default: @code{10\mm}, as determined by
+@code{set-default-paper-size} or @code{set-paper-size}.
+
+@item line-width
+@funindex line-width
+
+The width of music systems. Default: @code{paper-width} minus
+@code{20\mm}, as determined by @code{set-default-paper-size} or
+@code{set-paper-size}.
+
+@item paper-width
+@funindex paper-width
+
+The width of the page. Default: the width of the current paper
+size. For details, see @ref{Paper size}.
+
+@item short-indent
+@funindex short-indent
+
+The level of indentation for all systems in a score besides the
+first system. Default: @code{0}, as determined by
+@code{set-default-paper-size} or @code{set-paper-size}.
+
+@end table
+
+
+@seealso
+
+Snippets:
+@rlsr{Spacing}.
+
+
@knownissues
-The option right-margin is defined but doesn't set the right margin
-yet. The value for the right margin has to be defined adjusting the
-values of @code{left-margin} and @code{line-width}.
+The option @code{right-margin} is defined but doesn't set the
+right margin yet. The value for the right margin has to be
+defined by adjusting the values of @code{left-margin} and
+@code{line-width}.
+
+
+@node Other layout variables
+@unnumberedsubsubsec Other layout variables
+
+These variables can be used to adjust page layout in general.
+
+@table @code
+
+@item auto-first-page-number
+@funindex auto-first-page-number
+
+The page breaking algorithm is affected by the first page number
+being odd or even. If set to true, the page breaking algorithm
+will decide whether to start with an odd or even number. This
+will result in the first page number remaining as is or being
+increased by one. Default: @code{##f}.
+
+@item blank-last-page-force
+@funindex blank-last-page-force
+
+The penalty for ending the score on an odd-numbered page.
+Default: @code{0}.
+
+@item blank-page-force
+@funindex blank-page-force
+
+The penalty for having a blank page in the middle of a
+score. This is not used by @code{ly:optimal-breaking} since it will
+never consider blank pages in the middle of a score. Default:
+@code{5}.
+
+@item blank-after-score-page-force
+@funindex blank-after-score-page-force
+
+TODO. Default: @code{2}.
+
+@item first-page-number
+@funindex first-page-number
+
+The value of the page number on the first page. Default:
+@code{#1}.
+
+@item packed
+@funindex packed
+
+TODO
+
+@item page-breaking-between-system-padding
+@funindex page-breaking-between-system-padding
+
+Tricks the page breaker into thinking that
+@code{between-system-padding} is set to something different than
+it really is. For example, if this variable is set to something
+substantially larger than @code{between-system-padding}, then the
+page-breaker will put fewer systems on each page. Default: unset.
+
+@item page-count
+@funindex page-count
+
+TODO
+
+@item page-limit-inter-system-space
+@funindex page-limit-inter-system-space
+
+If set to true, limits space between systems on a page with a lot
+of space left. Default: @code{##f}. For details, see
+@ref{Vertical spacing between systems}.
+
+@item page-limit-inter-system-space-factor
+@funindex page-limit-inter-system-space-factor
+
+The factor used by @code{page-limit-inter-system-space}. Default:
+@code{1.4}. For details, see
+@ref{Vertical spacing between systems}.
+
+@item page-spacing-weight
+@funindex page-spacing-weight
+
+The relative importance of page (vertical) spacing and line
+(horizontal) spacing. High values will make page spacing more
+important. Default: @code{#10}.
+
+@item printallheaders
+@funindex printallheaders
+
+If set to true, this will print all headers for each \score in the
+output. Normally only the piece and opus header variables are
+printed. Default: @code{##f}.
+
+@item print-first-page-number
+@funindex print-first-page-number
+
+If set to true, a page number is printed on the first page.
+Default: @code{##f}.
+
+@item print-page-number
+@funindex print-page-number
+
+If set to false, page numbers are not printed. Default:
+@code{##t}.
+
+@item ragged-bottom
+@funindex ragged-bottom
+
+If set to true, systems will not spread vertically across the
+page. This does not affect the last page. Default: @code{##f}.
+
+This should be set to true for pieces that have only two or three
+systems per page, for example orchestral scores.
+
+@item ragged-last
+@funindex ragged-last
+
+If set to true, the last system in the score will not fill the
+line width. Instead the last system ends at its natural
+horizontal length. Default: @code{##f}.
+
+@item ragged-last-bottom
+@funindex ragged-last-bottom
+
+If set to false, systems will spread vertically across the last
+page. Default: @code{##t}.
+
+Pieces that amply fill two pages or more should have this set to
+true.
+
+@item ragged-right
+@funindex ragged-right
+
+If set to true, systems will not fill the line width. Instead,
+systems end at their natural horizontal length. Default:
+@code{##f}.
+
+If the score has only one system, the default value is @code{##t}.
+
+@item systemSeparatorMarkup
+@funindex systemSeparatorMarkup
+
+A markup object that is inserted between systems. This is often
+used for orchestral scores. Default: unset.
+
+The markup command @code{\slashSeparator} is provided as a sensible
+default, for example
+
+@lilypond[quote,ragged-right]
+#(set-default-paper-size "a6" 'landscape)
+\book {
+ \score {
+ \relative { c1 \break c1 }
+ }
+ \paper {
+ systemSeparatorMarkup = \slashSeparator
+ }
+}
+@end lilypond
+
+@item system-count
+@funindex system-count
+
+The number of systems to be used for a score.
+Default: unset.
+
+@end table
+
+
+@seealso
+
+Snippets:
+@rlsr{Spacing}.
+
+
+@knownissues
The default page header puts the page number and the @code{instrument}
field from the @code{\header} block on a line.
@end example
+
@seealso
-This manual: @ref{Selecting notation font size}.
+Notation Reference:
+@ref{Selecting notation font size}.
+
+Snippets:
+@rlsr{Spacing}.
@knownissues
@seealso
-This manual: @ref{Changing context default settings}.
+Notation Reference:
+@ref{Changing context default settings}.
+
+Snippets:
+@rlsr{Spacing}.
@node Breaks
* Using an extra voice for breaks::
@end menu
+
@node Line breaking
@subsection Line breaking
>>
@end example
+@c TODO Check this
+A linebreaking configuration can be saved as a @code{.ly} file
+automatically. This allows vertical alignments to be stretched to
+fit pages in a second formatting run. This is fairly new and
+complicated. More details are available in
+@rlsr{Spacing}.
+
+
@predefined
-@code{\break}, and @code{\noBreak}.
@funindex \break
+@code{\break},
@funindex \noBreak
+@code{\noBreak}.
+
@seealso
-Internals: @rinternals{LineBreakEvent}.
+Internals Reference:
+@rinternals{LineBreakEvent}.
-@c TODO Check this
-A linebreaking configuration can be saved as a @code{.ly} file
-automatically. This allows vertical alignments to be stretched to
-fit pages in a second formatting run. This is fairly new and
-complicated. More details are available in
+Snippets:
@rlsr{Spacing}.
+
@knownissues
Line breaks can only occur if there is a @q{proper} bar line. A note
@code{optimal-page-breaks}. If you are having trouble with the new page
breakers, you can enable the old one as a workaround.
+
@predefined
@funindex \pageBreak
-@code{\pageBreak}
+@code{\pageBreak},
@funindex \noPageBreak
-@code{\noPageBreak}
+@code{\noPageBreak}.
+
+
+@seealso
+
+Snippets:
+@rlsr{Spacing}.
@node Optimal page breaking
@code{ly:page-turn-breaking}, it has no concept of page turns.
+@seealso
+
+Snippets:
+@rlsr{Spacing}.
+
+
@node Optimal page turning
@subsection Optimal page turning
@code{\allowPageTurn}, may also be used at top-level, between scores and
top-level markups.
+
@predefined
@funindex \pageTurn
-@code{\pageTurn}
+@code{\pageTurn},
@funindex \noPageTurn
-@code{\noPageTurn}
+@code{\noPageTurn},
@funindex \allowPageTurn
-@code{\allowPageTurn}
+@code{\allowPageTurn}.
+
+
+@seealso
+
+Snippets:
+@rlsr{Spacing}.
+
@knownissues
There should only be one @code{Page_turn_engraver} in a score. If there is more
than one, they will interfere with each other.
+
@node Minimal page breaking
@subsection Minimal page breaking
@}
@end example
+
+@seealso
+
+Snippets:
+@rlsr{Spacing}.
+
+
@node Explicit breaks
@subsection Explicit breaks
@end lilypond
+@seealso
+
+Snippets:
+@rlsr{Spacing}.
+
+
@node Using an extra voice for breaks
@subsection Using an extra voice for breaks
This makes @code{\break} and @code{\pageBreak} commands easy to enter but mixes
music entry with information that specifies how music should lay out
on the page. You can keep music entry and line- and page-breaking
-information in two separate places by introducing an extra voice to
+information in two separate places by introducing an extra voice to
contain the breaks. This extra voice
contains only skips together with @code{\break}, @code{pageBreak} and other
breaking layout information.
@end lilypond
+@seealso
+
+Notation Reference:
+@ref{Vertical spacing}.
+
+Snippets:
+@rlsr{Spacing}.
+
+
@node Vertical spacing
@section Vertical spacing
staves inside a system.
@menu
-* Vertical spacing inside a system::
-* Vertical spacing between systems::
-* Explicit staff and system positioning::
-* Two-pass vertical spacing::
-* Vertical collision avoidance::
+* Vertical spacing inside a system::
+* Vertical spacing between systems::
+* Explicit staff and system positioning::
+* Two-pass vertical spacing::
+* Vertical collision avoidance::
@end menu
}
@end lilypond
+Vertical alignment of staves is handled by the
+@code{VerticalAlignment} object. The context parameters
+specifying the vertical extent are described in connection with
+the @code{Axis_group_engraver}.
+
+
@seealso
-Internals: Vertical alignment of staves is handled by the
-@rinternals{VerticalAlignment} object. The context parameters
-specifying the vertical extent are described in connection with
-the @rinternals{Axis_group_engraver}.
+Snippets:
+@rlsr{Spacing}.
-Example files: @c @lsr{spacing,page-spacing.ly},
+@c @lsr{spacing,page-spacing.ly},
@c @lsr{spacing,alignment-vertical-spacing.ly}.
+Internals Reference:
+@rinternals{VerticalAlignment},
+@rinternals{Axis_group_engraver}.
+
@node Vertical spacing between systems
@subsection Vertical spacing between systems
}
@end lilypond
+
+@seealso
+
+Snippets:
+@rlsr{Spacing}.
+
+
@node Explicit staff and system positioning
@subsection Explicit staff and system positioning
@code{NonMusicalPaperColumn #'line-break-system-details} accepts an associative
list of five different settings:
-@itemize
+@itemize
@item @code{X-offset}
@item @code{Y-offset}
@item @code{alignment-offsets}
@end itemize
+@seealso
+
+Snippets:
+@rlsr{Spacing}.
+
+
@node Two-pass vertical spacing
@subsection Two-pass vertical spacing
-Warning: two-pass vertical spacing is deprecated and will be removed in
+@warning{Two-pass vertical spacing is deprecated and will be removed in
a future version of LilyPond. Systems are now stretched automatically
-in a single pass. See @ref{Vertical spacing inside a system}.
+in a single pass. See @ref{Vertical spacing inside a system}.}
In order to automatically stretch systems so that they should fill the
space left on a page, a two-pass technique can be used:
@end example
+@seealso
+
+Snippets:
+@rlsr{Spacing}.
+
+
@node Vertical collision avoidance
@subsection Vertical collision avoidance
\once \override TextScript #'outside-staff-priority = #1
c4_"Text"\pp % this time the text will be closer to the staff
r2.
-% by setting outside-staff-priority to a non-number,
+% by setting outside-staff-priority to a non-number,
% we disable the automatic collision avoidance
\once \override TextScript #'outside-staff-priority = ##f
\once \override DynamicLineSpanner #'outside-staff-priority = ##f
@end lilypond
+@seealso
+
+Snippets:
+@rlsr{Spacing}.
+
@node Horizontal spacing
-@section Horizontal Spacing
+@section Horizontal spacing
@cindex horizontal spacing
@cindex spacing, horizontal
@menu
-* Horizontal spacing overview::
-* New spacing area::
-* Changing horizontal spacing::
-* Line length::
-* Proportional notation::
+* Horizontal spacing overview::
+* New spacing area::
+* Changing horizontal spacing::
+* Line length::
+* Proportional notation::
@end menu
@seealso
-Internals: @rinternals{SpacingSpanner}, @rinternals{NoteSpacing},
-@rinternals{StaffSpacing}, and @rinternals{SeparationItem}.
+Snippets:
+@rlsr{Spacing}.
+
+Internals Reference:
+@rinternals{SpacingSpanner},
+@rinternals{NoteSpacing},
+@rinternals{StaffSpacing},
+@rinternals{SeparationItem}.
@knownissues
@subsection New spacing area
New sections with different spacing parameters can be started with
-@code{newSpacingSection}. This is useful when there are
+@code{newSpacingSection}. This is useful when there are
sections with a different notions of long and short notes.
In the following example, the time signature change introduces a new
@lilypond[relative,fragment,verbatim,quote]
\time 2/4
-c4 c8 c
+c4 c8 c
c8 c c4 c16[ c c8] c4
\newSpacingSection
\time 4/16
c16[ c c8]
@end lilypond
-
The @code{\newSpacingSection} command creates a new
-@rinternals{SpacingSpanner} object, and hence new @code{\override}s
+@code{SpacingSpanner} object, and hence new @code{\override}s
may be used in that location.
+@seealso
+
+Snippets:
+@rlsr{Spacing}.
+
+Internals Reference:
+@rinternals{SpacingSpanner}.
+
+
@node Changing horizontal spacing
@subsection Changing horizontal spacing
>>
@end lilypond
-
When @code{strict-note-spacing} is set, notes are spaced without
regard for clefs, bar lines, and grace notes,
@end lilypond
+@seealso
+
+Snippets:
+@rlsr{Spacing}.
+
+
@node Line length
@subsection Line length
@end example
+@seealso
+
+Snippets:
+@rlsr{Spacing}.
+
+
@node Proportional notation
@subsection Proportional notation
for these related settings.
+@seealso
+
+Notation Reference:
+@ref{New spacing area}.
+
+Snippets:
+@rlsr{Spacing}.
+
+
@node Fitting music onto fewer pages
@section Fitting music onto fewer pages
interval.
+@seealso
+
+Snippets:
+@rlsr{Spacing}.
+
+
@node Changing spacing
@subsection Changing spacing
Notation Reference:
@ref{Page formatting},
@ref{Changing horizontal spacing}.
+
+Snippets:
+@rlsr{Spacing}.
@node Displaying staves
@subsection Displaying staves
-This section shows the different possibilities of creating and
+This section describes the different methods of creating and
grouping staves, which are marked at the beginning of each line
with either a bracket or a brace.
music: @code{MensuralStaff} and @code{VaticanaStaff}. They are
described in @ref{Pre-defined contexts}.
-Staves can be started or stopped at any point in the score. The
-commands @code{\startStaff} and @code{\stopStaff} are used for
-this purpose. For details, see @ref{Staff symbol}.
+New single staff contexts may be defined. For details, see
+@ref{Defining new contexts}.
@seealso
@ref{Pre-defined contexts},
@ref{Staff symbol},
@ref{Gregorian chant contexts},
-@ref{Mensural contexts}.
+@ref{Mensural contexts},
+@ref{Defining new contexts}.
Snippets:
@rlsr{Staff notation}.
@code{SystemStartSquare}, is also available, but it must be
explicitly specified.
+New staff group contexts may be defined. For details, see
+@ref{Defining new contexts}.
+
@snippets
@rglos{grand staff}.
Notation Reference:
-@ref{Instrument names}.
+@ref{Instrument names},
+@ref{Defining new contexts}.
Snippets:
@rlsr{Staff notation}.
>>
@end lilypond
+New nested staff group contexts can be defined. For details, see
+@ref{Defining new contexts}.
+
@snippets
Notation Reference:
@ref{Grouping staves},
-@ref{Instrument names}.
+@ref{Instrument names},
+@ref{Defining new contexts}.
Snippets:
@rlsr{Staff notation}.
@warning{The @code{'line-positions} property overrides the
@code{'line-count} property. The number of staff lines is
implicitly defined by the number of elements in the list of values
-for @code{'line-positions}}
+for @code{'line-positions}.}
@lilypond[verbatim,quote,relative=1]
\new Staff \with {
{ e4 d c b }
@end lilypond
-The distance between staff lines can be changed. This setting has
-influence on ledger lines as well.
+The distance between staff lines can be changed. This setting
+affects the spacing of ledger lines as well.
@lilypond[verbatim,quote,relative=1]
\new Staff \with {
@end lilypond
The width of a staff can be modified. The unit is one staff
-space. The spacing of objects inside the staff is not influenced
-by this setting.
+space. The spacing of objects inside the staff is not affected by
+this setting.
@lilypond[verbatim,quote,relative=1]
\new Staff \with {
a2 a
@end lilypond
+@cindex stopping a staff
+
+@noindent
+In general, @code{\startStaff} and @code{\stopStaff} can be used
+to stop or start a staff in the middle of a score.
+
+@lilypond[verbatim,quote,relative=2]
+c4 b a2
+\stopStaff
+b4 c d2
+\startStaff
+e4 d c2
+@end lilypond
+
@predefined
@rglos{staff}.
Notation Reference:
-@ref{Displaying pitches}.
+@ref{Clef}.
Snippets:
@rlsr{Staff notation}.
}
@end lilypond
+@noindent
However, the above example is usually not the desired result. To
create ossia staves that are above the original staff, have no
time signature or clef, and have a smaller font size, tweaks must
>>
@end lilypond
-@c The following is the legacy "ossia.ly" example
-@c
-@c I don't think this method is very efficient.
-@c I'm commenting it out for now. -pm
-
-@ignore
-
-@ lilypond[verbatim,quote]
-<<
- \new Staff \with
- {
- %No time signature in the ossia staff
- \remove "Time_signature_engraver"
- fontSize = #-3
- \override StaffSymbol #'staff-space = #(magstep -3)
- \override StaffSymbol #'thickness = #(magstep -3)
- firstClef = ##f
- }
- \relative c'' {
- \stopStaff
- \skip 2
-
- \startStaff
- \clef treble
- bes8[^"ossia" g bes g]
- \stopStaff
-
- s2
-
- \startStaff
- f8 d g4
- }
- \new Staff \relative c'' {
- \time 2/4
- c4 c g' g a a g2
- }
->>
-@ end lilypond
-
-@end ignore
-
Using the @code{\RemoveEmptyStaffContext} command to create ossia
staves may be used as an alternative. This method is most
convenient when ossia staves occur immediately following a line
@rlearning{Length and thickness of objects}.
Notation Reference:
-@ref{Setting the staff size}.
+@ref{Hiding staves}.
Snippets:
@rlsr{Staff notation}.
Empty staves can be hidden by setting the
@code{\RemoveEmptyStaffContext} command in the @code{\layout}
block. In orchestral scores, this style is known as @q{Frenched
-Score}. By default, this command hides all empty staves in a
-score except for those in the first system.
+Score}. By default, this command hides and removes all empty
+staves in a score except for those in the first system.
@warning{An empty staff may only include multi-measure rests,
-skips, spacer rests, or a combination of these.}
+skips, spacer rests, or a combination of these elements.}
@lilypond[verbatim,quote,ragged-right]
\layout {
\RemoveEmptyStaffContext
}
}
+
\relative c' <<
\new Staff {
e4 f g a \break
@cindex ossia
+@noindent
@code{\RemoveEmptyStaffContext} can also be used to create ossia
sections for a staff. For details, see @ref{Ossia staves}.
@rinternals{FiguredBass},
@rinternals{Lyrics},
@rinternals{Staff},
-@rinternals{VerticalAxisGroup}.
+@rinternals{VerticalAxisGroup},
+@rinternals{Staff_symbol_engraver}.
+
+
+@knownissues
+
+Removing @code{Staff_symbol_engraver} also hides bar lines. If
+bar line visibility is forced, formatting errors may occur. In
+this case, use the following overrides instead of removing the
+engraver:
+
+@example
+\override StaffSymbol #'stencil = ##f
+\override NoteHead #'no-ledgers = ##t
+@end example
@node Writing parts
@cindex instrument names
@cindex instrument names, short
-Instrument names can be printed on the left side of staves for the
+Instrument names can be printed on the left side of staves in the
@code{Staff} and @code{PianoStaff} contexts. The value of
@code{instrumentName} is used for the first staff, and the value
of @code{shortInstrumentName} is used for all succeeding staves.
However, if the instrument names are longer, the instrument names
in a staff group may not be centered unless the @code{indent} and
-@code{short-indent} settings are increased. The @code{indent} and
-@code{short-indent} settings are modified in the @code{\layout}
-block and specify the level of indentation for the first system
-and all succeeding systems, respectively.
+@code{short-indent} settings are increased. For details about
+these settings, see @ref{Page formatting}.
@lilypond[verbatim,quote,ragged-right]
\layout {
c1 c c c \break
@end lilypond
+@cindex instrument switch
+@cindex switching instruments
+
+If an instrument @emph{switch} is needed,
+@code{\addInstrumentDefinition} may be used in combination with
+@code{\instrumentSwitch} to create a detailed list of the
+necessary changes for the switch. The
+@code{\addInstrumentDefinition} command has two arguments: an
+identifying string, and an alist of context properties and values
+to be used for the instrument. It must be placed in the toplevel
+scope. @code{\instrumentSwitch} is used in the music expression
+to declare the instrument switch:
+
+@lilypond[verbatim,quote,ragged-right]
+\addInstrumentDefinition #"contrabassoon"
+ #`((instrumentTransposition . ,(ly:make-pitch -1 0 0))
+ (shortInstrumentName . "Cbsn.")
+ (clefGlyph . "clefs.F")
+ (middleCPosition . 6)
+ (clefPosition . 2)
+ (instrumentCueName . ,(make-bold-markup "cbsn."))
+ (midiInstrument . "bassoon"))
+
+\new Staff \with {
+ instrumentName = "Bassoon"
+}
+\relative c' {
+ \clef tenor
+ \compressFullBarRests
+ c2 g'
+ R1*16
+ \instrumentSwitch "contrabassoon"
+ c,,2 g \break
+ c,1 ~ | c1
+}
+@end lilypond
+
@seealso
Notation Reference:
+@ref{Page formatting},
@ref{Modifying context plug-ins}.
Snippets:
@cindex fragments
@cindex cue notes
-Quotations allow fragments of other parts to be inserted directly
-into a music expression. Before a part can be quoted, the
-@code{\addQuote} command must be used to initialize the quoted
-fragment. This command must be used in the toplevel scope. The
-first argument is an identifying string, and the second is a music
-expression:
+Fragments of other parts can be inserted directly into a music
+expression; this is called @emph{quotation}. Before a part can be
+quoted, the @code{\addQuote} command must be used to initialize
+the quoted fragment. This command must be used in the toplevel
+scope. The first argument is an identifying string, and the
+second is a music expression:
@example
-flute = \relative c' @{
- f4 fis g gis
+flute = \relative c'' @{
+ a4 gis g gis
@}
\addQuote "flute" @{ \flute @}
@end example
-The @code{\quoteDuring} command may then be used to indicate when
-the quotation should take place. The corresponding measures from
-the quotation are inserted into the music expression. The syntax
-is similar to @code{\addQuote}:
+The @code{\quoteDuring} command is used to indicate when the
+quotation should take place. The corresponding measures from the
+quotation are inserted into the music expression. The syntax is
+similar to @code{\addQuote}:
@lilypond[verbatim,quote]
-flute = \relative c' {
- f4 fis g gis
+flute = \relative c'' {
+ a4 gis g gis
}
\addQuote "flute" { \flute }
situation is created, which is often not desirable:
@lilypond[verbatim,quote]
-flute = \relative c' {
- f4 fis g gis
+flute = \relative c'' {
+ a4 gis g gis
}
\addQuote "flute" { \flute }
@end lilypond
Quotations recognize instrument transposition settings for both
-the source and target instruments if they are specified using the
-@code{\transposition} command:
+the source and target instruments if the @code{\transposition}
+command is used. For details about @code{\transposition}, see
+@ref{Instrument transpositions}.
@lilypond[verbatim,quote]
-clarinet = \relative c' {
+clarinet = \relative c'' {
\transposition bes
- f4 fis g gis
+ a4 gis g gis
}
\addQuote "clarinet" { \clarinet }
}
@end lilypond
+It is possible to tag quotations with unique names in order to
+process them in different ways. For details about this procedure,
+see @ref{Using tags}.
+
@c add to snippets, possibly. It might already be there. -pm
@c
@c The type of events that are present in the quoted music can be
@seealso
Notation Reference:
-@ref{Instrument transpositions}.
+@ref{Instrument transpositions},
+@ref{Using tags}.
Snippets:
@rlsr{Staff notation}.
@cindex quoting other voices
@cindex cues, formatting
-The previous section explains how to quote other voices. The
+The previous section explains how to create quotations. The
@code{\cueDuring} command is a more specialized form of
@code{\quoteDuring}, being particularly useful for inserting cue
notes into a part. The syntax is as follows:
}
@end lilypond
+@noindent
In the above example, the @code{Voice} context had to be
explicitly declared, or else the entire music expression would
belong to the @code{CueVoice} context.
The name of the cued instrument can be printed by setting the
-@code{instrumentCueName} property.
+@code{instrumentCueName} property in the @code{CueVoice} context.
@lilypond[verbatim,quote]
oboe = \relative c''' {
>>
@end lilypond
-The @code{\killCues} command is used to remove the cue notes from
-a music expression.
+In addition to printing the name of the cued instrument, when cue
+notes end, the name of the original instrument should be printed,
+and any other changes introduced by the cued part should be
+undone. This can be accomplished by using
+@code{\addInstrumentDefinition} and @code{\instrumentSwitch}. For
+an example and explanation, see @ref{Instrument names}.
+
+The @code{\killCues} command removes cue notes from a music
+expression. This can be useful if cue notes need to be removed
+from a part but may be restored at a later time.
@lilypond[verbatim,quote]
flute = \relative c''' {
}
@end lilypond
-When typesetting cue notes, some guidelines should be followed:
-
-@itemize
-@item
-The instrument playing the cue should be clearly marked on the
-score.
-
-@item
-When the cue notes end, the name of the original instrument should
-be indicated.
-
-@item
-Any other changes introduced by the cued part should also be
-undone. For example, if the cued instrument plays in a different
-clef, the original clef should be stated once again.
-
-@end itemize
-
-The @code{\transposedCueDuring} command is useful to add cues for
-instruments in a completely different register. The syntax is
-similar to @code{\cueDuring}, but it requires one more argument to
-specify the transposition of the cued instrument. For more
-information about transposition, see
+The @code{\transposedCueDuring} command is useful for adding
+instrumental cues from a completely different register. The
+syntax is similar to @code{\cueDuring}, but it requires one extra
+argument to specify the transposition of the cued instrument. For
+more information about transposition, see
@ref{Instrument transpositions}.
@lilypond[verbatim,quote]
>>
@end lilypond
+It is possible to tag cued parts with unique names in order to
+process them in different ways. For details about this procedure,
+see @ref{Using tags}.
+
@seealso
Notation Reference:
-@ref{Instrument transpositions}.
+@ref{Instrument transpositions},
+@ref{Instrument names},
+@ref{Using tags}.
Snippets:
@rlsr{Staff notation}.
@knownissues
-Collisions are not checked between @code{Voice} and
-@code{CueVoice} contexts.
+Collisions can occur with rests, when using @code{\cueDuring},
+between @code{Voice} and @code{CueVoice} contexts.
#!@PYTHON@
"""
-Postprocess HTML files.
+Postprocess HTML files:
+add footer, tweak links, add language selection menu.
"""
import re
import os
## This is www_post.py. This script is the main stage
## of toplevel GNUmakefile local-WWW-post target.
-# USAGE: www_post PACKAGE_NAME TOPLEVEL_VERSION BUILDSCRIPT-DIR OUTDIR TARGETS
+# USAGE: www_post PACKAGE_NAME TOPLEVEL_VERSION OUTDIR TARGETS
# please call me from top of the source directory
import sys
(base (cadr l)))
(LilyPond-command-expand
(concat (substring string 0 b)
- dir
- base
+ (shell-quote-argument (concat dir base))
(let ((entry (assoc (substring string b e)
LilyPond-expand-alist)))
(if entry (cdr entry) ""))
projects / lilypond.git / commitdiff