1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @c This file is part of lilypond-program.tely
4 Translation of GIT committish: b258483467822a7fee6ec2d060e67e209e456582
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
15 Este capítulo trata sobre varias opciones de configuración, posteriores a la instalación, para
16 LilyPond y otros programas. Este capítulo se puede tratar tranquilamente como una referencia:
17 lea solamente las secciones que le interesen.
20 * Setup for specific Operating Systems::
21 * Text editor support::
26 @node Setup for specific Operating Systems
27 @section Setup for specific Operating Systems
29 Esta sección explica cómo realizar puestas a punto adicionales para sistemas operativos
33 * MacOS X on the command-line::
37 @node MacOS X on the command-line
38 @subsection MacOS X on the command-line
40 Los «scripts» (guiones como lilypond-book, convert-ly, abc2ly e incluso
41 el propio lilypond) van incluidos dentro del archivo de aplicación .app de MacOS X. Se pueden ejecutar a partir de
42 la línea de órdenes invocándolos directamente, p.ej.
45 @var{ruta/hacia}/LilyPond.app/Contents/Resources/bin/lilypond
49 Lo mismo vale para otros scripts de ese directorio, incluidos los guiones
50 lilypond-book, convert-ly, abc2ly, etc.
52 Como alternativa, puede crear scripts que añadan la ruta
53 automáticamente. Cree un directorio para guardar estos guiones,
60 Cree un archivo de nombre @code{lilypond} que contenga
63 exec @var{ruta/hacia}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
66 Cree archivos similares @code{lilypond-book}, @code{convert-ly} y cualesquiera
67 otros programas de apoyo que vaya a utilizar (@code{abc2ly}, @code{midi2ly},
68 etc). Sencillamente, sustituya el fragmento @code{bin/lilypond} por
69 @code{bin/convert-ly} (u otro nombre de programa) en el archivo anterior.
71 Haga ejecutable al archivo,
77 Y ahora añada este directorio a su ruta de ejecución. Modifique (o cree)
78 un archivo llamado @code{.profile} en su directorio personal que contenga
81 export PATH=$PATH:~/bin
85 Este archivo debe acabar con una línea en blanco.
87 Fíjese en que @var{ruta/hacia} será por lo general @code{/Applications/}.
90 @node Text editor support
91 @section Text editor support
96 @cindex modos del editor
97 @cindex sintaxis, resaltado de
98 @cindex colores, sintaxis
100 Existe apoyo por parte de varios editores de texto para LilyPond.
111 @subsection Emacs mode
113 Emacs tiene un @file{lilypond-mode}, que proporciona autocompleción de
114 teclado, sangrado, compensación de paréntesis específica de LilyPond
115 y resaltado de sintaxis con colores, útiles combinaciones de teclas para compilar y leer los manuales de LilyPond
116 utilizando Info. Si el @file{lilypond-mode} no está instalado en su sistema,
119 Está incluido un modo de Emacs para escribir música y ejecutar LilyPond, en
120 el archivo del código fuente dentro del directorio @file{elisp}. Haga @command{make
121 install} para instalarlo dentro de @var{elispdir}. El archivo @file{lilypond-init.el}
122 se debe situar en @var{load-path}@file{/site-start.d/} o añadirse a su
123 @file{~/.emacs} o @file{~/.emacs.el}.
125 Como usuario, puede querer añadir su ruta a las fuentes (p.ej. @file{~/site-lisp/}) a su
126 @var{load-path} añadiendo la siguiente línea (modificada) a su
129 @c any reason we do not advise: (push "~/site-lisp" load-path)
131 (setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))
138 Para @uref{http://@/www@/.vim@/.org,VIM} se proporciona un @file{vimrc},
139 junto con herramientas de resaltado de sintaxis con colores. Se encuentra incluido un modo de Vim para escribir música y
140 ejecutar LilyPond, dentro del archivo de código fuente, en el directorio
143 El tipo de archivo de LilyPond se detecta si el archivo
144 @file{~/.vim/filetype.vim} tiene el siguiente contenido
147 if exists("did_load_filetypes")
150 augroup filetypedetect
151 au! BufNewFile,BufRead *.ly setf lilypond
155 Incluya esta ruta añadiendo la siguiente línea a su
159 set runtimepath+=/usr/local/share/lilypond/$@{LILYPOND_VERSION@}/vim/
163 donde $@{LILYPOND_VERSION@} es su versión de lilypond. Si Lilypond no se instaló
164 en su momento en @file{/usr/local/}, cambie esta ruta de la forma correspondiente.
170 Creado como un «plugin» o añadido para el editor de texto @uref{http://@/www@/.jedit@/.org@/,jEdit},
171 LilyPondTool es la herramienta basada en texto más rica en posibilidades para
172 editar partituras de LilyPond. Sus posibilidades incluyen un Asistente de Documentos con apoyo para las
173 letras de las canciones para preparar documentos más fácilmente, y un visor de PDF empotrado con apoyo
174 avanzado para el uso del cursor del ratón. Para ver capturas de pantalla, demostraciones e
175 instrucciones de instalación, visite
176 @uref{http://lilypondtool@/.organum@/.hu}
182 El editor @uref{http://@/www@/.uoregon@/.edu/~koch/texshop/index@/.html,TexShop}
183 para Mac OS X se puede extender para la ejecución de LilyPond, lilypond-book y
184 convert-ly desde dentro del editor, usando las extensiones disponibles en
185 @uref{http://@/www@/.dimi@/.uniud@/.it/vitacolo/freesoftware@/.html}.
191 Hay un tinglado de LilyPond para TextMate. Se puede instalar ejecutando
194 mkdir -p /Library/Application\ Support/TextMate/Bundles
195 cd /Library/Application\ Support/TextMate/Bundles
196 svn co http://macromates.com/svn/Bundles/trunk/Bundles/Lilypond.tmbundle/
201 @node Point and click
202 @section Point and click
203 @cindex apuntar y pulsar
206 «Point and click» (apuntar y pulsar con el ratón) le da la posibilidad de localizar notas del código de entrada pulsando sobre ellas
207 dentro del visor de PDF. Ello facilita encontrar los fragmentos de la entrada que producen
208 algún tipo de error en la partitura.
210 Cuando esta funcionalidad está activada, LilyPond añade hiper-enlaces al archivo
211 PDF. Estos hiper-enlaces se envían al navegador de web, que a su vez abre un
212 editor de texto con el cursor situado en el lugar correcto.
214 Para conseguir que esta cadena funcione, tendrá que configurar el visor de PDF de forma que
215 siga los hiper-enlaces usando el guión @file{lilypond-invoke-editor} proporcionado
218 Para Xpdf sobre Unix, lo siguiente debe estar presente en
219 @file{xpdfrc}@footnote{En Unix, este archivo se encuentra o bien en
220 @file{/etc/xpdfrc} o como @file{.xpdfrc} en su directorio personal.}
223 urlCommand "lilypond-invoke-editor %s"
226 El programa @file{lilypond-invoke-editor} es un pequeño programa de
227 apoyo. Invoca un editor para las URIs especiales de @code{textedit},
228 y lanza un navegador de web para el resto. Comprueba la variable de entorno
229 @code{EDITOR} en busca de los siguientes patrones,
235 emacsclient --no-wait +@var{line}:@var{column} @var{file}
240 gvim --remote +:@var{line}:norm@var{char} @var{file}
246 nc -noask +@var{line} @var{file}'
250 La variable de entorno @code{LYEDITOR} se utiliza para sobreescribir esto. Contiene
251 la instrucción de línea de órdenes para abrir el editor, donde @code{%(file)s},
252 @code{%(column)s}, @code{%(line)s} se sustituye por el archivo, columna y
253 línea respectivamente. El ajuste
256 emacsclient --no-wait +%(line)s:%(column)s %(file)s
260 para @code{LYEDITOR} equivale a la invocación estándar de
264 @cindex archivo de salida, tamaño del
266 Los enlaces de apuntar y pulsar aumentan significativamente el tamaño de los archivos de salida. Para
267 reducir el tamaño de los archivos PDF y PS, la posibilidad de apuntar y pulsar se puede desactivar
271 #(ly:set-option 'point-and-click #f)
275 dentro de un archivo @file{.ly}. De forma alternativa, puede pasarlo como una opción de
279 lilypond -dno-point-and-click file.ly