Extension:Score
The Score extension requires setting up an external service, Shellbox , to securely process musical scores via LilyPond. Please review the information in #Security concerns and the 2021 security advisory before installing this extension. |
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 |
|
|
score |
|
Quarterly downloads | 30 (Ranked 102nd) |
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
- Orijinal Extension:LilyPond Johannes E. Schindelin tarafından yazılmıştır.
- Bu uzantı Tim Starling'in Extension:LilyPond kod incelemesine dayanmaktadır.
- Orijinal Extension:ABC , Tarnell Nehri tarafından yazılmıştı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:
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:
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>
İ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
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üzdekiScore
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 dizininizdeimages
adlı dizin). Dizinin Web sunucunuz tarafından yazılabilir olduğundan emin olun. - 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
- Vikipedi'de Yardım:Puan ve Yardım:Müzik notası üzerinde daha fazla LilyPond sözdizimi örneği var.
- LilyPond notası
- ABC notası
Bu uzantı bir veya daha fazla Wikimedia projelerinde kullanılıyor. Bu, muhtemelen uzantının kararlı olduğu ve bu tür yüksek trafikli web siteleri tarafından kullanılacak kadar iyi çalıştığı anlamına gelir. Nerede kurulduğunu görmek için bu uzantının adını Wikimedia'nın CommonSettings.php ve InitialiseSettings.php yapılandırma dosyalarında arayın. Belirli bir vikide yüklü olan uzantılar listesinin tamamı vikinin Special:Version sayfasında görülebilir. |
This extension is included in the following wiki farms/hosts and/or packages: This is not an authoritative list. Some wiki farms/hosts and/or packages may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm. |