Tillägg:Score

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

• Ladda ner och placera filen/filerna i en katalog som heter Score i din extensions/-mapp.
  Utvecklare och personer som bidrar med kod borde istället installera tillägget från Git, med:

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

• Lägg till följande kod längst ner i din LocalSettings.php -fil:

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

• Skapa en underkatalog med namnet lilypond i din $wgUploadDirectory (oftast katalogen med namnet images i din MediaWiki-katalog). Se till att katalogen är kan skrivas av din webbserver.
• Yes Klart – Ta dig till Special:Version på din wiki för att bekräfta att tillägget har installerats ordentligt.

Följande packet rekommenderas:

• LilyPond
• Ghostscript
• ImageMagick
• FluidSynth
• Firejail

Det här tillägget använder LiltPond för att rendera not-bilder, så du behöver en fungerande LilyPond-installation (Special:Version visar LilyPond-versionen). Om du installerar LilyPond från ett paket kommer Ghostscript också installeras, eftersom LilyPond beror på Ghostscript. ImageMagick bör installeras för att trimma bilder, annars kommer de innehålla överdrivet mycket tomrum.

Av säkerhetsskäl rekommenderas det starkt att installera firejail för att vidare begränsa vad LilyPond och Ghostscript kan göra om obetrodda användare tillåts redigera på din wiki.

Tillägget kan också skapa ljudfiler från MIDI-filerna som genererats av LilyPond. Vill du använda den här funktionaliteten behöver du installera Tillägg:TimedMediaHandler .

FluidSynth är den föredragna metoden för att konvertera MIDI-filer till ljudfiler, men TiMidity++ stöds också.

LilyPond files can run arbitrary code on the server. Om du inte helt litar på alla som kan redigera på din wiki rekommenderas det starkt att innesluta lilypond med Shellbox . Se Shellbox#Server setup för detaljer på hur man sätter upp den inneslutna servern, och nedan för att konfigurera MediaWiki för att använda det. Se också till att du använder en ny version av LilyPond (2.22.0+) eller ett distribuerat paket (t.ex. från Debian) som har säkerhetslösningar.

Det här tillägget kör diverse binärer i en Shellbox för att erbjuda viss säkerhet. Du kan behöva öka din $wgMaxShellMemory om du får "för lite minne"-fel.

Här följer några av tilläggets globala konfigurationsparametrar.

Ange $wgScoreLilyPond i vägen till din LiltPond-executable (oftast /usr/bin/lilypond eller /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).

$wgScoreTrim är en boolesk som faller tillbaka på värdet hos $wgUseImageMagick. Om true trimmas de resulterande notations-PNG-bilderna med ImageMagick. Om du inte vill att de ska trimmas eller inte vill installera ImageMagick, ange $wgScoreTrim till 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.

Ange $wgScoreAbc2Ly till din ABC:s väg till LilyPond-konverterar-executable (oftast /usr/bin/abc2ly eller /usr/local/bin/abc2ly).

Ange $wgScoreFluidsynth till din Fluidsynth-executables väg (oftast /usr/bin/fluidsynth eller /usr/local/bin/fluidsynth).

Ange $wgScoreSoundfont till din soundfont-fils väg (oftast /usr/share/sounds/sf2/FluidR3_GM.sf2 eller /usr/share/sounds/sf2/FluidR3_GS.sf2).

Ange $wgScoreLame till din Lame-executables väg (oftast /usr/bin/lame eller /usr/local/bin/lame). Krävs om den genererade ljudfilen ska vara en MP3.

Efter installation kan du bädda in enkel LilyPond-notation i din wikitext inuti en ‎<score>...‎</score>-tagg. Till exempel:

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

ger:

Du kan också ange attribut till score-taggarna i det allmänna formatet

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

Till exempel:

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

ger:

Följande attribut är tillgängliga:

<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>

Låttexter kan läggas till så här:

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

För erfarna användare, kan \set Staff.midiInstrument-kommandot användas för att ändra ljudets MIDI-instrument.

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.

• Den ursprungliga Extension:LilyPond skrevs av Johannes E. Schindelin.
• Tillägget bygger på en kodgranskning av Extension:LilyPond av Tim Starling.
• Den ursprungliga Extension:ABC skrevs av River Tarnell.

• Help:Score på engelskspråkiga Wikipedia och Help:Sheet music på Wikisource har fler exempel på LilyPond-syntax.

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

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