Merge branch 'source-lilypond-ejercicios'
[lilypond-ejercicios.git] / apuntes-01-instalacion.tex
blobd37df7b1c565f285bc9aaf0569f198c1e6a68e94
1 % \version "2.17.0"
3 \section{Uso de LilyPond y Frescobaldi bajo Windows}
4 \subsection{Descarga e instalación}
6 Recomendamos utilizar la combinación LilyPond/Frescobaldi para el
7 trabajo con partituras de LilyPond. Ambos están disponibles para su
8 descarga gratuita en las respectivas páginas oficiales de los
9 proyectos, \texttt{lilypond.org} y \texttt{frescobaldi.org}. Después
10 de ejecutar los programas instaladores, las aplicaciones están listas
11 para su uso.
13 %\subsection{Configuración de Frescobaldi}
14 %Después de instalar Frescobaldi y LilyPond, es necesario que el
15 %primero pueda llamar al segundo para procesar las partituras, para lo
16 %que debe estar configurado con la ruta
18 % Opcional, no es seguro, comprobar
20 \subsection{Creación de una partitura sencilla}
22 Ahora comprobaremos si todo nuestro software funciona, con un ejemplo
23 absolutamente mínimo. Abrimos el programa Frescobaldi y escribimos lo
24 siguiente\footnote{Las llaves se consiguen con AltGr pulsando una
25 tecla que en los teclados españoles de PC suele estar junto a la
26 'Ñ'. Los apóstrofos se consiguen mediante la tecla que está justo a
27 la derecha del número 0.}:
29 \begin{quote}
30 \begin{verbatim}
31 { b }
32 \end{verbatim}
33 \end{quote}
35 Denominamos a este texto \emph{código de entrada}.
37 \subsection{Procesar el documento}
39 Los programas Frescobaldi (un editor) y LilyPond (un generador de
40 partituras a partir de un texto) forman una combinación en la que cada
41 uno está especializado en una misión. Si pulsamos en Frescobaldi la
42 combinación de teclas Control+M, éste llama a LilyPond pasándole el
43 documento en curso para que lo convierta en una partitura en formato
44 PDF. Esto se denomina \emph{procesar el código de entrada}, y al PDF
45 resultante le llamamos \emph{la salida}.
47 El procesado tarda un par de segundos\footnote{La primera vez después
48 de haber instalado LilyPond, el programa tiene que preparar las
49 fuentes tipográficas; esto lleva aproximadamente medio minuto, pero
50 las ejecuciones posteriores tardan, como se ha dicho, unos
51 segundos.}. El resultado es un archivo PDF que puede verse en el
52 panel derecho de Vista Previa de la música:
54 \begin[staffsize=15,fragment,quote]{lilypond}
56 \end{lilypond}
58 Podemos guardar este texto con un nombre terminado en la extensión
59 \verb+.ly+, por ejemplo \verb+prueba.ly+. Pulse la combinación de
60 teclas Control+S para hacerlo. Denominaremos a este archivo con la
61 extensión \verb+.ly+ que contiene el código de entrada, \emph{archivo
62 fuente} o \emph{archivo de entrada}. Si pulsamos de nuevo
63 Control+M, el PDF resultante se llamará \verb+prueba.pdf+ y estará
64 localizado en la misma carpeta en que hemos guardado el archivo
65 fuente.
67 Antes de haber guardado el documento, tanto el texto de entrada como
68 el PDF de salida se encuentran en una carpeta temporal, de donde se
69 borrarán al salir del programa Frescobaldi.
71 \subsection{Expresiones musicales de LilyPond}
73 Una partitura completa de LilyPond es un fragmento de música encerrado
74 entre llaves \verb+{ }+, llamado \emph{expresión musical}. En los
75 ejemplos que aparecen en este cuaderno de ejercicios, con frecuencia
76 se omiten las llaves por sencillez, pero no debe olvidarlas cuando
77 inserte el código en sus propios ejercicios.
79 De igual forma que las expresiones matemáticas, en LilyPond podemos
80 ampliar una expresión añadiéndole operadores a la izquierda o
81 combinando varias de ellas en una sola; el ejemplo de este primer
82 ejercicio, sin embargo, es una expresión sencilla. Veremos casos más
83 complejos cuando la música lo requiera.
85 \subsection{Conclusión}
87 Observamos que nuestro código de entrada minimalista se limita a
88 declarar la nota \emph{si} por su nombre anglosajón, ``b'', y que el
89 resultado incluye esta nota (con un valor de negra) y además un
90 pentagrama, una clave de \emph{sol} y un compás de 4/4. Son los
91 valores por omisión, que se dan por supuestos si no los damos
92 explícitamente.
94 Le damos la enhorabuena si ha conseguido completar la primera lección
95 con éxito. En los apartados siguientes vamos a profundizar en la
96 producción de partituras progresivamente más complejas.