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: b258483467822a7fee6ec2d060e67e209e456582
   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 @c \version "2.11.51"
  11
  12 @node Setup
  13 @chapter Setup
  14
  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.
  18
  19 @menu
  20 * Setup for specific Operating Systems::
  21 * Text editor support::
  22 * Point and click::
  23 @end menu
  24
  25
  26 @node Setup for specific Operating Systems
  27 @section Setup for specific Operating Systems
  28
  29 Esta sección explica cómo realizar puestas a punto adicionales para sistemas operativos
  30 específicos.
  31
  32 @menu
  33 * MacOS X on the command-line::
  34 @end menu
  35
  36
  37 @node MacOS X on the command-line
  38 @subsection MacOS X on the command-line
  39
  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.
  43
  44 @example
  45 @var{ruta/hacia}/LilyPond.app/Contents/Resources/bin/lilypond
  46 @end example
  47
  48 @noindent
  49 Lo mismo vale para otros scripts de ese directorio, incluidos los guiones
  50 lilypond-book, convert-ly, abc2ly, etc.
  51
  52 Como alternativa, puede crear scripts que añadan la ruta
  53 automáticamente.  Cree un directorio para guardar estos guiones,
  54
  55 @example
  56 mkdir -p ~/bin
  57 cd ~/bin
  58 @end example
  59
  60 Cree un archivo de nombre @code{lilypond} que contenga
  61
  62 @example
  63 exec @var{ruta/hacia}/LilyPond.app/Contents/Resources/bin/lilypond "$@@"
  64 @end example
  65
  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.
  70
  71 Haga ejecutable al archivo,
  72
  73 @example
  74 chmod u+x lilypond
  75 @end example
  76
  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
  79
  80 @example
  81 export PATH=$PATH:~/bin
  82 @end example
  83
  84 @noindent
  85 Este archivo debe acabar con una línea en blanco.
  86
  87 Fíjese en que @var{ruta/hacia} será por lo general @code{/Applications/}.
  88
  89
  90 @node Text editor support
  91 @section Text editor support
  92
  93 @cindex editores
  94 @cindex vim
  95 @cindex emacs
  96 @cindex modos del editor
  97 @cindex sintaxis, resaltado de
  98 @cindex colores, sintaxis
  99
 100 Existe apoyo por parte de varios editores de texto para LilyPond.
 101
 102 @menu
 103 * Emacs mode::
 104 * Vim mode::
 105 * jEdit::
 106 * TexShop::
 107 * TextMate::
 108 @end menu
 109
 110 @node Emacs mode
 111 @subsection Emacs mode
 112
 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,
 117 siga leyendo.
 118
 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}.
 124
 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
 127 @file{~/.emacs}
 128
 129 @c any reason we do not advise:  (push "~/site-lisp" load-path)
 130 @example
 131 (setq load-path (append (list (expand-file-name "~/site-lisp")) load-path))
 132 @end example
 133
 134
 135 @node Vim mode
 136 @subsection Vim mode
 137
 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
 141 @code{$VIM}.
 142
 143 El tipo de archivo de LilyPond se detecta si el archivo
 144 @file{~/.vim/filetype.vim} tiene el siguiente contenido
 145
 146 @example
 147 if exists("did_load_filetypes")
 148   finish
 149 endif
 150 augroup filetypedetect
 151   au! BufNewFile,BufRead *.ly           setf lilypond
 152 augroup END
 153 @end example
 154
 155 Incluya esta ruta añadiendo la siguiente línea a su
 156 @file{~/.vimrc}
 157
 158 @example
 159 set runtimepath+=/usr/local/share/lilypond/$@{LILYPOND_VERSION@}/vim/
 160 @end example
 161
 162 @noindent
 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.
 165
 166
 167 @node jEdit
 168 @subsection jEdit
 169
 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}
 177
 178
 179 @node TexShop
 180 @subsection TexShop
 181
 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}.
 186
 187
 188 @node TextMate
 189 @subsection TextMate
 190
 191 Hay un tinglado de LilyPond para TextMate.  Se puede instalar ejecutando
 192
 193 @example
 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/
 197 @end example
 198
 199
 200
 201 @node Point and click
 202 @section Point and click
 203 @cindex apuntar y pulsar
 204
 205
 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.
 209
 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.
 213
 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
 216 con LilyPond.
 217
 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.}
 221
 222 @example
 223 urlCommand     "lilypond-invoke-editor %s"
 224 @end example
 225
 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,
 230
 231 @table @code
 232 @item emacs
 233   esto invoca a
 234 @example
 235 emacsclient --no-wait +@var{line}:@var{column} @var{file}
 236 @end example
 237 @item vim
 238   esto invoca a
 239 @example
 240 gvim --remote +:@var{line}:norm@var{char} @var{file}
 241 @end example
 242
 243 @item nedit
 244 esto invoca a
 245 @example
 246   nc -noask +@var{line} @var{file}'
 247 @end example
 248 @end table
 249
 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
 254
 255 @example
 256 emacsclient --no-wait +%(line)s:%(column)s %(file)s
 257 @end example
 258
 259 @noindent
 260 para @code{LYEDITOR} equivale a la invocación estándar de
 261 emacsclient.
 262
 263
 264 @cindex archivo de salida, tamaño del
 265
 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
 268 escribiendo
 269
 270 @example
 271 #(ly:set-option 'point-and-click #f)
 272 @end example
 273
 274 @noindent
 275 dentro de un archivo @file{.ly}.  De forma alternativa, puede pasarlo como una opción de
 276 la linea de órdenes
 277
 278 @example
 279 lilypond -dno-point-and-click file.ly
 280 @end example
 281