Estensione:Score

See the extension's README.md for detailed installation instructions.

• Download and move the extracted Score folder to your extensions/ directory.
  Developers and code contributors should install the extension from Git instead, using:

  cdextensions/
  gitclonehttps://gerrit.wikimedia.org/r/mediawiki/extensions/Score
  

• Aggiungi il seguente codice al tuo $LocalSettings (preferibilmente alla fine):

  wfLoadExtension( 'Score' );
  $wgScoreTrim = true;
  $wgImageMagickConvertCommand = '/usr/bin/convert';
  $wgShellboxUrl = '... address to Shellbox ...';
  $wgShellboxSecretKey = '... your secret key ...';
  

• Create a subdirectory named lilypond in your $wgUploadDirectory (usually the directory named images in your MediaWiki directory). Make sure the directory is writable by your Web server.
• Yes Done – Naviga in Special:Version nella tua wiki per verificare che l'estensione sia stata installata correttamente.

Si raccomanda l'installazione dei seguenti pacchetti:

• LilyPond
• Ghostscript
• ImageMagick
• FluidSynth
• Firejail

Questa estensione utilizza il programma LilyPond per visualizzare gli spartiti musicali, quindi è necessario prima installare LilyPond. (Special:Version mostra la versione di LilyPond installata). Se si installa LilyPond da un pacchetto e non dai sorgenti, sarà installato anche Ghostscript, poiché LilyPond dipende da quest'ultimo. ImageMagick dovrebbe essere installato per fare in modo che le immagini vengano ritagliate, poiché le immagini prodotte dall'estensione contengono una quantità eccessiva di spazio bianco.

Per ragioni di sicurezza, si raccomanda vivamente di installare firejail per limitare ulteriormente ciò che LilyPond e Ghostscript possono fare se utenti non attendibili sono autorizzati a modificare la propria 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 Extension:TimedMediaHandler .

FluidSynth è il programma preferito per convertire i file MIDI in file audio, tuttavia è supportato anche TiMidity++.

LilyPond files can run arbitrary code on the server. Se non ci si può fidare in modo assoluto di tutti coloro che hanno i privilegi di modifica nella propria wiki, è fortemente consigliabile impostare delle limitazioni a LilyPond utilizzando Shellbox . 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.

Questa estensione esegue diversi comandi in una Shellbox per ragioni di sicurezza. In caso di errori "out of memory" (memoria non disponibile), è necessario incrementare $wgMaxShellMemory .

Alcuni dei parametri di configurazione globale dell'estensione sono elencati qui di seguito.

Imposta $wgScoreLilyPond sul percorso del tuo eseguibile LilyPond (tipicamente /usr/bin/bin/lilypond o /usr/local/bin/lilypond).

Set $wgScoreUseSvg to true to render scores as SVG in the browser. Requires LilyPond version 2.24 or above, compiled with Cairo support (included by default since version 2.26).

Il <codice>$wgScoreTrim</codice> è un booleano che ha come valore predefinito <codice>$wgUseImageMagick</codice>. Se true, le immagini PNG del punteggio risultante vengono tagliate con ImageMagick. Se non si desidera il trimming, o non si vuole installare ImageMagick, impostare $wgScoreTrim su false If true, the resulting score PNG images are trimmed with ImageMagick. If you don't want trimming, or don't want to install ImageMagick, set $wgScoreTrim to false.

Impostare $wgScoreAbc2Ly sul percorso eseguibile del convertitore da ABC a LilyPond (tipicamente /usr/bin/abc2ly o /usr/local/bin/abc2ly).

Impostare $wgScoreFluidsynth sul percorso del proprio eseguibile Fluidsynth (tipicamente /usr/bin/fluidsynth o /usr/local/bin/fluidsynth).

Impostare $wgScoreSoundfont sul percorso del file soundfont (tipicamente /usr/share/sounds/sf2/FluidR3_GM.sf2 o /usr/share/sounds/sf2/FluidR3_GS.sf2).

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

Dopo l'installazione, puoi semplicemente incorporare le notazioni LilyPond nel tuo wikitesto fra due tag ‎<score>...‎</score>. Per esempio:

<scorelang="lilypond">\relativec'{fdfadfedcisaciseagfe}</score>

rende:

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

<scoreattribute1="value1"attribute2="value2">...</score>.

Per esempio:

<scoresound="1"lang="lilypond">\relativec'{\setStaff.midiInstrument="tenor sax"fdfadfedcisaciseagfe}</score>

rende:

Sono disponibili i seguenti attributi:

<scorelang="ABC">
X:1
M:C
L:1/4
K:C
C,D,E,F,|G,A,B,C|DEFG|ABcd|
efga|bc'd'e'|f'g'a'b'|]
</score>

I testi possono essere aggiunti in questo modo:

<scorelang="lilypond"sound="1">
\relativec''{\time4/4\keyc\major
c4g8ga4grb^>c^>r\bar"|."}
\addlyrics{Shaveandahair--cut:twobits.}
</score>

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

Pages containing ‎<score> tags are in the tracking category with message name score-use-category. Visit Special:TrackingCategories to find the localized title of this category on your wiki and show the pages in it, for example w:Category:Pages using the Score extension on the English Wikipedia.

L'originale Extension:LilyPond è stato scritto da Johannes E. Schindelin.

• Questa estensione si basa su una revisione del code di Extension:LilyPond di Tim Starling.
• L'originale Extension:ABC è stato scritto da River Tarnell.

• Stable extensions/it
• Tag extensions/it
• ParserFirstCallInit extensions/it
• ResourceLoaderRegisterModules extensions/it
• SoftwareInfo extensions/it
• WikibaseClientDataTypes extensions/it
• WikibaseRepoDataTypes extensions/it
• WikibaseRepoWbui2025InitResourceDependenciesHook extensions/it
• GPL licensed extensions/it
• Extensions in Wikimedia version control/it
• All extensions/it
• Extensions used on Wikimedia/it
• Music editor extensions/it
• Extensions with VisualEditor support/it

• Pages using the Score extension
• Extensions with manual MediaWiki version/it