@LaTeX{}, y es por lo que explicamos las dos formas.}, y cualquiera
que sea el método que utilice, podrá convertir fácilmente entre
PostScript y PDF con herramientas como @command{ps2pdf} y
-@command{pdf2ps} que vienen incluidas con GhostScript.
+@command{pdf2ps} que vienen incluidas con Ghostscript.
Para producir un archivo PDF por medio de PDF@LaTeX{}, utilice
@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: 2f2de8ba82a8032b9c48aa6d9defe5b29abf81be
+ Translation of GIT committish: 7465f4b1291f38bed8ee81e3922eb685f7e909ad
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@menu
* Invocar a LilyPond::
-* Opciones de la línea de órdenes para lilypond::
+* Opciones básicas de la línea de órdenes para LilyPond::
+* Opciones avanzadas de línea de órdenes para LilyPond::
* Variables de entorno::
* LilyPond en una jaula de chroot::
@end menu
opciones, o si la sintaxis es distinta. Observe que son instrucciones
del shell y que no tienen nada que ver con lilypond.
-@node Opciones de la línea de órdenes para lilypond
-@unnumberedsubsec Opciones de la línea de órdenes para @command{lilypond}
+
+@node Opciones básicas de la línea de órdenes para LilyPond
+@unnumberedsubsec Opciones básicas de la línea de órdenes para @command{lilypond}
@translationof Command line options for lilypond
@cindex invocación de @command{lilypond}
@table @code
@item -d,--define-default=@var{variable}=@var{valor}
-Establece la opción interna del programa @var{variable} al valor de
-Scheme @var{valor}. Si no se proporciona ningún @var{valor}, se usa
-@var{#t}. Para desactivar una opción se puede anteponer @code{no-} a
-la @var{variable}, p.ej.:
-
-@cindex apuntar y pulsar, línea de órdenes
-
-@example
--dno-point-and-click
-@end example
-
-@noindent
-es lo mismo que
-@example
--dpoint-and-click=#f
-@end example
-
-Están contempladas las siguientes opciones:
-
-@cindex help (ayuda), línea de órdenes
-
-@table @code
-
-@item help
-La ejecución de @code{lilypond -dhelp} imprime todas las opciones
-@option{-d} disponibles.
-
-@cindex paper-size, línea de órdenes
-
-@item paper-size
-Esta opción establece el tamaño predeterminado del papel,
-@example
--dpaper-size=\"letter\"
-@end example
-
-@noindent
-Observe que la cadena se debe incluir dentro de comillas escapadas
-( @code{\"} ).
-
-@c Match " in previous line to help context-sensitive editors
-
-@cindex safe, línea de órdenes
-
-@item safe
-No confiar en la entrada @file{.ly}.
-
-Cuando el proceso de tipografía de LilyPond se encuentra disponible a
-través de un servidor web, @b{SE DEBEN} pasar las opciones
-@option{--safe} (seguro) o @option{--jail} (jaula). La opción
-@option{--safe} evita que el código de Scheme en línea arme un desastre,
-por ejemplo
-
-@quotation
-@verbatim
-#(system "rm -rf /")
-{
- c4^$(ly:gulp-file "/etc/passwd")
-}
-@end verbatim
-@end quotation
-
-La opción @option{-dsafe} funciona evaluando las expresiones en línea de
-Scheme dentro de un módulo especial seguro. Este módulo seguro deriva
-del módulo GUILE @file{safe-r5rs}, pero añade ciertas funciones del
-API de LilyPond. Estas funciones se relacionan en
-@file{scm/safe-lily.scm}.
-
-Además, el modo seguro prohíbe las directivas @code{\include} e
-inhabilita el uso de barras invertidas en las cadenas de @TeX{}.
-
-En el modo seguro, no es posible la importación de variables de
-LilyPond dentro de Scheme.
-
-@option{-dsafe} @emph{no} detecta la sobreutilización de recursos. Aún
-es posible hacer que el programa se cuelgue indefinidamente, por
-ejemplo alimentando el backend con estructuras de datos cíclicas. Por
-tanto, si se está utilizando LilyPond sobre un servidor web accesible
-públicamente, el proceso debe limitarse tanto en el uso de CPU como de
-memoria.
-
-El modo seguro impide que muchos fragmentos útiles de código de
-LilyPond se puedan compilar. La opción @option{--jail} es una
-alternativa más segura, pero su preparación requiere más trabajo.
-
-@cindex salida, establecer el formato de
-
-@item backend
-el formato de salida que usar para el back-end o extremo final.
-Para el @code{formato} se puede elegir entre
-
-@table @code
-@item ps
-
-@cindex PostScript, salida
-
-para PostScript.
-
-Los archivos PostScript incluyen las tipografías TTF, Type1 y OTF. No
-se seleccionan subconjuntos de estas tipografías. Cuando se usan
-conjuntos de caracteres orientales, esto puede dar lugar a archivos
-enormes.
-
-@item eps
-
-@cindex Postscript encapsulado
-@cindex EPS (PostScript Encapsulado)
-
-para obtener PostScript encapsulado. Esto vuelca cada una de las
-páginas/sistemas como un archivo @file{EPS} distinto, sin tipografías,
-y como un solo archivo @file{EPS} encuadernado con todas las
-páginas/sistemas con las tipografías incluidas.
-
-Este modo se usa de forma predeterminada por parte de
-@command{lilypond-book}.
-
-@item svg
-
-@cindex SVG (Gráficos vectoriales escalables)
-
-para obtener SVG (gráficos vectoriales escalables).
-
-Crea un único archivo SVG que contiene toda la salida de música, con
-las tipografías incrustadas. Se necesita un visor de SVG que
-contemple las tipografías incrustadas, o un visor de SVG que pueda
-sustituir las tipografías incrustadas por tipografías OTF. Bajo UNIX,
-puede usar @uref{http://www.inkscape.org,Inkscape} (versión 0.42 o
-posterior), después de copiar las tipografías OTF del directorio de
-LilyPond (que normalmente es
-@file{/usr/share/lilypond/VERSIÓN/fonts/otf/}) al directorio
-@file{~/.fonts/}.
-
-@item scm
-
-@cindex Scheme, volcado de
-@cindex salida, volcado de Scheme
-
- para obtener un volcado de las instrucciones internas de dibujo
-basadas en Scheme, en bruto.
-
-@item null
- no producir una salida impresa; tiene el mismo efecto que @option{-dno-print-pages}.
-
-@end table
-
-Ejemplo: @code{lilypond -dbackend=svg @var{archivo}.ly}
-
-@item preview
-
-@cindex vista previa, línea de órdenes
-
-Esta opción está contemplada por todos los back-ends:
-@code{pdf}, @code{png}, @code{ps}, @code{eps} y @code{svg},
-pero no por @code{scm}. Genera un archivo de salida,
-de la forma @code{miArchivo.preview.extensión},
-que contiene solamente los títulos de
-cabecera y el primer sistema de música. Si se usan bloques
-@code{\book} o @code{\bookpart}, aparecerán en la salida
-los títulos de @code{\book}, @code{\bookpart} y @code{\score},
-incluido el primer sistema de cada bloque @code{\score}
-si la variable de @code{\paper} @code{print-all-headers}
-está establecida al valor verdadero (@code{#t}).
-
-Para suprimir la salida usual, use las opciones adicionales
-@option{-dprint-pages} ó @option{-dno-print-pages}
-según sus necesidades.
-
-@item gui
-Ejecutar en modo silencioso y redirigir toda la salida a un archivo de
-registro.
-
-Nota para usuarios de Windows: de forma predeterminada
-@code{lilypond.exe} imprime toda la información del progreso de
-ejecución hacia la ventana de la consola, @code{lilypond-windows.exe}
-no lo hace y devuelve una indicación del sistema o prompt sin ninguna
-información del progreso de la ejecución inmediatamente en la línea de
-órdenes. La opción @option{-dgui} se puede usar en este caso para
-redirigir la salida a un archivo de registro.
-
-@item print-pages
-Generar las páginas completas, el ajuste predeterminado.
-@option{-dno-print-pages} es útil en combinación con @option{-dpreview}.
-
-@end table
+Véase @ref{Opciones avanzadas de línea de órdenes para LilyPond}.
@cindex Scheme, evaluación de expresiones
@cindex expresiones de Scheme, evaluación
Ejecutar @command{lilypond} en una jaula de chroot.
La opción @option{--jail} (jaula) proporciona una alternativa más
-flexible a la opción @option{--safe} cuando el proceso de tipografía de
+flexible a la opción @option{-dsafe} cuando el proceso de tipografía de
LilyPond está disponible a través de un servidor web o cuando LilyPond
-ejecuta archivos fuente procedentes del exterior.
+ejecuta instrucciones enviadas por fuentes externas
+(véase @ref{Opciones avanzadas de línea de órdenes para LilyPond}).
La opción @option{--jail} funciona cambiando la raíz de
@command{lilypond} a @var{jaula} justo antes de comenzar el proceso de
que se han dado en la opción, y el directorio actual se cambia a
@var{directorio}. Esta instalación garantiza que no es posible, al
menos en teoría, escapar de la jaula. Observe que para que funcione
-@option{--jail} se debe ejecutar @command{lilypond} como root, lo que
+@option{--jail}, se debe ejecutar @command{lilypond} como root, lo que
normalmente se puede hacer de una forma segura utilizando
@command{sudo}.
-La instalación de una jaula es un asunto algo delicado, pues debemos
-asegurarnos de que LilyPond puede encontrar @emph{dentro de la jaula}
-todo lo que necesita para poder compilar la fuente. Una configuración
-típica consta de los siguientes elementos:
+La instalación de una jaula puede ser un asunto relativamente
+complejo, pues debemos asegurarnos de que LilyPond puede encontrar
+@emph{dentro} de la propia jaula todo lo que necesita para poder
+compilar la fuente. Una típica configuración de jaula de chroot
+consta de los siguientes elementos:
@table @asis
@item Ejecutar LilyPond
Dentro de una jaula montada con @code{noexec} es imposible ejecutar
ningún programa externo. Por tanto, LilyPond se debe ejecutar con un
-backend que no necesite tal programa. Como ya mencionamos, también se
+backend que no necesite tal programa. Como ya hemos mencionado, se
debe ejecutar con privilegios del superusuario (que por supuesto
-perderá inmediatamente), posiblemente usando @command{sudo}. Es buena
-idea limitar el número de segundos de tiempo de CPU que LilyPond puede
-usar (p.ej., usando @command{ulimit@tie{}-t}), y, si su sistema operativo
-lo contempla, el tamaño de la memoria que se puede reservar.
+perderá inmediatamente), posiblemente usando @command{sudo}. También
+es una práctica recomendable limitar el número de segundos de tiempo
+de CPU que LilyPond puede usar (p.ej., usando
+@command{ulimit@tie{}-t}), y, si su sistema operativo lo contempla, el
+tamaño de la memoria que se puede reservar. Véase también
+@ref{LilyPond en una jaula de chroot}.
@end table
@end table
+@node Opciones avanzadas de línea de órdenes para LilyPond
+@unnumberedsubsec Opciones avanzadas de línea de órdenes para LilyPond
+@translationof Advanced command line options for LilyPond
+
+@table @code
+
+@item -d@var{[option-name]}=@var{[value]},--define-default=@var{[option-name]}=@var{[value]}
+Establece la función de Scheme interna equivalente a @var{valor}. Si
+no se proporciona ningún @var{valor}, se usa el valor predeterminado.
+Para desactivar una opción se puede anteponer @code{no-} a la
+@var{variable}, p.ej.:
+
+@cindex point and click, command line
+
+@example
+-dno-point-and-click
+@end example
+
+@noindent
+is the same as
+@example
+-dpoint-and-click=#f
+@end example
+@end table
+
+@noindent Están contempladas las siguientes opciones junto a sus respectivos
+valores predeterminados:
+
+@multitable @columnfractions .33 .16 .51
+@item @strong{Símbolo}
+@tab @strong{Valor}
+@tab @strong{Explicación/Opciones}
+
+@item @code{anti-alias-factor} (factor de antialias)
+@tab @code{1}
+@tab Renderizar a mayor resolución (utilizando el factor dado) y reducir la
+escala del resultado para así evitar @q{escaleras} en las imágenes
+@code{PNG}.
+
+@item @code{aux-files} (archivos auxiliares)
+@tab @code{#t}
+@tab Crear archivos @code{.tex}, @code{.texi}, @code{.count} en el
+@q{back-end} @code{EPS}.
+
+@item @code{backend}
+@tab @code{'ps}
+@tab Seleccionar un @q{back-end}. Los archivos (la opción predeterminada)
+incluyen las fuentes tipográficas @code{TTF}, @code{Type1} y
+@code{OTF}. No se hace ningún subconjunto de estas fuentes. El uso
+de conjuntos de caracteres @q{orientales} puede dar lugar a archivos
+muy grandes.
+
+@item
+@tab @code{'eps}
+@tab PostScript encapsulado. Vuelca cada página o sistema como un archivo
+@file{EPS} distinto, sin fuentes tipográficas, y como un archivo
+@file{EPS} encuadernado con todas las páginas o sistemas que incluye
+las fuentes. Utilizado como opción predeterminada por parte de
+@command{lilypond-book}.
+
+@item
+@tab @code{'null}
+@tab No producir ninguna partitura impresa a la salida; tiene el mismo
+efecto que @code{-dno-print-pages}.
+
+@item
+@tab @code{'svg}
+@tab Grácifos vectoriales escalables. Crea un solo archivo @code{SVG}, sin
+fuentes tipográficas incrustadas, por cada página de salida. Se
+recomienda instalar las fuentes Century Schoolbook, incluidas con la
+instalación de LilyPond, para un renderizado óptimo. Bajo UNIX,
+bastará con que copie estaos archivos de fuente del directorio de
+LilyPond (normalmente @file{/usr/share/lilypond/VERSION/fonts/otf/})
+al directorio @file{~/.fonts/}. La salida @code{SVG} debería ser
+compatible con cualquier editor o cliente de SVG. También hay una
+opción @code{svg-woff} (véase más abajo) para usar los archivos de
+fuente woff en el @q{back-end} SVG.
+
+@item
+@tab @code{'scm}
+@tab Volcado de las instrucciones de dibujo internas basadas en Scheme, en
+bruto.
+
+@item @code{check-internal-types}
+@tab @code{#f}
+@tab Comprobar el tipo de cada asignación de propiedades.
+
+@item @code{clip-systems} (recortar los sistemas)
+@tab @code{#f}
+@tab Generar fragmentos de imagen recortados de una partitura.
+
+@item @code{datadir} (directorio de datos)
+@tab
+@tab Prefijo de los archivos de datos (sólo lectura).
+
+@item @code{debug-gc}
+@tab @code{#f}
+@tab Volcar estadísticas de depuración de memoria.
+
+@item @code{debug-gc-assert-parsed-dead}
+@tab @code{#f}
+@tab Para la depuración de memoria: asegurarse de que todas las referencias
+a objetos analizados están muertas. Es una opción interna, y se
+activa automáticamente para @code{`-ddebug-gc'}.
+
+@item @code{debug-lexer}
+@tab @code{#f}
+@tab Depuración del analizador léxico flex.
+
+@item @code{debug-page-breaking-scoring}
+@tab @code{#f}
+@tab Volcar las partituras para muchas configuraciones de saltos de página
+diferentes.
+
+@item @code{debug-parser}
+@tab @code{#f}
+@tab Depuración del analizador sintáctico bison.
+
+@item @code{debug-property-callbacks}
+@tab @code{#f}
+@tab Depuración de las cadenas cíclicas de funciones de callback.
+
+@item @code{debug-skylines}
+@tab @code{#f}
+@tab Depuración de las líneas de horizonte.
+
+@item @code{delete-intermediate-files}
+@tab @code{#t}
+@tab Eliminar los archivos intermedios @code{.ps} inútiles ques e crean
+durante la compilación.
+
+@item @code{dump-cpu-profile}
+@tab @code{#f}
+@tab Volcar información de cuenta de tiempo (dependiente del sistema).
+
+@item @code{dump-profile}
+@tab @code{#f}
+@tab Volcar de la información de memoria y de tiempo para cada archivo.
+
+@item @code{dump-signatures}
+@tab @code{#f}
+@tab Volcar las firmas de salida de cada sistema. Usado para las pruebas
+de regresión.
+
+@item @code{eps-box-padding}
+@tab @code{#f}
+@tab Rellenar el borde izquierdo de la caja contenedora del EPS de salida
+en la cantidad dada (en mm).
+
+@item @code{gs-load-fonts}
+@tab @code{#f}
+@tab Cargar las fuentes tipográficas a través de Ghostscript.
+
+@item @code{gs-load-lily-fonts}
+@tab @code{#f}
+@tab Cargar sólo las fuentes de LilyPond por medio de Ghostscript.
+
+@item @code{gui}
+@tab @code{#f}
+@tab Se ejecuta silenciosamente y se redirige toda la salida a un archivo
+de registro.
+@end multitable
+
+@noindent
+@strong{Nota para los usuarios de Windows:} De manera predeterminada,
+@code{lilypond.exe} dirige toda la salida de la información de avance
+hacia la ventana de consola, @code{lilypond-windows.exe} no lo hace y
+devuelve un indicador del sistema, sin ninguna indicación del avance,
+inmediatamente en la línea de órdenes. La opción @option{-dgui} se
+puede usar en este caso para redirigir la salida a un archivo de
+registro.
+
+@multitable @columnfractions .33 .16 .51
+@item @code{help}
+@tab @code{#f}
+@tab Mostrar esta ayuda.
+
+@item @code{include-book-title-preview}
+@tab @code{#t}
+@tab Incluir los títulos de libro en las imágenes de vista previa.
+
+@item @code{include-eps-fonts}
+@tab @code{#t}
+@tab Incluir las fuentes tipográficas en los archivos EPS de cada uno de
+los sistemas.
+
+@item @code{include-settings}
+@tab @code{#f}
+@tab Incluir el archivo de los ajustes globales, se incluye antes de que la
+partitura se procese.
+
+@item @code{job-count}
+@tab @code{#f}
+@tab Procesar en paralelo, usando el número de tareas dado.
+
+@item @code{log-file}
+@tab @code{#f [file]}
+@tab Si se da una cadena @code{NOMBRE} como segundo argumento,
+redirigir la salida al archivo de registro @code{NOMBRE.log}.
+
+@item @code{max-markup-depth}
+@tab @code{1024}
+@tab Profundidad máxima del árbol de marcado. Si un marcado tiene más niveles,
+suponer que no terminará por sí mismo, imprimiento una advertencia y
+devolviendo en su lugar un elemento de marcado nulo.
+
+@item @code{midi-extension}
+@tab @code{"midi"}
+@tab Fijar la extensión de archivo predeterminada para el archivo de salida
+MIDI a la cadena dada.
+
+@item @code{music-strings-to-paths}
+@tab @code{#f}
+@tab Convertir las cadenas de texto a rutas cuando los glifos pertenecen a
+una fuente de tipografía musical.
+
+@item @code{old-relative}
+@tab @code{#f}
+@tab Hacer que el modo @code{\relative} para la música simultánea funcione
+de manera similar a la sintaxis de los acordes.
+
+@item @code{paper-size}
+@tab @code{\"a4\"}
+@tab Establecer el tamaño predeterminado del papel. Observe que la cadena
+debe ir encerrada entre comillas dobles.
+
+@item @code{pixmap-format}
+@tab @code{png16m}
+@tab Fijar el formato de salida de Ghostscript para las imágenes de píxeles.
+
+@item @code{point-and-click}
+@tab @code{#f}
+@tab Añadir enlaces de @q{apuntar y pulsar} a la salida @code{PDF}. Véase
+@ref{Apuntar y pulsar}.
+
+@item @code{preview}
+@tab @code{#f}
+@tab Crear imágenes de vista previa además de la salida normal.
+@end multitable
+
+@noindent
+Esta opción está contemplada por todos los @q{back-ends}: @code{pdf},
+@code{png}, @code{ps}, @code{eps} y @code{svg}, pero no por
+@code{scm}. Genera un archivo de salida, en la forma
+@code{miArchivo.preview.extensión}, que contiene los títulos y el
+primer sistema de la música. Si se están utilizando bloques
+@code{\book} o @code{\bookpart}, aparecen en la salida los títulos de
+@code{\book}, @code{\bookpart} o @code{\score}, incluido el primer
+sistema de cada bloque @code{\score} si la variable de @code{\paper}
+@code{print-all-headers} está fijada al valor @code{#t}.
+
+Para suprimir la salida usual, utilice las opciones
+@option{-dprint-pages} o @option{-dno-print-pages} según sus
+necesidades.
+
+@multitable @columnfractions .33 .16 .51
+@item @code{print-pages}
+@tab @code{#t}
+@tab Generar páginas completas (es la opción predeterminada). Es útil
+@option{-dno-print-pages} en combinación con @option{-dpreview}.
+
+@item @code{profile-property-accesses}
+@tab @code{#f}
+@tab Conservar las estadísticas de las llamadas de función
+@code{get_property()}.
+
+@item @code{protected-scheme-parsing}
+@tab @code{#t}
+@tab Continuar cuando se captan en el analizador sintáctico errores del
+Scheme empotrado. Si se fija a @code{#f}, detenerse cuando haya
+errores e imprimir un registro de traza de pila.
+
+@item @code{read-file-list}
+@tab @code{#f [archivo]}
+@tab Especificar el nobmre de un archivo que contiene una lista de archivos
+de entrada para procesar.
+
+@item @code{relative-includes}
+@tab @code{#f}
+@tab Cuando se procesa una instrucción @code{\include} command, buscar el
+archivo incluido de forma relativa al archivo actual (en lugar del
+archivo principal).
+
+@item @code{resolution}
+@tab @code{101}
+@tab Fijar la resolución para generar imágenes de píxeles @code{PNG} al
+valor dado (en ppp).
+
+@item @code{safe}
+@tab @code{#f}
+@tab No confiar en la entrada @code{.ly}.
+@end multitable
+
+@noindent
+Cuando el servicio de tipografía está disponible a través de un
+servidor web, @b{SE DEBEN} pasar las opciones @option{--safe} o
+@option{--jail}. La opción @option{--safe} evita que el código de
+Scheme monte un desastre, p.ej.:
+
+@quotation
+@verbatim
+#(system "rm -rf /")
+{
+ c4^$(ly:gulp-file "/etc/passwd")
+}
+@end verbatim
+@end quotation
+
+La opción @option{-dsafe} funciona evaluando las expresiones de Scheme
+en línea dentro de un módulo seguro especial. Deriva del módulo
+@file{safe-r5rs} de GUILE, pero además añade unas cuantas funciones de
+la API de LIlyPond que están relacionadas en @file{scm/safe-lily.scm}.
+
+Además, el modo seguro prohíbe las directivas @code{\include} y
+desactiva la utilización de barras invertidas en las cadenas de
+@TeX{}. Asimismo, no es posible importar variables de LilyPond dentro
+de Scheme cuando se está en modo seguro.
+
+@option{-dsafe} @emph{no} detecta la sobreutilización de recursos, por
+lo que aún es posible hacer que el programa se cuelgue
+indefinidamente, por ejemplo suministrando estructuras de datos
+cíclicas en el backend. Por ello, si está usando LilyPond en un
+servidor web accesible públicamente, el proceso se debe limitar tanto
+en el uso de memoria como de CPU.
+
+El modo seguro evita que se puedan compilar muchos fragmentos de
+código útiles.
+
+La opción @option{--jail} es una aliternativa más segura aún, pero
+requiere más trabajo para su configuración. Véase
+@ref{Opciones básicas de la línea de órdenes para LilyPond}.
+
+@multitable @columnfractions .33 .16 .51
+@item @code{separate-log-files}
+@tab @code{#f}
+@tab Para los archivos de entrada @code{ARCHIVO1.ly}, @code{ARCHIVO2.ly},
+etc. sacar los datos de registro hacia los archivos @code{ARCHIVO1.log},
+@code{ARCHIVO2.log}, ...
+
+@item @code{show-available-fonts}
+@tab @code{#f}
+@tab Listar todos los nombres de las fuentes tipográficas disponibles.
+
+@item @code{strict-infinity-checking}
+@tab @code{#f}
+@tab Forzar una terminación abrupta si se encuentran las excepciones de
+punto flotante @code{Inf} y @code{NaN}.
+
+@item @code{strip-output-dir}
+@tab @code{#t}
+@tab No usar los directorios de los archivos de entrada al construir los
+nombres de los archivos de salida.
+
+@item @code{svg-woff}
+@tab @code{#f}
+@tab Usar archivos de fuente tipográfica de woff en el backend SVG.
+
+@item @code{trace-memory-frequency}
+@tab @code{#f}
+@tab Registrar el uso de células de Scheme esta cantidad de veces por
+segundo. Volcar los resultados en @code{ARCHIVO.stacks} y en
+@code{ARCHIVO.graph}.
+
+@item @code{trace-scheme-coverage}
+@tab @code{#f}
+@tab Registrar la cobertura de los archivos de Scheme en @code{ARCHIVO.cov}.
+
+@item @code{verbose}
+@tab @code{#f}
+@tab Salida prolija, es decir el nivel de registro en DEBUG (sólo lectura).
+
+@item @code{warning-as-error}
+@tab @code{#f}
+@tab Cambiar todos los mensajes de advertencia y de @q{error de
+programación} a errores.
+@end multitable
+
+
@node Variables de entorno
@unnumberedsubsec Variables de entorno
@translationof Environment variables
-
@cindex LANG
@cindex LILYPOND_DATADIR
@itemize
-@item Instale los paquetes necesarios: LilyPond, GhostScript e ImageMagick.
+@item Instale los paquetes necesarios: LilyPond, Ghostscript e ImageMagick.
@item Cree un usuario nuevo con el nombre de @code{lily}:
@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@ignore
- Translation of GIT committish: 8afb2adf0bab372f845ff3eae30e1e950b5c63ca
+ Translation of GIT committish: c610645cc9a77cba1a2798280965db142d649ac5
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Vous pouvez aussi obtenir des documents au format Scalable Vector
Graphics (SVG), Encapsulated PostScript (EPS) ou Portable Network
Graphics (PNG) dès lors que vous aurez lancé LilyPond en ligne de
-commande avec l'option @i{ad hoc} -- voir
-@rprogram{Options en ligne de commande pour lilypond} à ce sujet.
+commande avec l'option @i{ad hoc} -- voir
+@rprogram{Utilisation en ligne de commande} à ce sujet.
@node Changement des fontes musicales
@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@ignore
- Translation of GIT committish: 321993f3a277f69471fcacbb6afc12857faa4e8c
+ Translation of GIT committish: c610645cc9a77cba1a2798280965db142d649ac5
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@menu
* Lancement de lilypond::
-* Options en ligne de commande pour lilypond::
+* Options basiques de lilypond::
+* Options avancées de lilypond::
* Variables d'environnement::
* Exécution de LilyPond en mode protégé::
@end menu
qui n'ont rien à voir avec LilyPond.
-@node Options en ligne de commande pour lilypond
-@unnumberedsubsec Options en ligne de commande pour @command{lilypond}
-@translationof Command line options for lilypond
+@node Options basiques de lilypond
+@unnumberedsubsec Options basiques de @command{lilypond}
+@translationof Basic command line options for LilyPond
@cindex lancement de @command{lilypond}
@cindex ligne de commande, options pour @command{lilypond}
@cindex switches
@cindex commutateurs
-Voici les différentes options disponibles à la ligne de commande@tie{}:
+Différentes options sont disponibles en ligne de commande@tie{}:
@table @code
-@item -d,--define-default=@var{var}=@var{val}
-Affecte la valeur Scheme @var{val} à l'option interne @var{var} du
-programme. En l'absence de @var{val}, le programme utilisera @var{#t}.
-Préfixer @var{var} d'un @code{no-} vous permet de désactiver une option.
-Ainsi,
-
-@cindex point and click, ligne de commande
-@cindex pointer-cliquer, ligne de commande
-
-@example
--dno-point-and-click
-@end example
-
-@noindent
-revient au même que
-@example
--dpoint-and-click=#f
-@end example
-
-Voici les options disponibles@tie{}:
-
-@cindex help, ligne de commande
-
-@table @code
-
-@item help
-Lancer @code{lilypond -dhelp} affichera la liste de toutes les options
-@code{-d} disponibles.
-
-
-@cindex paper-size, ligne de commande
-@item paper-size
-Détermine la taille par défaut du papier, par exemple
-@example
--dpaper-size=\"letter\"
-@end example
-
-@noindent
-Veillez à ne pas oublier d'encadrer la valeur par des guillemets
-échappés ( @code{\"} ).
-@c Match " in previous line to help context-sensitive editors
-
-
-@cindex safe, ligne de commande
-@item safe
-Ne pas avoir une confiance aveugle dans le code @file{.ly}.
-
-Lorsque LilyPond est accessible au travers d'un serveur web, il est
-@strong{impératif} d'utiliser les options @option{--safe} ou
-@option{--jail}. L'option @option{--safe} aura pour effet d'empêcher
-tout code Scheme inclus de mettre en péril votre installation grâce à
-quelque chose du style
-
-@quotation
-@verbatim
-#(system "rm -rf /")
-{
- c4^$(ly:gulp-file "/etc/passwd")
-}
-@end verbatim
-@end quotation
-
-L'option @code{-dsafe} forcera l'évaluation, au fil de l'eau et par un
-module sécurisé, des expressions Scheme contenues dans le fichier
-source. Ce module sécuritaire, dérivé du module GUILE @file{safe-r5rs},
-ajoute un certain nombre de fonctions -- listées dans
-@file{scm/safe-lily.scm} -- à l'API de LilyPond.
-
-De plus, le mode @emph{safe} ne permet ni l'utilisation de directives
-@code{\include} ni le recours aux obliques inversées (@emph{backslash})
-dans les chaînes @TeX{}.
-
-L'import de variables LilyPond dans du code Scheme n'est pas possible
-en mode sécuritaire.
-
-L'option @code{-dsafe} @strong{ne détecte pas} l'utilisation abusive des
-ressources. Il est donc possible que le programme finisse par rester
-sans réponse si on lui envoie une boucle sans fin. C'est la raison pour
-laquelle nous recommandons, lorsque LilyPond tourne sur un serveur
-accessible au public, d'en limiter aussi bien les ressources processeur
-que mémoire.
-
-Notez bien que l'utilisation du mode sécuritaire empêchera aussi la
-compilation d'un certain nombre de fragments LilyPond. L'option
-@code{--jail} est dans ce cas une excellente alternative en terme de
-sécurité, même si elle requiert plus de temps à mettre en place.
-
-
-@cindex format de sortie, définition
-@item backend
-Détermine le format de sortie à utiliser par le moteur de traitement.
-Les types de @code{format} reconnus sont
-
-@table @code
-@item ps
-
-@cindex PostScript output
-pour du PostScript.
-
-Les fichiers PostScript incluent les polices TTF, Type1 et OTF, et
-aucune substitution ne sera opérée pour ces fontes. Si vous utilisez
-des caractères orientaux, le fichier aura vite fait d'atteindre une
-taille conséquente.
-
-
-@item eps
-@cindex Postscript encapsulé
-@cindex EPS (Encapsulated PostScript)
-pour du PostScript encapsulé.
-
-Chaque page (système) fera l'objet d'un fichier @file{EPS} particulier,
-sans fontes, auquel sera associé un fichier @file{EPS} qui, lui,
-contiendra toutes les pages (systèmes) et les fontes.
-
-Notez qu'il s'agit du mode que @command{lilypond-book} utilise par défaut.
-
-@item svg
-@cindex SVG (Scalable Vector Graphics)
-pour du SVG (@emph{Scalable Vector Graphics}).
-
-Cette option permet de créer un fichier SVG par page, sans incorporation
-des fontes. Nous vous recommandons d'installer les fontes Century
-Schoolbook comprises dans le paquetage LilyPond afin d'obtenir le
-meilleur rendu possible. Sous UNIX, il suffit de les recopier, à partir
-du répertoire @file{/usr/share/lilypond/VERSION/fonts/otf/}, dans
-@file{~/.fonts/}. Les fichiers SVG alors générés devraient être
-lisibles par votre éditeur SVG habituel.
-
-@item scm
-@cindex Scheme dump
-pour une recopie brute des commandes Scheme internes de formatage.
-
-@item null
-permet de ne pas générer de partition imprimable. Cette option est
-équivalente à @code{-dno-print-pages}.
-
-@end table
-
-Exemple : @code{lilypond -dbackend=svg @var{monfichier}.ly}
-
-
-@item preview
-@cindex preview, ligne de commande
-
-Cette option, disponible dans tous les formats de sortie imprimables --
-@code{pdf}, @code{png}, @code{ps}, @code{eps} et @code{svg} -- génère
-un fichier de la forme @code{monFichier.preview.extension} comprenant le
-titrage et le premier système. S'il existe plusieurs sections
-@code{\book}, @code{\bookpart}, ce fichier contiendra les titrage et
-premier système de chacun des @code{\book}, @code{\bookpart} et
-@code{\score}, dès lors que la variable @code{print-all-headers} du bloc
-@code{\paper} est activée.
-
-Pour l'éviter, utilisez conjointement l'une des options
-@option{-dprint-pages} ou @option{-dno-print-pages} selon vos besoins.
-
-@item gui
-Travaille silencieusement, et redirige tout le verbiage dans un fichier
-journal.
-
-Note à l'attention des utilisateurs de Windows@tie{}: toutes les
-informations concernant le traitement apparaissent au fur et à mesure
-dans l'interpréteur de commandes lorsque vous lancez le programme
-@code{lilypond.exe}, à l'inverse de @w{@code{lilypond-windows.exe}} qui
-vous renvoie simplement la main. L'option @option{-dgui} vous permettra
-alors de rediriger ces informations dans un fichier journal.
-
-@item print-pages
-Génère l'intégralité des pages de la partition. L'option
-@option{-dno-print-pages} est particulièrement utile lorsqu'utilisée
-conjointement avec l'option @option{-dpreview}.
-
-@end table
-
+@item -d,--define-default=@var{variable}=@var{valeur}
+Voir @ref{Options avancées de lilypond}.
@cindex Scheme, évaluation d'expression
@cindex expression Scheme, évaluation
@noindent
en tête de votre fichier @file{.ly}.
-@warning{Les utilisateurs de Windows doivent utiliser des quillements
+@warning{Les utilisateurs de Windows doivent utiliser des guillemets
doubles @code{"} en lieu et place des guillemets simples @code{'}.}
-@c Match " in previous line to help context-sensitive editors
-
+@c Match " in context-sensitive editors
@cindex sortie, format
@cindex format de sortie
Exemple : @code{lilypond -fpng @var{monfichier}.ly}
-
@item -h,--help
Affiche un résumé des commandes.
-
@item -H,--header=@var{CHAMP}
Recopie le champ d'entête dans le fichier @file{RACINE.@var{CHAMP}}.
-
@item -i,--init=@var{fichier}
Définit @var{fichier} (par défaut @file{init.ly}) en tant que fichier
d'initialisation.
-
@cindex recherche de fichier
@cindex chemin de recherche
@item -I,--include=@var{répertoire}
-
Ajoute @var{répertoire} au chemin de recherche pour les inclusions.
Vous pouvez mentionner plusieurs fois l'option @option{-I}, auquel cas
fichier en question ne s'y trouve pas, les répertoires suivants seront
examinés l'un après l'autre.
-
@cindex chroot jail, fonctionnement
@item -j,--jail=@var{user},@var{group},@var{jail},@var{dir}
Lance @command{lilypond} dans un environnement protégé.
L'option @option{--jail} est une alternative qui offre plus de
flexibilité que l'option @option{--safe} lorsque LilyPond est installé
-sur un serveur web ou traite des fichiers externes.
+sur un serveur web ou traite des fichiers externes -- voir
+@ref{Options avancées de lilypond}.
L'option @option{--jail} va détourner la racine de @command{lilypond}
sur @var{jail} juste avant d'effectuer la compilation à proprement
@item Création d'un système de fichiers indépendant
L'intérêt d'un système de fichiers dédié à LilyPond réside dans le fait
-qu'on peut le brider à l'aide des options @code{noexec},@code{nodev} et
+qu'on peut le brider à l'aide des options @code{noexec}, @code{nodev} et
@code{nosuid}. Il sera de fait impossible de lancer des exécutables ou
d'écrire sur un périphérique à partir de LilyPond. Si vous n'avez pas
l'intention de créer un tel système sur une partition séparée, vous
lancé avec les privilèges de l'administrateur -- privilèges qu'il perdra
aussitôt --, ce qui peut nécessiter le recours à la commande
@code{sudo}. Il est par ailleurs judicieux de limiter le temps
-processeur aloué à LilyPond -- grâce à @command{ulimit@tie{}-t} par
+processeur alloué à LilyPond -- grâce à @command{ulimit@tie{}-t} par
exemple -- ainsi que, si votre système le permet, la taille de la
-mémoire.
+mémoire. Voir aussi @ref{Exécution de LilyPond en mode protégé}.
@end table
-
@cindex loglevel
@cindex verbosité, définir le degré de
@item -l,--loglevel=@var{DEGRÉ}
@end table
-
+@cindex redirection
@cindex répertoire de destination
@cindex fichier de destination
@item -o,--output=@var{FICHIER} ou @var{RÉPERTOIRE}
Détermine le nom par défaut du fichier résultant à @var{FICHIER}@tie{};
lorsque l'argument @var{RÉPERTOIRE} correspond à un répertoire déjà
existant, c'est là que les fichiers résultants seront déposés. Le
-suffixe adéquat sera ajouté (p.ex. @file{.pdf} pour du pdf) dans tous
+suffixe adéquat sera ajouté (par ex. @code{.pdf} pour du pdf) dans tous
les cas.
-
@cindex PostScript, output
@cindex PS (PostScript), output
@item --ps
Génère du PostScript.
-
-@item --png
@cindex Portable Network Graphics (PNG), output
@cindex PNG (Portable Network Graphics), output
+@item --png
Génère une image par page, au format PNG@tie{}; ceci sous-entend
l'utilisation de @option{--ps}. La résolution de l'image, en DPI, peut
se régler en ajoutant par exemple
-dresolution=110
@end example
-
-@item --pdf
@cindex Portable Document Format (PDF), output
@cindex PDF (Portable Document Format), output
+@item --pdf
Génère du PDF. Ceci sous-entend l'utilisation de @option{--ps}.
-
@item -v,--version
Affiche le numéro de version.
-
@item -V,--verbose
Active le mode verbeux@tie{}: affichage de l'intégralité du chemin
d'accès de chaque fichier, et information des temps de traitement.
-
@item -w,--warranty
-Affiche les informations de garantie appliquables à GNU LilyPond -- il
+Affiche les informations de garantie applicables à GNU LilyPond -- il
est livré @strong{SANS GARANTIE}@tie{}!
+
@end table
+@node Options avancées de lilypond
+@unnumberedsubsec Options avancées de @command{lilypond}
+@translationof Advanced command line options for LilyPond
+
+@table @code
+
+@item -d@var{[nom-option]}=@var{[valeur]},--define-default=@var{[nom-option]}=@var{[valeur]}
+Affecte la valeur Scheme @var{valeur} à l'option interne @var{nom-option} du
+programme. En l'absence de @var{valeur}, le programme utilisera @var{#t}.
+Préfixer @var{nom-option} d'un @code{no-} vous permet de désactiver une option.
+Ainsi,
+
+@cindex point and click, ligne de commande
+@cindex pointer-cliquer, ligne de commande
+
+@example
+-dno-point-and-click
+@end example
+
+@noindent
+revient au même que
+@example
+-dpoint-and-click=#f
+@end example
+@end table
+
+@noindent Voici les différentes options disponibles, ainsi que leur
+valeur par défaut.
+
+@multitable @columnfractions .33 .16 .51
+@item @strong{Symbole}
+@tab @strong{Valeur}
+@tab @strong{Observations}
+
+
+@item @code{anti-alias-factor}
+@tab @code{1}
+@tab Adopte une résolution supérieure (selon le facteur donné),puis
+réduit au niveau du résultat afin d'éviter les @qq{distorsions} des
+images @code{PNG}.
+
+@item @code{aux-files}
+@tab @code{#t}
+@tab Génère les fichiers @code{.tex}, @code{.texi} et @code{.count}
+pour le moteur de rendu @code{EPS}.
+
+@item @code{backend}
+@tab @code{'ps}
+@tab Détermine le format de sortie à utiliser par le moteur de
+traitement. Les fichiers PostScript (format par défaut) incluent les
+fontes @code{TTF}, @code{Type1} et @code{OTF}, et aucune substitution ne
+sera opérée pour ces fontes. Si vous utilisez des jeux de caractères
+orientaux, le fichier aura vite fait d'atteindre une taille conséquente.
+
+@item
+@tab @code{'eps}
+@tab Génère du PostScript encapsulé. Chaque page (système) fera l'objet
+d'un fichier @file{EPS} particulier, sans fontes, auquel sera associé un
+fichier @file{EPS} qui, lui, contiendra toutes les pages (systèmes) et
+les fontes. Notez qu'il s'agit du mode que @command{lilypond-book}
+utilise par défaut.
+
+@item
+@tab @code{'null}
+@tab Ne génère aucun fichier imprimable. Cette option est équivalente à
+@code{-dno-print-pages}.
+
+@item
+@tab @code{'svg}
+@tab Génère du@emph{Scalable Vector Graphics}. Cette option permet de
+créer un fichier @code{SVG} par page, sans incorporation des fontes.
+Nous vous recommandons d'installer les fontes Century Schoolbook
+comprises dans le paquetage LilyPond afin d'obtenir le meilleur rendu
+possible. Sous UNIX, il suffit de les recopier, à partir du répertoire
+@file{/usr/share/lilypond/VERSION/fonts/otf/}, dans @file{~/.fonts/}.
+Les fichiers @code{SVG} alors générés devraient être lisibles par votre
+éditeur SVG habituel. L'option @code{svg-woff} -- voir ci-après --
+permet d'utiliser les fontes @code{woff} avec le moteur @code{SVG}.
+
+@item
+@tab @code{'scm}
+@tab Recopie littéralement les commandes Scheme internes de formatage.
+
+@item @code{check-internal-types}
+@tab @code{#f}
+@tab Vérifie qu'à chaque propriété est bien affecté un type.
+
+@item @code{clip-systems}
+@tab @code{#f}
+@tab Génère des typons à partir d'une partition.
+
+@item @code{datadir}
+@tab
+@tab Détermine le préfixe des fichiers de données (lecture seule).
+
+@item @code{debug-gc}
+@tab @code{#f}
+@tab Génère une copie brute de la mémoire, aux fins de débogage.
+
+@item @code{debug-gc-assert-parsed-dead}
+@tab @code{#f}
+@tab Pour débogage de la mémoire@tie{}: s'assure que toute référence à
+des objets analysés est effacée. Il s'agit d'une option interne qui
+est automatiquement activée par l'option @code{`-ddebug-gc'}.
+
+@item @code{debug-lexer}
+@tab @code{#f}
+@tab Débogage de l'analyseur lexical @emph{flex}.
+
+@item @code{debug-page-breaking-scoring}
+@tab @code{#f}
+@tab Purge les calculs des configurations de saut de page.
+
+@item @code{debug-parser}
+@tab @code{#f}
+@tab Débogage de l'analyseur @emph{bison}.
+
+@item @code{debug-property-callbacks}
+@tab @code{#f}
+@tab Débogage des chaînes de @emph{callback} cycliques.
+
+@item @code{debug-skylines}
+@tab @code{#f}
+@tab Débogage des lignes d'horizon.
+
+@item @code{delete-intermediate-files}
+@tab @code{#t}
+@tab Supprime les fichiers @code{.ps} inutiles crées lors de la
+compilation.
+
+@item @code{dump-cpu-profile}
+@tab @code{#f}
+@tab Génère une copie brute des informations de timing (dépend du
+système).
+
+@item @code{dump-profile}
+@tab @code{#f}
+@tab Génère une copie brute de la mémoire et des temps de traitement
+pour chaque fichier.
+
+@item @code{dump-signatures}
+@tab @code{#f}
+@tab Génère une copie des signatures de chaque système. Cette option
+est utilisée pour les tests de régression.
+
+@item @code{eps-box-padding}
+@tab @code{#f}
+@tab Décale le bord gauche du typon EPS d'une valeur donnée en
+millimètres.
+
+@item @code{gs-load-fonts}
+@tab @code{#f}
+@tab Charge les fontes grâce à Ghostscript.
+
+@item @code{gs-load-lily-fonts}
+@tab @code{#f}
+@tab Limites les fontes chargées par Ghostscript aux seules fontes
+LilyPond.
+
+@item @code{gui}
+@tab @code{#f}
+@tab Travaille silencieusement, et redirige tout le verbiage dans un
+fichier journal.
+@end multitable
+
+@noindent
+@strong{Note à l'attention des utilisateurs de Windows@tie{}:} toutes
+les informations concernant le traitement apparaissent au fur et à
+mesure dans l'interpréteur de commandes lorsque vous lancez le programme
+@code{lilypond.exe}, à l'inverse de @w{@code{lilypond-windows.exe}} qui
+vous renvoie simplement la main. L'option @option{-dgui} vous permettra
+alors de rediriger ces informations dans un fichier journal.
+
+@multitable @columnfractions .33 .16 .51
+@item @code{help}
+@tab @code{#f}
+@tab Affiche cette aide.
+
+@item @code{include-book-title-preview}
+@tab @code{#t}
+@tab Inclut les titres de l'ouvrage dans les images de prévisualisation.
+
+@item @code{include-eps-fonts}
+@tab @code{#t}
+@tab Inclut les fontes dans chaque fichier EPS contenant un système.
+
+@item @code{include-settings}
+@tab @code{#f}
+@tab Inclut un fichier contenant les réglages globaux. Ce fichier sera
+inclus avant traitement de la partition.
+
+@item @code{job-count}
+@tab @code{#f}
+@tab Traite plusieurs fichiers en parallèle, selon le nombre de
+@emph{jobs}.
+
+@item @code{log-file}
+@tab @code{#f [fichier]}
+@tab Fournir @code{TOTO} en second argument redirigera la sortie dans le
+fichier journal @code{TOTO.log}.
+
+@item @code{max-markup-depth}
+@tab @code{1024}
+@tab Profondeur maximale de l'arborescence de @emph{markups}. Si un
+@emph{markup} était plus profond, part du principe qu'on aboutira pas,
+émet un avertissement et renvoie alors un @emph{markup} vide.
+
+@item @code{midi-extension}
+@tab @code{"midi"}
+@tab Détermine l'extension par défaut des fichiers MIDI, selon la chaîne
+donnée en argument.
+
+@item @code{music-strings-to-paths}
+@tab @code{#f}
+@tab Convertit les chaînes textuelles en chemins lorsque les glyphes
+font partie d'une fonte musicale.
+
+@item @code{old-relative}
+@tab @code{#f}
+@tab Affecte au mode @code{\relative} le même comportement pour de la
+musique simultanée que celui d'une syntaxe d'accords.
+
+@cindex paper-size, ligne de commande
+@item @code{paper-size}
+@tab @code{\"a4\"}
+@tab Détermine la taille par défaut du papier. Veillez à ne pas oublier
+d'encadrer la valeur par des guillemets échappés (@code{\"}).
+@c Match " in context-sensitive editors
+
+@item @code{pixmap-format}
+@tab @code{png16m}
+@tab Détermine le format de sortie en images pixélisées pour
+Ghostscript.
+
+@item @code{point-and-click}
+@tab @code{#f}
+@tab Ajoute les liens @qq{point & click} à la sortie @code{PDF}. Voir
+@ref{Pointer-cliquer}.
+
+@cindex format de sortie, définition
+@cindex preview, ligne de commande
+@item @code{preview}
+@tab @code{#f}
+@tab Génère une prévisualisation en plus de la sortie normale.
+@end multitable
+
+@noindent
+Cette option, disponible dans tous les formats de sortie imprimables --
+@code{pdf}, @code{png}, @code{ps}, @code{eps} et @code{svg} -- génère
+un fichier de la forme @code{monFichier.preview.extension} comprenant le
+titrage et le premier système. S'il existe plusieurs sections
+@code{\book}, @code{\bookpart}, ce fichier contiendra les titrage et
+premier système de chacun des @code{\book}, @code{\bookpart} et
+@code{\score}, dès lors que la variable @code{print-all-headers} du bloc
+@code{\paper} est activée.
+
+Pour l'éviter, utilisez conjointement l'une des options
+@option{-dprint-pages} ou @option{-dno-print-pages} selon vos besoins.
+
+@multitable @columnfractions .33 .16 .51
+@item @code{print-pages}
+@tab @code{#t}
+@tab Génère l'intégralité des pages de la partition. L'option
+@option{-dno-print-pages} est particulièrement utile lorsqu'utilisée
+conjointement avec l'option @option{-dpreview}.
+
+@item @code{profile-property-accesses}
+@tab @code{#f}
+@tab Enregistre des statistiques des appels à la fonction
+@code{get_property()}.
+
+@item @code{protected-scheme-parsing}
+@tab @code{#t}
+@tab Continue en dépit des erreurs que l'analyseur syntaxique
+détecterait dans du code Scheme inclus. Lorsque basculé sur @code{#f},
+stoppe le traitement s'il y a erreur et affiche une trace de la pile.
+
+@item @code{read-file-list}
+@tab @code{#f [fichier]}
+@tab Spécifie un fichier listant les différents fichier sources à
+traiter.
+
+@item @code{relative-includes}
+@tab @code{#f}
+@tab Face à une instruction @code{\include}, recherche les fichiers à
+inclure relativement à l'endroit où se trouve le fichier en cours de
+traitement plutôt que par rapport au fichier maître.
+
+@item @code{resolution}
+@tab @code{101}
+@tab Détermine, en @code{dpi}, la résolution des pixmaps @code{PNG} à
+générer selon la valeur donnée.
+
+@item @code{safe}
+@tab @code{#f}
+@tab Ne pas avoir une confiance aveugle dans le code @file{.ly}.
+@end multitable
+
+@noindent
+Lorsque LilyPond est accessible au travers d'un serveur web, il est
+@strong{impératif} d'utiliser les options @option{--safe} ou
+@option{--jail}. L'option @option{--safe} aura pour effet d'empêcher
+tout code Scheme inclus de mettre en péril votre installation grâce à
+quelque chose du style
+
+@quotation
+@verbatim
+#(system "rm -rf /")
+{
+ c4^$(ly:gulp-file "/etc/passwd")
+}
+@end verbatim
+@end quotation
+
+L'option @code{-dsafe} forcera l'évaluation, au fil de l'eau et par un
+module sécurisé, des expressions Scheme contenues dans le fichier
+source. Ce module sécuritaire, dérivé du module GUILE @file{safe-r5rs},
+ajoute un certain nombre de fonctions -- listées dans
+@file{scm/safe-lily.scm} -- à l'API de LilyPond.
+
+De plus, le mode @emph{safe} ne permet ni l'utilisation de directives
+@code{\include} ni le recours aux obliques inversées (@emph{backslash})
+dans les chaînes @TeX{}. L'import de variables LilyPond dans du code
+Scheme n'est pas possible en mode sécuritaire.
+
+L'option @code{-dsafe} @strong{ne détecte pas} l'utilisation abusive des
+ressources. Il est donc possible que le programme finisse par rester
+sans réponse si on lui envoie une boucle sans fin. C'est la raison pour
+laquelle nous recommandons, lorsque LilyPond tourne sur un serveur
+accessible au public, d'en limiter aussi bien les ressources processeur
+que mémoire.
+
+Notez bien que l'utilisation du mode sécuritaire empêchera aussi la
+compilation d'un certain nombre de fragments LilyPond. L'option
+@code{--jail} est dans ce cas une excellente alternative en terme de
+sécurité, même si elle requiert plus de temps à mettre en place -- voir
+@ref{Options basiques de lilypond}.
+
+@multitable @columnfractions .33 .16 .51
+@item @code{separate-log-files}
+@tab @code{#f}
+@tab Pour les fichiers @code{FICHIER1.ly}, @code{FICHIER2.ly} etc.
+enregistre le déroulement dans les journaux @code{FICHIER1.log},
+@code{FICHIER2.log}@dots{}
+
+@item @code{show-available-fonts}
+@tab @code{#f}
+@tab Liste le nom des fontes disponibles.
+
+@item @code{strict-infinity-checking}
+@tab @code{#f}
+@tab Force le crash en présence des points d'exception de virgule
+flottante @code{Inf} ou @code{NaN} -- infini ou non-nombre.
+
+@item @code{strip-output-dir}
+@tab @code{#t}
+@tab Supprime, lors du nommage des fichiers résultant, la partie
+correspondant au répertoire des fichiers sources.
+
+@item @code{svg-woff}
+@tab @code{#f}
+@tab Utilise, avec le moteur SVG, les fontes @code{woff}.
+
+@item @code{trace-memory-frequency}
+@tab @code{#f}
+@tab Enregistre l'utilisation de la cellule Scheme plusieurs fois par
+seconde, dans les fichiers @code{FICHIER.stacks} et
+@code{FICHIER.graph}.
+
+@item @code{trace-scheme-coverage}
+@tab @code{#f}
+@tab Enregistre la couverture des fichiers Scheme dans @code{FILE.cov}.
+
+@item @code{verbose}
+@tab @code{#f}
+@tab Passe en mode verbeux, ce qui correspond à un niveau de
+journalisation @code{DEBUG} (lecture seule).
+
+@item @code{warning-as-error}
+@tab @code{#f}
+@tab Considère tous les messages d'avertissement et @qq{erreur de
+programmation} comme étant de véritables erreurs.
+@end multitable
+
+
@node Variables d'environnement
@unnumberedsubsec Variables d'environnement
@translationof Environment variables
@itemize
-@item Installation des paquetages nécessaires@tie{}: LilyPond, GhostScript et
+@item Installation des paquetages nécessaires@tie{}: LilyPond, Ghostscript et
ImageMagick.
@item Création de l'utilisateur @code{lily} :
cp -L /usr/bin/convert /usr/bin/gs usr/bin
cp -L /usr/share/fonts/truetype usr/share/fonts
-# la formule magique de recopie des biblothèques
+# la formule magique de recopie des bibliothèques
for i in "$lilydir/usr/bin/lilypond" "$lilydir/usr/bin/guile" "/bin/sh" \
"/bin/rm" "/usr/bin/gs" "/usr/bin/convert"; do ldd $i | sed 's/.*=> \
\/\(.*\/\)\([^(]*\).*/mkdir -p \1 \&\& cp -L \/\1\2 \1\2/' | sed \
positionnez régulièrement des contrôles de barre de mesure -- voir
@ruser{Vérification des limites et numéros de mesure}.
-Si vous tenez absolument à enchainer de tels débordements, vous devrez
+Si vous tenez absolument à enchaîner de tels débordements, vous devrez
insérer des barres de mesure invisibles là où vous souhaitez positionner
un saut de ligne. Consultez le chapitre @ruser{Barres de mesure} pour
plus de détails.
@end lilypond
Autre exemple : la présence d'une commande @code{\relative} à
-l'intérieur d'une section @code{\repeat} génèrera obligatoirement une
+l'intérieur d'une section @code{\repeat} générera obligatoirement une
portée intempestive. Cela tient au fait que la commande @code{\repeat}
va créer deux blocs @code{\relative} qui, chacun à leur tour, créeront
implicitement un bloc @code{Staff} assorti d'un bloc @code{Voice}.
@c -*- coding: utf-8; mode: texinfo; documentlanguage : fr -*-
@ignore
- Translation of GIT committish: 70f44b888f365e1f27f7f54c3b1b2cb552a18bd4
+ Translation of GIT committish: 24f9636ac779b4c0de197f60bf4f922c16be5ec4
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
LilyPond.
@item
-@ref{Signalement de bogue} : disfonctionnement du programme.
+@ref{Signalement de bogue} : dysfonctionnement du programme.
@end itemize
@divEnd
@item
@ref{Développement} : pour ceux qui veulent contribuer et tester.
+@item
+@ref{GSoC}: liste des projets pour le Google Summer of Code.
+
@item
@ref{Auteurs} : ceux qui ont permis à LilyPond d'être ce qu'il est
aujourd'hui.
@item
@ref{Archives} : archives des dépêches.
+@item
+@ref{Grenier} : annonces et recensement des modifications intervenues
+aux cours des versions précédentes.
+
@end itemize
@divEnd
* Participation::
* Mécénat::
* Développement::
+* GSoC::
* Auteurs::
* Publications::
* Archives::
+* Grenier::
@end menu
@divEnd
@subsubheading LilyPond Report
-Le @uref{http://news.lilynet.net/, LilyPond Report} est le bulletin de
-la communauté. À lire pour savoir ce qui se passe.
+Le LilyPond Report est le bulletin de la communauté. À lire pour savoir
+ce qui se passe.
+
+@example
+@uref{http://news.lilynet.net}
+@end example
@subsubheading Liste de diffusion des versions : @code{info-lilypond@@gnu.org}
@c don't include gmane posting here. -gp
@end quotation
-
@divEnd
@divEnd
+
@divClass{column-right-bottom}
@subheading Courriels sensibles
@item
Le cas échéant, joignez une image de ce à quoi vous voulez arriver.
+
@end itemize
@divEnd
@unnumberedsec Signalement de bogue
@translationof Bug reports
+@divClass{heading-center}
+Si votre saisie entraîne un crash ou une sortie erronée, c'est un bogue.
+@divEnd
+
+
@divClass{column-center-top}
@subheading Étape 1 : Le bogue est-il déjà recensé ?
-Si votre saisie entraîne un crash ou une sortie erronée, c'est un bogue.
Un recensement des bogues non encore résolus est disponible sur notre
@emph{google bug tracker}@tie{}; suivez le lien
@uref{http://code.google.com/p/lilypond/issues/list}
@end example
-@warning{Nous vous remercions de ne pas ajouter directement de
+@warning{Nous vous saurons gré de ne pas ajouter directement de
signalement sur le traceur de bogues. Vous pourrez toujours, une fois
qu'il aura été dûment répertorié, y apporter vos commentaires et
compléments d'information.}
Une fois le message reçu, nos @qq{exterminateurs de bogues} analyseront
votre rapport et vous demanderont peut-être des informations
-supplémentaires avant de l'ajouter au traceur. Dans la mesure où
+complémentaires avant de l'ajouter au traceur. Dans la mesure où
l'équipe est réduite, merci de leur laisser quelques jours avant
qu'ils ne vous transmettent le numéro de référence de votre signalement
une fois qu'il aura été ajouté à la base.
-Vous serez automatiquement notifié du traitement apporté à ce bogue, dès
-lors que vous avez une compte chez google.
+Vous pourrez alors, après l'avoir @qq{marqué}, y apporter vos
+commentaires et être automatiquement notifié du traitement apporté à ce
+bogue, dès lors que vous avez un compte chez google.
@divEnd
@divClass{column-center-bottom}
Une fois votre requête enregistrée, n'hésitez pas à nous indiquer le
résultat que vous escomptiez. Qu'il s'agisse d'un bout de code ou d'une
-image -- réalisée à partir de n'importe quel outil --, tant qu'il nous
+image -- réalisée à partir de n'importe quel outil --, tant que cela nous
aide à voir ce que vous désirez obtenir.
@divEnd
@divClass{column-left-top}
@divClass{keep-bullets}
-@helpusTasks
+@helpusSimple
@divEnd
@divEnd
@divClass{column-right-top}
-@helpusProjects
+@helpusAdvanced
@divEnd
@end ifset
+@c we normally don't allow named references, but in this case
+@c it's good to emphasize the "stable" part. -gp
@warning{Il s'agit des versions @emph{instables et de développement}.
Si vous avez le moindre doute quant à l'utilisation ou l'installation de
LilyPond, nous vous enjoignons à utiliser le
-@ref{Téléchargement,téléchargement de la version stable} et la
-lecture des @ref{Manuels,manuels pour la version stable}.}
+@ref{Téléchargement, téléchargement de la version stable} et la
+lecture des @ref{Manuels, manuels pour la version stable}.}
@divEnd
@divClass{column-center-top}
@subheading Numérotation des versions
-Il existe deux jeux de version pour LilyPond@tie{} des versions stables
+Il existe deux jeux de version pour LilyPond@tie{}: des versions stables
et des versions instables de développement. Les versions stables
comportent, en versionnage @qq{mineur}, un numéro pair (par ex. 2.8,
-2.10, ou 2.12). Les versions de développement, quant à elles,
+2.10 ou 2.12). Les versions de développement, quant à elles,
comportent un versionnage @qq{mineur} impair (par ex. 2.7, 2.9 ou 2.11).
@divEnd
@uref{http://git.sv.gnu.org/gitweb/?p=lilypond.git, dépôt git de LilyPond}
@end quotation
-Les rédacteurs de la documentation ainsi que les testeurs préfèreront
+Les rédacteurs de la documentation ainsi que les testeurs préféreront
travailler à partir des binaires les plus à jour@tie{}:
@quotation
la stabilité de ce système, nous avons rédigé un manuel dédié aux
activités de développement.
-@warning{Dans la mesure où le développement de LilyPond est disséminé
+@warning{Dans la mesure où les développeurs de LilyPond sont disséminés
sur la planète, il n'est pas prévu que ce document soit un jour
traduit@dots{}}
@item
@uref{../../input/regression/lilypond-book/collated-files.html,
Test de lilypond-book} relatifs à ce niveau de mise à jour
-(@uref{../../input/regression/lilypond-book/collated-files.pdf, versionpdf}).
+(@uref{../../input/regression/lilypond-book/collated-files.pdf, version pdf}).
@end itemize
@end ifclear
@subsubheading Toutes versions
@itemize
-@item @uref{http://lilypond.org/test, Archives des tests de régression} :
-Comparaisons entre différentes versions.
+@item @uref{http://lilypond.org/test,
+Comparaison entre différentes versions}
+
+@item @uref{http://lilypond.org/download/binaries/test-output/,
+Archive de tous les tests de régression}
@end itemize
@divEnd
-
@divClass{column-center-bottom}
@subheading Manuels
@docLinkPdf{Initiation,learning,@manualDevelLearningPdf-fr}
@item
-@docLinkSplit{Glossaire,music-glossary,@manualDevelGlossarySplit-fr}
+@docLinkSplit{Glossaire,music-glossary,@manualDevelGlossarySplit}
@tab
-@docLinkBig{Glossaire,music-glossary,@manualDevelGlossaryBig-fr}
+@docLinkBig{Glossaire,music-glossary,@manualDevelGlossaryBig}
@tab
-@docLinkPdf{Glossaire,music-glossary,@manualDevelGlossaryPdf-fr}
+@docLinkPdf{Glossaire,music-glossary,@manualDevelGlossaryPdf}
@item
@docLinkSplit{Essai,essay,@manualDevelEssaySplit-fr}
@docLinkPdf{Utilisation,usage,@manualDevelUsagePdf-fr}
@item
-@docLinkSplit{Morceaux choisis,snippets,@manualDevelSnippetsSplit-fr}
+@docLinkSplit{Morceaux choisis,snippets,@manualDevelSnippetsSplit}
@tab
-@docLinkBig{Morceaux choisis,snippets,@manualDevelSnippetsBig-fr}
+@docLinkBig{Morceaux choisis,snippets,@manualDevelSnippetsBig}
@tab
-@docLinkPdf{Morceaux choisis,snippets,@manualDevelSnippetsPdf-fr}
+@docLinkPdf{Morceaux choisis,snippets,@manualDevelSnippetsPdf}
@headitem Utilisation ponctuelle
@docLinkPdf{Web,web,@manualDevelWebPdf-fr}
@item
-@docLinkSplit{Nouveautés,changes,@manualDevelChangesSplit-fr}
+@docLinkSplit{Nouveautés,changes,@manualDevelChangesSplit}
@tab
-@docLinkBig{Nouveautés,changes,@manualDevelChangesBig-fr}
+@docLinkBig{Nouveautés,changes,@manualDevelChangesBig}
@tab
-@docLinkPdf{Nouveautés,changes,@manualDevelChangesPdf-fr}
+@docLinkPdf{Nouveautés,changes,@manualDevelChangesPdf}
@item
@docLinkSplit{Extension,extending,@manualDevelExtendingSplit-fr}
@docLinkPdf{Extension,extending,@manualDevelExtendingPdf-fr}
@item
-@docLinkSplit{Références internes,internals,@manualDevelInternalsSplit-fr}
+@docLinkSplit{Références internes,internals,@manualDevelInternalsSplit}
@tab
-@docLinkBig{Références internes,internals,@manualDevelInternalsBig-fr}
+@docLinkBig{Références internes,internals,@manualDevelInternalsBig}
@tab
-@docLinkPdf{Références internes,internals,@manualDevelInternalsPdf-fr}
+@docLinkPdf{Références internes,internals,@manualDevelInternalsPdf}
@ifset web_version
@headitem En téléchargement
@divEnd
+@node GSoC
+@unnumberedsec GSoC
+@translationof GSoC
+
+
+@divClass{column-center-top}
+@subheading Le Google Summer of Code
+
+Pour reprendre les termes même du
+@uref{http://www.google-melange.com/gsoc/homepage/google/gsoc2012,
+site du GSoC},
+@qq{Le Google Summer of Code est un programme global qui rémunère des
+étudiants pour écrire du code au bénéfice de projets @emph{open source}.
+Google a travaillé de concert avec la communauté @emph{open source} afin
+d'identifier et subventionner des projets passionnants au cours de l'été
+prochain.}
+
+L'équipe LilyPond considère qu'il s'agit là d'une excellente opportunité
+pour recruter de nouveaux contributeurs, encourager et motiver les
+étudiants qui participent déjà au développement de LilyPond et,
+pourquoi pas, écrire du code qui bénéficiera à tout le monde.
+
+Nous participons au GSoC sous l'égide du projet GNU. Vous trouverez
+plus d'informations sur les conditions de participations sur la
+@uref{http://www.gnu.org/software/soc-projects/guidelines.html,
+page GNU GSoC}.
+
+@divEnd
+
+
+@divClass{column-center-bottom}
+@subheading Recensement de nos idées
+
+Voici les projets que nous proposons aux étudiants du GSoC. N'hésitez
+pas à émettre vos propres suggestions si aucun d'entre eux ne vous
+convient. Par ailleurs, si l'un de ces projets vous semble trop
+volumineux, il est toujours possible d'en réduire l'ampleur.
+
+Nous exigeons des étudiants intéressés un minimum de connaissances de
+@code{git}. En dehors du dernier projet, il serait souhaitable que les
+candidats connaissent un peu la musique.
+
+
+@subheading Notes d'ornement (grace notes)
+
+Résolution des problèmes de synchronisation des notes d'ornement, tout
+en tenant compte de l'architecture sous-jacente (voir
+@uref{http://code.google.com/p/lilypond/issues/detail?id=34,
+le numéro 34 de notre traceur}). Les notes d'ornement perturbent
+LilyPond dans sa gestion du temps, dans la mesure où elles correspondent
+quelque peu à un retour en arrière. Ceci entraîne des effets
+indésirables tout particulièrement lorsqu'elles interviennent dans une
+portée seulement.
+
+@strong{Difficulté :} moyenne
+
+@strong{Préalables :} C++, MIDI
+
+@strong{Recommandé :} familiarité avec les arcanes de LilyPond
+
+@strong{Mentors :} Mike Solomon, Carl Sorensen
+
+
+@subheading MusicXML
+
+Ajout d'une fonctionnalité d'export au format MusiXML et amélioration de
+l'import, tout en fournissant des tests de performance. Selon le temps
+imparti, ceci pourrait se restreindre à@tie{}:
+
+@divClass{keep-bullets}
+@itemize
+
+@item
+L'exportation d'un minimum d'informations musicales tel que cela se
+pratique déjà au niveau du MIDI, autrement dit à l'aide de classes
+d'exportateurs dérivées de la classe @emph{translator}@tie{};
+
+@item
+Construction de l'arborescence XML d'après le contenu musical de base, et
+connexion des éléments musicaux à des balises XML@tie{};
+
+@item
+Faire en sorte que tous les graveurs LilyPond restent pleinement
+opérationnels@tie{};
+
+@item
+Ajout d'une capacité de lier tout objet de rendu -- autrement dit chaque
+stencil ou groupe de stencils -- à l'élément musical qui en est la
+cause et, par voie de conséquence, à la balise correspondante dans
+l'arborescence XML@tie{};
+
+@item
+Ajout d'un moteur de rendu XML qui pourrait alors inclure l'information
+de mise en forme pour tout objet de rendu dans les balises XML.
+
+@end itemize
+@divEnd
+
+Le but sera considéré atteint dès lors qu'une partition en XML aura été
+importée, puis ré-exportée dans ce même format sans perte non
+intentionnelle de donnée.
+
+@strong{Difficulté :} moyenne
+
+@strong{Préalables :} MusicXML, Python, les bases de LilyPond
+
+@strong{Mentors :} Reinhold Kainhofer, Mike Solomon
+
+La connaissance d'autres éditeurs de partition, dans un but de tests
+comparatifs, constituerait un plus.
+
+
+@subheading Amélioration des liaisons
+
+Le galbe par défaut des liaisons n'est souvent pas pleinement
+satisfaisant. Il est par ailleurs impossible de marquer une liaison de
+prolongation entre des enharmoniques (@code{@{ cis'~ des' @}}), et la
+@qq{coupure} d'une liaison par un changement de clef ou de ligne n'est
+pas totalement fonctionnelle. Ce projet comporte entre autres un
+recensement d'exemples de résultats défectueux, l'appréciation du
+résultat optimal et l'écriture du code approprié.
+
+@strong{Difficulté :} difficile
+
+@strong{Préalables :} C++, expérience dans l'écriture d'heuristiques
+
+@strong{Connaissances appréciées :} LilyPond, sens de l'esthétique
+
+@strong{Mentor :} Mike Solomon
+
+
+@subheading Ajout de variantes spécifiques pour certains glyphes
+
+Il s'agit ici de pouvoir disposer de variantes, sur la ligne ou entre
+deux lignes, plus courts ou plus étroits, pour certains glyphes -- les
+altérations par exemple -- ainsi que d'une infrastructure générique de
+gestion. Autre exemple, dans le domaine de la notation ancienne, avec
+deux variantes de la brève, l'une avec un évidement plus important que
+l'autre.
+
+@strong{Difficulté :} facile
+
+@strong{Préalables :} MetaFont, C++, une bonne vue pour les détails
+
+@strong{Connaissance appréciée :} les bases de LilyPond
+
+@strong{Mentor :} Werner Lemberg
+
+
+@subheading Amélioration des ligatures
+
+Le positionnement des ligatures, qu'elles soient rectilignes, passent
+d'une portée à l'autre, discontinues ou coudées, n'est pas optimal.
+Une ligature devrait dépendre du contexte et des notes adjacentes (voir
+@uref{http://icking-music-archive.org/lists/sottisier/sottigra.pdf,
+la section 2.2 de cet article}). Dans la mesure du possible, raccourcir
+le temps de calcul nécessaire à la génération des ligatures.
+
+@strong{Difficulté :} moyenne
+
+@strong{Préalables :} C++, expérience dans l'écriture d'heuristiques
+
+@strong{Connaissance appréciée :} sens de l'esthétique
+
+@strong{Mentors :} Mike Solomon, Carl Sorensen
+
+
+@subheading Amélioration du support des tablatures
+
+@divClass{keep-bullets}
+@itemize
+
+@item
+Accordages non monotoniques, tel le Ukulele ;
+
+@item
+Création d'un mode de saisie spécifique -- pour l'instant, l'information
+musicale est saisie en notation occidentale moderne, comme @qq{un fa
+dièse noire}, puis convertie en tablature -- pour faciliter la
+transcription de tablatures médiévales pour luth@tie{};
+
+@item
+Implémentation de fonctionnalités de tablatures modernes, tels les
+désinences, pichenettes et tapotements@tie{};
+
+@item
+Un diagramme de fret correspondant à un accord particulier devrait
+pouvoir permettre de reproduire cet accord sur la portée, sans être
+limité à l'accord par défaut.
+
+@end itemize
+@divEnd
+
+@strong{Difficulté :} facile
+
+@strong{Préalable :} C++
+
+@strong{Connaissance appréciée :} notation en tablature
+
+@strong{Mentor :} Carl Sorensen
+
+
+@subheading Nettoyage des messages en cours de compilation
+
+Il s'agit d'assainir les messages du compilateur, l'analyse du code
+statique, ainsi que les messages de @emph{valgrind}. Les outils
+d'analyse automatique du code (messages en @code{g++} ou @code{clang})
+ainsi que les outils d'analyse comme @emph{valgrind} pour les
+éventuelles fuites de mémoire ou @emph{callgrind} pour le profilage du
+code, fournissent des informations précieuses quant à d'éventuelles
+faiblesses du code C++. Faire le ménage dans tous ces messages nous
+permettrait de rejeter tout patch qui introduirait des messages
+superflus.
+
+@strong{Difficulté :} moyenne
+
+@strong{Préalable :} C++
+
+@strong{Mentors :} Joe Neeman, Reinhold Kainhofer
+
+@divEnd
@node Auteurs
@divEnd
@divClass{column-right-top}
-@subheading Ceux qui ont participé
+@subheading Ceux qui ont participé dans le passé
@divClass{keep-bullets}
@developersPrevious
@subheading Ce que nous avons écrit
@divClass{keep-bullets}
-@itemize
-
-@item
-Han-Wen Nienhuys, @emph{LilyPond, Automated music formatting and
-the Art of Shipping}. Forum international du logiciel libre 2006
-(FISL7.0) (@uref{http://lilypond.org/website/pdf/FISL7-slides.pdf,
-PDF 1095k})
-
-@item
-Erik Sandberg, @emph{Séparer le langage source et le système de
-formatage dans GNU LilyPond (Separating input language and formatter in
-GNU LilyPond)}. Thèse de master, université d'Uppsala, Département des
-technologies de l'information, mars@tie{}2006.
-(@uref{http://lilypond.org/website/pdf/thesis-erik-sandberg.pdf,
-PDF 750k})
-
-@item
-Han-Wen Nienhuys et Jan Nieuwenhuizen, @emph{LilyPond, un système de
-gravure musicale automatisée}. Actes du 14e Colloque d'informatique
-musicale (XIV CIM 2003), Florence, Itale, mai@tie{}2003.
-(@uref{ http://lilypond.org/website/pdf/xivcim.pdf, PDF 95k})
-@end itemize
+@include we-wrote.itexi
@divEnd
@divEnd
@divClass{column-center-bottom}
-
@subheading Ce que certains ont fait avec LilyPond
-
@divClass{keep-bullets}
-@itemize
-@item
-Graham Percival, Tosten Anders et George Tzanetakis,
-@emph{Generating Targeted Rhythmic Exercises for Music Students
-with Constraint Satisfaction Programming}, International Computer
-Music Conference 2008.
-
-@item
-Alexandre Tachard Passos, Marcos Sampaio, Pedro Kröger, Givaldo de
-Cidra, @emph{Functional Harmonic Analysis and Computational Musicology
-in Rameau}, Proceedings of the 12th Brazilian Symposium on Computer
-Music, 2009, p. 207-210.
-
-@item
-Alberto Simões, Anália Lourenço et José João Almeida,
-@emph{Using Text Mining Techniques for Classical Music Scores Analysis},
-New Trends in Artificial Intelligence, 2007 J. Neves et al ed.
-
-@item
-Kevin C. Baird 2005,
-@emph{Real-time generation of music notation via audience interaction
-using python and GNU lilypond}. Proceedings of the 2005 Conference on
-New interfaces For Musical Expression (Vancouver, Canada, May 26 - 28,
-2005). New Interfaces For Musical Expression. National University of
-Singapore, Singapore, 240-241.
-
-@end itemize
+@include others-did.itexi
@divEnd
@divEnd
+@contactUsAbout{publications universitaires}
+
@node Archives
@unnumberedsec Archives
@translationof Old news
+@divClass{heading-center}
+@warning{Le vieilles annonces et informations de version sont rangées au
+@rwebnamed{Grenier,grenier}.}
+@divEnd
+
@include web/news-front.itexi
@include web/news.itexi
+
+@node Grenier
+@unnumberedsec Grenier
+@translationof Attic
+
+@divClass{column-center-top}
+@subheading Annonces
+
+Annonces et nouvelles, par version :
+@miscLink{announce-v2.12,v2.12},
+@miscLink{announce-v2.12.de,v2.12 (allemand)},
+@miscLink{announce-v2.12.es,v2.12 (espagnol)},
+@miscLink{announce-v2.12.fr,v2.12 (français)},
+@miscLink{announce-v2.10,v2.10},
+@miscLink{announce-v2.8,v2.8},
+@miscLink{announce-v2.6,v2.6},
+@miscLink{announce-v2.4,v2.4},
+@miscLink{announce-v2.2,v2.2},
+@miscLink{announce-v2.0,v2.0},
+@miscLink{NEWS-1.4,v1.4},
+@miscLink{NEWS-1.2,v1.2 (1)},
+@miscLink{ANNOUNCE-1.2,v1.2 (2)},
+@miscLink{ANNOUNCE-1.0,v1.0},
+@miscLink{ANNOUNCE-0.1,v0.1}
+
+@divEnd
+
+@divClass{column-center-bottom}
+@subheading Journal des modifications
+
+Modifications et apports, par version :
+@miscLink{ChangeLog-2.10,v2.10},
+@miscLink{ChangeLog-2.3,v2.3},
+@miscLink{ChangeLog-2.1,v2.1},
+@miscLink{ChangeLog-1.5,v1.5 (1)},
+@miscLink{CHANGES-1.5,v1.5 (2)},
+@miscLink{CHANGES-1.4,v1.4},
+@miscLink{CHANGES-1.3,v1.3},
+@miscLink{CHANGES-1.2,v1.2},
+@miscLink{CHANGES-1.1,v1.1},
+@miscLink{CHANGES-1.0,v1.0},
+@miscLink{CHANGES-0.1,v0.1},
+@miscLink{CHANGES-0.0,v0.0}
+
+@divEnd
@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@c This file is part of web.texi
@ignore
- Translation of GIT committish: c299f84d574ac9b97ab7ffbb640b5c3a1cdca5cc
+ Translation of GIT committish: 24f9636ac779b4c0de197f60bf4f922c16be5ec4
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@docLinks{Extension, extending,
@rextendnamed{Top,Extension},
- @manualStableExtendingSplit,
- @manualStableExtendingBig, 200 KB,
- @manualStableExtendingPdf, 400 KB}
+ @manualStableExtendingSplit-fr,
+ @manualStableExtendingBig-fr, 200 KB,
+ @manualStableExtendingPdf-fr, 400 KB}
@divEnd
@c contributor/introduction.itely
@ignore
- Translation of GIT committish: 66e5185e494d29c40ec25d5f71326836204cd680
+ Translation of GIT committish: 0942948dca35950b6e9cd3529ada31c38360e184
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@end macro
-@macro helpusTasks
+@macro helpusSimple
@subheading Compiti semplici
-Non è richiesto compilare o lavorare sul codice sorgente!
+@strong{Non è necessario} saper programmare!
@itemize
@item
Segnalazione bug: aiuta gli utenti a creare una @rweb{Segnalazione bug}
corretta e/o entra nel Bug Squad per l'organizzazione dei @rcontribnamed{Issues, Problemi}.
+@item
+@rcontrib{Grand Regression Test Checking}: verifica che LilyPond funzioni
+correttamente esaminando l'output dei test. Controllare un frammento di codice
+richiede meno di un minuto!
+
@item
Documentazione: puoi proporre piccole modifiche seguendo le linee
guida per i @rcontribnamed{Documentation suggestions,Consigli per la documentazione}.
e il test di nuove funzionalità. Contribuisci a queste discussioni!
@end itemize
+@end macro
+@macro HelpusAdvanced
@subheading Compiti avanzati
Questi compiti di solito richiedono il codice sorgente e la capacità di
@rcontribnamed{Working with source code,Lavorare col codice sorgente} e
@rcontribnamed{Compiling,Compilare}.
+Si consiglia di iniziare con la lettura
+del @rcontribnamed{Summary for experienced developers,Sommario per programmatori esperti}.
+
@itemize
@item
Documentazione: per ampie modifiche si veda
@end macro
-
+@ignore
@macro helpusProjects
@subheading Progetti
grandi in futuro.
@end macro
-
+@end ignore
\input texinfo @c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
@c This file is part of lilypond-learning.tely
@ignore
- Translation of GIT committish: 1c846b2c2348b4e0ca4a3c2e8fb267047ba2d203
+ Translation of GIT committish: 08560a1b8076630c4fc6cb9b902614d8b74fd6fc
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
@ignore
- Translation of GIT committish: d6315a746c47259f56dc2835347985658d71d0c9
+ Translation of GIT committish: d6b6b53d09a0fb8e137e7cfcec39fe22dc7b6872
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@lilypond[verbatim,quote,relative=2]
r4 <c e g>~ <c f a>2 |
-<c e g>8[ <c f a> <c e g> <c f a>] <c e g>\>[ <c f a> <c f a> <c e g>]\! |
+<c e g>8[ <c f a> <c e g> <c f a>]
+ <c e g>8\>[ <c f a> <c f a> <c e g>]\! |
r4 <c e g>8.\p <c f a>16( <c e g>4-. <c f a>) |
@end lilypond
@c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
@ignore
- Translation of GIT committish: fb04880077ab1b4107815ab50b171a97e2fd3772
+ Translation of GIT committish: f1d318170db686e9215c391a448975d5e88fad91
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
costrutto per scrivere tre o più voci aggiungendo più backslash.
I contesti della voce hanno i nomi @code{"1"}, @code{"2"}, etc.
-In ogni contesto, la direzione verticale di legature di portamento,
-gambi, legature di valore, dinamica, etc., è impostata correttamente.
+I primi contesti impostano le voci @emph{più esterne}, la voce
+più alta nel contesto @code{"1"} e la più bassa nel @code{"2"}. Le voci
+più interne vanno nei contesti @code{"3"} e @code{"4"}. In ogni
+contesto, la direzione verticale di legature di portamento, gambi,
+legature di valore, dinamica, etc., è impostata correttamente.
@lilypond[quote,verbatim]
\new Staff \relative c' {
<< % Voice one
{ c2 aes4. bes8 }
\\ % Voice two
- { aes2 f4 fes }
- \\ % No voice three
- \\ % Voice four
{
% Ignore these for now - they are explained in Ch 4
- \once \override NoteColumn #'force-hshift = #0
- <ees c>2
+ \once \override NoteColumn #'ignore-collision = ##t
+ <ees, c>2
\once \override NoteColumn #'force-hshift = #0.5
des2
}
+ \\ % No voice three
+ \\ % Voice four
+ {
+ \override NoteColumn #'force-hshift = #0
+ aes'2 f4 fes
+ }
>> |
<c ees aes c>1 |
}
}
\\ % Voice two
{ \voiceTwoStyle
- aes2 f4 fes
+ % Ignore these for now - they are explained in Ch 4
+ \once \override NoteColumn #'ignore-collision = ##t
+ <ees, c>2
+ \once \override NoteColumn #'force-hshift = #0.5
+ des2
}
\\ % No Voice three (we want stems down)
\\ % Voice four
{ \voiceThreeStyle
- % Ignore these for now - they are explained in Ch 4
- \once \override NoteColumn #'force-hshift = #0
- <ees c>2
- \once \override NoteColumn #'force-hshift = #0.5
- des2
+ \override NoteColumn #'force-hshift = #0
+ aes'2 f4 fes
}
>> |
<c ees aes c>1 |
\new Staff \relative c'' {
\key aes \major
<<
- { c2 aes4. bes8 } \\ { aes2 f4 fes } \\ { <ees c>2 des2 }
- >>
- <c ees aes c>1
+ { c2 aes4. bes8 } \\ { <ees, c>2 des } \\ { aes'2 f4 fes }
+ >> |
+ <c ees aes c>1 |
}
@end lilypond
@lilypond[quote,verbatim,ragged-right]
\new Staff \relative c'' {
\key aes \major
- << % Voice one
+ << % Voice one
{ c2 aes4. bes8 }
- \\ % Voice two
- { aes2 f4 fes }
- \\ % Omit Voice three
- \\ % Voice four
- { <ees c>2 des2 }
+ \\ % Voice two
+ { <ees, c>2 des }
+ \\ % Omit Voice three
+ \\ % Voice four
+ { aes'2 f4 fes }
>> |
<c ees aes c>1 |
}
@end lilypond
@noindent
-Possiamo vedere che questo corregge la direzione del gambo, ma espone
-a un problema talvolta presente con le voci multiple: i gambi delle note
-in una voce possono collidere con le teste delle note di un'altra voce. Nel
-disporre le note, LilyPond permette alle note o agli accordi di due diverse
-voci di occupare la stessa colonna verticale della nota purché i gambi siano
-in direzioni opposte, ma le note della terza e quarta voce vengono
-spostate, se necessario, per evitare la collisione tra le teste. Questo
-di solito funziona bene, ma in questo esempio le note della voce più bassa,
-con le impostazioni predefinite, appaiono chiaramente disposte in una posizione
-non ottimale. LilyPond fornisce molti modi per aggiustare la collocazione
+Possiamo vedere che questo corregge la direzione del gambo, ma il posizionamento
+orizzontale delle note non è quello che desideriamo. LilyPond sposta le note
+più interne quando queste o i loro gambi collidono con le voci più
+esterne, ma questo non è appropriato nella musica per pianoforte. In altre
+situazioni, gli spostamenti applicati da LilyPond potrebbero non riuscire
+a evitare le collisioni. LilyPond fornisce molti modi per aggiustare la collocazione
orizzontale delle note. Per ora, non siamo ancora pronti a cercare di
correggere questo problema, dunque dovremo aspettare fino a una
prossima sezione -- si veda la proprietà @code{force-hshift} in @ref{Fixing
overlapping notation}.
+@warning{Il testo e gli @emph{spanner} (come le legature di portamento e di valore, le
+forcelle, etc.) non possono essere create @q{attraverso} le voci.}
@seealso
Guida alla notazione: @ruser{Multiple voices}.
@c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
@ignore
- Translation of GIT committish: 4ca01b6da8d60b0d8575be05ae974429c91becd5
+ Translation of GIT committish: d6b6b53d09a0fb8e137e7cfcec39fe22dc7b6872
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@appendixsubsec Transcrizione di musica mensurale
-@lilypondfile[verbatim,quote,ragged-right,texidoc]
+@c Line-width below is because of Issue 766. If that's fixed, it can be removed.
+@lilypondfile[verbatim,quote,ragged-right,texidoc,line-width=140]
{ancient-notation-template----modern-transcription-of-mensural-music.ly}
@appendixsubsec Trascrizione di musica Gregoriana
@appendixsubsec Combo jazz
-@lilypondfile[verbatim,quote,ragged-right,texidoc]
+@c Line-width below is because of Issue 766. If that's fixed, it can be removed.
+@lilypondfile[verbatim,quote,ragged-right,texidoc,line-width=140]
{jazz-combo-template.ly}
\input texinfo @c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
@ignore
- Translation of GIT committish: 1c846b2c2348b4e0ca4a3c2e8fb267047ba2d203
+ Translation of GIT committish: 08560a1b8076630c4fc6cb9b902614d8b74fd6fc
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@c `Notation Reference' was born 1999-10-11 with git commit 940dda0...
@macro copyrightDeclare
-Copyright @copyright{} 1999--2011 degli autori.
+Copyright @copyright{} 1999--2012 degli autori.
@end macro
@c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
@ignore
- Translation of GIT committish: bbd4df5bd5cec42e9b3b23eb6bdfa7123a1b2413
+ Translation of GIT committish: 80340bdefc128536c79733d8c6f3467d91b01f72
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
}
@end lilypond
-
@seealso
Glossario musicale:
@rglosnamed{Pitch names,Nomi delle altezze}.
Guida al funzionamento interno:
@rinternals{RelativeOctaveMusic}.
-
@cindex ottava relativa e trasposizione
@cindex trasposizione e ottava relativa
@funindex \relative
@funindex relative
-
@c DEPRECATED
Se non viene specificata una @code{@var{altezza_di_riferimento}} per @code{\relative},
allora si assume che corrisponda a @tie{}@code{c'}. Tuttavia, questa è un'opzione
suo impiego è quindi sconsigliato.
-
@node Alterazioni
@unnumberedsubsubsec Alterazioni
@translationof Accidentals
@rinternals{AccidentalCautionary},
@rinternals{accidental-interface}.
-
@cindex alterazione, quarto di tono
@cindex alterazione di un quarto di tono
@knownissues
-
Poiché non esistono standard universalmente accettati per indicare
le alterazioni di quarto di tono, il simbolo impiegato da LilyPond
non si riferisce ad alcuno standard.
-
@node Nomi delle note in altre lingue
@unnumberedsubsubsec Nomi delle note in altre lingue
@translationof Note names in other languages
anche altezze e sistemi di accordatura alternativi: si veda
@ref{Common notation for non-Western music}.
-
@seealso
Glossario musicale:
@rglosnamed{Pitch names,Nomi delle altezze},
}
@end lilypond
-
@seealso
Frammenti di codice:
@rlsr{Pitches, Altezze}.
@lilypondfile[verbatim,quote,texidoc,doctitle]
{transposing-pitches-with-minimum-accidentals-smart-transpose.ly}
-
@seealso
Guida alla notazione:
@ref{Instrument transpositions},
Guida al funzionamento interno:
@rinternals{TransposedMusic}.
-
@funindex \transpose
@funindex transpose
@funindex \chordmode
@funindex relative
@knownissues
-
La conversione relativa non avrà effetto sulle sezioni @code{\transpose},
@code{\chordmode} e @code{\relative} comprese all'interno di un
blocco @code{\relative}. Per usare la modalità relativa all'interno
@lilypondfile[verbatim,quote,texidoc,doctitle]
{non-traditional-key-signatures.ly}
-
@seealso
Glossario musicale:
@rglos{church mode},
@lilypondfile[verbatim,quote,texidoc,doctitle]
{ottava-text.ly}
-
@seealso
Glossario musicale:
@rglosnamed{octavation,ottavazione}.
c2 g
@end lilypond
-
@seealso
Glossario musicale:
@rglosnamed{concert pitch,intonazione reale},
@rinternals{AccidentalPlacement},
@rinternals{accidental-suggestion-interface}.
-
@cindex alterazioni e note simultanee
@cindex note simultanee e alterazioni
@cindex alterazioni negli accordi
@cindex accordi, alterazioni in
@knownissues
-
Le note simultanee non vengono considerate nell'individuazione
automatica delle alterazioni; vengono prese come riferimento solo
le note precedenti e l'armatura di chiave. Se la stessa nota
}
@end lilypond
+
@node Ambitus
@unnumberedsubsubsec Ambitus
@translationof Ambitus
@lilypondfile[verbatim,quote,texidoc,doctitle]
{changing-the-ambitus-gap.ly}
-
@seealso
Glossario musicale:
@rglos{ambitus}.
@rinternals{AmbitusNoteHead},
@rinternals{ambitus-interface}.
-
@knownissues
-
Le collisioni non vengono gestite in presenza di un ambitus multiplo su
più di una voce.
@lilypondfile[verbatim,quote,texidoc,doctitle]
{numbers-as-easy-note-heads.ly}
-
@seealso
Guida alla notazione:
@ref{Setting the staff size}.
La lista completa di tutti gli stili delle teste si trova in @ref{Note head styles}.
-
@seealso
Frammenti di codice:
@rlsrnamed{Pitches, Altezze}.
}
@end lilypond
-
@predefined
@code{\improvisationOn},
@code{\improvisationOff}.
@endpredefined
-
@seealso
Frammenti di codice:
@rlsrnamed{Pitches, Altezze}.
<!--
- Translation of GIT committish: db084d94d56b4bc5dd51fee39410320c95eb4e50
+ Translation of GIT committish: 427bb2b004227f3afc7de10dfd896fc375cbc320
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
-->
+<!--
+we depend on an external entity here, which we cannot control. Suppose
+we go from 2.15.x to 2.17.x and put the documentation under "v2.17".
+For some time, Google won't have the new location in its index, so the
+search would get nothing. It would be better to keep "v2.15" in the
+search for a while and have a redirection from "v2.15" to "v2.17".
+-->
<form action="http://google.com/search"
method="get"
name="search"
- onSubmit="search.q.value='site:lilypond.org +v2.14 '
+ onSubmit="search.q.value='site:lilypond.org/doc/v2.15 '
+ search.brute_query.value"
- onMouseMove="search.q.value='site:lilypond.org +v2.14 '
+ onMouseMove="search.q.value='site:lilypond.org/doc/v2.15 '
+ search.brute_query.value"
- onKeyUp="search.q.value='site:lilypond.org +v2.14 '
+ onKeyUp="search.q.value='site:lilypond.org/doc/v2.15 '
+ search.brute_query.value">
<input type="hidden" name="btnG" value="Cerca con Google">
<input type="text" name="brute_query" onfocus="this.value=''" value="Cerca">
\input texinfo @c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
@ignore
- Translation of GIT committish: 1c846b2c2348b4e0ca4a3c2e8fb267047ba2d203
+ Translation of GIT committish: 08560a1b8076630c4fc6cb9b902614d8b74fd6fc
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
@ignore
- Translation of GIT committish: 2aeac5e3815effa47427dad86d6be811c7b0d8a2
+ Translation of GIT committish: c46be1b7c0e190478a16035db5aad453f31e9d02
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@section Punta e clicca
@translationof Point and click
+Il "punta e clicca" aggiunge dei collegamenti ai documenti pdf per certi
+elementi musicali.
+
+@menu
+* Abilitare il punta e clicca::
+* Punta e clicca selettivo::
+@end menu
+
+@node Abilitare il punta e clicca
+@unnumberedsubsec Abilitare il punta e clicca
+@translationof Enabling point and click
+
@cindex punta e clicca
Il "punta e clicca" (@emph{point and click}) permette di individuare gli elementi
fornito insieme a LilyPond.
Per Xpdf su UNIX, occorre inserire la seguente linea nel file
-@file{xpdfrc}@footnote{Su UNIX, questo file si trova in
-@file{/etc/xpdfrc} o come @file{.xpdfrc} nella propria directory home.}
+@file{xpdfrc}. Su UNIX, questo file si trova in
+@file{/etc/xpdfrc} o @file{$HOME/.xpdfrc}.
@example
urlCommand "lilypond-invoke-editor %s"
che si vogliano diffondere, per evitare di includere nel file .pdf delle informazioni
sui percorsi del proprio computer: questo infatti può costituire un rischio di
sicurezza.}
+
+@node Punta e clicca selettivo
+@unnumberedsubsec Punta e clicca selettivo
+@translationof Selective point-and-click
+
+Per alcune applicazioni interattive, si potrebbe voler includere
+soltanto alcuni elementi punta e clicca. Ad esempio, se qualcuno
+volesse creare un'applicazione che riproduca audio o video a partire
+da una nota in particolare, sarebbe inopportuno che il clic sulla
+nota portasse alla posizione di un'alterazione o di una legatura
+che si trovi sopra quella nota.
+
+Questo può essere controllato indicando quali eventi includere:
+
+@itemize
+@item
+Codice interno al file @file{.ly}:
+
+@example
+\pointAndClickTypes #'note-event
+\relative c' @{
+ c2\f( f)
+@}
+@end example
+
+oppure
+
+@example
+#(ly:set-option 'point-and-click 'note-event)
+\relative c' @{
+ c2\f( f)
+@}
+@end example
+
+@item
+Linea di comando:
+
+@example
+lilypond -dpoint-and-click=note-event example.ly
+@end example
+
+@end itemize
+
+Si può includere più di un evento:
+
+@itemize
+@item
+Codice interno al file @file{.ly}:
+
+@example
+\pointAndClickTypes #'(note-event dynamic-event)
+\relative c' @{
+ c2\f( f)
+@}
+@end example
+
+oppure
+
+@example
+#(ly:set-option 'point-and-click '(note-event dynamic-event))
+\relative c' @{
+ c2\f( f)
+@}
+@end example
+
+@item
+Linea di comando:
+
+@smallexample
+lilypond \
+ -e"(ly:set-option 'point-and-click '(note-event dynamic-event))" \
+ example.ly
+@end smallexample
+
+
+@end itemize
+
+
@node LilyPond e gli editor di testo
@section LilyPond e gli editor di testo
@translationof Text editor support
@c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
@ignore
- Translation of GIT committish: feb460d0ba95db4081619c8490496d09d4fb118d
+ Translation of GIT committish: 0cc0c4fb20b70e717db7e8f43cbb0c1878cd8395
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
Si tratta di un programma separato da @command{lilypond} e viene lanciato
dalla linea di comando; per maggiori informazioni, si veda @ref{Command-line
-usage}. Chi usa MacOS 10.3 o 10.4 e non riesce ad eseguire
-@code{lilypond-book} veda @rweb{MacOS X}.
+usage}. In caso di problemi nell'eseguire @code{lilypond-book} da linea di
+comando su Windows o Mac OS X, si veda @rweb{Windows} o @rweb{MacOS X}.
Questo procedimento può essere applicato ai documenti @LaTeX{}, HTML, Texinfo
o DocBook.
@cindex texinfo
-@cindex latex
+@cindex LaTex
@cindex texinfo
@cindex texi
-@cindex html
+@cindex HTML
@cindex docbook
-@cindex documenti, aggiungere musica ai
-@cindex HTML, musica in
-@cindex Texinfo, musica in
-@cindex DocBook, musica in
-@cindex @LaTeX{}, musica in
+@cindex documenti, aggiungere musica
+@cindex HTML, aggiungere musica
+@cindex Texinfo, aggiungere musica
+@cindex DocBook, aggiungere musica
+@cindex LaTeX, aggiungere musica
@menu
* Un esempio di documento musicologico::
essere ignorati. Se esegui @command{latex} in modalità due colonne, ricorda
di aggiungere @option{-t landscape} alle opzioni di @command{dvips}.
+@knownissues
+Il comando @code{\pageBreak} non funziona all'interno dell'ambiente
+@code{\begin@{lilypond@} @dots{} \end@{lilypond@}}.
+
+Molte variabili del blocco @code{\paper} non funzionano all'interno dell'ambiente
+@code{\begin@{lilypond@} @dots{} \end@{lilypond@}}. Usa
+@code{\newcommand} con @code{\betweenLilyPondSystem} nel preambolo;
+
+@example
+\newcommand@{\betweenLilyPondSystem@}[1]@{\vspace@{36mm@}\linebreak@}
+@end example
+
+
@subsubheading Texinfo
Per generare un documento Texinfo (in qualsiasi formato di output), si seguono
@c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
@ignore
- Translation of GIT committish: ccc485525e63f68623bce1c3ca7a2d4fb6e94499
+ Translation of GIT committish: 7465f4b1291f38bed8ee81e3922eb685f7e909ad
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@menu
* Utilizzo di lilypond::
-* Opzioni della linea di comando per lilypond::
+* Opzioni di base della linea di comando per LilyPond::
+* Opzioni avanzate della linea di comando per LilyPond::
* Variabili d'ambiente::
* LilyPond in una gabbia chroot::
@end menu
e non hanno niente a che fare con lilypond.
-@node Opzioni della linea di comando per lilypond
-@unnumberedsubsec Opzioni della linea di comando per @command{lilypond}
-@translationof Command line options for lilypond
+@node Opzioni di base della linea di comando per LilyPond
+@unnumberedsubsec Opzioni di base della linea di comando per @command{lilypond}
+@translationof Basic command line options for LilyPond
@cindex Utilizzo di @command{lilypond}
@cindex opzioni della linea di comando per @command{lilypond}
@cindex linea di comando, opzioni di
-@cindex switches
+@cindex switch
Sono contemplate le seguenti opzioni:
@table @code
+@item -d,--define-default=@var{variabile}=@var{valore}
+Si veda @ref{Advanced command line options for LilyPond}.
+
+@cindex Scheme, valutazione dell'espressione
+@cindex valutazione dell'espressione, Scheme
+
@item -e,--evaluate=@var{espressione}
Valuta l'@var{espressione} di Scheme prima di analizzare qualsiasi file @file{.ly}.
Si possono specificare varie opzioni @option{-e}; saranno analizzate in modo
@noindent
in cima al file @code{.ly}.
+@warning{Gli utenti Windows devono usare i doppi apici invece dei singoli apici.}
+
+@cindex output, formato
+@cindex formato, output
+
@item -f,--format=@var{formato}
Formati di output. Come @code{formato} si può scegliere tra
-@code{ps}, @code{pdf}, e @code{png}.
+@code{ps}, @code{pdf} e @code{png}.
Esempio: @code{lilypond -fpng @var{file}.ly}
+@item -h,--help
+Mostra una sintesi dell'utilizzo.
+@item -H,--header=@var{CAMPO}
+Estrae un campo dell'intestazione nel file @file{NOME.@var{CAMPO}}.
-@item -d,--define-default=@var{variabile}=@var{valore}
-Imposta l'opzione interna del programma, @var{variabile}, al valore di Scheme
-@var{valore}. Se @var{valore} non viene specificato, allora viene usato
-@var{#t}. Per disabilitare un'opzione, si può usare il prefisso @code{no-}
-prima della @var{variabile}, ad esempio
-
-@cindex punta e clicca, linea di comando
-
-@example
--dno-point-and-click
-@end example
-
-@noindent
-è equivalente a
-@example
--dpoint-and-click='#f'
-@end example
-
-Di seguito alcune opzioni interessanti.
-
-@cindex aiuto, linea di comando
-
-@table @samp
-@item help
-L'esecuzione di @code{lilypond -dhelp} mostrerà tutte le opzioni disponibili
-di @option{-d}.
-
-@cindex paper-size, linea di comando
-
-@item paper-size
-Questa opzione imposta la dimensione predefinita del foglio,
-@example
--dpaper-size=\"letter\"
-@end example
-
-@noindent
-Nota che la stringa deve essere compresa tra virgolette precedute dal
-segno di escape ( @code{\"} ).
-@c Match " in previous line to help context-sensitive editors
-
-@cindex safe, linea di comando
-
-@item safe
-Non si fida dell'input nel file @code{.ly}.
-
-Quando la formattazione di LilyPond viene messa a disposizione tramite un server
-web, si @b{DEVE} passare l'opzione @option{--safe} o l'opzione @option{--jail}. L'opzione
-@option{--safe} impedirà che il codice Scheme presente nell'input possa fare uno
-scempio, ad esempio
-
-@quotation
-@verbatim
-#(system "rm -rf /")
-{
- c4^$(ly:gulp-file "/etc/passwd")
-}
-@end verbatim
-@end quotation
-
-L'opzione @option{-dsafe} serve a valutare le espressioni Scheme presenti nell'input
-in uno speciale modulo di sicurezza. Questo modulo di sicurezza è derivato dal
-modulo GUILE @file{safe-r5rs}, ma aggiunge alcune funzioni del
-LilyPond API. Queste funzioni sono elencate in @file{scm/safe-lily.scm}.
-
-Inoltre, la modalità sicura non permette le direttive @code{\include} e
-disabilita l'uso del backslash nelle stringhe @TeX{}.
-
-In modalità sicura, non è possibile importare le variabili di LilyPond
-in Scheme.
-
-@option{-dsafe} @emph{non} rileva il sovrautilizzo di risorse. È ancora possibile
-far sì che il programma rimanga in sospeso per un tempo indefinito, ad esempio
-alimentando il backend con strutture di dati cicliche. Dunque se si vuole usare
-LilyPond su un server web pubblicamente accessibile, si deve limitare il processo
-nell'uso della CPU e della memoria.
-
-La modalità sicura bloccherà la compilazione di molti utili frammenti di codice
-LilyPond. L'opzione @option{--jail} è un'alternativa più sicura, ma richiede
-più lavoro per configurarla.
-
-@cindex formato di output, impostare il
-@item backend
-il formato di output da usare per il back-end. Per il @code{formato} si può
-scegliere tra
-@table @code
-@item ps
-@cindex PostScript, output
- per PostScript.
-
- I file Postscript includono i tipi di carattere TTF, Type1 e OTF. Non vengono
- inclusi i sottoinsiemi di questi tipi. Se si usa un set di caratteri orientali,
- si possono ottenere file di grosse dimensioni.
-
-@item eps
-
-@cindex Postscript, incapsulato
-@cindex EPS (Encapsulated PostScript)
-
- per PostScript incapsulato. Invia ogni pagina (sistema) in un file
-@file{EPS} separato, senza font, e in un unico file @file{EPS} con
-tutte le pagine (sistemi) inclusi i font.
-
-Questa è la modalità predefinita di @command{lilypond-book}.
+@item -i,--init=@var{file}
+Imposta il file di inizializzazione su @var{file} (predefinito: @file{init.ly}).
-@item svg
+@cindex ricerca dei file
+@cindex percorso di ricerca
-@cindex SVG (Scalable Vector Graphics)
+@item -I, --include=@var{directory}
+Aggiunge @var{directory} al percorso di ricerca per i file di input.
- per ottenere SVG (Scalable Vector Graphics).
+È possibile assegnare più opzioni -I. La ricerca inizierà nella prima
+directory definita, e se il file da includere non viene trovato
+la ricerca continuerà nelle directory seguenti.
- Crea un singolo file SVG, senza font incorporati, per ogni pagina
- dell'output. Si raccomanda di installare i font Century
- Schoolbook, inclusi nell'installazione di LilyPond, per una resa
- ottimale. In UNIX basta copiare questi font dalla directory di
- LilyPond (solitamente
- @file{/usr/share/lilypond/VERSION/fonts/otf/}) in
- @file{~/.fonts/}. L'output SVG dovrebbe essere compatibile con qualsiasi
- editor SVG o user agent.
+@cindex gabbia chroot, esecuzione all'interno di
-@item scm
+@item -j,--jail=@var{utente},@var{gruppo},@var{gabbia},@var{directory}
+Esegue @command{lilypond} in una gabbia chroot.
-@cindex Scheme, estrazione di
+L'opzione @option{--jail} fornisce un'alternativa più flessibile a
+@option{--safe} quando la formattazione di LilyPond è messa a disposizione attraverso
+un server web o quando LilyPond esegue sorgenti provenienti dall'esterno
+(si veda @ref{Advanced command line options for LilyPond}).
- per estrarre i comandi di disegno grezzi e interni, basati su Scheme.
+L'opzione @option{--jail} modifica la radice di @command{lilypond} in
+@var{gabbia} appena prima di iniziare il vero processo di compilazione. L'utente
+e il gruppo vengono poi modificati per corrispondere a quelli forniti, e la
+directory corrente viene spostata in @var{directory}. Questa configurazione
+garantisce che non sia possibile (almeno in teoria) uscire dalla gabbia. Si noti
+che perché @option{--jail} funzioni @command{lilypond} deve essere eseguito come root;
+di solito questo si fa in modo sicuro col comando @command{sudo}.
-@item null
- non produce la stampa della partitura; ha lo stesso effetto di @option{-dno-print-pages}.
-@end table
+Configurare una gabbia è una questione un po' delicata, perché bisogna essere
+sicuri che LilyPond possa trovare tutto quello di cui ha bisogno per compilare il
+sorgente @emph{dentro la gabbia}. Una configurazione tipica comprende i seguenti
+elementi:
-Esempio: @code{lilypond -dbackend=svg @var{filename}.ly}
+@table @asis
-@item preview
-@cindex preview, linea di comando
-Genera un file di output che contiene i titoli e il primo sistema
-del brano musicale. Se si usano i blocchi @code{\bookpart}, i titoli e il
-primo sistema di ogni @code{\bookpart} apparirà nell'output.
-I backend @code{ps}, @code{eps}, e @code{svg} supportano questa
-opzione.
+@item Impostare un filesystem distinto
+Si dovrebbe creare un filesystem separato LilyPond, così che possa essere
+montato con opzioni di sicurezza come @code{noexec}, @code{nodev}, e
+@code{nosuid}. In questo modo è impossibile lanciare degli eseguibili o
+scrivere su un dispositivo direttamente da LilyPond. Se non si vuole creare
+una partizione separata, si può creare un file di dimensioni ragionevoli e usarlo
+per montare un dispositivo di loop. Un filesystem separato garantisce inoltre
+che LilyPond non possa scrivere su uno spazio maggiore di quanto permesso.
-@item gui
-Viene eseguito senza avvisi e redirige tutto l'output verso un file di log.
+@item Impostare un altro utente
+Per eseguire LilyPond in una gabbia si dovrebbe usare un altro utente e gruppo
+(ad esempio, @code{lily}/@code{lily}) con pochi privilegi. Ci dovrebbe essere
+una sola directory scrivibile da questo utente, che dovrebbe essere passata in
+@var{dir}.
-Nota per gli utenti Windows: Per impostazione predefinita @code{lilypond.exe} mostra
-tutta l'informazione dell'elaborazione in corso nella finestra dei comandi, @code{lilypond-windows.exe}
-invece fa apparire un prompt, privo di informazioni sull'elaborazione, subito
-nella linea di comando. In questo caso si può usare l'opzione @option{-dgui}
-per redirigere l'output verso un file di log.
+@item Preparare la gabbia
+LilyPond ha bisogno di leggere alcuni file quando viene lanciato. Tutti questi
+file devono essere copiati nella gabbia, sotto lo stesso percorso in cui appaiono
+nel vero filesystem principale. Si deve copiare l'intero contenuto dell'installazione
+LilyPond (ad esempio, @file{/usr/share/lilypond}).
-@item print-pages
-Genera tutte le pagine, come da impostazione predefinita. @option{-dno-print-pages} è
-utile in combinazione con @option{-dpreview}.
+Se c'è un problema, il modo più semplice per individuarlo è lanciare
+LilyPond usando @command{strace}, che permetterà di scoprire quali
+file mancano.
+@item Eseguire LilyPond
+In una gabbia montata con @code{noexec} è impossibile eseguire qualsiasi
+programma esterno. Dunque LilyPond deve essere eseguito con un backend che
+non richieda tale programma. Come è già stato detto, deve essere eseguito
+con privilegi di superutente (che ovviamente perderà immediatamente),
+possibilmente con l'uso di @command{sudo}. È una buona idea limitare il
+numero di secondi di tempo della CPU che LilyPond può usare (ad esempio con
+@command{ulimit -t}), e, se il sistema operativo lo permette, la quantità di
+memoria che può essere allocata. Si veda anche @ref{LilyPond in chroot jail}.
@end table
-
-
-@item -h,--help
-Mostra una sintesi dell'utilizzo.
-
-@item -H,--header=@var{CAMPO}
-Estrae un campo dell'intestazione nel file @file{NOME.@var{CAMPO}}.
-
-@cindex ricerca dei file
-@cindex percorso di ricerca
-@item --include, -I=@var{directory}
-Aggiunge @var{directory} al percorso di ricerca per i file di input.
-
-È possibile assegnare più opzioni -I. La ricerca inizierà nella prima
-directory definita, e se il file da includere non viene trovato
-la ricerca continuerà nelle directory seguenti.
-
-@item -i,--init=@var{file}
-Imposta il file di inizializzazione su @var{file} (predefinito: @file{init.ly}).
-
@cindex loglevel
-@cindex output verbosity, setting
+@cindex output dettagliato
@item -l,--loglevel=@var{LIVELLO}
Imposta la verbosità dell'output della console su @var{LIVELLO}. I valori possibili sono:
@table @code
+
@item NONE
Nessun output, nemmeno i messaggi di errore.
@item DEBUG
Tutti i messaggi possibili, incluso l'output verboso di debug.
+
@end table
-@cindex cartella, dirigere l'output in
-@cindex nome del file di output, impostare
+@cindex directory, dirigere l'output in
+@cindex output, impostare il nome del file
+@cindex output, directory
-@item -o,--output=@var{FILE} or @var{CARTELLA}
+@item -o,--output=@var{FILE} o @var{CARTELLA}
Imposta il file di output predefinito @var{FILE} oppure, se una cartella con
quel nome esiste già, dirige l'output in @var{CARTELLA}, prendendo il nome
del file dal file di input. In entrambi i casi verrà aggiunto il suffisso
appropriato (ad esempio @code{.pdf} per il pdf).
-
-@cindex PostScript
+@cindex PS (Postscript), output
+@cindex Postscript (PS), output
+@cindex output, PS (Postscript)
@item --ps
Genera PostScript.
-@cindex Portable Network Graphics (PNG)
+@cindex PNG (Portable Network Graphics), output
+@cindex output, PNG (Portable Network Graphics)
@item --png
Genera immmagini di ogni pagina in formato PNG. Questo implica
-dresolution=110
@end example
-@cindex Portable Document Format (PDF)
+@cindex PDF (Portable Document Format), output
+@cindex output, PDF (Portable Document Format)
@item --pdf
Genera PDF. Questo implica @option{--ps}.
+@item -v,--version
+Mostra informazioni sulla versione.
+@item -V,--verbose
+Aumenta la prolissità: mostra i percorsi completi di tutti i file letti e dà
+informazioni sui tempi.
-@item -j,--jail=@var{utente},@var{gruppo},@var{gabbia},@var{directory}
-Esegue @command{lilypond} in una gabbia chroot.
+@item -w,--warranty
+Mostra la garanzia con cui viene distribuito GNU LilyPond. (Distribuito
+con @strong{NESSUNA GARANZIA}!)
-L'opzione @option{--jail} fornisce un'alternativa più flessibile a
-@option{--safe} quando la formattazione di LilyPond è messa a disposizione attraverso
-un server web o quando LilyPond esegue sorgenti provenienti dall'esterno.
+@end table
-L'opzione @option{--jail} modifica la radice di @command{lilypond} in
-@var{gabbia} appena prima di iniziare il vero processo di compilazione. L'utente
-e il gruppo vengono poi modificati per corrispondere a quelli forniti, e la
-directory corrente viene spostata in @var{directory}. Questa configurazione
-garantisce che non sia possibile (almeno in teoria) uscire dalla gabbia. Si noti
-che perché @option{--jail} funzioni @command{lilypond} deve essere eseguito come root;
-di solito questo si fa in modo sicuro col comando @command{sudo}.
-Configurare una gabbia è una questione un po' delicata, perché bisogna essere
-sicuri che LilyPond possa trovare tutto quello di cui ha bisogno per compilare il
-sorgente @emph{dentro la gabbia}. Una configurazione tipica comprende i seguenti
-elementi:
+@node Opzioni avanzate della linea di comando per LilyPond
+@unnumberedsubsec Opzioni avanzate della linea di comando per @command{lilypond}
+@translationof Advanced command line options for LilyPond
-@table @asis
-@item Impostare un filesystem distinto
-Si dovrebbe creare un filesystem separato LilyPond, così che possa essere
-montato con opzioni di sicurezza come @code{noexec}, @code{nodev}, e
-@code{nosuid}. In questo modo è impossibile lanciare degli eseguibili o
-scrivere su un dispositivo direttamente da LilyPond. Se non si vuole creare
-una partizione separata, si può creare un file di dimensioni ragionevoli e usarlo
-per montare un dispositivo di loop. Un filesystem separato garantisce inoltre
-che LilyPond non possa scrivere su uno spazio maggiore di quanto permesso.
+@table @code
-@item Impostare un altro utente
-Per eseguire LilyPond in una gabbia si dovrebbe usare un altro utente e gruppo
-(ad esempio, @code{lily}/@code{lily}) con pochi privilegi. Ci dovrebbe essere
-una sola directory scrivibile da questo utente, che dovrebbe essere passata in
-@var{dir}.
+@item -d@var{[nome-opzione]}=@var{[valore]},--define-default=@var{[nome-opzione]}=@var{[valore]}
+Imposta l'equivalente funzione interna di Scheme su @var{valore}. Se non
+viene specificato un @var{valore}, viene usato il valore predefinito. Per disabilitare
+un'opzione, si può usare il prefisso @code{no-} prima di @var{nome-opzione}, ad esempio
-@item Preparare la gabbia
-LilyPond ha bisogno di leggere alcuni file quando viene lanciato. Tutti questi
-file devono essere copiati nella gabbia, sotto lo stesso percorso in cui appaiono
-nel vero filesystem principale. Si deve copiare l'intero contenuto dell'installazione
-LilyPond installation (ad esempio, @file{/usr/share/lilypond}).
+@cindex punta e clicca, linea di comando
-Se c'è un problema, il modo più semplice per individuarlo è lanciare
-LilyPond usando @command{strace}, che permetterà di scoprire quali
-file mancano.
+@example
+-dpoint-and-click=#f
+@end example
-@item Eseguire LilyPond
-In una gabbia montata con @code{noexec} è impossibile eseguire qualsiasi
-programma esterno. Dunque LilyPond deve essere eseguito con un backend che
-non richieda tale programma. Come è già stato detto, deve essere eseguito
-con privilegi di superutente (che ovviamente perderà immediatamente),
-possibilmente con l'uso di @command{sudo}. È una buona idea limitare il
-numero di secondi di tempo della CPU che LilyPond può usare (ad esempio con @command{ulimit
--t}), e, se il sistema operativo lo permette, la quantità di memoria che
-può essere allocata.
+@noindent
+è equivalente a
+@example
+-dno-point-and-click
+@end example
@end table
+@noindent Sono supportate le seguenti opzioni insieme ai loro rispettivi
+valori predefiniti:
-@item -v,--version
-Mostra informazioni sulla versione.
+@multitable @columnfractions .33 .16 .51
+@item @strong{Simbolo}
+@tab @strong{Valore}
+@tab @strong{Spiegazione/Opzioni}
-@item -V,--verbose
-Aumenta la prolissità: mostra i percorsi completi di tutti i file letti, e dà
-informazioni sui tempi.
+@item @code{anti-alias-factor}
+@tab @code{1}
+@tab Elabora a una risoluzione più alta (usando un certo fattore) e ridimensiona
+il risultato per evitare gli @q{artefatti} nelle immagini @code{PNG}.
-@item -w,--warranty
-Mostra la garanzia con cui viene distribuito GNU LilyPond. (Distribuito
-con @strong{NESSUNA GARANZIA}!)
-@end table
+@item @code{aux-files}
+@tab @code{#t}
+@tab Crea i file @code{.tex}, @code{.texi}, @code{.count} nel backend
+@code{EPS}.
+
+@item @code{backend}
+@tab @code{'ps}
+@tab Seleziona il backend. I file Postscript (predefinito) includono i tipi di
+carattere @code{TTF}, @code{Type1} e @code{OTF}. Non vengono inclusi i sottoinsiemi
+di questi tipi. Se si usa un set di caratteri @q{orientali}, si possono ottenere
+file di grosse dimensioni.
+
+@item
+@tab @code{'eps}
+@tab Encapsulated PostScript. Invia ogni pagina (sistema) in un file
+@file{EPS} separato, senza font, e in un unico file @file{EPS} con
+tutte le pagine (sistemi) inclusi i font. Questa è la modalità
+predefinita di @command{lilypond-book}.
+
+@item
+@tab @code{'null}
+@tab non produce la stampa della partitura; ha lo stesso
+effetto di @code{-dno-print-pages}.
+
+@item
+@tab @code{'svg}
+@tab Scalable Vector Graphics. Crea un singolo file SVG, senza font
+incorporati, per ogni pagina dell'output. Si raccomanda di installare i
+font Century Schoolbook, inclusi nell'installazione di LilyPond, per una
+resa ottimale. In UNIX basta copiare questi font dalla directory di
+LilyPond (solitamente @file{/usr/share/lilypond/VERSION/fonts/otf/}) in
+@file{~/.fonts/}. L'output SVG dovrebbe essere compatibile con qualsiasi
+editor SVG o user agent. C'è anche un'opzione @code{svg-woff} (sotto) per
+poter usare i file di font woff nel backend SVG.
+
+@item
+@tab @code{'scm}
+@tab Estrae i comandi di disegno grezzi e interni, basati su Scheme.
+
+@item @code{check-internal-types}
+@tab @code{#f}
+@tab Controlla l'assegnazione di ogni proprietà per i tipi.
+
+@item @code{clip-systems}
+@tab @code{#f}
+@tab Genera frammenti ritagliati di una partitura.
+
+@item @code{datadir}
+@tab
+@tab Prefisso per i file di dati (sola lettura).
+
+@item @code{debug-gc}
+@tab @code{#f}
+@tab Scarica le statistiche sul debug della memoria.
+
+@item @code{debug-gc-assert-parsed-dead}
+@tab @code{#f}
+@tab Per il debug della memoria: Assicura che tutti i riferimenti agli oggetti
+analizzati siano eliminati. Questa è un'opzione interna e viene abilitata
+automaticamente da @code{`-ddebug-gc'}.
+
+@item @code{debug-lexer}
+@tab @code{#f}
+@tab Debug dell'analizzatore lessicale flex.
+
+@item @code{debug-page-breaking-scoring}
+@tab @code{#f}
+@tab Crea le partiture per diverse configurazioni di interruzione di pagina.
+
+@item @code{debug-parser}
+@tab @code{#f}
+@tab Debug dell'analizzatore bison.
+
+@item @code{debug-property-callbacks}
+@tab @code{#f}
+@tab Debug delle catene cicliche di callback.
+
+@item @code{debug-skylines}
+@tab @code{#f}
+@tab Debug skylines.
+
+@item @code{delete-intermediate-files}
+@tab @code{#t}
+@tab Cancella i file @code{.ps} intermedi e inutilizzabili creati durante
+la compilazione.
+
+@item @code{dump-cpu-profile}
+@tab @code{#f}
+@tab Scarica l'informazione sui tempi (dipendente dal sistema).
+
+@item @code{dump-profile}
+@tab @code{#f}
+@tab Scarica l'informazione sulla memoria e il tempo per ogni file.
+
+@item @code{dump-signatures}
+@tab @code{#f}
+@tab Scarica le firme dell'output di ogni sistema. Usato per testare le regressioni.
+
+@item @code{eps-box-padding}
+@tab @code{#f}
+@tab Sposta il margine sinistro della cornice EPS dell'output della quantità
+specificata (in mm).
+
+@item @code{gs-load-fonts}
+@tab @code{#f}
+@tab Carica i font attraverso Ghostscript.
+
+@item @code{gs-load-lily-fonts}
+@tab @code{#f}
+@tab Carica solo i font LilyPond attraverso Ghostscript.
+
+@item @code{gui}
+@tab @code{#f}
+@tab Esegue il programma senza stampare messaggi e redirige tutto l'output in un file di log.
+@end multitable
+
+@noindent
+@strong{Nota per gli utenti Windows:} Per impostazione predefinita @code{lilypond.exe}
+stampa tutta l'informazione sull'avanzamento nella finestra dei comandi.
+@code{lilypond-windows.exe} non lo fa e riporta un prompt, privo di
+informazioni sull'avanzamento, subito nella linea di comando. L'opzione
+@option{-dgui} può essere usata in questo caso per redirigere l'output in
+un file di log.
+
+@multitable @columnfractions .33 .16 .51
+@item @code{help}
+@tab @code{#f}
+@tab Mostra questo aiuto.
+
+@item @code{include-book-title-preview}
+@tab @code{#t}
+@tab Include i titoli dei libri nelle immagini di anteprima.
+
+@item @code{include-eps-fonts}
+@tab @code{#t}
+@tab Include i font in file EPS con sistemi separati.
+
+@item @code{include-settings}
+@tab @code{#f}
+@tab Include il file per le impostazioni globali, questo viene incluso prima
+che la partitura sia elaborata.
+
+@item @code{job-count}
+@tab @code{#f}
+@tab Elabora in parallelo, usando il dato numero di lavori.
+
+@item @code{log-file}
+@tab @code{#f [file]}
+@tab Se la stringa @code{FOO} viene assegnata come secondo argomento,
+redirige l'output nel file @code{FOO.log}.
+
+@item @code{max-markup-depth}
+@tab @code{1024}
+@tab Maximum depth for the markup tree. If a markup has more levels,
+assume it will not terminate on its own, print a warning and return a
+null markup instead.
+
+@item @code{midi-extension}
+@tab @code{"midi"}
+@tab Imposta l'estensione predefinita per il file MIDI sulla stringa specificata.
+
+@item @code{music-strings-to-paths}
+@tab @code{#f}
+@tab Converte le stringhe di testo in percorsi quando i glifi appartengono a
+un font musicale.
+
+@item @code{old-relative}
+@tab @code{#f}
+@tab Fa sì che il modo @code{\relative} per la musica simultanea funzioni in
+modo simile alla sintassi degli accordi.
+
+@item @code{paper-size}
+@tab @code{\"a4\"}
+@tab Imposta la dimensione predefinita del foglio. Nota che la stringa deve
+essere compresa tra virgolette precedute dal segno di escape.
+
+@item @code{pixmap-format}
+@tab @code{png16m}
+@tab Imposta il formato di output di GhostScript per le immagini raster.
+
+@item @code{point-and-click}
+@tab @code{#f}
+@tab Aggiunge i collegamenti @q{punta e clicca} all'output @code{PDF}. Si veda
+@ref{Point and click}.
+
+@item @code{preview}
+@tab @code{#f}
+@tab Crea immagini di anteprima oltre al normale output.
+@end multitable
+
+@noindent
+Questa opzione è supportata da tutti i backend; @code{pdf}, @code{png},
+@code{ps}, @code{eps} e @code{svg}, ma non @code{scm}. Genera un file
+di output nella forma @code{mioFile.preview.estensione}, contenente i
+titoli e il primo sistema. Se vengono usati i blocchi @code{\book} o
+@code{\bookpart}, i titoli di @code{\book}, @code{\bookpart} o @code{\score}
+appariranno nell'output, incluso il primo sistema di ogni blocco @code{\score}
+se la variabile @code{print-all-headers} di @code{\paper} è impistata
+su @code{#t}.
+
+Per impedire il normale output, si usano le opzioni @option{-dprint-pages} o
+@option{-dno-print-pages} in base alle proprie esigenze.
+
+@multitable @columnfractions .33 .16 .51
+@item @code{print-pages}
+@tab @code{#t}
+@tab Genera le pagine complete (predefinito). @option{-dno-print-pages} è
+utile in combinazione con @option{-dpreview}.
+
+@item @code{profile-property-accesses}
+@tab @code{#f}
+@tab Mantiene una statistica delle chiamate di funzione @code{get_property()}.
+
+@item @code{protected-scheme-parsing}
+@tab @code{#t}
+@tab Continua se l'analizzatore coglie degli errori nel codice scheme interno
+al file di input. Se impostato su @code{#f}, in caso di errore si ferma e
+mostra la traccia di stack.
+
+@item @code{read-file-list}
+@tab @code{#f [file]}
+@tab Specifica il nome di un file che contiene una lista di file di input da
+elaborare.
+
+@item @code{relative-includes}
+@tab @code{#f}
+@tab Quando elabora un comando @code{\include}, cerca il file incluso
+in posizione relativa al file corrente (invece che in posizione assoluta).
+
+@item @code{resolution}
+@tab @code{101}
+@tab Imposta la risoluzione per generare immagini @code{PNG} su un certo
+valore (in dpi).
+
+@item @code{safe}
+@tab @code{#f}
+@tab Non si fida dell'input nel file @code{.ly}.
+@end multitable
+
+@noindent
+Quando la formattazione di LilyPond viene messa a disposizione tramite un server
+web, si @b{DEVE} passare l'opzione @option{--safe} o l'opzione @option{--jail}. L'opzione
+@option{--safe} impedirà che il codice Scheme presente nell'input possa fare uno
+scempio, ad esempio
+
+@quotation
+@verbatim
+#(system "rm -rf /")
+{
+ c4^$(ly:gulp-file "/etc/passwd")
+}
+@end verbatim
+@end quotation
+
+L'opzione @option{-dsafe} serve a valutare le espressioni Scheme presenti nell'input
+in uno speciale modulo di sicurezza. Questo modulo di sicurezza è derivato dal
+modulo GUILE @file{safe-r5rs}, ma aggiunge alcune funzioni del
+LilyPond API. Queste funzioni sono elencate in @file{scm/safe-lily.scm}.
+
+Inoltre, la modalità sicura non permette le direttive @code{\include} e
+disabilita l'uso del backslash nelle stringhe @TeX{}. In modalità sicura,
+non è possibile importare le variabili di LilyPond in Scheme.
+
+@option{-dsafe} @emph{non} rileva il sovrautilizzo di risorse. È ancora possibile
+far sì che il programma rimanga in sospeso per un tempo indefinito, ad esempio
+alimentando il backend con strutture di dati cicliche. Dunque se si vuole usare
+LilyPond su un server web pubblicamente accessibile, si deve limitare il processo
+nell'uso della CPU e della memoria.
+
+La modalità sicura bloccherà la compilazione di molti utili frammenti di codice
+LilyPond.
+
+L'opzione @option{--jail} è un'alternativa più sicura, ma richiede più lavoro
+per configurarla. Si veda @ref{Basic command line options for LilyPond}.
+
+@multitable @columnfractions .33 .16 .51
+@item @code{separate-log-files}
+@tab @code{#f}
+@tab Per i file di input @code{FILE1.ly}, @code{FILE2.ly}, etc. salva i dati di
+log nei file @code{FILE1.log}, @code{FILE2.log}, ...
+
+@item @code{show-available-fonts}
+@tab @code{#f}
+@tab Elenca i nomi di font disponibili.
+
+@item @code{strict-infinity-checking}
+@tab @code{#f}
+@tab Forza il blocco del programma quando si incontrano eccezioni @code{Inf} e
+@code{NaN} sui numeri in virgola mobile.
+
+@item @code{strip-output-dir}
+@tab @code{#t}
+@tab Non usa le directory dei file di input per costruire i nomi dei file
+di output.
+
+@item @code{svg-woff}
+@tab @code{#f}
+@tab Usa i file di font woff nel backend SVG.
+
+@item @code{trace-memory-frequency}
+@tab @code{#f}
+@tab Registra molte volte al secondo l'uso delle celle da parte di Scheme. Salva i
+risultati in @code{FILE.stacks} e @code{FILE.graph}.
+
+@item @code{trace-scheme-coverage}
+@tab @code{#f}
+@tab Registra la copertura dei file Scheme in @code{FILE.cov}.
+
+@item @code{verbose}
+@tab @code{#f}
+@tab Output dettagliato, ovvero livello di log DEBUG (sola lettura).
+
+@item @code{warning-as-error}
+@tab @code{#f}
+@tab Trasforma tutti i messaggi di avviso e di @q{errore di programmazione} in errori.
+@end multitable
@node Variabili d'ambiente
\input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
@ignore
- Translation of GIT committish: 37bd2b54bdfaa3693f6aa3f43f9072cc9cfacc21
+ Translation of GIT committish: 08560a1b8076630c4fc6cb9b902614d8b74fd6fc
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
@ignore
- Translation of GIT committish: 02fe0c6153548b148121e3fa3974a6b426a3daa0
+ Translation of GIT committish: af50298395325eb7c1c4adfa667555d26af9299e
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@item
@ref{Sviluppo}: per i collaboratori e i tester.
+@item
+@ref{GSoC}: lista di progetti per il Google Summer of Code.
+
@item
@ref{Autori}: le persone che hanno reso LilyPond quello che è oggi.
@item
@ref{Notizie vecchie}: un archivio.
+@item
+@ref{Attic}: annunci e changelog delle versioni precedenti.
+
@end itemize
@divEnd
* Aiutaci::
* Sponsor::
* Sviluppo::
+* GSoC::
* Autori::
* Pubblicazioni::
* Notizie vecchie::
+* Soffitta::
@end menu
@divEnd
@item
Un esempio minimo dimostra che hai tentato di risolvere il problema
-da solo. Quando le persone inviano grandi porzioni di input, sembra
-che non si preoccupino che noi li possiamo aiutare o no.
+da solo. Quando le persone inviano grandi porzioni di codice, sembra
+che non si preoccupino che li possiamo aiutare o no.
@item
Creare un esempio minimo ti aiuta a capire cosa sta
succedendo. Molte segnalazioni di un falso problema possono essere
evitate se si prova a creare un esempio minimo; se non riesci a ricreare
un @qq{bug} in un esempio minimo, allora probabilmente il problema è
-una comprensione di LilyPond insufficiente, non un vero bug!
+una conoscenza di LilyPond insufficiente, non un vero bug!
@end itemize
@divEnd
@item
Crea un esempio piccolo! Gli esempi che riguardano la spaziatura o la
formattazione di pagina potrebbero richiedere molte battute, ma la maggior
-parte dei problemi può essere ricreata in meno di una sola battuta.
+parte dei problemi può essere riprodotta con meno di una battuta.
@item
Durante la preparazione di un esempio, cerca di commentare @w{(@code{%}
allora elimina il materiale commentato!
@item
-Evita di usare note, tonalità o segni di tempo complicati a meno che
+Evita di usare note, tonalità o segni di tempo complessi a meno che
il malfunzionamento non riguardi proprio il comportamento di questi elementi.
@item
-Non usare i comandi @code{\override} o @code{\set} a meno che il malfunzionamento
+Non usare i comandi @code{\override} o @code{\set}, a meno che il malfunzionamento
non riguardi questi comandi in particolare.
@item
@}
@end example
-Non è così grande, ma un vero esempio minimo è il seguente:
+Non è poi così grande, ma un vero esempio minimo è il seguente:
@example
\version "2.14.1"
@end example
Sono pochi gli esempi minimi che superano 10 righe di codice -
-spesso 4 righe sono sufficienti per spiegare il problema!
+spesso 4 righe sono sufficienti per illustrare il problema!
@divEnd
@unnumberedsec Segnalazione bug
@translationof Bug reports
+@divClass{heading-center}
+Se hai un codice di input che produce un crash o un output sbagliato,
+allora si tratta di un bug.
+@divEnd
+
@divClass{column-center-top}
@subheading Passo 1: Bug noti
-Se hai un codice di input che produce un crash o un output sbagliato,
-allora si tratta di un bug. Sul nostro bug tracker su google c'è una
-lista dei bug aperti,
+Potremmo già essere a conoscenza di questo bug. Controlla qui:
@example
@uref{http://code.google.com/p/lilypond/issues/list}
@divClass{column-left-bottom}
@subheading Passo 2: Creare una segnalazione bug
-Se hai scoperto un bug che non è elencato, puoi aiutarci creando
+Se hai scoperto un bug che non è ancora stato riportato, puoi aiutarci creando
una segnalazione bug.
@warning{Accettiamo segnalazioni bug esclusivamente nella forma di @ref{Esempi
-minimi}. Abbiamo risorse molto limitate da dedicare alle segnalazioni
-bug, quindi qualsiasi esempio non minimo sarà scartato. Quasi
-ogni bug può essere dimostrato con quattro note o meno!}
+minimi}. Abbiamo risorse molto limitate, quindi qualsiasi esempio non minimo
+sarà scartato. Quasi ogni bug può essere dimostrato con quattro note o meno!}
Ecco un esempio di una valida segnalazione bug:
@divClass{column-center-bottom}
@subheading Passo 4: Attendi una risposta
-Una volta che il bug è stato inviato alla lista, la nostra Squadra Bug esaminerà
-la segnalazione. Una risposta può richiedere fino a 24 ore, perché abbiamo
-un numero limitato di volontari per questo compito. Potrebbero chiederti maggiori
-informazioni, oppure aggiungere la segnalazione al tracker e comunicartene il
-numero di riferimento.
+Una volta che la segnalazione bug è stata inviata alla lista, la nostra Squadra
+Bug la esaminerà e forse ti chiederà maggiori informazioni. Verrai avvisato
+quando la segnalazione viene aggiunta al bug tracker. Una risposta può richiedere
+fino a 4 giorni, perché abbiamo un numero limitato di volontari per questo compito.
-Puoi contrassegnare il bug in modo da ricevere automaticamente delle email
-ogni volta capiti un'attività relativa al bug. Per fare questo occorre
-avere un account google.
+Una volta che un bug è stato aggiunto al tracker, puoi commentarlo per aggiungere
+informazioni a riguardo. Puoi anche contrassegnare il bug in modo da ricevere
+automaticamente delle email ogni volta capiti un'attività relativa al bug. Per
+fare questo occorre avere un account google.
@divEnd
@divClass{column-center-bottom}
@divClass{column-left-top}
@divClass{keep-bullets}
-@helpusTasks
+@helpusSimple
@divEnd
@divEnd
@divClass{column-right-top}
-@helpusProjects
+@helpusAdvanced
@divEnd
@itemize
@item
-Gli sviluppatori di LilyPond ogni tanto pubblicizzano i propri servizi sulle
+Gli sviluppatori di LilyPond talvolta pubblicizzano i propri servizi sulle
liste email di lilypond.
@item
@subheading Numeri di versione
LilyPond viene distribuito in due versioni: la versione stabile e quella
-di sviluppo o instabile. Le versioni stabili hanno un numero pari
-per numero di versione @q{minore} (e.g., 2.8, 2.10, 2.12).
-Le versioni di sviluppo hanno un numero dispari per numero di versione
-@q{minore} (e.g., 2.7, 2.9, 2.11).
+di sviluppo o instabile. Le versioni stabili hanno un numero di versione
+@q{minore} pari (per esempio 2.8, 2.10, 2.12). Le versioni di sviluppo
+hanno un numero di versione @q{minore} dispari (per esempio 2.7, 2.9, 2.11).
@divEnd
@divEnd
+@node GSoC
+@unnumberedsec GSoC
+@translationof GSoC
+
+@divClass{column-center-top}
+@subheading Che cos'è il Google Summer of Code?
+
+Citando il
+@uref{http://www.google-melange.com/gsoc/homepage/google/gsoc2012, sito del GSoC},
+@qq{Google Summer of Code è un programma globale che offre stipendi agli
+studenti per scrivere codice per progetti open source. Google ha collaborato
+con la comunità open source per identificare e finanziare dei progetti
+interessanti per la prossima estate.}
+
+Il team di LilyPond ha deciso che si tratta di un'ottima opportunità per trovare
+nuovi collaboratori, stimolare gli studenti che già partecipano allo sviluppo di
+LilyPond ad essere più coinvolti, e infine - per ultimo ma non meno importante -
+scrivere del buon codice per il bene di tutti!
+
+Partecipiamo al GSoC come membri del Progetto GNU. Si veda
+@uref{http://www.gnu.org/software/soc-projects/guidelines.html, la pagina GNU su GSoC}
+per informazioni su come partecipare.
+
+@divEnd
+
+@divClass{column-center-bottom}
+@subheading La nostra lista delle idee
+
+Ecco una lista di progetti che suggeriamo per gli studenti del GSoC. Se nessuno
+dei progetti che vedi è adatto a te, puoi suggerirne uno tuo!
+È anche possibile ridimensionare un progetto se pensi che sia troppo impegnativo.
+
+È necessario che ogni studente abbia una conoscenza di base di @code{git} e
+consigliamo che chiunque faccia domanda per uno qualsiasi di questi progetti,
+eccetto l'ultimo, abbia una conoscenza di base della notazione musicale.
+
+@subheading Abbellimenti
+
+Correggere i problemi di sincronizzazione degli abbellimenti,
+insieme a tutta l'architettura sottostante (si veda il
+@uref{http://code.google.com/p/lilypond/issues/detail?id=34, numero 34 del nostro tracker}).
+Gli abbellimenti confondono il tempo di LilyPond perché è come se portassero
+indietro il tempo. Questo causa strani effetti, specialmente quando un rigo
+ha un abbellimento e l'altro non ce l'ha.
+
+@strong{Difficoltà:} media
+
+@strong{Requisiti:} C++, MIDI
+
+@strong{Consigliato:} familiarità col funzionamento interno di LilyPond
+
+@strong{Mentore/i:} Mike Solomon, Carl Sorensen
+
+@subheading MusicXML
+
+Aggiungere un'esportazione a MusicXML completa e migliorare l'importazione,
+insieme a dei test che verifichino il funzionamento. A seconda del tempo a
+disposizione, implementare alcune o tutte le seguenti funzionalità:
+
+@divClass{keep-bullets}
+@itemize
+
+@item
+Gestire l'esportazione del contenuto musicale principale come l'esportazione
+MIDI (ovvero usando classi dedicate dell'esportatore, derivate dalla classe
+del traduttore)
+
+@item
+Costruire l'albero XML del contenuto musicale di base,
+aggiungere un collegamento dall'evento musicale al tag XML
+
+@item
+Far sì che tutti gli incisori di LilyPond facciano il loro lavoro
+
+@item
+aggiungere la capacità di collegare ogni oggetto dell'output
+(in pratica ogni stampo (stencil) / gruppo di stampi) alla sua causa musicale
+(e quindi al tag XML nell'albero XML)
+
+@item
+Aggiungere un backend di outoput XML, che possa aggiungere le informazioni di
+formattazione per ogni oggetto di output ai tag XML
+
+@end itemize
+@divEnd
+
+L'obiettivo sarà considerato raggiunto quando una partitura (scelta precedentemente)
+può essere importata da MusicXML e riesportata senza una perdita di dati
+indesiderata.
+
+@strong{Difficoltà:} media
+
+@strong{Requisiti:} MusicXML, Python, conoscenza di base di LilyPond
+
+@strong{Mentore/i:} Reinhold Kainhofer, Mike Solomon
+
+è auspicabile una certa familiarità con altri software di notazione musicale (a
+fine comparativo).
+
+@subheading Migliorare le legature di portamento e di valore
+
+La forma predefinita delle curve delle legature di portamento e di valore è spesso
+non soddisfacente. Non sono supportate né le legature di valore su note
+enarmoniche @code{@{ cis'~ des' @}} né le legature di valore "spezzate" da
+una chiave o da un cambio di rigo. Il progetto include la raccolta e la classificazione
+di esempi di output scadente, la decisione sull'output desiderato e la scrittura
+del codice vero e proprio.
+
+@strong{Difficoltà:} difficile
+
+@strong{Requisiti:} C++, esperienza con la scrittura di euristica
+
+@strong{Conoscenze consigliate:} conoscenza di LilyPond, senso estetico
+
+@strong{Mentore/i:} Mike Solomon
+
+@subheading Aggiungere una variante speciale dei glifi dei tipi di carattere
+Aggiungere varianti sulla linea del rigo, tra le linee dei righi, più corte e
+più strette di alcuni glifi, come ad esempio le alterazioni, insieme a un'infrastruttura
+generica per supportarle. Un esempio è la testa della nota breve nella notazione
+antica che ha due varianti, con un buco più piccolo e più grande.
+
+@strong{Difficoltà:} facile
+
+@strong{Requisiti:} MetaFont, C++, buon occhio per il dettaglio
+
+@strong{Conoscenze consigliate:} conoscenza di base di LilyPond
+
+@strong{Mentore/i:} Werner Lemberg
+
+@subheading Migliorare la disposizione delle travature
+
+Il posizionamento predefinito delle travature normali, tra i righi, spezzate e angolari
+deve essere migliorato. La disposizione delle travature deve dipendere dal contesto
+e dalle note vicine (si veda la
+@uref{http://icking-music-archive.org/lists/sottisier/sottieng.pdf, sezione 2.2 qui}).
+Se possibile, ridurre il tempo di elaborazione della disposizione delle travature.
+
+@strong{Difficoltà:} media
+
+@strong{Requisiti:} C++, esperienza con la scrittura di euristiche
+
+@strong{Conoscenze consigliate:} senso estetico
+
+@strong{Mentore/i:} Mike Solomon, Carl Sorensen
+
+@subheading Miglior supporto all'intavolatura
+
+@divClass{keep-bullets}
+@itemize
+
+@item
+accordature non monotoniche, come l'Ukulele
+
+@item
+creare una modalità di input per l'intavolatura (attualmente l'informazione
+musicale viene inserita secondo i termini della notazione musicale occidentale,
+ovvero @qq{una nota Fa# di un quarto} e poi convertita in intavolatura) per
+trascrivere l'intavolatura del liuto medievale
+
+@item
+implementare funzionalità dell'intavolatura moderna, come la piegatura (bending),
+lo strappato e il martellato (hammer-on e pull-off)
+
+@item
+se si definisce una forma sulla tastiera per un certo accordo, questa informazione
+deve essere usata quando si mostra l'accordo sul rigo (invece di mostrare soltanto
+la forma predefinita dell'accordo)
+
+@end itemize
+@divEnd
+
+@strong{Difficoltà:} facile
+
+@strong{Requisiti:} C++
+
+@strong{Conoscenze consigliate:} familiarità con l'intavolatura
+
+@strong{Mentore/i:} Carl Sorensen
+
+@subheading Semplificare vari avvisi durante la compilazione
+
+Semplificare gli avvisi del compilatore e di valgrind e l'analisi del codice statico.
+Strumenti di analisi automatica del codice (avvisi in @code{g++} e @code{clang})
+e strumenti di analisi come il rilevamento di perdite di memoria di valgrind e
+i profilatori di codice di callgrind forniscono informazioni utili per individuare
+possibili errori nel codice C++.
+Pulire questi avvisi ci permetterebbe di rifiutare automaticamente qualsiasi
+patch che introduca avvisi ulteriori.
+
+@strong{Difficoltà:} media
+
+@strong{Requisiti:} C++
+
+@strong{Mentore/i:} Joe Neeman, Reinhold Kainhofer
+
+@divEnd
@node Autori
@divClass{column-center-bottom}
-
@subheading Cosa altri hanno fatto con LilyPond
@divClass{keep-bullets}
@unnumberedsec Notizie vecchie
@translationof Old news
+@divClass{heading-center}
+@warning{Molti dei vecchi annunci e changelog si possono trovare
+in @ref{Soffitta}}
+@divEnd
+
@include web/news-front.itexi
@include web/news.itexi
+
+
+@node Soffitta
+@unnumberedsec Soffitta
+@translationof Attic
+
+@divClass{column-center-top}
+@subheading Annunci
+
+Annunci e notizie ordinati per versione:
+@miscLink{announce-v2.12,v2.12},
+@miscLink{announce-v2.12.de,v2.12 (German)},
+@miscLink{announce-v2.12.es,v2.12 (Spanish)},
+@miscLink{announce-v2.12.fr,v2.12 (French)},
+@miscLink{announce-v2.10,v2.10},
+@miscLink{announce-v2.8,v2.8},
+@miscLink{announce-v2.6,v2.6},
+@miscLink{announce-v2.4,v2.4},
+@miscLink{announce-v2.2,v2.2},
+@miscLink{announce-v2.0,v2.0},
+@miscLink{NEWS-1.4,v1.4},
+@miscLink{NEWS-1.2,v1.2 (1)},
+@miscLink{ANNOUNCE-1.2,v1.2 (2)},
+@miscLink{ANNOUNCE-1.0,v1.0},
+@miscLink{ANNOUNCE-0.1,v0.1}
+
+@divEnd
+
+@divClass{column-center-bottom}
+@subheading Changelog
+
+Changelog ordinati per versione:
+@miscLink{ChangeLog-2.10,v2.10},
+@miscLink{ChangeLog-2.3,v2.3},
+@miscLink{ChangeLog-2.1,v2.1},
+@miscLink{ChangeLog-1.5,v1.5 (1)},
+@miscLink{CHANGES-1.5,v1.5 (2)},
+@miscLink{CHANGES-1.4,v1.4},
+@miscLink{CHANGES-1.3,v1.3},
+@miscLink{CHANGES-1.2,v1.2},
+@miscLink{CHANGES-1.1,v1.1},
+@miscLink{CHANGES-1.0,v1.0},
+@miscLink{CHANGES-0.1,v0.1},
+@miscLink{CHANGES-0.0,v0.0}
+
+@divEnd
@c -*- coding: utf-8; mode: texinfo; documentlanguage: it -*-
@ignore
- Translation of GIT committish: d6315a746c47259f56dc2835347985658d71d0c9
+ Translation of GIT committish: b6731e900a2037112364ad328b8e3b2f7bcd1eb0
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
e il suo complesso @uref{http://www.earlymusicny.org/, Early Music
New York} (spartiti realizzati da Nicolas Sceaux).
+@item
+@emph{Pictures at an exhibition} di Mussorgsky, riorchestrata e diretta
+da @uref{http://www.aurelienbello.com/,Aurélien Bello} con
+la @uref{http://www.junge-philharmonie-brandenburg.de/,Junge Philharmonie Brandenburg}
+il 10 Ottobre 2011 e di nuovo il 15-16 Aprile 2012.
+
@end itemize
@divEnd
@itemize
@item
-@uref{http://www.rosegardenmusic.com,Rosegarden}, un sequencer audio
-e MIDI, che ha anche un editor per le partiture con un solo rigo.
+@uref{http://www.canorus.org,Canorus}, un editor di partiture, può anche
+esportare in formato LilyPond, ma è un software ancora in beta. Gli utenti
+che vogliono provarlo sono benvenuti.
@item
@uref{http://vsr.informatik.tu-chemnitz.de/staff/jan/nted/nted.xhtml,NtEd},
@uref{http://www.cairographics.org,Cairo}, supporta in via sperimentale
l'esportazione in formato LilyPond.
-@item
-@uref{http://www.tuxguitar.com.ar/,TuxGuitar}, un editor e riproduttore multitraccia
-per tablatura, include un visualizzatore della partitura e può esportare
-in formato LilyPond.
-
@item
@uref{http://www.musescore.org,MuseScore}, un editor di partiture, ha un'esportazione
in formato LilyPond incompleta ma è in attivo sviluppo.
@item
-@uref{http://www.canorus.org,Canorus}, un editor di partiture, può anche
-esportare in formato LilyPond, ma è un software ancora in beta. Gli utenti
-che vogliono provarlo sono benvenuti.
+@uref{http://www.holmessoft.co.uk/homepage/software/NWC2LY/index.htm,
+NW2LY} è un programma scritto in C# che converte una canzone di
+@uref{http://www.noteworthysoftware.com/,NoteWorthy} in formato
+LilyPond.
+
+@item
+@uref{https://github.com/ciconia/ripple/blob/master/README.markdown,
+Ripple} è un programma che aiuta a creare partiture e parti; include un
+modo per mischiare insieme opere musicali diverse in una singola partitura
+o parte.
+
+@item
+@uref{http://www.rosegardenmusic.com,Rosegarden}, un sequencer audio
+e MIDI, che ha anche un editor per le partiture con un solo rigo.
@item
@uref{http://www.volny.cz/smilauer/rumor/rumor.html,Rumor}, un convertitore
realtime monofonico da MIDI a LilyPond.
@item
-@uref{http://www.holmessoft.co.uk/homepage/software/NWC2LY/index.htm,
-NW2LY} è un programma scritto in C# che converte una canzone di
-@uref{http://www.noteworthysoftware.com/, NoteWorthy} in formato
-LilyPond.
+@uref{http://www.tuxguitar.com.ar/,TuxGuitar}, un editor e riproduttore
+multitraccia per tablatura, include un visualizzatore della partitura e può
+esportare in formato LilyPond.
@end itemize
Document Format (PDF) and PostScript (PS). Scalable Vector
Graphics (SVG), Encapsulated PostScript (EPS) and Portable
Network Graphics (PNG) output formats are also available through
-command line options, see @rprogram{Command line options for
-lilypond}.
+command line options, see
+@rprogram{Basic command line options for LilyPond}.
@node Replacing the notation font
@node Basic command line options for LilyPond
-@unnumberedsubsec Basic command line options for @command{lilypond}
+@unnumberedsubsec Basic command line options for LilyPond
@cindex Invoking @command{lilypond}
@cindex command line options for @command{lilypond}
projects / lilypond.git / commitdiff