Extension:Score/it

L'estensione Score permette il rendering di spartiti musicali come immagini PNG utilizzando LilyPond e può anche trasformarli in file audio e MIDI.

Riconoscimenti
L'originale è stato scritto da Johannes E. Schindelin.
 * Questa estensione si basa su una revisione del code di di Tim Starling.
 * L'originale è stato scritto da River Tarnell.

Uso
Dopo l'installazione, puoi semplicemeten incorporare le notazioni LilyPond nel tuo wikitesto usando i tag . Per esempio:

rende:

È inoltre possibile specificare gli attributi dei tag di punteggio nella forma generale

.

Per esempio:

rende:

Sono disponibili i seguenti attributi:



Il linguaggio Lilypond
I testi possono essere aggiunti in questo modo:

Per gli utenti avanzati, il comando può essere usato per cambiare lo strumento MIDI per il suono.

Prerequisiti
The following packages are recommended:


 * LilyPond
 * Ghostscript
 * ImageMagick
 * FluidSynth
 * Firejail

Questa estensione utilizza LilyPond per rendere le immagini dei punteggi, quindi è necessaria un'installazione LilyPond funzionante. Se volete l'estensione per tagliare i file dei punteggi per voi, avrete bisogno anche di ImageMagick. If you install LilyPond from a package, Ghostscript will also be installed, since LilyPond depends on Ghostscript. ImageMagick should be installed to trim the images, otherwise they will contain an excessive amount of whitespace.

For security reasons, it is highly recommended to install firejail to further restrict what LilyPond and Ghostscript can do if untrusted users are allowed to edit your wiki.

L'estensione è anche in grado di creare file audio dai file MIDI generati da LilyPond. Se si vuole utilizzare questa funzionalità, è necessario avere installato.

FluidSynth is the preferred method to convert MIDI files to audio files, however TiMidity++ is also supported.

Security concerns
Score uses LilyPond in safe mode, however there are known unfixed safe mode escape vulnerabilities leading to arbitrary execution.

If you don't absolutely trust everyone who has editing privileges on your wiki, it is strongly recommended to set up containment of lilypond using. See Shellbox#Server setup for details on how to set up the contained server, and below for configuring MediaWiki to use it. Also, ensure you're using a recent version of LilyPond (2.22.0+) or a distribution package (e.g. from Debian) that has security fixes. Keep safe mode enabled, even with containment as an extra layer of defense. Certain functionality will not work in safe mode, the fix for that is to modify LilyPond to allow that functionality in safe mode.

Installazione

 * See the extension's  for detailed installation instructions.

Configurazione
Attualmente, l'estensione ha i seguenti parametri di configurazione globale.

$wgScoreLilyPond
Imposta  sul percorso del tuo eseguibile LilyPond (tipicamente   o  ).

$wgScoreTrim
Il $wgScoreTrim è un booleano che ha come valore predefinito $wgUseImageMagick. Se, le immagini PNG del punteggio risultante vengono tagliate con ImageMagick. Se non si desidera il trimming, o non si vuole installare ImageMagick, impostare  su

$wgScoreAbc2Ly
Impostare  sul percorso eseguibile del convertitore da ABC a LilyPond (tipicamente   o  ).

$wgScoreFluidsynth
Impostare  sul percorso del proprio eseguibile Fluidsynth (tipicamente   o  ).

$wgScoreSoundfont
Impostare  sul percorso del file soundfont (tipicamente   o  ).

$wgScoreLame
Impostare  sul percorso del proprio eseguibile Lame (tipicamente   o  ). Richiesto se il file audio generato deve essere un MP3.

Osservazioni
Questa estensione esegue vari binari su shell. Potresti dover aumentare di se esci per errori di memoria.



Trovare i punteggi
Le pagine con i punteggi su di esse avranno il "punteggio" page property impostato. Usando Special:PagesWithProp, si possono trovare pagine che hanno un punteggio. ([$url Esempio di richiesta per la Wikipedia inglese]).