Estensione:Score

This page is a translated version of the page Extension:Score and the translation is 51% complete.
Outdated translations are marked like this.
Other languages:
English • ‎Türkçe • ‎Yorùbá • ‎español • ‎français • ‎italiano • ‎português do Brasil • ‎中文 • ‎日本語 • ‎한국어
Manuale sulle Estensioni MediaWiki
OOjs UI icon advanced.svg
Score
Stato della release: stabile
Lilytest1.png
Implementazione Tag
Descrizione Permette la resa di spartiti musicali con LilyPond.
Autore(i) Alexander Klauer, Étienne Beaulé
Versione 0.3.0 (2019-03-23)
MediaWiki 1.31+
PHP 5.3+
Licenza GNU General Public License 3.0 or later
Scaricare
README
  • $wgScorePath
  • $wgScoreAbc2Ly
  • $wgScoreFluidsynth
  • $wgScoreLame
  • $wgScoreSafeMode
  • $wgScoreLilyPond
  • $wgWikibaseMusicalNotationLineWidthInches
  • $wgScoreLilyPondFakeVersion
  • $wgScoreFileBackend
  • $wgScoreTrim
  • $wgScoreGhostscript
  • $wgMusicalNotationEnableWikibaseDataType
  • $wgScoreOfferSourceDownload
  • $wgScoreMaxLength
  • $wgScoreDirectory
  • $wgScoreDisableExec
  • $wgScoreTimidity
  • $wgScoreSoundfont
score
Traducete l'estensione Score se è disponibile su translatewiki.net
Verificare uso e versione della matrice.
Problemi Compiti aperti · Riportare un bug

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 Extension:LilyPond è stato scritto da Johannes E. Schindelin.

Uso

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

<score>\relative c' { f d f a d f e d cis a cis e a g f e }</score>

rende:

 

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

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

Per esempio:

<score sound="1">\relative c' { f d f a d f e d cis a cis e a g f e }</score>

rende:

Musical scores are temporarily disabled.

Sono disponibili i seguenti attributi:

Attributi Valori concessi Effetti
lang ABC, lilypond (default) Sets the score language. For example, to provide a score in ABC notation, you might use
<score lang="ABC">
X:1
M:C
L:1/4
K:C
C, D, E, F,|G, A, B, C|D E F G|A B c d|
e f g a|b c' d' e'|f' g' a' b'|]
</score>
.
midi obsolete This used to control whether the rendered score image linked to a MIDI file.
override_midi Known file name, that is, if override_midi="name" is given, [[File:name]] does not yield a red link (deprecato) Instead you can add a [[File:superior midi filename.mid]] wikilink after the closing </score> tag.
Uses the specified MIDI file instead of generating one with LilyPond. Use this attribute together with the midi attribute (see before) or the sound attribute (see later). This attribute is useful if you already have a MIDI file whose quality is superior to what would be generated by LilyPond.
override_audio Known file name, that is, if override_audio="name" is given, [[File:Name]] does not yield a red link (deprecato) Instead you can add a [[File:superior audio filename.oga]] wikilink after the closing </score> tag.
Embeds the media specified by the file name in the HTML after the score image(s). This is an alternative to the sound attribute (see further). It can, for example, be useful if you have a suitable audio file of superior quality compared with the auto-generated audio file. Of course, you can still omit both attributes in this case and add the file manually to the page, if you prefer.
override_ogg Doubly-deprecated alias for override_audio.
raw 0 (default), 1 If set to 1, the score code is interpreted as a complete LilyPond file. Use this option if you want to create more complex scores. If the score language (lang attribute) is not set to lilypond, this attribute is ignored. By default (when raw=0), provided code is wrapped in a \score{...} block, along with default \layout{...} and \midi{...} blocks, if not already provided.
sound 0 (default), 1 If set to 1, an audio file will be generated for the score, provided you installed and configured Extension:TimedMediaHandler . An audio player will be embedded in the HTML after the score image(s).
vorbis 0 (default), 1 (deprecato) Alias for sound.

Il linguaggio Lilypond

I testi possono essere aggiunti in questo modo:

<score>\relative c'' { \time 4/4 \key c \major 
c4 g8 g a4 g r b^> c^> r \bar "|." } 
\addlyrics { Shave and a hair -- cut: two bits. }</score>
 

Per gli utenti avanzati, il comando \set Staff.midiInstrument 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 Extension:TimedMediaHandler .

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

Installazione

  • Download and place the file(s) in a directory called Score in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    wfLoadExtension( 'Score' );
    $wgScoreTrim = true;
    $wgImageMagickConvertCommand = '/usr/bin/convert';
    $wgShellRestrictionMethod = 'firejail';
    
  • 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.
  •   Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

To users running MediaWiki 1.26 or earlier:

The instructions above describe the new way of installing this extension using wfLoadExtension(). If you need to install this extension on these earlier versions (MediaWiki 1.26 and earlier), instead of wfLoadExtension( 'Score' );, you need to use:

require_once "$IP/extensions/Score/Score.php";

Configurazione

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

$wgScoreLilyPond

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

$wgScoreTrim

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

$wgScoreAbc2Ly

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

$wgScoreFluidsynth

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

$wgScoreSoundfont

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

$wgScoreTimidity

Impostare $wgScoreTimidity sul percorso del proprio eseguibile TiMidity++ (tipicamente /usr/bin/timidity o /usr/local/bin/timidity). Se $wgScoreFluidsynth non esiste, TiMidity++ verrà utilizzato come ripiego.

$wgScoreLame

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.

Osservazioni

Questa estensione esegue vari binari su shell. Potresti dover aumentare di $wgMaxShellMemory 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. (Esempio di richiesta per la Wikipedia inglese).

See also