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.

La documentazione in questa pagina si riferisce al {{{file}}} dell'estensione Score. Se si scarica la versione 0.1, fare riferimento al file README.

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:

 

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

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 want the extension to trim score images for you, you will also need ImageMagick.

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 .

La versione 0.1 di questa estensione è stata testata con MediaWiki 1.18.0 e LilyPond 2.12.3. La current git snapshot potrebbe richiedere una versione più recente di MediaWiki e/o LilyPond.

Istruzioni per il download

Usa il distributore di estensioni. Puoi anche scaricare un tarball da GitHub: [1]; o come file zippato: [2]. Il ramo master del punteggio su GitHub funziona con una versione stabile di MediaWiki, ma potrebbe non avere ancora le caratteristiche più recenti.

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' );
    $wgScoreLilyPond = '/path/to/your/lilypond/executable'; /* required */
    $wgScoreAbc2Ly = '/path/to/your/abc2ly/executable'; /* if you want ABC to LilyPond conversion */
    $wgScoreFluidsynth = '/path/to/your/fluidsynth/executable'; /* if you want MIDI to audio conversion */
    $wgScoreSoundfont = '/path/to/your/soundfont/file'; /* required for Fluidsynth */
    $wgScoreTimidity = '/path/to/your/timidity/executable'; /* fallback when Fluidsynth is not installed */
    $wgScoreLame = '/path/to/your/lame/executable'; /* required to convert audio file for MP3 */
    $wgScoreTrim = true; /* Set to false if you don't want score trimming */
    
  • 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