Jump to content

Extension:Score

From mediawiki.org
This page is a translated version of the page Extension:Score and the translation is 93% complete.
MediaWiki manüel uzantıları
Score
Sürüm durumu: kararlı
Uygulama Etiket
Açıklama LilyPond ile müzik notalarının oluşturulmasına izin verir
Yazar(lar) Alexander Klauer, Étienne Beaulé
En son sürüm 0.3.0 (2019-03-23)
MediaWiki 1.36+
PHP 5.3+
Lisans GNU Genel Kamu Lisansı 3.0 veya üstü
İndir
README.md
  • $wgScorePath
  • $wgScoreAbc2Ly
  • $wgScoreFluidsynth
  • $wgScoreLame
  • $wgScoreEnvironment
  • $wgScoreLilyPond
  • $wgWikibaseMusicalNotationLineWidthInches
  • $wgScoreImageMagickConvert
  • $wgScoreLilyPondFakeVersion
  • $wgScoreFileBackend
  • $wgScoreDirectory
  • $wgScoreTrim
  • $wgScoreGhostscript
  • $wgMusicalNotationEnableWikibaseDataType
  • $wgScoreOfferSourceDownload
  • $wgScoreMaxLength
  • $wgScoreDebugOutput
  • $wgScoreUseSvg
  • $wgScoreDisableExec
  • $wgScoreSafeMode
  • $wgScoreSoundfont
score
Quarterly downloads 18 (Ranked 116th)
Public wikis using 918 (Ranked 265th)
Translatewiki.net adresinde mevcutsa, Score uzantısını çevirin
Sorunlar Açık görevler · Hata bildir

Score uzantısı, PNG görüntüleri olarak LilyPond kullanarak müzik notalarının oluşturulmasına izin verir ve bunları ses ve MIDI dosyalarına dönüştürebilir.

Teşekkür

Kullanım

Kurulum sonrasında, basit bir ‎<score>...‎</score> etiketi içindeki viikmetinize LilyPond gösterimini gömebilirsiniz. Örneğin:

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

verim:

\relative c' { f d f a d f e d cis a cis e a g f e }

Skor etiketlerine nitelikleri genel formda da belirtebilirsiniz.

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

Örneğin:

<score sound="1">\relative c' { \set Staff.midiInstrument = "tenor sax" f d f a d f e d cis a cis e a g f e }</score>

verim:



\relative c' { \set Staff.midiInstrument = "tenor sax" f d f a d f e d cis a cis e a g f e }

Aşağıdaki özellikler kullanılabilir:

Öznitelik İzin verilen değerler Etki
lang ABC, lilypond (default) Skor dilini ayarlar. Örneğin, ABC notasyonu içinde bir puan sağlamak için şunu kullanabilirsiniz:
<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 (kaldırıldı) Bu, oluşturulan skor resminin bir MIDI dosyasına bağlı olup olmadığını kontrol etmek için kullanılır.
override_midi Bilinen dosya adı, yani override_midi="name" verilirse, [[File:name]] kırmızı bir bağlantı vermez (kaldırıldı) Bunun yerine, kapanış ‎</score> etiketinden sonra bir [[File:superior midi filename.mid]] vikibağlantı ekleyebilirsiniz.
LilyPond ile bir tane oluşturmak yerine belirtilen MIDI dosyasını kullanır. Bu özniteliği midi özniteliği (daha önce bakın) veya ses özniteliği (daha sonra bakın) ile birlikte kullanın. Bu özellik, kalitesi LilyPond tarafından oluşturulandan daha üstün olan bir MIDI dosyanız varsa yararlıdır.
override_audio Bilinen dosya adı, yani override_audio="name" verilirse, [[File:Name]] kırmızı bir bağlantı vermez (kaldırıldı) Bunun yerine, kapanış ‎</score> etiketinden sonra bir [[File:superior audio filename.oga]] vikibağlantı ekleyebilirsiniz.
Dosya adıyla belirtilen medyayı skor görüntülerinden sonra HTML içine gömer. Bu, ses özelliğine bir alternatiftir (daha fazla bilgi edinin). Örneğin, otomatik oluşturulan ses dosyasına kıyasla üstün kalitede uygun bir ses dosyanız varsa yararlı olabilir. Elbette, bu durumda her iki özelliği de atlayabilir ve isterseniz dosyayı sayfaya manüel olarak ekleyebilirsiniz.
override_ogg (kaldırıldı) override_audio iki kez kullanımdan kaldırılan takma ad.
raw 0 (default), 1 1 olarak ayarlanırsa, skor kodu tam bir LilyPond dosyası olarak yorumlanır. Daha karmaşık puanlar oluşturmak istiyorsanız bu seçeneği kullanın. Puan dili (lang özelliği) lilypond olarak ayarlanmamışsa, bu özellik yok sayılır. Varsayılan olarak (raw=0 olduğunda), sağlanan kod, henüz sağlanmamışsa, varsayılan \layout{...} ve \midi{...} bloklarıyla birlikte \score{...} bir blokta sarılır.
sound 0 (default), 1 1 olarak ayarlanırsa, Extension:TimedMediaHandler kurup yapılandırmanız koşuluyla skor için bir ses dosyası oluşturulur. Skor resimden sonra bir ses oynatıcı HTML'ye gömülecektir.
vorbis 0 (default), 1 (kaldırıldı) sound için takma ad.

LilyPond dili

Şarkı sözleri şu şekilde eklenebilir:

<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>
\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. }

İleri düzey kullanıcılar için, \set Staff.midiInstrument komutu sesin MIDI cihazını değiştirmek için kullanılabilir.

Ön koşullar

Aşağıdaki paketler önerilir:

  • LilyPond
  • Ghostscript
  • ImageMagick
  • FluidSynth
  • Firejail

Bu uzantı, skor görüntüleri oluşturmak için LilyPond'u kullanır, bu nedenle çalışan bir LilyPond kurulumuna ihtiyacınız vardır (Special:Version, LilyPond sürümünü görüntüler). LilyPond'u bir paketten yüklerseniz, LilyPond Ghostscript'e bağlı olduğundan Ghostscript de kurulacaktır. Resimleri kırpmak için ImageMagick kurulmalıdır, aksi takdirde aşırı miktarda boşluk içerirler.

Güvenlik nedeniyle, güvenilmeyen kullanıcıların vikinizi düzenlemesine izin verilirse LilyPond ve Ghostscript'in yapabileceklerini daha da kısıtlamak için firejail yüklemeniz önemle tavsiye edilir.

Uzantı ayrıca LilyPond tarafından üretilen MIDI dosyalarından ses dosyaları oluşturabilir. Bu işlevsellikten yararlanmak istiyorsanız, Extension:TimedMediaHandler kurulu olması gerekir.

FluidSynth, MIDI dosyalarını ses dosyalarına dönüştürmek için tercih edilen yöntemdir, ancak TiMidity++ de desteklenir.

Güvenlik endişeleri

Vikinizi korumak için LilyPond'u güvenceye almak için Shellbox'ı kullanın!

Score, güvenli modda LilyPond'u kullanır, ancak rastgele yürütmeye yol açan bilinen sabitlenmemiş güvenli mod kaçış güvenlik açıkları vardır.

Vikinizde düzenleme ayrıcalıklarına sahip olan herkese kesinlikle güvenmiyorsanız, Shellbox kullanarak lilypond'un çevrelenmesini ayarlamanız şiddetle tavsiye edilir. 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.

Kurulum

See the extension's README.md for detailed installation instructions.
  • Dosyaları indirin ve extensions/ klasörünüzdeki Score adlı dizine yerleştirin.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Score
  • LocalSettings.php dosyanızın altına aşağıdaki kodu ekleyin:
    wfLoadExtension( 'Score' );
    $wgScoreTrim = true;
    $wgImageMagickConvertCommand = '/usr/bin/convert';
    $wgShellboxUrl = '... address to Shellbox ...';
    $wgShellboxSecretKey = '... your secret key ...';
    
  • $wgUploadDirectory içinizde lilypond adlı bir alt dizin oluşturun (genellikle MediaWiki dizininizde images adlı dizin). Dizinin Web sunucunuz tarafından yazılabilir olduğundan emin olun.
  • Yes Yapıldı – Uzantının başarıyla yüklendiğini doğrulamak için vikinizde Special:Version seçeneğine gidin.

Yapılandırma

Uzantının küresel yapılandırma parametrelerinden bazıları aşağıda verilmiştir.

$wgScoreLilyPond

$wgScoreLilyPond LilyPond yürütülebilir dosyanızın yoluna ayarlayın (genellikle /usr/bin/lilypond veya /usr/local/bin/lilypond).

$wgScoreTrim

$wgScoreTrim, varsayılan olarak $wgUseImageMagick değerine ayarlanan bir boole değeridir. true ise, elde edilen skor PNG görüntüleri ImageMagick ile kırpılır. Kırpmak istemiyorsanız veya ImageMagick'i yüklemek istemiyorsanız, $wgScoreTrim öğesini false olarak ayarlayın.

$wgScoreAbc2Ly

$wgScoreAbc2Ly öğenizi ABC'nizin LilyPond dönüştürücü yürütülebilir dosyasına (tipik olarak /usr/bin/abc2ly veya /usr/local/bin/abc2ly olarak ayarlayın).

$wgScoreFluidsynth

$wgScoreFluidsynth Fluidsynth yürütülebilir dosya yolunuza (genellikle /usr/bin/fluidsynth veya /usr/local/bin/ fluidsynth olarak ayarlayın).

$wgScoreSoundfont

$wgScoreSoundfont soundfont dosyanızın (genellikle /usr/share/sounds/sf2/FluidR3_GM.sf2 veya /usr/share/sounds/sf2/FluidR3_GS.sf2 olarak ayarlayın).

$wgScoreLame

$wgScoreLame öğesini Lame yürütülebilir dosya yolunuza (genellikle /usr/bin/lame veya /usr/local/bin/lame olarak ayarlayın). Oluşturulan ses dosyasının MP3 olması gerekiyorsa gereklidir.

Notlar

Bu uzantı, biraz güvenlik sağlamak için bir Kabuk Kutusu içinde çeşitli ikili dosyaları çalıştırır. Bellek hatalarından kurtulursanız $wgMaxShellMemory artırmanız gerekebilir.

Puanları bulma

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.

Ayrıca bakınız