Documentation/es/user/setup.itely

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @c This file is part of lilypond-program.tely
   3 @ignore
   4     Translation of GIT committish: 35ad19e0e1bcd393d45de90abe1295c16e91190b
   5
   6     When revising a translation, copy the HEAD committish of the
   7     version that you are working on.  See TRANSLATION for details.
   8 @end ignore
   9
  10 @node Setup
  11 @chapter Setup
  12
  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.
  16
  17 @menu
  18 * Setup for specific Operating Systems::
  19 * Text editor support::
  20 * Point and click::
  21 @end menu
  22
  23
  24 @node Setup for specific Operating Systems
  25 @section Setup for specific Operating Systems
  26
  27 Esta sección explica cómo realizar puestas a punto adicionales para sistemas operativos
  28 específicos.
  29
  30 @menu
  31 * MacOS X on the command-line::
  32 @end menu
  33
  34
  35 @node MacOS X on the command-line
  36 @subsection MacOS X on the command-line
  37
  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.
  41
  42 @example
  43 @var{ruta/hacia}/LilyPond.app/Contents/Resources/bin/lilypond
  44 @end example
  45
  46 @noindent
  47 Lo mismo vale para otros scripts de ese directorio, incluidos los guiones
  48 lilypond-book, convert-ly, abc2ly, etc.
  49
  50 Como alternativa, puede crear scripts que añadan la ruta
  51 automáticamente.  Cree un directorio para guardar estos guiones,
  52
  53 @example
  54 mkdir -p ~/bin
  55 cd ~/bin
  56 @end example
  57
  58 Cree un archivo de nombre @code{lilypond} que contenga
  59
  60 @example
  61 exec @var{ruta/hacia}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
  62 @end example
  63
  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.
  68
  69 Haga ejecutable al archivo,
  70
  71 @example
  72 chmod u+x lilypond
  73 @end example
  74
  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
  77
  78 @example
  79 export PATH=$PATH:~/bin
  80 @end example
  81
  82 @noindent
  83 Este archivo debe acabar con una línea en blanco.
  84
  85 Fíjese en que @var{ruta/hacia} será por lo general @code{/Applications/}.
  86
  87
  88 @node Text editor support
  89 @section Text editor support
  90
  91 @cindex editores
  92 @cindex vim
  93 @cindex emacs
  94 @cindex modos del editor
  95 @cindex sintaxis, resaltado de
  96 @cindex colores, sintaxis
  97
  98 Existe apoyo por parte de varios editores de texto para LilyPond.
  99
 100 @menu
 101 * Emacs mode::
 102 * Vim mode::
 103 * jEdit::
 104 * TexShop::
 105 * TextMate::
 106 @end menu
 107
 108 @node Emacs mode
 109 @subsection Emacs mode
 110
 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,
 115 siga leyendo.
 116
 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}.
 122
 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
 125 @file{~/.emacs}
 126
 127 @c any reason we do not advise:  (push "~/site-lisp" load-path)
 128 @example
 129 (setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))
 130 @end example
 131
 132
 133 @node Vim mode
 134 @subsection Vim mode
 135
 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
 139 @code{$VIM}.
 140
 141 El tipo de archivo de LilyPond se detecta si el archivo
 142 @file{~/.vim/filetype.vim} tiene el siguiente contenido
 143
 144 @example
 145 if exists("did_load_filetypes")
 146   finish
 147 endif
 148 augroup filetypedetect
 149   au! BufNewFile,BufRead *.ly           setf lilypond
 150 augroup END
 151 @end example
 152
 153 Incluya esta ruta añadiendo la siguiente línea a su
 154 @file{~/.vimrc}
 155
 156 @example
 157 set runtimepath+=/usr/local/share/lilypond/$@{LILYPOND_VERSION@}/vim/
 158 @end example
 159
 160 @noindent
 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.
 163
 164
 165 @node jEdit
 166 @subsection jEdit
 167
 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}
 175
 176
 177 @node TexShop
 178 @subsection TexShop
 179
 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}.
 184
 185
 186 @node TextMate
 187 @subsection TextMate
 188
 189 Hay un tinglado de LilyPond para TextMate.  Se puede instalar ejecutando
 190
 191 @example
 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/
 195 @end example
 196
 197
 198
 199 @node Point and click
 200 @section Point and click
 201 @cindex apuntar y pulsar
 202
 203
 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 error en la partitura.
 207
 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.
 211
 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
 214 con LilyPond.
 215
 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.}
 219
 220 @example
 221 urlCommand     "lilypond-invoke-editor %s"
 222 @end example
 223
 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 el resto.  Comprueba la variable de entorno
 227 @code{EDITOR} en busca de los siguientes patrones,
 228
 229 @table @code
 230 @item emacs
 231   esto invoca a
 232 @example
 233 emacsclient --no-wait +@var{line}:@var{column} @var{file}
 234 @end example
 235 @item vim
 236   esto invoca a
 237 @example
 238 gvim --remote +:@var{line}:norm@var{char} @var{file}
 239 @end example
 240
 241 @item nedit
 242 esto invoca a
 243 @example
 244   nc -noask +@var{line} @var{file}'
 245 @end example
 246 @end table
 247
 248 La variable de entorno @code{LYEDITOR} se utiliza para sobreescribir 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
 252
 253 @example
 254 emacsclient --no-wait +%(line)s:%(column)s %(file)s
 255 @end example
 256
 257 @noindent
 258 para @code{LYEDITOR} equivale a la invocación estándar de
 259 emacsclient.
 260
 261
 262 @cindex archivo de salida, tamaño del
 263
 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
 266 escribiendo
 267
 268 @example
 269 #(ly:set-option 'point-and-click #f)
 270 @end example
 271
 272 @noindent
 273 dentro de un archivo @file{.ly}.  De forma alternativa, puede pasarlo como una opción de
 274 la linea de órdenes
 275
 276 @example
 277 lilypond -dno-point-and-click file.ly
 278 @end example
 279