1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @c This file is part of lilypond-program.tely
4 Translation of GIT committish: aea9d21f9173e688c4b18b64ef4bf955cd8d2d82
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
13 Este capítulo trata sobre varias opciones de configuración, posteriores a la instalación, para
14 LilyPond y otros programas. Este capítulo se puede tratar tranquilamente como una referencia:
15 lea solamente las secciones que le interesen.
18 * Setup for specific Operating Systems::
19 * Text editor support::
24 @node Setup for specific Operating Systems
25 @section Setup for specific Operating Systems
27 Esta sección explica cómo realizar pùestas a punto adicionales para sistemas operativos
31 * MacOS X on the command-line::
35 @node MacOS X on the command-line
36 @subsection MacOS X on the command-line
38 Los scripts (guiones como lilypond-book, convert-ly, abc2ly e incluso
39 el propio lilypond) van incluidos dentro del archivo de aplicación .app de MacOS X. Se pueden ejecutar a partir de
40 la línea de órdenes invocándolos directamente, p.ej.
43 @var{ruta/hacia}/LilyPond.app/Contents/Resources/bin/lilypond
47 Lo mismo vale para otros scripts de ese directorio, incluidos los guiones
48 lilypond-book, convert-ly, abc2ly, etc.
50 Como alternativa, puede crear scripts que añadan la ruta
51 automáticamente. Cree un directorio para guardar estos guiones,
58 Cree un archivo de nombre @code{lilypond} que contenga
61 exec @var{ruta/hacia}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
64 Cree archivos similares @code{lilypond-book}, @code{convert-ly} y cualesquiera
65 otros programas de apoyo que vaya a utilizar (@code{abc2ly}, @code{midi2ly},
66 etc). Sencillamente, sustituya el fragmento @code{bin/lilypond} por
67 @code{bin/convert-ly} (u otro nombre de programa) en el archivo anterior.
69 Haga ejecutable al archivo,
75 Y ahora añada este directorio a su ruta de ejecución. Modifique (o cree)
76 un archivo llamado @code{.profile} en su directorio personal que contenga
79 export PATH=$PATH:~/bin
83 Este archivo debe acabar con una línea en blanco.
85 Fíjese en que @var{ruta/hacia} será por lo general @code{/Applications/}.
88 @node Text editor support
89 @section Text editor support
95 @cindex syntax coloring
96 @cindex coloring, syntax
98 Existe apoyo por parte de varios editores de texto para LilyPond.
109 @subsection Emacs mode
111 Emacs tiene un @file{lilypond-mode}, que proporciona autocompleción de
112 teclado, sangrado, compensación de paréntesis específica de LilyPond
113 y resaltado de sintaxis con colores, útiles combinaciones de teclas para compilar y leer los manuales de LilyPond
114 utilizando Info. Si el @file{lilypond-mode} no está instalado en su sistema,
117 Está incluido un modo de Emacs para escribir música y ejecutar LilyPond, en
118 el archivo del código fuente dentro del directorio @file{elisp}. Haga @command{make
119 install} para instalarlo dentro de @var{elispdir}. El archivo @file{lilypond-init.el}
120 se debe situar en @var{load-path}@file{/site-start.d/} o añadirse a su
121 @file{~/.emacs} o @file{~/.emacs.el}.
123 Como usuario, puede querer añadir su ruta a las fuentes (p.ej. @file{~/site-lisp/}) a su
124 @var{load-path} añadiendo la siguiente línea (modificada) a su
127 @c any reason we do not advise: (push "~/site-lisp" load-path)
129 (setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))
136 Para @uref{http://@/www@/.vim@/.org,VIM} se proporciona un @file{vimrc},
137 junto con herramientas de resaltado de sintaxis con colores. Se encuentra incluido un modo de Vim para escribir música y
138 ejecutar LilyPond, dentro del archivo de código fuente, en el directorio
141 El tipo de archivo de LilyPond se detecta si el archivo
142 @file{~/.vim/filetype.vim} tiene el siguiente contenido
145 if exists("did_load_filetypes")
148 augroup filetypedetect
149 au! BufNewFile,BufRead *.ly setf lilypond
153 Incluya esta ruta añadiendo la siguiente línea a su
157 set runtimepath+=/usr/local/share/lilypond/$@{LILYPOND_VERSION@}/vim/
161 donde $@{LILYPOND_VERSION@} es su versión de lilypond. Si Lilypond no se instaló
162 en su momento en @file{/usr/local/}, cambie esta ruta de la forma correspondiente.
168 Creado como un plugin o añadido para el editor de texto @uref{http://@/www@/.jedit@/.org@/,jEdit},
169 LilyPondTool es la herramienta basada en texto más rica en posibilidades para
170 editar partituras de LilyPond. Sus posibilidades incluyen un Asistente de Documentos con apoyo para las
171 letras de las canciones para preparar documentos más fácilmente, y un visor de PDF empotrado con apoyo
172 avanzado para el uso del cursor del ratón. Para ver capturas de pantalla, demostraciones e
173 instrucciones de instalación, visite
174 @uref{http://lilypondtool@/.organum@/.hu}
180 El editor @uref{http://@/www@/.uoregon@/.edu/~koch/texshop/index@/.html,TexShop}
181 para Mac OS X se puede extender para la ejecución de LilyPond, lilypond-book y
182 convert-ly desde dentro del editor, usando las extensiones disponibles en
183 @uref{http://@/www@/.dimi@/.uniud@/.it/vitacolo/freesoftware@/.html}.
189 Hay un tinglado de LilyPond para TextMate. Se puede instalar ejecutando
192 mkdir -p /Library/Application\ Support/TextMate/Bundles
193 cd /Library/Application\ Support/TextMate/Bundles
194 svn co http://macromates.com/svn/Bundles/trunk/Bundles/Lilypond.tmbundle/
199 @node Point and click
200 @section Point and click
201 @cindex point and click
204 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
205 dentro del visor de PDF. Ello facilita encontrar los fragmentos de la entrada que producen
206 algún tipo de eeror en la partitura.
208 Cuando esta funcionalidad está activada, LilyPond añade hiper-enlaces al archivo
209 PDF. Estos hiper-enlaces se envían al navegador de web, que a su vez abre un
210 editor de texto con el cursor situado en el lugar correcto.
212 Para conseguir que esta cadena funciones, tendrá que configurar el visor de PDF de forma que
213 siga los hiper-enlaces usando el guión @file{lilypond-invoke-editor} proporcionado
216 Para Xpdf sobre Unix, lo siguiente debe estar presente en
217 @file{xpdfrc}@footnote{En Unix, este archivo se encuentra o bien en
218 @file{/etc/xpdfrc} o como @file{.xpdfrc} en su directorio personal.}
221 urlCommand "lilypond-invoke-editor %s"
224 El programa @file{lilypond-invoke-editor} es un pequeño programa de
225 apoyo. Invoca un editor para las URIs especiales de @code{textedit},
226 y lanza un navegador de web para otros. Comprueba la variable de entorno
227 @code{EDITOR} en busca de los siguientes patrones,
233 emacsclient --no-wait +@var{line}:@var{column} @var{file}
238 gvim --remote +:@var{line}:norm@var{char} @var{file}
244 nc -noask +@var{line} @var{file}'
248 La variable de entorno @code{LYEDITOR} se utiliza para sobreescibir esto. Contiene
249 la instrucción de línea de órdenes para abrir el editor, donde @code{%(file)s},
250 @code{%(column)s}, @code{%(line)s} se sustituye por el archivo, columna y
251 línea respectivamente. El ajuste
254 emacsclient --no-wait +%(line)s:%(column)s %(file)s
258 para @code{LYEDITOR} equivale a la invocación estándar de
262 @cindex archivo de salida, tamaño del
264 Los enlaces de apuntar y pulsar aumentan significativamente el tamaño de los archivos de salida. Para
265 reducir el tamaño de los archivos PDF y PS, la posibilidad de apuntar y pulsar se puede desactivar
269 #(ly:set-option 'point-and-click #f)
273 dentro de un archivo @file{.ly}. De forma alternativa, puede pasarlo como una opción de
277 lilypond -dno-point-and-click file.ly